# codex-octopus

Запускает несколько настроенных Codex-агентов через MCP. Подходит для раздельного ревью кода, написания тестов и быстрых ответов.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 20
- Автор: xiaolai
- Лицензия: ISC · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/xiaolai/codex-octopus
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/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 и выше сервер не запустится.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `CODEX_API_KEY`, `CODEX_TOOL_NAME`, `CODEX_MODEL`, `CODEX_SANDBOX_MODE`, `CODEX_APPROVAL_POLICY`, `CODEX_APPEND_INSTRUCTIONS`, `CODEX_FACTORY_ONLY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- разделить ревью кода и написание тестов между агентами
- настроить для агентов разные модели и уровни рассуждений
- ограничить доступ агента режимом `read-only`
- передать агенту дополнительные директории проекта
- создать запись MCP-конфигурации через фабрику

## Примеры запросов агенту
- Проверь этот модуль как строгий ревьюер и сообщи только о реальных ошибках.
- Напиши тесты для этого кода, включая пограничные случаи, с доступом на запись в рабочую папку.
- Создай MCP-конфигурацию для агента, который проверяет код в режиме `read-only`, через `create_codex_mcp`.

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md