Как параллелить работу облачных браузеров в Claude Code агентах с помощью worktrees и 2Captcha Browser API

• отдельный worktree для кода каждого агента;
• отдельная сессия 2Captcha Browser API для каждого браузерного сценария.

Что такое worktree в Claude Code

claude --worktree browser-auth

claude -w browser-auth

claude --worktree product-parser

project/
├── .git/
├── src/
├── package.json
└── .claude/
    └── worktrees/
        ├── browser-auth/
        └── product-parser/

Почему worktree не решает все проблемы

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

Worktree разделяет исходники. Браузерную сессию он не разделяет.

Как распределить ресурсы между агентами

Одна задача
    ↓
Один Claude Code worktree
    ↓
Одна Git-ветка
    ↓
Одна сессия 2Captcha Browser API
    ↓
Своя папка с логами и результатами

Зачем здесь нужен 2Captcha Browser API

ws://BROWSER_USERNAME:[email protected]:9222

import { chromium } from "playwright";

const browser = await chromium.launch({
  headless: true,
});

import { chromium } from "playwright";

const browser = await chromium.connectOverCDP(
  process.env.BROWSER_WS_ENDPOINT
);

Пример: авторизация и сбор данных

1. настроить вход в аккаунт и сохранение сессии;
2. написать сборщик данных со страниц товаров.

Агент авторизации

claude --worktree browser-auth

Реализуй авторизацию через Playwright и 2Captcha Browser API.

Ограничения:
- изменяй только модуль авторизации;
- используй браузерную конфигурацию этого worktree;
- сохраняй авторизованную сессию;
- сохраняй скриншоты и трассировки в artifacts/browser-auth;
- не изменяй код сбора данных;
- не создавай миграции базы данных.

Worktree: browser-auth
Ветка: worktree-browser-auth
Браузерный логин: claude-browser-auth
Результаты: artifacts/browser-auth
Задача: вход в аккаунт и сохранение сессии

Агент сбора данных

claude --worktree product-parser

Реализуй сбор данных со страницы товара через Playwright
и 2Captcha Browser API.

Ограничения:
- изменяй только модуль сбора данных;
- используй браузерную конфигурацию этого worktree;
- извлекай название, цену, наличие и canonical URL;
- сохраняй скриншоты и трассировки в artifacts/product-parser;
- не изменяй модуль авторизации;
- не создавай миграции базы данных.

Worktree: product-parser
Ветка: worktree-product-parser
Браузерный логин: claude-product-parser
Результаты: artifacts/product-parser
Задача: навигация и извлечение данных

Подключение Playwright к 2Captcha Browser API

npm install playwright dotenv

BROWSER_USERNAME=YOUR_BROWSER_USERNAME
BROWSER_PASSWORD=YOUR_API_KEY
BROWSER_HOST=browser-cloud.2captcha.com
BROWSER_PORT=9222

.env
.claude/worktrees/
artifacts/

import "dotenv/config";
import { chromium } from "playwright";
import { mkdir } from "node:fs/promises";
import path from "node:path";

const requiredVariables = [
  "BROWSER_USERNAME",
  "BROWSER_PASSWORD",
  "BROWSER_HOST",
  "BROWSER_PORT",
];

for (const variable of requiredVariables) {
  if (!process.env[variable]) {
    throw new Error(`Missing required environment variable: ${variable}`);
  }
}

const username = encodeURIComponent(process.env.BROWSER_USERNAME);
const password = encodeURIComponent(process.env.BROWSER_PASSWORD);
const host = process.env.BROWSER_HOST;
const port = process.env.BROWSER_PORT;

const endpoint = `ws://${username}:${password}@${host}:${port}`;
const outputDirectory = path.resolve("artifacts/browser-example");

await mkdir(outputDirectory, { recursive: true });

const browser = await chromium.connectOverCDP(endpoint);

try {
  const contexts = browser.contexts();
  const context = contexts[0] ?? await browser.newContext();
  const pages = context.pages();
  const page = pages[0] ?? await context.newPage();

  await page.goto("https://example.com", {
    waitUntil: "domcontentloaded",
    timeout: 60000,
  });

  const title = await page.title();
  const heading = await page.locator("h1").first().textContent();

  await page.screenshot({
    path: path.join(outputDirectory, "page.png"),
    fullPage: true,
  });

  console.log({
    title,
    heading: heading?.trim() ?? null,
    url: page.url(),
  });
} finally {
  await browser.close();
}

node browser-example.mjs

Отдельная конфигурация для каждого worktree

BROWSER_USERNAME=claude-auth
BROWSER_PASSWORD=YOUR_API_KEY
BROWSER_HOST=browser-cloud.2captcha.com
BROWSER_PORT=9222
BROWSER_OUTPUT_DIR=artifacts/browser-auth

