OpenAI Codex vs Claude Code: ¿Qué agente de codificación CLI deberías usar?

Codex CLI y Claude Code son herramientas de codificación agénticas basadas en terminal, pero se dirigen a diferentes flujos de trabajo. Codex CLI es un agente ligero y de código abierto con total flexibilidad de API compatible con OpenAI y un modelo de sandbox limpio. Claude Code es una plataforma más completa en funciones con soporte en múltiples superficies, gestión de sesiones más rica y una integración más estrecha en CLI, IDE, escritorio y navegador. La elección correcta se reduce a si necesitas máxima flexibilidad de modelos o un entorno de codificación unificado construido alrededor de la API de un solo proveedor.

¿Qué es Codex CLI?

Codex CLI es el agente de codificación de terminal de código abierto de OpenAI. Se ejecuta localmente, envía solicitudes a un backend de API compatible con OpenAI, y puede leer archivos, editar código y ejecutar comandos dentro de un directorio aislado (sandbox) en tu máquina.

La elección de diseño clave en Codex CLI es la flexibilidad de proveedores. La herramienta habla el formato de cable de OpenAI Chat Completions, lo que significa que cualquier proveedor que exponga un endpoint compatible con OpenAI puede integrarse a través de un archivo de configuración TOML. Esto incluye los modelos propios de OpenAI (GPT-4o, o3, o4-mini), pero también proveedores externos como Novita AI.

El modelo de seguridad de Codex CLI es explícito por diseño. El acceso a la red está deshabilitado por defecto para el código ejecutado, y las escrituras de archivos se limitan al directorio configurado. Tres modos de aprobación controlan cuánta autonomía tiene el agente:

• Modo sugerencia (predeterminado): solicita aprobación en cada paso
• Modo edición automática: edita archivos automáticamente pero pregunta antes de ejecutar comandos
• Modo completamente automático: ejecuta sin preguntar

El proyecto tiene licencia MIT y se mantiene activamente en openai/codex en GitHub.

¿Qué es Claude Code?

Claude Code es la herramienta de codificación agéntica de Anthropic. Está disponible como CLI, extensión de VS Code, plugin de JetBrains, aplicación de escritorio e interfaz de navegador en claude.ai/code. Cada superficie ejecuta el mismo motor de agente subyacente, que lee tu proyecto, edita archivos, ejecuta comandos y maneja tareas de múltiples pasos como escribir pruebas, refactorizar entre archivos y gestionar git.

Internamente, Claude Code envía solicitudes a un endpoint de API compatible con Anthropic. El predeterminado es api.anthropic.com de Anthropic, pero una sola variable de entorno (ANTHROPIC_BASE_URL) lo redirige a cualquier proveedor compatible.

Claude Code añade características de continuidad de sesión que Codex CLI no tiene: sesiones con nombre, bifurcaciones de conversación estilo rama, puntos de control de retroceso (rewind), y un comando /compact que resume el contexto para ampliar la ventana utilizable en tareas largas. Las instrucciones a nivel de proyecto se colocan en un archivo CLAUDE.md que el agente lee al inicio de cada sesión.

Codex CLI vs Claude Code: Comparación lado a lado

Característica	Codex CLI	Claude Code
Proveedor	OpenAI	Anthropic
Licencia	Código abierto (MIT)	Propietaria (acceso API)
API de cable	OpenAI Chat Completions	Anthropic Messages API
Proveedores externos	Cualquier compatible con OpenAI	Cualquier compatible con Anthropic
Superficies	Solo terminal	CLI, VS Code, JetBrains, escritorio, navegador
Configuración proyecto	Archivo de configuración TOML	CLAUDE.md + settings.json
Continuidad de sesión	Por sesión	Sesiones con nombre, reanudar, bifurcar, retroceder
Modos de aprobación	Sugerencia / Edición automática / Totalmente automático	default, plan, auto, acceptEdits, bypassPermissions
Soporte MCP	No	Sí
Gestión de contexto	Contexto por sesión	/compact, /context, /branch
Seguridad del sandbox	Red deshabilitada, ámbito de directorio	Ámbito de modo de permisos

Soporte de Modelos y Flexibilidad de API

Aquí es donde las dos herramientas difieren más marcadamente en la práctica.

