Guía

Claude Code + Codex: Dos Agentes, Un Proyecto

Usar Claude Code y Codex en paralelo sobre el mismo repositorio entrega más valor que cualquier plan premium individual, porque cada herramienta opera con su propio presupuesto de tokens. Esta guía explica las dos formas de integrarlos y los cinco escenarios donde el equipo rinde más que cualquier agente solo. Especialmente útil para developers indie y equipos pequeños que quieren velocidad sin escalar costos.

1 fuente30 de junio de 2026

Dos suscripciones de $20 coordinadas pueden superar lo que ofrece un plan de $200 al mes. La clave no es la potencia individual de cada modelo, sino que operan sobre presupuestos de tokens independientes: mientras uno trabaja, el otro no está consumiendo cuota. Cuando se orquestan bien, el resultado es un flujo continuo donde un agente planea y el otro ejecuta, uno codifica y el otro audita, uno se traba y el otro retoma.

Dos formas de integrar Claude Code y Codex

Camino A: Codex como entorno, Claude como herramienta

Abrir el terminal embebido de Codex con Cmd+J e invocar Claude Code desde ahí. Ambas herramientas quedan apuntando al mismo directorio del proyecto. No hay sincronización especial: comparten el sistema de archivos del OS, así que los cambios que uno hace los ve el otro en tiempo real.

Este camino es el más directo pero tiene una advertencia: ejecutar CLIs de terceros dentro del terminal embebido de Codex no está documentado oficialmente por OpenAI y puede dejar de funcionar con actualizaciones futuras de la app.

Camino B: Claude Code como entorno, Codex como plugin

Instalar el plugin oficial de OpenAI dentro de Claude Code. El repositorio es github.com/openai/codex-plugin-cc — evitar forks de la comunidad porque el ecosistema de plugins de Claude Code todavía es joven y los forks pueden quedar desactualizados rápido.

La instalación toma menos de 30 segundos con cuatro comandos slash dentro de Claude Code. Después de autenticar con codex login, quedan disponibles los siguientes comandos:

Comando Qué hace
/codex:setup Verifica autenticación y conectividad
/codex:review Auditoría de solo lectura sobre cambios sin commitear
/codex:adversarial-review Cuestiona decisiones de arquitectura
/codex:rescue Delega trabajo cuando Claude se traba
/codex:rescue --fresh Empieza desde perspectiva limpia, sin contexto previo

Este camino es el más estable para uso diario porque Claude Code maneja el entorno principal y Codex se invoca a demanda.

Cinco escenarios donde el equipo rinde más que uno solo

1. Planear y construir con agentes separados

Claude Code toma la tarea de arquitectura: define la estructura de carpetas, los contratos entre módulos, las decisiones de diseño que impactan todo lo demás. Codex implementa esa arquitectura. La separación de roles importa porque los modelos grandes tienden a ser mejores planificando cuando no están simultáneamente ejecutando detalles de implementación.

El flujo concreto: Claude genera un plan en markdown con el árbol de archivos y las interfaces esperadas. Ese archivo vive en el repo. Codex lo lee como contexto y empieza a construir.

2. Revisión antes de cada commit

Antes de hacer git commit, correr /codex:review. Codex hace una auditoría de solo lectura sobre todos los cambios sin commitear: detecta patrones problemáticos, variables sin usar, inconsistencias de estilo, potenciales bugs. No modifica nada, solo reporta.

Esto funciona especialmente bien cuando se trabaja rápido en modo exploración y los commits tienden a acumular ruido. La revisión toma segundos y a menudo captura cosas que ambos agentes (y el programador) pasaron por alto en el calor de la implementación.

3. Cuestionar decisiones de arquitectura

/codex:adversarial-review no busca bugs: busca suposiciones. Si el sistema asume que los usuarios siempre tienen conexión a internet, lo dice. Si la estructura de base de datos va a generar N+1 queries a escala, lo dice. Si una decisión de diseño que pareció razonable al principio crea rigidez a largo plazo, también.

Útil especialmente al inicio de un feature nuevo o cuando se está refactorizando código que otros van a mantener.

4. Desbloquear cuando Claude se traba

Claude Code a veces entra en loops: intenta la misma solución con variaciones mínimas, acumula contexto que contamina su perspectiva, o simplemente no tiene el ángulo correcto para un problema específico. /codex:rescue --fresh delega el problema a Codex sin pasar contexto previo, lo que puede generar un enfoque completamente diferente.

No es una admisión de falla del agente principal; es usar la diversidad de perspectivas como recurso deliberado. Los dos modelos tienen preentrenamientos distintos y tienden a resolver problemas de maneras diferentes.

5. Trabajo paralelo en el mismo repositorio

Cuando hay dos features independientes en paralelo — por ejemplo, un endpoint nuevo en el backend y un componente nuevo en el frontend — cada agente puede trabajar en su rama o en sus archivos sin pisarse. El límite práctico es la coordinación: si los dos agentes tocan los mismos archivos, hay que gestionar los conflictos manualmente.

La estrategia más limpia es definir ownership de archivos antes de empezar: Claude Code owns src/api/, Codex owns src/components/. Así el trabajo paralelo funciona sin fricción.

Lo que se necesita para empezar

Para el Camino B (el más recomendado):

  • Claude Code instalado con plan Pro ($20/mes mínimo)
  • Codex CLI instalado globalmente: npm install -g @openai/codex
  • Autenticación con codex login usando una cuenta de ChatGPT (Free, Plus, Pro, o API key)

El plan Free de ChatGPT da acceso a Codex CLI con cuota limitada. Para trabajo continuo, Plus o una API key con créditos es más práctico.

Advertencia sobre Review Gate

El plugin incluye una función llamada Review Gate que activa auditorías automáticas continuas — cada vez que Claude Code termina un ciclo, Codex revisa. En teoría suena bien. En la práctica, puede crear loops donde los dos agentes se intercambian trabajo indefinidamente sin avanzar, drenando la cuota mensual de ambos en cuestión de horas.

Recomendación: desactivar Review Gate por defecto y usarlo manualmente con /codex:review cuando sea necesario. El control manual sobre cuándo ocurre la auditoría es más eficiente que el automático.

📎