Blog · Agentes de programación

Cómo usar Claude Code y Codex juntos

Sí, Claude Code y Codex funcionan bien juntos: ejecuta cada uno en su propio git worktree del mismo repositorio, dale a ambos el mismo AGENTS.md y deja que uno escriba el código mientras el otro lo revisa. Para un vínculo más estrecho, OpenAI publica un plugin oficial que permite a Claude Code llamar a Codex para hacer revisiones y encargarle tareas. Esta guía recoge las cinco formas en que la gente combina los dos, una configuración paso a paso con comandos de la documentación oficial, cómo pueden comunicarse los agentes entre sí, qué vigilar cuando los dos funcionan a la vez y las herramientas que los orquestan. Actualizado el 20 de noviembre de 2026.

Cinco formas de usar Claude Code y Codex juntos

La mayoría de las configuraciones combinan dos o tres de ellas. Si todavía estás eligiendo entre los agentes, empieza por Claude Code vs Codex.

FormaCómo funcionaÚsala cuando
1. Instrucciones compartidasUn AGENTS.md que leen ambos agentes; CLAUDE.md lo importaSiempre. Es el paso más barato y evita que los dos agentes sigan reglas distintas
2. Worktrees separadosCada agente trabaja en su propio git worktree y rama del mismo repositorioAmbos agentes editan código a la vez
3. Uno escribe, el otro revisaClaude Code escribe y codex review comprueba la rama, o al revésQuieres que un segundo modelo detecte lo que el primero pasó por alto
4. Codex dentro de Claude CodeEl codex-plugin-cc de OpenAI añade /codex:review, /codex:rescue y más a Claude CodeTrabajas sobre todo en Claude Code y quieres Codex a un comando de distancia
5. Un orquestadorUn tablero o una app (Claude Squad, Conductor, Orca, Vibe Kanban, Crewmark) inicia y sigue a ambosEjecutas varios agentes cada día y pierdes el control de las terminales

1. Dale las mismas instrucciones a ambos agentes

Codex lee AGENTS.md: un archivo global en ~/.codex, y después cada AGENTS.md desde la raíz del proyecto hasta la carpeta en la que estás, con un AGENTS.override.md que tiene prioridad en su directorio. Deja de añadir archivos a los 32 KiB por defecto (project_doc_max_bytes). Más en nuestra guía de AGENTS.md en Codex.

Claude Code también puede leer AGENTS.md, desde la v2.1.277, pero por defecto solo cuando no hay un CLAUDE.md, .claude/CLAUDE.md ni CLAUDE.local.md en la carpeta ni por encima de ella. Si tu repositorio tiene un CLAUDE.md, pon @AGENTS.md al principio para que Claude lea primero el archivo compartido y añade debajo las reglas solo de Claude. Un enlace simbólico (ln -s AGENTS.md CLAUDE.md) también funciona, pero la documentación recomienda la importación si alguien del equipo usa Windows. Consulta la guía de CLAUDE.md para el resto.

  • Pon en AGENTS.md los comandos de build, test y lint, el estilo de código y las reglas de "no tocar", para que ambos agentes ejecuten las mismas comprobaciones.
  • Deja fuera las notas específicas de un agente: las reglas solo de Claude van debajo de la importación en CLAUDE.md y los ajustes solo de Codex en ~/.codex/config.toml.
  • Claude Code ignora AGENTS.override.md y AGENTS.local.md, así que no pongas ahí reglas compartidas.

2. Ejecútalos en worktrees separados

Dos agentes que editan un mismo checkout se sobrescribirán entre sí; la propia documentación de Claude Code advierte de que dos agentes editando el mismo archivo provocan sobrescrituras. Un git worktree es un segundo directorio de trabajo con sus propios archivos y su propia rama que comparte el historial del repositorio, así que cada agente tiene su propia copia para editar.

Claude Code crea uno por ti con claude --worktree <nombre> dentro de .claude/worktrees/. La CLI de Codex tiene un indicador --worktree que inicia una sesión o una ejecución de codex exec en un nuevo worktree gestionado, y la app de escritorio de Codex gestiona worktrees para sus tareas. Un simple git worktree add sirve para cualquiera de los dos agentes. Nuestra guía de worktrees en Claude Code cubre la limpieza, .worktreeinclude para los archivos .env y la rama base.

3. Que uno escriba y el otro revise

