Codex solía ejecutarse como servidor MCP para Claude Code, pero el comando codex mcp-server se eliminó de la CLI. Este artículo explica qué dejó de funcionar, qué alternativas funcionan hoy, los comandos exactos de instalación, los ajustes de sandbox y las soluciones a los errores más comunes.
Si escribiste codex mcp-server en una terminal y obtuviste Error: stdin is not a terminal, tu equipo está bien. El comando ya no existe. Durante un tiempo, Codex MCP para Claude Code significaba una sola configuración: ejecutar Codex como servidor MCP, registrarlo en Claude Code y dejar que un agente de programación pidiera una segunda opinión al otro. OpenAI ha eliminado ese subcomando desde entonces, y todo tutorial que todavía lo muestre lleva a un callejón sin salida.
Este artículo explica qué cambió, qué alternativas funcionan hoy y los comandos exactos para cada una. Encontrarás el plugin oficial, un wrapper MCP de la comunidad, una solución provisional de corta duración con una CLI anterior y la configuración inversa, en la que Codex llama a Claude Code. Cada comando procede de la documentación de OpenAI, del repositorio del plugin o del README del wrapper, así que puedes pegarlo sin adivinar.
💡 Resumen: instala el plugin oficial de Codex para Claude Code. Elige un wrapper MCP de la comunidad solo cuando necesites que Codex aparezca como herramientas MCP reales.
La CLI de Codex incluía un subcomando, codex mcp-server, que iniciaba Codex como servidor MCP por stdio. Claude Code podía lanzarlo como cualquier otro servidor, así que una sola línea de claude mcp add convertía Codex en una herramienta. El servidor exponía dos herramientas:
| Herramienta | Qué hacía | Entradas principales |
|---|---|---|
codex | Iniciaba una sesión nueva de Codex | prompt, approval-policy, sandbox |
codex-reply | Continuaba una sesión existente | prompt, threadId |
La primera llamada devolvía un threadId. Si lo pasabas a codex-reply, la conversación seguía, de modo que Claude Code podía encargarle una tarea a Codex, leer la respuesta y hacer después una pregunta de seguimiento en la misma sesión. El campo approval-policy aceptaba untrusted, on-request o never, y sandbox aceptaba read-only, workspace-write o danger-full-access.
El registro antiguo tenía este aspecto:. Ya no funciona en una CLI actual:
claude mcp add codex -- codex mcp-server
La documentación de MCP de OpenAI indica ahora que el comando codex mcp-server y el binario independiente codex-mcp-server se han eliminado. En una CLI actual, mcp-server no es un subcomando reconocido, así que la CLI trata la palabra como un prompt e intenta abrir su interfaz interactiva. Claude Code lanza los servidores a través de una tubería sin terminal asociada, de modo que la CLI se detiene con Error: stdin is not a terminal. Un informe de error del proyecto Quest sitúa el fallo exactamente en esa caída al modo de prompt.
Dentro de Claude Code, el síntoma es un servidor que aparece como failed en /mcp, sin herramientas listadas. Nada de tu configuración está mal. Lo que apunta ya no existe.
Un artículo sobre la migración data el aviso de obsolescencia en la CLI de Codex 0.149.1, publicada el 24 de agosto de 2026. Los informes de error de varios proyectos que dependían del comando, entre ellos Quest y la skill second-opinion de Trail of Bits, señalan la CLI de Codex 0.154.0 como la versión en la que desapareció. Comprueba qué versión usas:
codex --version
Cualquier versión desde la 0.154.0 en adelante carece del subcomando, así que ningún ajuste de configuración lo devolverá.
Elige según cómo quieras que aparezca Codex dentro de Claude Code. La tabla muestra la contrapartida de un vistazo:
| Opción | La mantiene | Aparece como | Inconveniente |
|---|---|---|---|
| Plugin de Codex para Claude Code | OpenAI | Comandos de barra como /codex:review | No son herramientas MCP |
| Wrapper MCP de la comunidad | Un tercero | Herramientas MCP como ask-codex | No oficial, envuelve codex exec |
| CLI de Codex anterior | OpenAI, congelada | Las herramientas originales codex y codex-reply | Sin actualizaciones, se rompe al actualizar |
Si lo que buscas es una segunda opinión sobre tu código, el plugin es el camino más corto. Si ya tienes prompts, scripts o subagentes que llaman a herramientas MCP por su nombre, el wrapper mantiene esa forma con la menor reescritura.
OpenAI publica openai/codex-plugin-cc. Envuelve el servidor de aplicaciones de Codex a través del binario codex que ya tienes en tu equipo, así que reutiliza tu inicio de sesión y tu configuración de Codex. Necesita Node.js 18.18 o posterior y una suscripción a ChatGPT (el plan Free cuenta) o un token de la API de OpenAI. La contrapartida: obtienes comandos de barra y trabajos en segundo plano, no herramientas MCP.
@cexll/codex-mcp-server mantiene la forma MCP. Llama internamente a codex exec y expone las herramientas ask-codex, brainstorm, ping y help. Necesita Node.js 18 o posterior y una CLI de Codex instalada y con sesión iniciada. Como es código de terceros que se ejecuta contra tu repositorio, léelo antes de confiar en él, y espera que vaya por detrás de los cambios de la CLI de Codex de días o semanas.
Puedes instalar una versión de la CLI de Codex anterior a la eliminación y mantener codex mcp-server en funcionamiento:
npm install -g @openai/codex@<a-version-before-0.154.0>
Confirma que el subcomando existe antes de conectarlo. Esto solo gana tiempo. Te quedas sin nuevos modelos ni correcciones, y la siguiente actualización vuelve a romper la configuración.
💡 Considera la CLI anterior como un puente de una semana, no como una arquitectura.
Instala primero la CLI de Codex. El plugin depende de ese binario global y usa el inicio de sesión que ya tenga guardado el binario.
Desde una terminal normal, instala la CLI:
npm install -g @openai/codex
Después, ejecuta estos dentro de Claude Code, uno a uno:
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup
/codex:setup comprueba que Codex está instalado y autenticado. Si informa de un problema, resuélvelo antes que nada, porque todos los demás comandos dependen de él.
El plugin añade una pequeña familia de comandos /codex::
| Comando | Úsalo para |
|---|---|
/codex:review | Una revisión estándar y de solo lectura de tus cambios |
/codex:adversarial-review | Una revisión que puedes orientar y que cuestiona las decisiones de diseño |
/codex:rescue | Pasarle a Codex una tarea atascada mediante un subagente |
/codex:transfer | Crear un hilo persistente de Codex desde la sesión actual |
/codex:status | Listar los trabajos de Codex en ejecución y recientes |
/codex:result | Mostrar la salida final de un trabajo terminado |
/codex:cancel | Detener un trabajo activo en segundo plano |
/codex:setup | Verificar la instalación y el inicio de sesión |
Un hábito que funciona: cuando Claude Code termine un cambio, ejecuta /codex:review para obtener la opinión de un segundo modelo antes de hacer commit. Recurre a /codex:rescue cuando Claude Code dé vueltas sobre el mismo error, y vigila /codex:status mientras el trabajo se ejecuta en segundo plano.
Elige esta ruta cuando necesites herramientas MCP reales. El wrapper se sitúa entre Claude Code y la CLI de Codex, traduciendo las llamadas a herramientas en ejecuciones de codex exec.
npm install -g @openai/codex
claude mcp add codex-cli -- npx -y @cexll/codex-mcp-server
Después, escribe /mcp dentro de Claude Code. El servidor debería aparecer como conectado, con sus herramientas listadas debajo. claude mcp list muestra lo mismo desde la terminal.
Añade --scope project al comando claude mcp add y Claude Code escribe el servidor en .mcp.json en la raíz del repositorio, de modo que todo el equipo tiene la misma configuración:
{
"mcpServers": {
"codex-cli": {
"command": "npx",
"args": ["-y", "@cexll/codex-mcp-server"]
}
}
}
Claude Code pide a cada compañero que apruebe un servidor del proyecto antes de ejecutarlo, que es el comportamiento correcto para una herramienta que puede tocar archivos.
El wrapper transmite los controles de seguridad de Codex, así que tú decides cuánta libertad recibe Codex. El README enumera estas opciones:
| Ajuste | Opciones |
|---|---|
| Sandbox | read-only, workspace-write, danger-full-access |
| Política de aprobación | never, on-request, on-failure, untrusted |
💡 Empieza con
read-onlypara revisiones y preguntas. Pasa aworkspace-writesolo cuando quieras que Codex edite archivos. Combinardanger-full-accessconneverquita todos los frenos, así que mantén esa combinación fuera de los repositorios compartidos.
El README también menciona valores predeterminados inteligentes desde la versión 1.2: el wrapper elige workspace-write cuando una tarea lo necesita, para evitar errores de permisos. Comprueba qué modo usó realmente una ejecución antes de dar por hecho que se mantuvo en solo lectura.
La conexión funciona en ambos sentidos. Claude Code puede llamar a Codex, y Codex puede llamar a Claude Code o a cualquier otro servidor MCP en el que confíes.
Codex consume servidores MCP de forma nativa. Añade uno desde la CLI:
codex mcp add my-server -- npx -y your-mcp-server-package
O escríbelo en config.toml como una tabla [mcp_servers.<name>]:
[mcp_servers.my-server]
command = "npx"
args = ["-y", "your-mcp-server-package"]
startup_timeout_sec = 20
tool_timeout_sec = 120
Los servidores por stdio también aceptan env, cwd, enabled_tools y disabled_tools, lo que te permite ocultar las herramientas que Codex nunca debería llamar. Los servidores HTTP admiten un url, además de opciones de autenticación.
Claude Code puede ofrecer sus propias herramientas por MCP con claude mcp serve. Registra ese comando en Codex:
codex mcp add claude-code -- claude mcp serve
Entonces Codex verá las herramientas de Claude Code, como la lectura y edición de archivos y el acceso a la shell, expuestas como herramientas MCP. Pruébalo primero en un repositorio desechable, porque dos agentes con permisos de escritura pueden sobrescribir las ediciones del otro.
La mayoría de los fallos encajan en cinco grupos. Identifica el síntoma y aplica la solución:
| Síntoma | Causa probable | Solución |
|---|---|---|
Error: stdin is not a terminal | Se eliminó el subcomando mcp-server | Cambia al plugin o al wrapper |
El servidor aparece como failed en /mcp | La CLI de Codex no está en PATH o no has iniciado sesión | Ejecuta codex --version, inicia sesión y reinicia Claude Code |
Faltan los comandos /codex: | El plugin no se recargó | Ejecuta /reload-plugins y después /codex:setup |
npx falla en Windows nativo | npx es un shim de .cmd | Regístralo con cmd /c npx -y @cexll/codex-mcp-server |
| El servidor agota el tiempo de espera al arrancar por primera vez | npx descarga el paquete en la primera ejecución | Instálalo globalmente o aumenta MCP_TIMEOUT |
Una comprobación de salud de 30 segundos detecta casi todo lo demás:
codex --version para confirmar que la CLI está instalada y es reciente.claude mcp list para confirmar que el servidor está registrado y conectado.ping (wrapper) o que ejecute /codex:setup (plugin).Si las tres pasan y una tarea sigue fallando, el problema es la tarea, no la fontanería. Acota el prompt, baja el sandbox a read-only y vuelve a ejecutarla.
Cuando una configuración sigue fallando, un modelo de programación potente puede leer el error contigo. GPT 5.6 Sol en PicassoIA está pensado para programación, redacción técnica y razonamiento de varios pasos, y lee imágenes, así que una captura de la terminal con el fallo también sirve.
codex --version y el comando que falló en el campo del prompt.high para los problemas enredados. El valor predeterminado, none, prioriza la velocidad.low cuando solo quieras el comando corregido, y en high cuando quieras el razonamiento detallado.Así se corresponden los ajustes con este tipo de trabajo:
| Ajuste | Valores | Útil para |
|---|---|---|
reasoning_effort | none, low, medium, high, xhigh | none para consultas rápidas, high para conflictos de configuración |
verbosity | low, medium, high | low cuando solo necesitas el comando |
max_completion_tokens | Entero | Súbelo junto con el esfuerzo |
system_prompt | Texto | Definir un rol y una regla sobre no adivinar |
image_input | Lista de imágenes | Capturas de terminal y diagramas |
Para comparar respuestas, ejecuta el mismo prompt en Claude Sonnet 5 o Claude Fable 5, ambos en la categoría Large Language Models. Que dos modelos no estén de acuerdo sobre tu configuración es una señal útil para leer tú mismo la documentación.
Los artículos de configuración y los README se leen mejor con recursos visuales reales: una foto de cabecera, un diagrama de cómo se conectan dos agentes, un clip corto para una nota de versión. PicassoIA también tiene su propia API para desarrolladores y su conector MCP, así que la misma sesión de Claude Code puede pedir imágenes sin salir de la terminal.
La API sigue el estilo de Replicate: la URL base es https://api.picassoia.com/v1, las peticiones llevan un token Bearer que empieza por pia_sk_, y los trabajos son asíncronos, así que creas una predicción, la consultas y después obtienes el resultado. Una cuenta puede ejecutar 5 predicciones simultáneas, compartidas entre tokens y conexiones MCP. Cuatro modelos están disponibles a través de la API y del conector MCP:
Consulta la página de precios para saber qué incluye tu plan, ya que el acceso a la API y a MCP depende de ello.
Elige una sección de este artículo, escribe un prompt fotográfico de 50 palabras para ella y genera tu primera imagen en PicassoIA. Después, pasa esa imagen a un modelo de video y conviértela en un clip de cinco segundos. Una tarde de experimentos te mostrará qué modelo encaja con tu documentación, y el prompt que acabes escribiendo merece guardarse para el siguiente artículo.
Elige tu idioma
