Настройка разрешений Claude Code при работе с MegaIndex Browser API

Почему для удаленного браузера одних разрешений Claude Code недостаточно

node scripts/check-account.mjs

• загрузить сохраненные cookies;
• войти в аккаунт;
• перейти по редиректам;
• открыть внутренние страницы;
• собрать данные;
• скачать отчет;
• нажать кнопку подтверждения.

Как выбрать режим для проекта с BrowserAPI

• какой аккаунт используется;
• есть ли в сессии сохраненные cookies;
• может ли сценарий изменить данные;
• где он выполняется — в staging или production;
• будет ли кто-то проверять запросы на подтверждение;
• можно ли тестами доказать, что браузер выполнил нужное действие.

Manual — для проверки и чувствительных сессий

• код подключения к браузеру;
• селекторы;
• логику авторизации;
• восстановление сессии;
• скриншоты;
• трейсы Playwright;
• логи выполнения;
• повторные попытки и тайм-ауты.

• производственными аккаунтами;
• административными панелями;
• платежными разделами;
• персональными данными;
• интерфейсами публикации;
• настройками аккаунта;
• необратимыми действиями.

Plan — перед сложной браузерной автоматизацией

• затрагивает несколько файлов;
• восстанавливает авторизованную сессию;
• работает с несколькими доменами;
• загружает или скачивает файлы;
• содержит повторные попытки или резервные ветки;
• изменяет состояние аккаунта;
• обрабатывает редиректы;
• использует постоянный профиль браузера.

1. начальный URL;
2. разрешенные домены;
3. условия авторизации;
4. источники учетных данных и cookies;
5. действия только для чтения;
6. действия, изменяющие данные;
7. лимиты повторных попыток и тайм-аутов;
8. условие успешного выполнения;
9. скриншоты, трейсы и логи, которые нужно сохранить;
10. порядок закрытия сессии.

Accept edits — для реализации согласованного сценария

• Playwright- и Puppeteer-скриптами;
• модулем подключения к BrowserAPI;
• вспомогательными функциями навигации;
• логикой извлечения данных;
• повторными попытками;
• логированием;
• тестовыми фикстурами;
• созданием скриншотов;
• закрытием сессий.

• слишком общие селекторы вроде button или text=Confirm;
• отсутствие проверки hostname;
• бесконечные циклы повторных попыток;
• повторное использование постоянного профиля;
• попадание учетных данных в логи;
• автоматическую отправку форм;
• резервные клики по неточным селекторам;
• обработчики ошибок, которые продолжают выполнение после неожиданного состояния страницы.

Auto — только для тестовой среды

• тестовый сайт;
• отдельные тестовые аккаунты;
• одноразовые браузерные сессии;
• строгий список разрешенных доменов;
• учетные данные с ограниченными правами;
• лимиты переходов и действий;
• автоматические тесты;
• скриншоты или трейсы после ключевых шагов.

• исправление селекторов после изменения интерфейса;
• настройка ожиданий и тайм-аутов;
• повторный запуск браузерных тестов;
• сравнение скриншотов;
• поиск причин ошибок при извлечении данных;
• проверка и улучшение закрытия сессий.

await page.getByRole("button", { name: "Confirm" }).click();

Don’t ask — для автоматических запусков

• плановые проверки доступности;
• ночные тесты рендеринга;
• сравнение скриншотов;
• браузерные smoke-тесты в CI;
• извлечение данных с заранее разрешенных страниц;
• регрессионные тесты после развертывания.

Bash
node *
npm *
git

Bash(npx playwright test tests/browser/staging*)

Bypass — только при полной изоляции

• находится временная копия проекта;
• используются только тестовые учетные данные;
• не подключен домашний каталог;
• нет производственных SSH-ключей;
• нет личных cookies;
• нет доступа к рабочей базе данных;
• используется одноразовый профиль BrowserAPI;
• ограничен исходящий сетевой трафик.

• среду, в которой работает Claude;
• удаленный браузер, которым он управляет.

Разрешения Claude Code не управляют действиями внутри браузера

npm run browser:check

