codex-octopus — MCP-сервер для Claude Code: установка
Запускает несколько настроенных Codex-агентов через MCP. Подходит для раздельного ревью кода, написания тестов и быстрых ответов.
claude mcp add --env CODEX_API_KEY=<CODEX_API_KEY> --env CODEX_TOOL_NAME=<CODEX_TOOL_NAME> --env CODEX_MODEL=<CODEX_MODEL> --env CODEX_SANDBOX_MODE=<CODEX_SANDBOX_MODE> --env CODEX_APPROVAL_POLICY=<CODEX_APPROVAL_POLICY> --transport stdio codex-octopus -- npx -y codex-octopusЧто делает codex-octopus
codex-octopus оборачивает OpenAI Codex SDK в MCP-сервер. Каждый экземпляр можно настроить отдельно: выбрать модель, режим песочницы, уровень рассуждений, рабочую папку и инструкции. В клиенте такие экземпляры появляются как разные инструменты.
Конфигурация задаётся переменными окружения в .mcp.json. Можно поднять отдельные серверы для ревью в режиме read-only и записи тестов в workspace-write, а также использовать фабрику с инструментом create_codex_mcp для генерации записи конфигурации. На каждый вызов доступны параметры рабочей папки, модели, дополнительных директорий, сети и веб-поиска.
Для работы нужны Node.js версии 18 или выше, установленный Codex CLI через @openai/codex и ключ OpenAI в CODEX_API_KEY либо унаследованный процессом. Без Node.js версии 18 и выше сервер не запустится.
Какие задачи решает
- разделить ревью кода и написание тестов между агентами
- настроить для агентов разные модели и уровни рассуждений
- ограничить доступ агента режимом
read-only - передать агенту дополнительные директории проекта
- создать запись MCP-конфигурации через фабрику
Примеры запросов агенту
- Проверь этот модуль как строгий ревьюер и сообщи только о реальных ошибках.
- Напиши тесты для этого кода, включая пограничные случаи, с доступом на запись в рабочую папку.
- Создай MCP-конфигурацию для агента, который проверяет код в режиме
read-only, черезcreate_codex_mcp.
Как установить codex-octopus
Командой платформы
claude mcp add --env CODEX_API_KEY=<CODEX_API_KEY> --env CODEX_TOOL_NAME=<CODEX_TOOL_NAME> --env CODEX_MODEL=<CODEX_MODEL> --env CODEX_SANDBOX_MODE=<CODEX_SANDBOX_MODE> --env CODEX_APPROVAL_POLICY=<CODEX_APPROVAL_POLICY> --transport stdio codex-octopus -- npx -y codex-octopusВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add codex-octopus --env CODEX_API_KEY=<CODEX_API_KEY> --env CODEX_TOOL_NAME=<CODEX_TOOL_NAME> --env CODEX_MODEL=<CODEX_MODEL> --env CODEX_SANDBOX_MODE=<CODEX_SANDBOX_MODE> --env CODEX_APPROVAL_POLICY=<CODEX_APPROVAL_POLICY> -- npx -y codex-octopusВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"codex-octopus": {
"command": "npx",
"args": [
"-y",
"codex-octopus"
],
"env": {
"CODEX_API_KEY": "<CODEX_API_KEY>",
"CODEX_TOOL_NAME": "<CODEX_TOOL_NAME>",
"CODEX_MODEL": "<CODEX_MODEL>",
"CODEX_SANDBOX_MODE": "<CODEX_SANDBOX_MODE>",
"CODEX_APPROVAL_POLICY": "<CODEX_APPROVAL_POLICY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"codex-octopus": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codex-octopus"
],
"env": {
"CODEX_API_KEY": "<CODEX_API_KEY>",
"CODEX_TOOL_NAME": "<CODEX_TOOL_NAME>",
"CODEX_MODEL": "<CODEX_MODEL>",
"CODEX_SANDBOX_MODE": "<CODEX_SANDBOX_MODE>",
"CODEX_APPROVAL_POLICY": "<CODEX_APPROVAL_POLICY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e CODEX_API_KEY=<CODEX_API_KEY> -e CODEX_TOOL_NAME=<CODEX_TOOL_NAME> -e CODEX_MODEL=<CODEX_MODEL> -e CODEX_SANDBOX_MODE=<CODEX_SANDBOX_MODE> -e CODEX_APPROVAL_POLICY=<CODEX_APPROVAL_POLICY> codex-octopus npx -y codex-octopusВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о codex-octopus
Как установить codex-octopus в Claude Code?
Выполните claude mcp add codex-octopus -e CODEX_API_KEY=<CODEX_API_KEY> -- npx -y codex-octopus.
Что делает codex-octopus?
Он запускает настроенные экземпляры Codex как отдельные MCP-инструменты. Для каждого можно задать модель, песочницу, инструкции и уровень рассуждений.
Какие требования нужны для работы MCP-сервера?
Нужны Node.js версии 18 или выше, Codex CLI через @openai/codex и ключ OpenAI в CODEX_API_KEY либо унаследованный процессом.