Este es el patrón al que se refiere la mayoría cuando habla de usar los dos juntos. Un segundo agente de otro proveedor lee el diff sin las suposiciones del primero, así que puede detectar lo que el autor pasó por alto.

  • Codex revisando a Claude: codex review --base main revisa la rama frente a main; --uncommitted revisa los cambios en el área de preparación, sin preparar y sin seguimiento; --commit <SHA> revisa un commit.
  • Claude revisando a Codex: pasa el diff por una tubería a claude -p, el modo no interactivo. La documentación de Claude Code muestra la misma idea como un script de build que ejecuta git diff main | claude -p como revisor.
  • Devuelve los hallazgos al agente que escribió el código y deja que los corrija; no dejes que el revisor edite también la rama.

4. Llama a Codex desde dentro de Claude Code (plugin oficial)

OpenAI publica codex-plugin-cc, un plugin de Claude Code con licencia Apache-2.0 para "use Codex from Claude Code to review code or delegate tasks". Usa la CLI codex que ya tienes en tu máquina, con el mismo inicio de sesión, la misma configuración y el mismo checkout. Necesitas un plan de ChatGPT (el gratuito cuenta) o una clave de API de OpenAI, y Node.js 18.18 o posterior. El uso cuenta para tus límites de uso de Codex.

Instálalo desde dentro de Claude Code con /plugin marketplace add openai/codex-plugin-cc, /plugin install codex@openai-codex, /reload-plugins y /codex:setup.

  • /codex:review: una revisión de Codex de solo lectura de los cambios sin confirmar, o de la rama con --base main. El README dice que equivale a ejecutar /review en el propio Codex.
  • /codex:adversarial-review: una revisión de solo lectura que puedes orientar, centrada en decisiones de diseño, compromisos y zonas de riesgo.
  • /codex:rescue: le encarga a Codex una tarea, como investigar un bug o probar una corrección, mediante un subagente; añade --background para trabajos largos y compruébalos con /codex:status y /codex:result.
  • /codex:transfer: convierte la conversación actual de Claude Code en un hilo de Codex e imprime el comando codex resume para continuarla allí.
  • La puerta de revisión opcional (/codex:setup --enable-review-gate) ejecuta una revisión de Codex cada vez que Claude intenta detenerse y bloquea la parada si encuentra problemas. El README advierte de que puede entrar en un bucle largo y agotar rápidamente los límites de uso, así que actívala solo mientras estás mirando.

Paso a paso: worktrees, instrucciones compartidas y un ciclo de revisión

Esta es la configuración más habitual: Claude Code y Codex construyen cada uno en su propio worktree a partir del mismo AGENTS.md y luego revisan la rama del otro antes de que hagas el merge. Todos los comandos salen de la documentación de Claude Code, la referencia de la CLI de Codex o el README del plugin; el prompt de revisión es un ejemplo.

  1. Escribe un solo AGENTS.md e impórtalo desde CLAUDE.md

    Pon las reglas compartidas en AGENTS.md, en la raíz del repositorio. Codex lo lee directamente. Si además tienes un CLAUDE.md, empieza con la importación para que Claude Code lea el mismo archivo.

    # CLAUDE.md: Claude Code lee primero AGENTS.md y luego el resto
    @AGENTS.md
    
    ## Claude Code
    Use plan mode for changes under src/billing/.
  2. Inicia Claude Code en su propio worktree

    Claude Code crea el worktree y una rama para él. Instala las dependencias dentro del worktree, porque es un checkout nuevo.

    # Claude Code en su propio worktree: .claude/worktrees/feature-auth, rama worktree-feature-auth
    claude --worktree feature-auth
    
    # mantén los worktrees fuera de git status
    echo ".claude/worktrees/" >> .gitignore
  3. Inicia Codex en un segundo worktree

    Crea un worktree con git y apunta Codex a él con --cd, o deja que Codex haga un worktree gestionado con --worktree.

    # Codex en un segundo worktree, en su propia rama
    git worktree add ../project-feature-a -b feature-a
    codex --cd ../project-feature-a
    
    # o deja que Codex cree un worktree gestionado para una tarea puntual
    codex exec --worktree "implement the next step"
  4. Pide a Codex que revise la rama de Claude

    Cuando Claude Code termine, ejecuta una revisión de Codex frente a main desde el worktree de Claude, o desde dentro de Claude Code si instalaste el plugin. Pega los hallazgos en Claude Code para que los corrija.

    # Codex revisa la rama de Claude (ejecútalo dentro del worktree de Claude)
    codex review --base main
    
    # o, desde dentro de Claude Code, con el plugin de OpenAI
    /codex:review --base main
  5. Pide a Claude Code que revise la rama de Codex

    Pasa el diff de Codex al modo no interactivo de Claude Code y devuelve los hallazgos a Codex.

    # Claude Code revisa la rama de Codex (ejecútalo dentro del worktree de Codex)
    git diff main | claude -p "Review this diff for bugs and missing tests. List each issue with file:line."
  6. Haz el merge y elimina los worktrees

    Haz el merge de cada rama como de costumbre (o abre un PR) y luego elimina los worktrees que ya no necesites. Claude Code te ofrece limpiar su propio worktree cuando sales de la sesión.

    git worktree list
    git worktree remove ../project-feature-a