• открыть другой домен;
• восстановить cookies аккаунта;
• перейти на закрытую страницу;
• загрузить файл;
• отправить форму;
• выполнить необратимое действие.

Ограничьте список доменов

const allowedHosts = new Set([
  "staging.example.com",
  "accounts.example.com"
]);

function assertAllowedUrl(rawUrl) {
  const url = new URL(rawUrl);

  if (!allowedHosts.has(url.hostname)) {
    throw new Error(`Navigation to unapproved host: ${url.hostname}`);
  }
}

page.on("framenavigated", frame => {
  if (frame === page.mainFrame()) {
    assertAllowedUrl(frame.url());
  }
});

Разделяйте чтение и изменение данных

• чтения и извлечения данных;
• отправки форм;
• публикации;
• изменения аккаунта;
• удаления;
• операций, связанных с оплатой.

scripts/browser/read-dashboard.mjs
scripts/browser/update-profile.mjs
scripts/browser/publish-page.mjs

Используйте аккаунты с минимальными правами

• платежным разделам;
• управлению пользователями;
• API-ключам;
• удалению аккаунта;
• публикации;
• способам оплаты.

Используйте временные сессии для автономных задач

Задайте жесткие лимиты

• общее время выполнения;
• количество переходов;
• число открытых страниц;
• повторные попытки для каждого шага;
• размер скачиваемых файлов;
• количество скриншотов;
• общее число браузерных действий;
• количество доменов, открытых через редиректы.

const limits = {
  maxNavigations: 10,
  maxActions: 40,
  maxRetriesPerStep: 2,
  maxRuntimeMs: 120000
};

Сохраняйте подтверждение результата

• трейсы Playwright;
• скриншоты;
• конечные URL;
• ошибки консоли;
• неудачные сетевые запросы;
• журнал действий;
• извлеченные данные;
• результаты проверок.

Добавьте Stop hook

{
  "permissions": {
    "defaultMode": "plan",
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./browser-data/**)",
      "Bash(git push --force*)",
      "Bash(git remote add *)",
      "Bash(git remote set-url *)"
    ],
    "ask": [
      "Bash(node scripts/browser/run-production.mjs *)"
    ],
    "allow": [
      "Bash(npx playwright test tests/browser/staging*)"
    ]
  },
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/verify-browser-tests.sh",
            "timeout": 300
          }
        ]
      }
    ]
  }
}

#!/usr/bin/env bash

set -uo pipefail

cat >/dev/null

cd "${CLAUDE_PROJECT_DIR:?CLAUDE_PROJECT_DIR is not set}"

if npm run lint && npx playwright test tests/browser/staging; then
  exit 0
fi

echo "Browser verification failed." >&2
exit 2

chmod +x .claude/hooks/verify-browser-tests.sh

• конечный hostname входит в список разрешенных;
• использован нужный тестовый аккаунт;
• страница находится в ожидаемом состоянии;
• не была случайно отправлена другая форма;
• получен нужный результат;
• все страницы и сессии закрыты.

Рекомендуемый порядок работы

Промпт для Claude Code

Проверь проект с MegaIndex BrowserAPI и подготовь безопасный план браузерной автоматизации.

1. Оставайся в режиме Plan. Не изменяй файлы и не запускай браузер.
2. Найди все файлы, связанные с подключением к BrowserAPI.
3. Укажи начальный URL, разрешенные хосты, возможные редиректы и внешние endpoints.
4. Отдели действия только для чтения от действий, которые меняют состояние удаленной системы.
5. Покажи, где в сценарий передаются учетные данные, cookies, профили браузера и токены сессии.
6. Определи лимиты переходов, повторных попыток, браузерных действий, скачиваний и общего времени выполнения.
7. Укажи, какие скриншоты, трейсы, логи и проверки нужны для подтверждения результата.
8. Перечисли команды staging, которые можно запускать автоматически.
9. Отметь все производственные, административные, платежные, удаляющие и публикующие действия как требующие подтверждения.
10. Верни план реализации, список затрагиваемых файлов, основные риски, тесты и точную команду для первого контролируемого запуска.

Главное правило