К основному содержанию
плагин CX Codex

kachilu-browser — плагин для Claude Code: что делает и как установить

Плагин kachilu-browser для Claude Code и Codex автоматизирует браузер, распознаёт капчу и передаёт её завершение в локальный поток; из WSL2 управляет браузером на Windows.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install kachilu-browser@awesome-codex-plugins
Открыть на GitHub

Что делает kachilu-browser

kachilu-browser даёт агенту браузер, который ведёт себя по-человечески: открывает страницы, кликает, печатает. Когда на пути встаёт reCAPTCHA v2/v3 или Cloudflare Turnstile, плагин распознаёт проверку и передаёт её завершение в локальный CLI-поток браузера. Работает с Claude и Codex.

Ставится через npm install -g kachilu-browser, дальше kachilu-browser onboard. В интерактивном терминале мастер спросит целевой хост, в скриптовом прогоне нужен флаг --target codex, --target claudecode или --target claudedesktop. Затем откройте страницу с галочкой разрешения remote debugging и отметьте её, иначе агент к браузеру не подключится. Для Codex и Claude на WSL2 полный MCP-онбординг сам прописывает KACHILU_BROWSER_AUTO_CONNECT_TARGET=windows и находит путь к Windows-профилю.

WSL2 здесь не побочный сценарий: агент из Linux управляет тем же браузером на Windows, что и вы. Отсюда и слабое место. Сырая shell-команда kachilu-browser может потерять переменную с целевой платформой и запустить локальный Linux-браузер вместо нужного, поэтому при живых MCP-инструментах держитесь маршрута prepare/exec. Всё крутится локально, без телеметрии и платного релея.

Какие задачи решает

  • пройти reCAPTCHA на форме регистрации, не выходя из агента
  • подключить Codex из WSL2 к Windows-браузеру с вашим профилем
  • сохранить сессию и профиль между перезапусками и сжатием контекста
  • настроить MCP-маршрут браузера одной командой onboard
  • понять, какая бот-защита стоит на странице

Примеры запросов агенту

  • Открой страницу входа через kachilu-browser и скажи, какая там проверка
  • Залогинься в кабинет через kachilu_browser_exec и оставь сессию для следующего шага
  • Подключись к Windows-браузеру из WSL2 и забери таблицу со страницы

Как установить kachilu-browser

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install kachilu-browser@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о kachilu-browser

Как установить kachilu-browser в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем поставьте плагин: /plugin install kachilu-browser@awesome-codex-plugins.

Что делает kachilu-browser?

Даёт агенту управление браузером: навигация, клики, ввод текста. Плюс распознавание reCAPTCHA и Cloudflare Turnstile с передачей проверки в локальный поток браузера.

Что происходит, когда на странице появляется капча?

Плагин определяет тип проверки и проводит её завершение через локальный CLI и браузер. Агенту не нужно бросать задачу на середине.

Исходный текст

kachilu-browser · MIT
# Kachilu Browser

`kachilu-browser` is an anti-bot-aware browser automation CLI for AI agents such
as Codex and Claude.

<p align="center">
  <img src="docs/reCAPTCHA.gif" alt="Kachilu Browser detecting a reCAPTCHA challenge" width="100%">
</p>

> CAPTCHA in the way? The LLM detects it through the SKILL and hands off
> completion automatically. Nothing complicated.

Human-like interaction is the default. When reCAPTCHA v2/v3 or Cloudflare
Turnstile appears, `kachilu-browser` detects the challenge and routes completion
through the local CLI/browser flow.

WSL2 is first-class: agents running in Linux can control the Windows-side
browser profile you actually use, instead of a separate WSL-only browser.

Free to use. Local by design. No hosted relay, no telemetry, no external control
plane between the agent and your browser.

## Install

```bash
npm install -g kachilu-browser
kachilu-browser onboard
```

When this page appears, tick the checkbox so the agent can connect to your browser:

![Remote debugging permission checkbox](docs/remote-debugging.png)

## OpenClaw

```bash
openclaw plugins install kachilu-browser
openclaw gateway restart
```

OpenClaw uses the same npm package bundle, so no separate package name or extra
install script is needed.

## Onboarding targets

- If `--target` is omitted in an interactive terminal, `kachilu-browser onboard` prompts for the host target
- In non-interactive runs, pass `--target codex`, `--target claudecode`, or `--target claudedesktop`
- Use `--skill-only` or `--no-mcp` for desktop hosts that already provide a browser session and only need the Codex or Claude Code skill
- For Codex and Claude Code on WSL2, full MCP onboarding persists `KACHILU_BROWSER_AUTO_CONNECT_TARGET=windows` and auto-detected `KACHILU_BROWSER_WINDOWS_LOCALAPPDATA` unless you override them
- When targeting Windows browsers from WSL2 through MCP, `onboard` also ensures `%USERPROFILE%\.wslconfig` has `[wsl2] networkingMode=mirrored` and reports when `wsl --shutdown` is required
- `codex`: writes `~/.codex/config.toml` and links `~/.codex/skills/kachilu-browser`
- `claudecode`: writes `~/.claude.json` and links `~/.claude/skills/kachilu-browser`
- `claudedesktop`: writes the Claude Desktop local MCP config. Use `claude-desktop` as an equivalent alias.
- Claude Desktop Skills are distributed as `kachilu-browser-skill.zip` on GitHub Releases and must be uploaded through Claude Desktop's Skills UI.

