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

Codex CLI y Claude Code son herramientas de codificación agentivas basadas en terminal, pero están dirigidas a diferentes flujos de trabajo. Codex CLI es un agente ligero, 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 con soporte multi-superficie, 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 la máxima flexibilidad de modelos o un entorno de codificación unificado construido en torno a 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 en sandbox en tu máquina.

La elección clave de diseño en Codex CLI es la flexibilidad del proveedor. La herramienta habla el formato de cable de OpenAI Chat Completions, lo que significa que cualquier proveedor que exponga un endpoint compatible con OpenAI se puede integrar a través de un archivo de configuración TOML. Eso incluye los propios modelos 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 Suggest (predeterminado): solicita aprobación en cada paso
• Modo Auto edit: edita archivos automáticamente pero pregunta antes de ejecutar comandos
• Modo Full auto: 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 agentiva de Anthropic. Está disponible como CLI, una extensión de VS Code, un plugin de JetBrains, una aplicación de escritorio y una 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 valor predeterminado es el propio api.anthropic.com de Anthropic, pero una sola variable de entorno (ANTHROPIC_BASE_URL) lo redirige a cualquier proveedor compatible.

Claude Code agrega funciones de continuidad de sesión que Codex CLI no tiene: sesiones con nombre, bifurcaciones de conversación estilo branch, puntos de control de rebobinado y un comando /compact que resume el contexto para extender la ventana utilizable en tareas largas. Las instrucciones a nivel de proyecto van 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	Cualquiera compatible con OpenAI	Cualquiera compatible con Anthropic
Superficies	Solo terminal	CLI, VS Code, JetBrains, escritorio, navegador
Configuración de proyecto	Archivo de configuración TOML	CLAUDE.md + settings.json
Continuidad de sesión	Por sesión	Sesiones con nombre, reanudar, bifurcar, rebobinar
Modos de aprobación	Suggest / Auto Edit / Full Auto	default, plan, auto, acceptEdits, bypassPermissions
Soporte MCP	No	Sí
Gestión de contexto	Contexto por sesión	/compact, /context, /branch
Seguridad sandbox	Red deshabilitada, ámbito de directorio	Ámbito de modo de permiso

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 parchear la herramienta en sí.

Claude Code utiliza el formato de API Anthropic Messages. Por defecto, se enruta a Anthropic y utiliza modelos Claude (Sonnet, Opus, Haiku). La variable de entorno ANTHROPIC_BASE_URL permite la sustitución del 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 todas las 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.

Arquitectura de código abierto vs 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 integrarlo en un pipeline de CI sin una conversación de licencia separada. La comunidad puede (y lo hace) contribuir con integraciones de proveedores, correcciones de errores y extensiones de funciones.

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 lanzamiento 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 con 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

Redirigir 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 a través de las sesiones.

Plataforma y cobertura de 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, la extensión de VS Code, el plugin de JetBrains, la 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 el 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

Codex CLI la configuración 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 una 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 slash como /memory para editar instrucciones durante una sesión
• Variables de entorno para enrutamiento de API y autenticación

El enfoque de CLAUDE.md es útil para equipos que desean que cada sesión de agente comience con una comprensión compartida 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:

• Suggest: muestra los cambios propuestos y pregunta antes de aplicar cualquier cosa
• Auto edit: escribe archivos sin preguntar, pero requiere aprobación antes de ejecutar comandos de shell
• Full auto: se ejecuta sin preguntar; útil para pipelines confiables

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

• default: solicita aprobación para ediciones de archivos y comandos de shell
• acceptEdits: aprueba automáticamente las ediciones de archivos, pregunta para 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 ejecutar
• bypassPermissions: omite todas las comprobaciones (para contextos automatizados confiables)

Claude Code también admite un sistema de reglas de permitir/denegar/preguntar detallado en settings.json, que te permite aprobar comandos específicos de forma permanente 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 encendido/apagado, el sistema de tres modos de Codex CLI es más fácil de entender.

Gestión de sesiones y contexto

Las sesiones de codificación largas 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 agrega gestión de sesiones persistente:

• Sesiones con nombre que se pueden reanudar con claude -r "session-name"
• /compact para resumir la conversación actual y reducir el uso de tokens mientras continúas
• /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 usa y dónde

Para tareas cortas y enfocadas — corregir este error, escribir esta función, agregar estas pruebas — la diferencia no importa. Para sesiones de refactorización largas 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:

• Necesitas conectarte directamente a modelos compatibles con OpenAI (GPT-4o, o3, o4-mini, o proveedores externos con endpoints de formato OpenAI)
• Deseas auditar o modificar el comportamiento del agente a nivel de código fuente
• Tu flujo de trabajo es 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 deseas una dependencia mínima y auditable
• Tus requisitos de seguridad exigen un sandboxing explícito con red deshabilitada por defecto

Cuándo usar Claude Code

Usa Claude Code cuando:

• Deseas un comportamiento consistente en terminal, VS Code, JetBrains y escritorio
• Tu equipo se beneficia del contexto de proyecto compartido CLAUDE.md a través de las sesiones
• Necesitas continuidad de sesión — reanudar sesiones con nombre, bifurcar conversaciones, rebobinar cambios
• La integración del servidor MCP es parte de tu flujo de trabajo
• Prefieres la API de formato Anthropic y deseas enrutar a proveedores compatibles con Anthropic (incluyendo Novita AI)

Usar Novita AI con cualquiera de las herramientas

Ambas herramientas aceptan Novita AI como un 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 emblemáticos 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: Configura ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic y pasa una clave de API de Novita. La bandera --model o la variable de entorno ANTHROPIC_MODEL selecciona el modelo específico. Referencia completa de la CLI en Documentación de Claude Code CLI.

El papel de Novita AI aquí es como un backend de inferencia, no 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 facilita probar diferentes modelos (DeepSeek para tareas que requieren mucho razonamiento, Qwen3-Coder para generación de código, GLM-4.7 para trabajo agentivo con muchas herramientas) sin cambiar de herramientas o flujos de trabajo.

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

FAQ

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

No. El Codex original era un modelo de generación de código lanzado por OpenAI en 2021 y posteriormente obsoleto. 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 de API Anthropic Messages, 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 cualquiera de las herramientas, 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. Consulta 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 como para integrarlo en contextos de CI o con 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.

---

Lecturas recomendadas

1. Cómo usar Codex con modelos de Novita AI: Guía de configuración completa
2. Documentación de Claude Code CLI: Configuración, comandos slash e integración de API LLM
3. Mejores herramientas de codificación con IA en 2026