Codex CLI acepta cualquier modelo que hable el formato OpenAI Chat Completions. De fábrica funciona con la línea de modelos de OpenAI — GPT-4o, o3, o4-mini — pero debido a que el proveedor es configurable a través de model_providers en la configuración TOML, puedes apuntarlo a Novita AI, Azure OpenAI o cualquier otro endpoint compatible sin modificar la herramienta en sí.

Claude Code utiliza el formato Anthropic Messages API. Por defecto se enruta a Anthropic y utiliza modelos Claude (Sonnet, Opus, Haiku). La variable de entorno ANTHROPIC_BASE_URL permite sustituir el proveedor, por lo que cualquier endpoint compatible con Anthropic — incluido Novita AI — funciona como reemplazo directo.

En la práctica, esto significa:

• Si tus modelos preferidos hablan el formato OpenAI (DeepSeek, Qwen Coder, Kimi K2 a través de endpoints compatibles con OpenAI), Codex CLI es la opción más natural.
• Si tus modelos preferidos hablan el formato Anthropic, o deseas usar la misma configuración en superficies CLI e IDE, Claude Code te ofrece un comportamiento más consistente.

Ambas herramientas admiten modelos de Novita AI. El método de configuración difiere (TOML para Codex, variable de entorno para Claude Code), pero la biblioteca de modelos de Novita AI — incluyendo DeepSeek V3, Qwen3-Coder y Kimi K2 — es accesible a través de ambas.

Código Abierto vs Arquitectura Propietaria

La naturaleza de código abierto de Codex CLI es importante en contextos específicos: puedes auditar el bucle del agente, bifurcarlo para herramientas internas, o incorporarlo en un pipeline de CI sin una conversación de licencia separada. La comunidad puede (y de hecho lo hace) contribuir con integraciones de proveedores, correcciones de errores y extensiones de funcionalidades.

El núcleo de Claude Code es propietario. Anthropic proporciona la CLI como un binario distribuido con acceso a la API, no como una versión de código fuente. La ventaja es una cadencia de versiones más consistente y bien mantenida con soporte directo de Anthropic. La desventaja es que la personalización se limita a lo que la herramienta expone a través de archivos de configuración, variables de entorno y las API de extensión.

Para la mayoría de los desarrolladores, la distinción de código abierto solo es relevante si necesitas modificar el comportamiento del agente a nivel de código. Para la integración de flujos de trabajo — pipelines de CI, tareas automatizadas, generación de código mediante scripts — ambas herramientas exponen suficientes banderas de CLI y modos de scripting para cubrir los casos comunes.

Instalación y Configuración

Codex CLI se instala mediante npm:

npm install -g @openai/codex

La configuración del proveedor se encuentra en ~/.codex/config.toml:

model = "deepseek/deepseek-v3.1"
model_provider = "novitaai"

[model_providers.novitaai]
name = "Novita AI"
base_url = "https://api.novita.ai/openai"
http_headers = {"Authorization" = "Bearer YOUR_NOVITA_API_KEY"}
wire_api = "chat"

Claude Code se instala mediante el instalador nativo (macOS/Linux/WSL):

curl -fsSL https://claude.ai/install.sh | bash

O mediante npm (Node.js 18+):

npm install -g @anthropic-ai/claude-code

Redirigiendo a un proveedor personalizado:

export ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
export ANTHROPIC_API_KEY=YOUR_NOVITA_API_KEY
claude --model deepseek/deepseek-v3.1

Claude Code también ejecuta /init en un proyecto para generar un CLAUDE.md inicial, que persiste instrucciones específicas del proyecto entre sesiones.

Cobertura de Plataforma y Superficies

Esta es la diferencia más visible en el uso diario.

Codex CLI se ejecuta en una terminal. Esa es su única superficie. Si tu flujo de trabajo es completamente basado en terminal — sesiones SSH, CI sin interfaz gráfica, contenedores de desarrollo — esto está bien. Si deseas sugerencias en línea dentro de VS Code o una GUI de escritorio, Codex CLI no las proporciona.

Claude Code se ejecuta en cinco superficies: la CLI, extensión de VS Code, plugin de JetBrains, aplicación de escritorio y claude.ai/code en el navegador. Todas las superficies comparten el mismo motor de agente y, en la mayoría de los casos, el mismo estado de sesión. Una tarea iniciada en la terminal puede retomarse en VS Code.