```bash
kachilu-browser onboard --target codex --codex-home <desktop-codex-home> --skill-only
```

## MCP control plane

Agents should keep using a host-provided browser session when one is explicit. Otherwise, they should keep using the MCP prepare/exec workflow whenever the tools are available, including after context compaction or resume. For MCP-managed sessions, this preserves the session, profile, and WSL2 Windows-browser target from the MCP env block.

Raw `kachilu-browser` shell commands are a fallback for environments without MCP, explicit CLI requests, or intentional local WSL/Linux browser work. On WSL2, a raw shell command can miss `KACHILU_BROWSER_AUTO_CONNECT_TARGET=windows` and launch or control a WSL2-local browser instead of the intended Windows browser.

Successful prepare and exec responses include `controlPlane: "mcp"` and `followUpTool: "kachilu_browser_exec"` so agents can preserve the MCP route across context compaction and long-running resumes.

## Release model

- Native binaries are built from the private source repo.
- The npm package bundles available native binaries so `npm install -g kachilu-browser` works without exposing the private source tree.
- The source repo must provide `KACHILU_BROWSER_RELEASE_TOKEN` so it can create this repo's GitHub Release and push synced tags.
- This public repo publishes the npm package via npm Trusted Publishing after the package already exists on npm.
- The very first npm publish for `kachilu-browser` must be done manually with `npm publish --access public`.
- If the package was unpublished, npm blocks republishing the same package name for 24 hours.
- This repo's publish workflow also refuses to publish if the package does not yet exist on npm.
- The npm package downloads matching native binaries from GitHub Releases only when the current platform binary was not bundled in the package.

## Commands

```bash
kachilu-browser --help
kachilu-browser onboard --help
node scripts/mcp-server.mjs
```

© Kachilu Inc. · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Браузер и парсинг» →
browser-screenshot zc277584121 Скилл browser-screenshot для Claude Code делает снимок конкретного блока страницы: поста, твита, графика — без меню, рекламы и сайдбаров. CX Codex +1 4 100установок dev-browser SawyerHood Скилл dev-browser управляет настоящим Chrome с помощью коротких скриптов Puppeteer. Именованные страницы сохраняются между запусками, позволяя продолжить работу с того же места. CX Codex +1 2 600установок agent-browser-automation reason-machines Скилл agent-browser-automation даёт ИИ headless-браузер через Rust CLI и Chrome DevTools Protocol. Подходит для навигации, форм и снимков страниц. CX Codex +1 2 100установок browser-replay ruvnet Скилл browser-replay для Claude Code повторяет записанную сессию браузера на том же или изменённом адресе. Используется для регрессионных тестов после деплоя. CX Codex +1 721установок browser-record ruvnet Скилл browser-record открывает именованную браузерную сессию и записывает действия в траекторию ruvector. Сессия подходит для последующего анализа и повторного использования. CX Codex +1 719установок setup-browser-cookies garrytan Скилл setup-browser-cookies для Claude Code переносит куки из установленного браузера Chromium в сессию headless-браузера. Запускается при авторизации на тестовом сайте или запросе импорта кук. CX Codex +1 379установок

Из того же набора391

Весь набор →
lacuna-music Плагин lacuna-music для Claude Code и Codex генерирует инструментальные треки и песни с вокалом по тексту через MCP-сервер Lacuna. Создаёт музыку для озвучки прототипов и фонового сопровождения. CX Codex ★ 1 596звёзд репо kuudo-skills Плагин kuudo-skills для Claude Code и Codex помогает аудировать Amazon-рекламу, листинги, цены и прибыль. Агент использует его для разбора коммерческих данных и выбора следующих шагов. CX Codex ★ 1 596звёзд репо krexa Плагин krexa превращает торговую идею, пост или видео в правила, гоняет бэктест и бумажную торговлю, а живого агента запускает только после вашей подписи. CX Codex ★ 1 596звёзд репо crawlberg Плагин crawlberg скачивает веб-страницы, переводит HTML в Markdown и обходит домены через локальный CLI и MCP-сервер. Поможет получить чистый контент сайтов прямо в контекст агента. CX Codex ★ 1 596звёзд репо jimeng-skills Плагин jimeng-skills разворачивает производственный конвейер раскадровки коротких сериалов с шестью субагентами. Помогает пройти путь от сырого текста до промптов генерации и финальной проверки. CX Codex ★ 1 596звёзд репо jev-social Плагин jev-social для Claude Code собирает данные из Instagram, TikTok и LinkedIn в отчёты с цитатами на источники. Агент выбирает операции для поиска, просмотра публикаций и чтения комментариев в Chrome. CX Codex ★ 1 596звёзд репо jetformat Направляет агента к локальному jetformat для обработки Office-файлов и PDF. Конвертирует Word, Excel и PowerPoint в PDF и извлекает текст. CX Codex ★ 1 596звёзд репо jk Плагин jk управляет контроллерами Jenkins в стиле GitHub CLI: запускает сборки, читает логи, скачивает артефакты и настраивает пайплайны через Claude Code. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой