claude-octopus — MCP-сервер для Claude Code: как установить
Запускает изолированные агенты Claude Code в виде инструментов MCP с отдельными моделями и системными промптами под разные задачи проекта.
claude mcp add --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env CLAUDE_TOOL_NAME=<CLAUDE_TOOL_NAME> --env CLAUDE_MODEL=<CLAUDE_MODEL> --env CLAUDE_PERMISSION_MODE=<CLAUDE_PERMISSION_MODE> --env CLAUDE_ALLOWED_TOOLS=<CLAUDE_ALLOWED_TOOLS> --transport stdio claude-octopus -- npx -y claude-octopusЧто делает claude-octopus
Сервер оборачивает Claude Agent SDK и позволяет поднимать несколько независимых подпроцессов Claude Code. Каждый агент получает собственную конфигурацию. Вы можете закрепить за ревью модель Opus с доступом только на чтение, а простые вопросы перенаправить на дешёвую Haiku. В базовом режиме сервер добавляет инструменты для отправки задач и создания HTML-отчётов.
Предусмотрен режим координатора через переменную CLAUDE_MCP_SERVERS. Для генерации конфигов есть фабрика create_claude_code_mcp и интерактивный мастер npx claude-octopus init. Для работы сервера нужен Node.js версии не ниже 18 и установленный CLI claude. Авторизация требует ключ ANTHROPIC_API_KEY либо активную OAuth-сессию Claude Code.
Какие задачи решает
- разделять задачи между лёгкими и ресурсоёмкими моделями Anthropic
- ограничивать права агента ревью только чтением файлов
- строить цепочки автономных агентов через схему координатора
- отслеживать хронологию выполнения задач и получать стенограммы сессий
Примеры запросов агенту
- Запусти проверку безопасности в
src/auth.tsчерез инструментcode_reviewer - Сгенерируй отчёт о выполненной сессии через
claude_code_report - Подготовь набор юнит-тестов для платёжного модуля с помощью
test_writer
Как установить claude-octopus
Командой платформы
claude mcp add --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env CLAUDE_TOOL_NAME=<CLAUDE_TOOL_NAME> --env CLAUDE_MODEL=<CLAUDE_MODEL> --env CLAUDE_PERMISSION_MODE=<CLAUDE_PERMISSION_MODE> --env CLAUDE_ALLOWED_TOOLS=<CLAUDE_ALLOWED_TOOLS> --transport stdio claude-octopus -- npx -y claude-octopusВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add claude-octopus --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env CLAUDE_TOOL_NAME=<CLAUDE_TOOL_NAME> --env CLAUDE_MODEL=<CLAUDE_MODEL> --env CLAUDE_PERMISSION_MODE=<CLAUDE_PERMISSION_MODE> --env CLAUDE_ALLOWED_TOOLS=<CLAUDE_ALLOWED_TOOLS> -- npx -y claude-octopusВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"claude-octopus": {
"command": "npx",
"args": [
"-y",
"claude-octopus"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"CLAUDE_TOOL_NAME": "<CLAUDE_TOOL_NAME>",
"CLAUDE_MODEL": "<CLAUDE_MODEL>",
"CLAUDE_PERMISSION_MODE": "<CLAUDE_PERMISSION_MODE>",
"CLAUDE_ALLOWED_TOOLS": "<CLAUDE_ALLOWED_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"claude-octopus": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"claude-octopus"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"CLAUDE_TOOL_NAME": "<CLAUDE_TOOL_NAME>",
"CLAUDE_MODEL": "<CLAUDE_MODEL>",
"CLAUDE_PERMISSION_MODE": "<CLAUDE_PERMISSION_MODE>",
"CLAUDE_ALLOWED_TOOLS": "<CLAUDE_ALLOWED_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -e CLAUDE_TOOL_NAME=<CLAUDE_TOOL_NAME> -e CLAUDE_MODEL=<CLAUDE_MODEL> -e CLAUDE_PERMISSION_MODE=<CLAUDE_PERMISSION_MODE> -e CLAUDE_ALLOWED_TOOLS=<CLAUDE_ALLOWED_TOOLS> claude-octopus npx -y claude-octopusВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о claude-octopus
Как установить claude-octopus в Claude Code?
Выполните команду claude mcp add claude-octopus -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- npx -y claude-octopus. Для настройки конкретных ролей передайте дополнительные переменные окружения через флаги --env.
Что делает claude-octopus?
Он разворачивает процессы Claude Code как инструменты протокола MCP. Это даёт возможность использовать специализированных ассистентов с собственными лимитами бюджета, системными инструкциями и наборами утилит.
Что нужно подготовить перед запуском сервера?
Потребуются среда Node.js версии 18 или новее, установленная утилита claude в системе и ключ ANTHROPIC_API_KEY либо действующая OAuth-авторизация.