¿Pueden Claude Code y Codex hablar entre sí?

No directamente, al estilo de un chat. Ningún agente tiene un canal integrado hacia el agente del otro proveedor, así que se comunican a través de algo que ambos pueden alcanzar: los archivos y el historial de git del repositorio, un comando que uno ejecuta en la CLI del otro, o un tablero que ambos leen.

  • A través de la CLI: Claude Code puede ejecutar codex exec o codex review como comando de shell, y Codex puede ejecutar claude -p. Cada uno recibe la respuesta del otro como salida del comando.
  • A través del plugin: en Claude Code, /codex:rescue y /codex:review envían trabajo a Codex y traen el resultado de vuelta a la conversación. OpenAI mantiene el plugin.
  • A través de MCP: esta vía se ha cerrado en buena parte. Codex solía ejecutarse como servidor MCP con codex mcp-server; OpenAI lo eliminó en Codex rust-v0.154.0 y remite a quienes integran al Codex app server experimental, que habla su propio protocolo JSON-RPC. En el otro sentido, claude mcp serve convierte a Claude Code en un servidor MCP, pero expone las herramientas de Claude Code (leer, editar, shell), no un segundo agente Claude.
  • A través de un tablero compartido: un orquestador o un tablero de issues guarda la tarea, los comentarios y el estado, y cada agente lee y escribe ahí.
  • Lo que no cruza entre proveedores: los agent teams de Claude Code y su mensajería entre sesiones conectan solo sesiones de Claude Code. Una sesión de Codex no puede ser compañera de equipo.

¿Se pueden ejecutar Claude Code y Codex al mismo tiempo?

Sí. Son programas distintos con inicios de sesión distintos, así que ambos pueden funcionar a la vez en una misma máquina y un mismo repositorio. Claude Code usa tu plan de Claude o tu clave de API; Codex usa tu plan de ChatGPT o una clave de API de OpenAI. Lo que tienes que gestionar son los archivos y el uso.

  • Archivos: dale a cada agente su propio worktree. Dos agentes en un mismo checkout editarán los mismos archivos y se sobrescribirán.
  • Uso: cada agente gasta de sus propios límites. El trabajo que envías a Codex a través del plugin de Claude Code cuenta para tus límites de uso de Codex.
  • Bucles: un ciclo de revisión automático (como la puerta de revisión del plugin) puede mantener ocupados a ambos agentes mucho tiempo y agotar los límites rápidamente. Ejecútalo mientras estás mirando.
  • El paralelismo del lado de Claude cuesta más: Anthropic dice que los agent teams usan bastantes más tokens que una sola sesión, y el coste crece con cada compañero.

Herramientas que orquestan Claude Code y Codex

Si inicias varios agentes al día, una herramienta que cree los worktrees, abra las terminales y muestre los diffs te ahorra muchos cambios de contexto. Todas ejecutan Claude Code y Codex; consulta las alternativas a Vibe Kanban para una comparación más amplia.

HerramientaQué haceAislamientoFunciona enLicencia / estado
Claude SquadApp de terminal para gestionar Claude Code, Codex, OpenCode, Amp y otros agentes; ejecuta Codex con cs -p "codex"Sesión de tmux y git worktree por agenteTerminal (se instala con Homebrew)Código abierto, AGPL-3.0
ConductorEjecuta Claude Code, Codex, Cursor y OpenCode en paralelo; revisa el diff, abre un PR, haz el mergeUn workspace y una rama por tareaMacApp de escritorio
OrcaEjecuta una flota de agentes de terminal, incluidos Claude Code y Codex, con tus propias suscripcionesGit worktree por agentemacOS, Windows, LinuxCódigo abierto, MIT
Vibe KanbanTablero kanban que inicia un workspace por issue con Claude Code, Codex, Gemini CLI y otrosGit worktree por workspaceNavegador o app de escritorio con npx vibe-kanbanCódigo abierto, Apache-2.0; mantenido por la comunidad desde que bloop cerró en abril de 2026
CrewmarkClaude Code y Codex como empleados de IA de larga duración con roles en un tablero de issues compartidoCada empleado es su propia sesión en tu máquinaTu propia máquinaVer abajo