Si la integración con IDE es importante para tu equipo, Claude Code tiene una clara ventaja. Si estás construyendo un pipeline donde el agente se ejecuta sin interfaz como parte de un sistema de automatización más grande, ambas herramientas funcionan igual de bien — y la huella más simple de Codex CLI puede ser más fácil de gestionar.

Configuración y Contexto del Proyecto

La configuración de Codex CLI se divide en configuración de proveedor/modelo (TOML) e instrucciones por proyecto (un archivo AGENTS.md o similar que el agente lee cuando está presente). Esto es intencionalmente mínimo.

Claude Code tiene configuración en capas:

• Archivos CLAUDE.md (a nivel de proyecto, directorio, usuario) para instrucciones persistentes
• .claude/settings.json para reglas de permisos, definiciones de hooks y configuraciones de herramientas
• Comandos de barra como /memory para editar instrucciones durante una sesión
• Variables de entorno para enrutamiento de API y autenticación

El enfoque CLAUDE.md es útil para equipos que desean que cada sesión de agente comience con un entendimiento compartido de las convenciones del código base, listas de verificación de revisión o bibliotecas permitidas. Codex CLI no tiene un mecanismo integrado equivalente, aunque puedes replicarlo anteponiendo instrucciones en cada prompt.

Modos de Aprobación y Controles de Seguridad

Ambas herramientas te dan control sobre cuánto puede hacer el agente sin preguntar.

Los tres modos de Codex CLI son simples y explícitos:

• Sugerencia: muestra los cambios propuestos y pregunta antes de aplicar cualquier cosa
• Edición automática: escribe archivos sin preguntar, pero requiere aprobación antes de ejecutar comandos de shell
• Totalmente automático: se ejecuta sin preguntar; útil para pipelines de confianza

Los modos de permiso de Claude Code se corresponden con conceptos similares con más granularidad:

• default: solicita aprobación en ediciones de archivos y comandos de shell
• acceptEdits: auto aprueba ediciones de archivos, pregunta por comandos de shell
• auto: se ejecuta sin preguntar (equivalente a Full Auto de Codex)
• plan: muestra un plan antes de ejecutar; útil para revisar tareas de varios pasos antes de ejecutarlas
• bypassPermissions: omite todas las comprobaciones (para contextos automatizados de confianza)

Claude Code también admite un sistema de reglas de permitir/denegar/preguntar detallado en settings.json, lo que te permite aprobar comandos específicos permanentemente sin cambiar el modo de permiso general.

Para equipos con requisitos estrictos de control de cambios, el sistema de permisos en capas de Claude Code proporciona más control. Para desarrolladores individuales que solo quieren un comportamiento claro de activado/desactivado, el sistema de tres modos de Codex CLI es más fácil de entender.

Gestión de Sesión y Contexto

Las sesiones largas de codificación se topan con límites de contexto. Ambas herramientas manejan esto, pero de manera diferente.

Codex CLI gestiona el contexto por sesión. Cuando una sesión termina, el contexto desaparece. Empiezas de nuevo en la siguiente invocación.

Claude Code añade gestión de sesión persistente:

• Sesiones con nombre que se pueden reanudar con claude -r "nombre-de-sesión"
• /compact para resumir la conversación actual y reducir el uso de tokens mientras continúa
• /branch para bifurcar una conversación y probar un enfoque diferente sin perder la original
• /rewind para retroceder a un punto de control si un cambio salió mal
• /context para visualizar cuánto de la ventana se está utilizando y dónde

Para tareas cortas y enfocadas — corregir este error, escribir esta función, agregar estas pruebas — la diferencia no importa. Para sesiones largas de refactorización o tareas que evolucionan a lo largo de múltiples intercambios, la continuidad de sesión de Claude Code reduce la fricción de la pérdida de contexto.

Cuándo Usar Codex CLI

Usa Codex CLI cuando:

• Necesites conectar directamente con modelos compatibles con OpenAI (GPT-4o, o3, o4-mini, o proveedores externos con endpoints de formato OpenAI)
• Quieras auditar o modificar el comportamiento del agente a nivel de código fuente
• Tu flujo de trabajo sea puramente basado en terminal sin necesidad de integración con IDE
• Estés integrando un agente de codificación en un pipeline de CI o herramienta interna y desees una dependencia mínima y auditable
• Tus requisitos de seguridad exijan un sandbox con red deshabilitada explícitamente por defecto

Cuándo Usar Claude Code

Usa Claude Code cuando:

• Quieras un comportamiento consistente en terminal, VS Code, JetBrains y escritorio
• Tu equipo se beneficie de un contexto de proyecto CLAUDE.md compartido entre sesiones
• Necesites continuidad de sesión — reanudar sesiones con nombre, bifurcar conversaciones, retroceder cambios
• La integración con servidor MCP sea parte de tu flujo de trabajo
• Prefieras la API de formato Anthropic y desees enrutar a proveedores compatibles con Anthropic (incluido Novita AI)

Usando Novita AI con Cualquier Herramienta

Ambas herramientas aceptan Novita AI como backend LLM de reemplazo directo. Esto es importante cuando deseas acceso a modelos que no están disponibles a través del proveedor predeterminado de la herramienta, o cuando el costo es una restricción: modelos como DeepSeek V3, Qwen3-Coder y Kimi K2 en Novita AI se ejecutan a tarifas por token significativamente más bajas que los modelos insignia de Anthropic o OpenAI.

Codex CLI con Novita AI: Configura model_provider en ~/.codex/config.toml para apuntar a https://api.novita.ai/openai. Consulta la lista completa de modelos y los pasos de configuración en Cómo usar Codex con modelos de Novita AI.

Claude Code con Novita AI: Establece ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic y pasa una clave API de Novita. La bandera --model o la variable de entorno ANTHROPIC_MODEL selecciona el modelo específico. Referencia completa de CLI en Documentación de CLI de Claude Code.

El rol de Novita AI aquí es como backend de inferencia, no como una capa de IDE. Una vez que se establece la variable de entorno, Codex CLI y Claude Code se comportan exactamente como lo harían con sus proveedores predeterminados — el modelo cambia, la interfaz de la herramienta no. Esto hace que sea sencillo probar diferentes modelos (DeepSeek para tareas con mucho razonamiento, Qwen3-Coder para generación de código, GLM-4.7 para trabajo agéntico con muchas herramientas) sin cambiar de herramientas o flujos de trabajo.

Para equipos que construyen sus propios pipelines agénticos o plataformas de codificación, Novita AI también ofrece entornos de sandbox aislados para ejecutar agentes — separados de la máquina local, con acceso a archivos limitado y ejecución controlada.

FAQ

¿Es Codex lo mismo que el modelo original OpenAI Codex?

No. El Codex original era un modelo de generación de código lanzado por OpenAI en 2021 y luego descontinuado. Codex CLI es un producto separado — un agente de terminal de código abierto lanzado en 2025 que utiliza los modelos actuales de OpenAI (GPT-4o, o3, etc.) a través de la API Chat Completions. Los nombres son similares pero los productos no están relacionados.

¿Puedo usar GPT-4o o modelos más nuevos de OpenAI con Codex CLI?

Sí. El campo model de Codex CLI en la configuración TOML acepta cualquier ID de modelo que admita el proveedor configurado. Si lo apuntas al endpoint de OpenAI, gpt-4o, o3, o4-mini y otros modelos actuales funcionan.

¿Claude Code admite endpoints compatibles con OpenAI?

No directamente. Claude Code utiliza el formato Anthropic Messages API, por lo que requiere un proveedor que exponga un endpoint compatible con Anthropic. Novita AI admite esto. El endpoint de OpenAI utiliza un formato diferente y no es compatible.

¿Qué herramienta es más barata de ejecutar?

Ambas herramientas envían solicitudes de API, por lo que el costo depende del modelo y proveedor al que te conectes — no de la herramienta en sí. Para cualquier herramienta, cambiar a un modelo de menor costo a través de Novita AI — como DeepSeek V3 o Qwen3-Coder — es la principal palanca de costos. Verifica los precios actuales en la biblioteca de modelos de Novita AI.

¿Puedo usar ambas herramientas juntas?

Algunos equipos lo hacen. Codex CLI es lo suficientemente ligero para integrarlo en contextos de CI o scripts, mientras que Claude Code maneja la sesión de desarrollo interactiva en VS Code. Las herramientas no comparten sesiones, por lo que combinarlas significa mantener configuraciones separadas — manejable pero vale la pena ser intencional al respecto.

---

Lectura Recomendada

1. Cómo usar Codex con modelos de Novita AI: Guía de configuración completa
2. Documentación de CLI de Claude Code: Configuración, comandos de barra e integración con API LLM
3. Agente de codificación CLI vs IDE: ¿Cuál es la opción más inteligente para tu próximo proyecto?