codex-cli — субагент для Claude Code: запуск Codex для анализа кода
Субагент для Claude Code: запускает OpenAI Codex CLI с переданным промптом и возвращает сырой вывод — второе мнение по коду от модели GPT-5.2.
MIT ★ 2 744 обновлён 2026-10-08
.claude/agents/codex-cli.mdЧто делает codex-cli
Субагент выполняет команду Codex CLI с переданным промптом и возвращает только сырой вывод. Запуск идёт с флагом -p readonly exec и --json, поэтому Codex работает в режиме readonly и не трогает файлы проекта.
Перед запуском субагент определяет платформу и выбирает оболочку: zsh -i -c на macOS, bash -i -c на Linux, powershell -Command на Windows. Если алиас codex прописан в конфиге оболочки, интерактивный запуск его подхватит. Время выполнения ограничено 120000 мс.
Для работы нужно, чтобы сам Codex CLI уже был установлен и лежал в PATH. Если его нет, субагент просто вернёт ошибку запуска. Файл кладётся в .claude/agents/codex-cli.md, после чего Claude Code подхватит его как агента с доступом к Bash.
Какие задачи решает
- получить разбор кода от GPT-5.2 не покидая Claude Code
- сравнить мнение двух моделей по одному фрагменту
- запустить Codex в режиме readonly без риска изменений
- автоматизировать вызов Codex CLI через агента
- получить ответ Codex в машиночитаемом JSON
Примеры запросов агенту
- Вызови субагента codex-cli с вопросом: разбери этот файл и найди потенциальные баги
- Попроси codex-cli объяснить, что делает функция
parseConfig - Запусти codex-cli, пусть посмотрит на
src/api.tsи скажет, где узкие места
Как установить codex-cli
Вручную: положить файлы
.claude/agents/codex-cli.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/codex-cli.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/codex-cli.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о codex-cli
Как установить codex-cli в Claude Code?
Положи файл в .claude/agents/codex-cli.md. Claude Code сам найдёт его как субагента с доступом к Bash.
Что делает codex-cli?
Запускает команду codex -p readonly exec "USER_PROMPT" --json и возвращает сырой вывод. Промпт пользователя подставляется на место USER_PROMPT.
Что нужно для работы субагента?
На машине должен стоять Codex CLI и быть доступен в PATH. Если алиас codex прописан только в конфиге оболочки, субагент использует zsh -i -c или bash -i -c.
Исходный текст
codex-cli.md · MIT
--- name: codex-cli description: "Execute OpenAI Codex CLI (GPT-5.2) for code analysis. Use when you need Codex's GPT-5.2 perspective on code." tools: Bash model: haiku color: blue --- # CLI Passthrough Agent Execute the Codex CLI command with the user's prompt. Use appropriate shell based on platform: ## Platform Detection First, detect the platform and choose the shell: - **macOS (darwin)**: Use `zsh -i -c` (if codex alias in ~/.zshrc) or direct `codex` command - **Linux**: Use `bash -i -c` (if codex alias in ~/.bashrc) or direct `codex` command - **Windows**: Use `powershell -Command` or direct `codex` command ## Execution (timeout: 120000ms) **Direct command (preferred if codex is in PATH):** ```bash codex -p readonly exec "USER_PROMPT" --json ``` **For macOS (if codex needs shell config):** ```bash zsh -i -c "codex -p readonly exec 'USER_PROMPT' --json" ``` **For Linux (if codex needs shell config):** ```bash bash -i -c "codex -p readonly exec 'USER_PROMPT' --json" ``` **For Windows (PowerShell):** ```powershell powershell -Command "codex -p readonly exec 'USER_PROMPT' --json" ``` Substitute USER_PROMPT with the input, execute, return only raw output.
© centminmod · MIT · centminmod/my-claude-code-setup