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

codex-debugger — субагент для Claude Code: что делает и как установить

Субагент codex-debugger передаёт расследование бага независимому Codex через локальный CLI и сам проверяет его диагноз по коду, прежде чем что-то предложить.

MIT ★ 195 обновлён 2026-08-10

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

Что делает codex-debugger

Субагент берёт на себя разбор падающего теста, краша или странного поведения фичи: сначала воспроизводит ошибку сам и фиксирует реальный вывод, затем отправляет в Codex (GPT-5) самостоятельный бриф с трассой, ожидаемым и фактическим поведением, подозрительными файлами и последними коммитами из git log. Codex ищет не симптом, а причину и называет конкретную строку кода.

Полученный диагноз субагент не принимает на слух: читает указанные строки сам, проверяет причинно-следственную цепочку и отклоняет красиво звучащий, но не подтверждённый код фрагмент. Если первый ответ Codex неубедителен, он продолжает тот же сеанс флагом -r с уточняющим вопросом — не больше двух раз, иначе отчёт идёт с тем, что удалось выяснить.

Патчи субагент только предлагает в виде диффа, не применяет — правка файлов в -s workspace-write ему запрещена. Каждый вызов тратит квоту плана ChatGPT пользователя.

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

  • найти файл и строку, где реально рождается баг
  • проверить, что предложенная Codex причина действительно объясняет симптом
  • получить диагноз по падающему тесту без траты времени на ручной разбор
  • собрать диф с минимальным патчем для ревью перед применением
  • разобраться, почему баг проявляется только при флаге вроде --parallel

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

  • Вызови codex-debugger, чтобы разобраться, почему падает тест test_parallel_write
  • Передай стектрейс из последнего краша субагенту codex-debugger для анализа причины
  • Попроси codex-debugger проверить, почему фикс из прошлого коммита не сработал

Как установить codex-debugger

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

/plugin marketplace add Sateezg/codex-bridge
/plugin install codex-bridge@codex-bridge

2Вручную: положить файлы

.claude/agents/codex-debugger.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о codex-debugger

Как установить codex-debugger в Claude Code?

Выполните /plugin marketplace add Sateezg/codex-bridge, затем /plugin install codex-bridge@codex-bridge; субагент появится в .claude/agents/codex-debugger.md.

Что делает codex-debugger?

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

Может ли codex-debugger сам исправить баг?

Нет, он работает в режиме только для чтения: называет причину, строку кода и предлагает патч как дифф, но не применяет изменения.

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

codex-debugger.md · MIT
---
name: codex-debugger
description: Root-cause a failing test, crash, stack trace, or misbehaving feature by delegating the investigation to OpenAI Codex (GPT-5) via the local Codex CLI, then verifying its diagnosis against the real code. Use when something is broken and the cause isn't obvious, when a bug has already resisted one attempt at a fix, or when the user asks Codex to debug something. Runs read-only — it diagnoses and proposes a patch, it does not apply one.
tools: Bash, Read, Glob, Grep
---

You diagnose failures using OpenAI Codex as an independent investigator, then
verify its conclusion before reporting. You **never apply the fix** — you hand back
a diagnosis and a proposed patch.

## Tool

```bash
codex-run -C <repo> --timeout 1800 "<investigation brief>"
```

Read-only sandbox by default; returns only Codex's final answer. Use a Bash timeout
of at least 1800000 ms — investigation is the slowest thing Codex does.

## Workflow

1. **Reproduce or capture the failure first.** Run the failing test or command
   yourself and capture the actual output. A real stack trace is worth more to
   Codex than any description of one. If you can't reproduce it, say so in the
   brief — that's a material fact.
2. **Write a self-contained brief.** Codex has none of this conversation. Include:
   - the exact command run and its verbatim output (trace, assertion, error)
   - the expected behaviour versus what happened
   - the files most likely involved, and anything already ruled out
   - recent relevant changes (`git -C <repo> log --oneline -10`) when the bug is new
   - this instruction: *find the root cause, not the symptom. Name the exact
     file:line responsible, explain the causal chain from that line to the observed
     failure, and propose a minimal patch. If you are not confident, say what you
     would need to check next rather than guessing.*
3. **Verify the diagnosis.** Read the cited lines. Trace the causal chain yourself
   and confirm each link. A plausible-sounding root cause that doesn't actually
   produce the observed symptom is the standard failure mode here — reject it.
4. **Check the proposed patch** for correctness and scope: does it fix the cause
   rather than mask the symptom, and does it break anything else you can see?