Crewmark: Claude Code y Codex como equipo en un solo tablero

Las herramientas anteriores están pensadas en torno a una tarea cada vez: inicias un agente, revisas el diff, haces el merge. Si quieres que Claude Code y Codex sigan trabajando juntos durante días, cada uno con su rol, Crewmark es otra opción.

En Crewmark cada agente es un empleado de IA: una sesión de larga duración con un rol, que funciona en tu propia máquina. Los empleados de Claude Code y Codex se ejecutan de forma nativa; otros agentes, como OpenCode, DeepSeek Harness y Gemini, se conectan mediante ACP (acpx). El trabajo avanza por un tablero de issues compartido, donde tú y los empleados asignáis issues, comentáis, os mencionáis con @ y cambiáis estados. Así es como un empleado de Claude Code le pasa una revisión a un empleado de Codex: lo menciona con @ en el issue. Los empleados se despiertan según un horario (heartbeats) y cada vez que los mencionan, así que la revisión empieza sin que tengas que pasarla tú.

No sustituye a los worktrees ni a los comandos de revisión anteriores; tus empleados siguen usándolos. Añade los roles, el tablero y los despertares a su alrededor. Para la idea que hay detrás, consulta multi-agent harness.

Preguntas frecuentes

¿Pueden Claude Code y Codex trabajar juntos?

Sí. La configuración habitual es un único AGENTS.md compartido, un git worktree separado para cada agente y un ciclo de revisión en el que uno escribe y el otro ejecuta una revisión. OpenAI también publica un plugin oficial de Claude Code, codex-plugin-cc, que permite a Claude Code llamar a Codex.

¿Cuál es la mejor forma de usar Claude Code y Codex juntos?

Que uno escriba y el otro revise. Construye con Claude Code en su propio worktree, luego ejecuta codex review --base main (o /codex:review desde dentro de Claude Code) y devuelve los hallazgos. Intercambia los papeles cuando escriba Codex.

¿Pueden Claude Code y Codex hablar entre sí?

De forma indirecta. Cada uno puede ejecutar la CLI del otro (codex exec, codex review, claude -p) y leer la salida, el plugin de Codex pasa tareas y resultados dentro de Claude Code, y un tablero compartido puede contener la conversación. Los agent teams de Claude Code y su mensajería entre sesiones conectan solo sesiones de Claude Code.

¿Puedo ejecutar Claude Code y Codex al mismo tiempo?

Sí, en la misma máquina y el mismo repositorio. Dale a cada uno su propio worktree para que no se sobrescriban los archivos. Cada uno usa su propio plan o clave de API, y el trabajo que envías a Codex a través del plugin cuenta para tus límites de Codex.

¿Puedo usar Codex como servidor MCP en Claude Code?

Ya no. codex mcp-server se eliminó en Codex rust-v0.154.0; OpenAI ahora remite al Codex app server, que no es MCP. Para usar Codex desde Claude Code, instala en su lugar el codex-plugin-cc de OpenAI.

¿Comparten AGENTS.md Claude Code y Codex?

Pueden. Codex lee AGENTS.md por defecto. Claude Code lo lee cuando el repositorio no tiene CLAUDE.md (v2.1.277 y posteriores); si tienes un CLAUDE.md, empieza con @AGENTS.md para que ambos agentes sigan el mismo archivo.

¿Puede Codex ser compañero de equipo en los agent teams de Claude Code?

No. Los agent teams se componen de instancias de Claude Code: un líder y compañeros que comparten una lista de tareas y un buzón. Para incorporar Codex al mismo trabajo, usa el plugin de Codex, un ciclo de revisión o un tablero que ejecute ambos.

¿Qué herramientas ejecutan Claude Code y Codex lado a lado?

Claude Squad, Conductor, Orca y Vibe Kanban inician ambos agentes en worktrees o workspaces aislados. Crewmark los ejecuta como empleados de IA de larga duración en un tablero de issues compartido.

Comandos y funciones verificados con la documentación de Claude Code, la documentación y la referencia de la CLI de Codex, y el README de codex-plugin-cc el 20 de noviembre de 2026.

Pon a Claude Code y Codex en el mismo equipo.

Crewmark da a cada agente un rol, un tablero de issues compartido y despertares programados, para que se pasen el trabajo sin que tú lo copies entre terminales.

Crewmark es de código abierto: danos una estrella en GitHub