OpenAI Codex MCP integration for Claude Code — audit, implement, verify, review, and debug via Codex.

Part of the xiaolai plugin marketplace. For the full reference, see GUIDE.md.

npm install -g @openai/codex && codex login    # prerequisite
/plugin marketplace add xiaolai/claude-plugin-marketplace
/plugin install codex-toolkit@xiaolai
/codex-toolkit:setup                           # verify readiness

Install fails with "Plugin not found in marketplace 'xiaolai'"? Your local marketplace clone is stale. Run claude plugin marketplace update xiaolai and retry — plugin install does not auto-refresh.

flowchart LR
    User -->|"slash commands"| Claude["Claude Code<br/>(orchestrator)"]
    Claude -->|"MCP (foreground)"| Codex["Codex<br/>(worker)"]
    Claude -->|"CLI (background)"| Codex
    Codex -->|"findings + threadId"| Claude
    Claude -->|"structured report"| User
    Claude -->|"fallback if Codex down"| Claude

/codex-toolkit:audit --mini              # fast audit of uncommitted changes
/codex-toolkit:audit --full --background # thorough audit, don't wait
/codex-toolkit:status                    # check progress
/codex-toolkit:result                    # get results
/codex-toolkit:audit-fix                 # auto-fix cycle

codex-toolkit — multi-dimensional auditing platform. Deep structured analysis, progressive disclosure (mini → full → specialized), automated fix cycles, cross-provider knowledge bridge.

codex-plugin-cc — focused Codex bridge. Mature runtime (app-server protocol, TCP broker, progress streaming), polished job UX, adversarial review command.

Both share: persistent job state, background execution, session lifecycle hooks, stop-time review gates.

The plugin registers Codex as an MCP server via .mcp.json. Authenticate via subscription (codex login) or OPENAI_API_KEY.

ISC