BROWSER_USERNAME=claude-products
BROWSER_PASSWORD=YOUR_API_KEY
BROWSER_HOST=browser-cloud.2captcha.com
BROWSER_PORT=9222
BROWSER_OUTPUT_DIR=artifacts/product-parser

Два агента не должны одновременно управлять одной постоянной браузерной сессией.

worktree browser-auth ─────┐
                           ├── общая браузерная сессия
worktree product-parser ───┘

worktree browser-auth
    └── отдельная сессия Browser API

worktree product-parser
    └── отдельная сессия Browser API

Что делать с .worktreeinclude

.env.example
.env.development

BROWSER_USERNAME=shared-browser-login
BROWSER_OUTPUT_DIR=/tmp/shared-browser-output

BROWSER_USERNAME=
BROWSER_PASSWORD=
BROWSER_HOST=browser-cloud.2captcha.com
BROWSER_PORT=9222
BROWSER_OUTPUT_DIR=

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

Очистка старых worktrees

• безымянное дерево без изменений может удалиться автоматически;
• для именованного дерева Claude Code может запросить подтверждение;
• дерево с изменениями не удаляется без подтверждения;
• после запуска через claude -p директория может остаться на диске.

git worktree list

git worktree remove .claude/worktrees/browser-auth

git worktree prune

.claude/worktrees/

Какие ресурсы все равно остаются общими

База данных

Аккаунт на сайте

Баланс и лимиты Browser API

Прокси

Папки с результатами

/tmp/latest-screenshot.png

artifacts/browser-auth/latest-screenshot.png
artifacts/product-parser/latest-screenshot.png

Локальные порты

FRONTEND_PORT=3001
BACKEND_PORT=8001

FRONTEND_PORT=3002
BACKEND_PORT=8002

Типичные ошибки

Два агента запущены в одной папке

Одна браузерная сессия используется несколькими агентами

Worktree считают защитой от merge-конфликтов

Несколько агентов создают миграции

Один .env копируется во все деревья

Все сценарии используют один тестовый аккаунт

Логи и скриншоты пишутся в общую папку

Зависимые задачи запускаются одновременно

Правила для CLAUDE.md

## Параллельная браузерная автоматизация

- Не запускай двух пишущих агентов в одной рабочей директории.
- Отдельные окна терминала не обеспечивают изоляцию файлов.
- Одна задача должна соответствовать одному worktree, одной ветке
  и одной зоне ответственности.
- Каждый параллельный worktree должен использовать отдельную сессию
  2Captcha Browser API или отдельный постоянный профиль.
- Не позволяй двум агентам одновременно управлять одной постоянной
  браузерной сессией.
- Для сценариев, меняющих состояние аккаунта, используй отдельные
  тестовые учетные записи.
- Скриншоты, трассировки, HAR-файлы, загрузки и логи сохраняй
  внутри текущего worktree.
- Миграции и документацию схемы базы данных изменяй последовательно.
- Добавь `.claude/worktrees/` в `.gitignore`.
- Не храни production-ключи Browser API в отслеживаемых файлах.
- Не копируй production-секреты во все worktrees.
- Назначай разные локальные порты параллельным серверам.
- Агент, выполняющий ревью, не должен изменять файлы и состояние браузера.
- После неинтерактивных запусков удаляй ненужные деревья вручную:
  `git worktree remove <path>`.

Когда параллельная работа оправдана

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

Когда лучше не усложнять

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

Две непроверенные ветки — это не две готовые задачи, а две очереди на ревью.

Рабочий порядок

1. Разделите работу на независимые задачи.
2. Создайте worktree для каждой задачи.
3. Назначьте каждому агенту отдельную сессию 2Captcha Browser API.
4. Разведите тестовые аккаунты, прокси, порты и папки с результатами.
5. Не запускайте параллельные изменения схемы базы данных.
6. Запустите тесты в каждом дереве.
7. Проверьте Git diff каждой ветки.
8. Объединяйте ветки по одной.
9. После каждого слияния запускайте полный набор тестов.
10. Удаляйте старые worktrees и временные браузерные сессии.

claude --worktree browser-auth
claude --worktree product-parser

git branch --list "worktree-*"

git diff main...worktree-browser-auth
git diff main...worktree-product-parser

git switch main
git merge worktree-browser-auth

git merge worktree-product-parser

git worktree remove .claude/worktrees/browser-auth
git worktree remove .claude/worktrees/product-parser
git branch -d worktree-browser-auth
git branch -d worktree-product-parser
git worktree prune

Итог

Worktree отвечает за изоляцию разработки. 2Captcha Browser API — за изоляцию выполнения.