cc-codex-bridge

Vytvořeno: 21.8.2026 | Aktualizováno: 21.08.2026 07:41

cc-codex-bridge připojuje nativní OpenAI Codex CLI jako adresovatelného člena týmu Claude Code. Claude Code zůstává hlavním agentním prostředím a na Codex deleguje konkrétní úlohy přes MCP.

Projekt nepřesměrovává celý Claude Code na jiný model. Místo toho přidá agenta codex-peer, kterému lze z Claude Code týmu poslat zprávu pomocí SendMessage. Tenký relay agent zavolá nástroj codex_turn a lokální Node.js bridge předá zadání nativnímu codex mcp-server.

Claude Code tým → codex-peer → codex_turn → codex-bridge → nativní Codex CLI

Codex je tedy samostatný specialista: může zkontrolovat diff, navrhnout řešení nebo oponovat architektonickému rozhodnutí. Hlavní Claude agent rozhoduje, jak s jeho odpovědí naloží.

Každá zpráva pro codex-peer začíná operátorem zadaným identifikátorem CONV_ID:.

CONV_ID: muj-projekt--review-01
Zkontroluj tento diff a najdi možné chyby.

Bridge uloží Codex thread_id pod tento klíč do ~/.claude/state/codex-bridge/{conv-id}.json. Díky tomu může nové spuštění codex-peer pokračovat ve stejném Codex vlákně i po re-instanciaci agenta nebo compaction kontextu.

Při ztrátě nebo neobnovitelnosti uloženého vlákna má bridge skončit viditelnou chybou. Nezakládá tiše novou konverzaci, která by ztratila předchozí kontext.

Projekt vyžaduje Node.js 20, aktuální Claude Code CLI, OpenAI Codex CLI alespoň ve verzi 0.133, PowerShell 7 pro instalační skript a proměnnou CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. Claude Code i Codex musí být samostatně autentizované.

Instalační skript zkopíruje bridge do ~/.claude/bridges/codex-bridge/, nainstaluje Node závislosti, vytvoří definici codex-peer v ~/.claude/agents/ a zaregistruje MCP server do Claude Code na user scope. Po instalaci je nutné Claude Code restartovat, protože definice agentů se načítají při startu session.

Projekt je ve verzi v1. Jeden sdílený proces codex mcp-server obsluhuje všechny konverzace; izolace je na úrovni Codex vláken, ne samostatných procesů. Výchozí sandbox Codexu je read-only a dokumentace výslovně nedoporučuje jeho rozšíření bez izolace procesu pro každou konverzaci.

Relay agent je podle návrhu postavený na Sonnetu, protože autor uvádí nespolehlivé volání nástroje při použití Haiku. Pro běh proto nejsou potřeba jen Codex přihlašovací údaje, ale i fungující Claude Code tým a relay agent.

CLIProxyAPI a cc-codex-bridge řeší podobný cíl jinak:

• CLIProxyAPI nahrazuje modelový backend celého Claude Code přes překlad API.
• cc-codex-bridge ponechává Claude Code s jeho původním backendem a přidává Codex jako samostatného člena týmu.

cc-codex-bridge je proto vhodný pro oponenturu, code review nebo delegování dílčích úloh na Codex. CLIProxyAPI je vhodnější, pokud má jiný model řídit celý běh Claude Code.

• cc-codex-bridge – zdrojový kód a dokumentace