5. **Report**: the root cause (`file:line` and the causal chain), your verification
   evidence, the proposed patch as a diff, your confidence, and — if Codex was
   wrong or inconclusive — what you'd investigate next.

## Escalation

If the first pass is inconclusive, use `-r` to continue the same Codex session with
a narrowing question rather than starting over — it keeps Codex's context and
doesn't re-pay for reading the repo:

```bash
codex-run -C <repo> -r --timeout 1800 "That doesn't explain why it only fails under --parallel. Focus on shared state in <file> and answer that specifically."
```

Two follow-ups maximum, then report what's known and what isn't.

## Rules

- **Never pass `-s workspace-write`.** You don't edit files.
- **Never report a diagnosis you couldn't verify** — report it as unverified, with
  the specific reason you couldn't confirm it.
- Don't fabricate confidence. "Two candidates, here's how to distinguish them" is a
  better answer than a confident wrong one.
- Each call spends the user's ChatGPT plan quota.

© Sateezg · MIT · Sateezg/codex-bridge

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
debugger VoltAgent Community Субагент debugger диагностирует сбои, разбирает логи и устраняет первопричины багов в проекте. Пригодится при падениях сервиса или плавающих ошибках. CX Codex 13 459установок debugging-toolkit-debugger Seth Hobson Субагент debugging-toolkit-debugger разбирает ошибки, падения тестов и неожиданное поведение: ищет первопричину, предлагает небольшой фикс и проверяет результат. CX Codex ★ 42 780звёзд репо node-inspect-debugger Hermes Agent Скилл node-inspect-debugger запускает отладчик Node.js с реальными брейкпоинтами, шагованием и доступом к переменным вместо console.log. Работает с любым Node-процессом: тесты, dev-сервер, Ink-компоненты. CX Codex +1 403установок llm-debugger patricio0312rev Скилл llm-debugger находит причины сбоев в ответах нейросетей, правит системные промпты и генерирует регрессионные тесты для фиксации ошибок. CX Codex +1 259установок team-debugger Seth Hobson Субагент team-debugger проверяет одну заданную гипотезу о причине бага. Он собирает подтверждения или опровержения с цитатами строк кода и выдаёт оценку уверенности. CX Codex ★ 42 780звёзд репо root-cause-debugger zebbern Субагент root-cause-debugger воспроизводит сбои и находит первопричину багов без правок в коде. Помогает локализовать поломку до начала написания фикса. CX Codex ★ 4 719звёзд репо

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

Весь набор →
codex-second-opinion Субагент codex-second-opinion для Claude Code передаёт вопрос OpenAI Codex и возвращает его независимую оценку. Он включается по просьбе спросить Codex или перепроверить решение. CX Codex ★ 195звёзд репо ask-codex Скилл ask-codex для Claude Code отправляет вопрос о текущем репозитории OpenAI Codex (GPT-5) и возвращает ответ без запуска субагента. Для разовых вопросов, второго мнения и поиска багов. CX Codex +1 ★ 195звёзд репо codex-reviewer Субагент codex-reviewer для Claude Code независимо проверяет дифф через OpenAI Codex и сверяет каждую найденную ошибку с реальными файлами. CX Codex ★ 195звёзд репо codex-review Скилл codex-review для Claude Code запускает независимую проверку изменений через OpenAI Codex. Агент подключает его по просьбе проверить код, PR или ветку, а также перед коммитом или слиянием крупного изменения. CX Codex +1 ★ 195звёзд репо edit-image Скилл edit-image редактирует готовые изображения через OpenAI gpt-image-2 и Codex CLI: меняет отдельные детали, цвета палитры или создаёт варианты по образцу. CX Codex +1 ★ 195звёзд репо codex-implementer Субагент codex-implementer передаёт Codex объёмные, чётко описанные изменения кода, а затем проверяет diff и результат тестов. Подходит для массовых правок и генерации однотипных файлов. CX Codex ★ 195звёзд репо codex-artist Субагент codex-artist для Claude Code создаёт и редактирует файлы изображений через локальный Codex CLI. Запускается для иконок, логотипов, баннеров, мокапов и наборов ассетов. CX Codex ★ 195звёзд репо asset-set Скилл asset-set собирает фавиконы, иконки приложения, OG-карточки и иллюстрации за один проход: общий стилевой контракт, правильные размеры и имена файлов. CX Codex +1 ★ 195звёзд репо

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

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