Capítulos

01Cómo usar esta guía

Dos inteligencias artificiales, un mismo proyecto

Esta guía explica cómo usar Claude Desktop, Claude Code y OpenAI Codex sobre la misma carpeta en Windows. Sirve para quien ya programa y quiere un segundo criterio, y también para quien abre la terminal con cuidado y necesita los comandos exactos.

01

Claude Desktop

La aplicación gráfica. La pestaña Code es Claude Code sin terminal.

02

Claude Code

El mismo agente, en PowerShell, CMD o Windows Terminal.

03

Codex

El agente de OpenAI. CLI local, aplicación y, si lo pides, un plugin.

Cómo moverte

  • En el ordenador, los capítulos están a la izquierda.
  • En el móvil, ábrelos con el botón Capítulos.
  • Cada comando tiene Copiar. Pégalo en la terminal que indica la etiqueta.
  • Compartir usa el menú del sistema. Si el navegador no lo ofrece, copia el enlace.
  • Presentar pone un capítulo por pantalla. Flechas o los botones inferiores cambian de capítulo. Escape cierra.

Comprobado el 19 de noviembre de 2026 contra la documentación de Anthropic, OpenAI y Node.js. Los enlaces están en el último capítulo. Los límites de cada plan cambian: confirma el tuyo en la cuenta antes de depender de una cifra.

02No son lo mismo

Tres nombres, tres sitios distintos

Se parecen porque los tres pueden leer tu código y proponer cambios. No son intercambiables, y no hay un interruptor oficial que los fusione.

Qué es cada herramienta en Windows
HerramientaDónde viveQué recuerda
Claude DesktopAplicación de Anthropic. La pestaña Code abre sesiones sobre una carpeta.El chat de esa sesión y los archivos del proyecto. No el chat de Codex.
Claude CodeComando claude en la terminal. Es el mismo producto que la pestaña Code.CLAUDE.md, la memoria automática en tu usuario y el historial de esa sesión.
CodexComando codex, la app de Codex o el trabajo en la nube de ChatGPT.AGENTS.md, su configuración en ~/.codex y sus propios hilos.

La aplicación de escritorio ya incluye Claude Code. No hace falta instalar Node.js ni el CLI para usar la pestaña Code. El CLI sí hace falta si quieres la terminal, o si vas a pedirle a Claude Code que delegue en Codex con el plugin oficial.

03La regla de oro

Lo que no viaja de uno a otro

Abrir la misma carpeta en los dos programas los pone delante de los mismos archivos. Ahí acaba lo automático.

  • El chat de Claude no aparece en Codex.
  • El chat de Codex no aparece en Claude.
  • La memoria automática de Claude se guarda en tu máquina, dentro de ~/.claude. Codex no la lee.
  • La configuración de Codex vive en ~/.codex. Claude no la usa como memoria propia.
  • Si uno edita un archivo y el otro lo tenía abierto en la cabeza de su sesión, el segundo no se entera hasta que vuelve a leer el disco.

Existe un traspaso explícito. El comando /codex:transfer del plugin oficial crea un hilo de Codex a partir del transcript de la sesión de Claude. Eso copia un momento de la conversación. No mantiene las dos memorias unidas después.

04Carpeta o delegación

Dos maneras reales de usarlos juntos

Manera A

La misma carpeta

Abres el proyecto en Claude Desktop o en claude, y en otra ventana ejecutas codex en esa ruta. Cada uno lee y escribe archivos. Tú decides quién toca qué, y cuándo.

Sirve para un segundo parecer, para repartir tareas que no pisan los mismos archivos, o para que uno revise el diff del otro.

Manera B

Delegar el CLI de Codex

Dentro de Claude Code instalas el plugin oficial openai/codex-plugin-cc. Cuando tú lo pides, Claude llama a tu Codex local: una revisión, un rescate de un bug, o un traspaso de la sesión.

Sigue siendo tu Codex, con tu login y tu carpeta. No es un servicio que conecte las dos nubes por su cuenta.

Pedirle a Claude Code que ejecute codex exec en la terminal es una tercera variante, más tosca. codex exec es el modo no interactivo documentado para scripts y CI. Si Claude lo lanza, estás autorizando un comando de shell: el resultado vuelve como salida de terminal, no como una conversación compartida. El camino mantenido por OpenAI para delegar desde Claude Code es el plugin, no ese atajo.

05Windows, cuentas, versiones

Qué necesita Windows

  • Windows 10 versión 1809 o posterior, o Windows Server 2019 o posterior.
  • 4 GB de RAM como mínimo. Para Codex, 8 GB es lo cómodo.
  • Un procesador x64 o ARM64. En Windows ARM, Claude Desktop tiene instalador propio.
  • Internet. Los modelos no corren enteros en tu PC.
  • PowerShell, CMD o Windows Terminal. PowerShell es el camino más claro en esta guía.

Cuentas, por separado

Claude Code pide un plan de pago de Claude: Pro, Max, Ultra, Team, Enterprise o una cuenta de Console. El plan gratuito de claude.ai no incluye Claude Code. También puede usarse con Amazon Bedrock, Google Cloud Agent Platform o Microsoft Foundry.

Codex se inicia con una cuenta de ChatGPT o con una clave de API. El README del CLI recomienda Plus, Pro, Business, Edu o Enterprise. El plugin para Claude Code dice que también admite suscripción de ChatGPT, incluido el plan Free, y que el uso cuenta para los límites de Codex. Esos límites no son una cifra fija: míralos en el panel de uso. Una clave de API se factura aparte y no gasta el cupo de ChatGPT.

Git y Node, sin confundirlos

Git for Windows es recomendable. Con Git, Claude Code puede usar Bash. Sin Git, usa PowerShell y sigue funcionando. El sandbox de comandos de Claude Code no está disponible en Windows nativo; sí en WSL 2.

Node.js no hace falta para los instaladores nativos de Claude Code ni de Codex, ni para la pestaña Code de Claude Desktop. Sí hace falta si instalas alguno de los dos con npm, y el plugin de delegación declara Node.js 18.18 o posterior. Si usas npm para Claude Code, la versión mínima sube a Node.js 22.

06Correcciones de noviembre 2026

Qué ya no coincide con las guías viejas

Varias instrucciones que circularon en 2025 quedaron cortas. Esta página usa lo que dicen hoy los sitios oficiales.

  1. El instalador recomendado de Claude Code en Windows es nativo: irm https://claude.ai/install.ps1 | iex. No pide Node.js.
  2. npm install -g @anthropic-ai/claude-code sigue existiendo y exige Node.js 22 o posterior. El paquete descarga el mismo binario nativo. No uses sudo en otros sistemas, ni un npm 12.
  3. Codex en Windows se instala con el script de PowerShell de chatgpt.com, no hace falta compilar Rust. La página de compilar el repositorio todavía cita Windows 11 vía WSL2: eso es para construir el código fuente, no para usarlo.
  4. La delegación oficial desde Claude Code es el plugin openai/codex-plugin-cc. Hay que instalarlo y pedir el comando. No arranca sola.
  5. El plugin OpenAI Developers no es ese puente. Sirve para la API, el Agents SDK y la documentación de OpenAI.
  6. Claude lee AGENTS.md solo cuando no hay CLAUDE.md ni CLAUDE.local.md en la carpeta de trabajo ni por encima, y desde Claude Code v2.1.277. Si existe un CLAUDE.md, Codex sigue leyendo AGENTS.md y Claude, por defecto, no.
  7. En Windows, no sustituyas esa relación por un enlace simbólico. Git en Windows a menudo deja el symlink como un archivo de texto. Usa la importación @AGENTS.md dentro de CLAUDE.md si quieres que Claude vea las dos cosas.

07La pestaña Code

Instalar Claude Desktop

  1. Descarga el instalador de Windows desde la guía oficial de la aplicación de escritorio. Hay build x64 y, por separado, ARM64.
  2. Ejecútalo, abre Claude desde el menú Inicio e inicia sesión.
  3. Entra en la pestaña Code. Si solo ves iconos, pasa el cursor para leer el nombre.
  4. Si te pide mejorar el plan, Claude Code no está en el plan gratuito. Si te pide iniciar sesión otra vez, termina el acceso en el navegador y reabre la app.
  5. Elige la carpeta del proyecto. Cada sesión tiene su chat y su carpeta.

Guía de inicio de Claude Desktop · Referencia de la pestaña Code

08La terminal

Instalar Claude Code en la terminal

Abre PowerShell. El aviso muestra PS al principio. No hace falta ejecutarlo como administrador.

PowerShell: instalador nativo de Claude Code
irm https://claude.ai/install.ps1 | iex

La descarga puede quedarse en silencio un rato. Cuando termine, cierra esa ventana, abre otra y comprueba:

PowerShell: comprobar Claude Code
claude --version
claude doctor

claude --version debe imprimir un número, por ejemplo una línea que termina en (Claude Code). claude doctor revisa la instalación sin abrir una sesión de trabajo.

Si estás en CMD y no en PowerShell

El aviso de CMD no lleva PS. Si ves que && no vale, estás en PowerShell y debes usar el comando anterior. Si irm no se reconoce, estás en CMD.

CMD: instalador nativo de Claude Code
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Otras vías

PowerShell: WinGet, sin autoactualización
winget install Anthropic.ClaudeCode
PowerShell o CMD: solo si ya tienes Node.js 22 o posterior
npm install -g @anthropic-ai/claude-code@latest

WinGet y npm no se actualizan solos. El instalador nativo sí, en segundo plano. Para forzar una actualización nativa: claude update.

Entrar al proyecto

PowerShell: abrir Claude Code en la carpeta
cd C:\proyectos\mi-app
claude

La primera vez, el navegador pide la cuenta. Si defines ANTHROPIC_API_KEY y aceptas usarla cuando Claude lo pregunta, se omite ese inicio de sesión.

Instala Git for Windows si quieres que el agente use Bash. Si Claude no encuentra Git Bash, la documentación permite indicar la ruta en ~/.claude/settings.json:

settings.json: solo si no detecta Git Bash
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Instalación y requisitos de Claude Code

09CLI de OpenAI

Instalar Codex

El CLI oficial se instala con un script. Ábrelo en una ventana nueva de PowerShell.

PowerShell: instalador nativo de Codex
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
PowerShell: comprobar Codex y abrirlo
codex --version
cd C:\proyectos\mi-app
codex

En el primer arranque elige Sign in with ChatGPT, o el otro método que te ofrezca si vas a usar una clave de API. La clave exige configuración adicional documentada por OpenAI; no la pegues dentro del repositorio.

Si prefieres npm

npm: instalación alternativa de Codex
npm install -g @openai/codex

También existe la aplicación de escritorio de Codex. El repositorio indica el comando codex app cuando ya está instalada, y la documentación general está en developers.openai.com/codex. Esta guía se centra en el CLI porque es el que el plugin de Claude Code reutiliza.

Repositorio openai/codex · Documentación del CLI · Planes y límites

10Un proyecto, dos sesiones

Prepara una sola carpeta

Elige una ruta corta, sin sorpresas de permisos. Ejemplo: C:\proyectos\mi-app.

PowerShell: crear el proyecto e iniciar Git
mkdir C:\proyectos\mi-app
cd C:\proyectos\mi-app
git init
git status --short

A partir de aquí, las dos herramientas deben usar esa misma ruta.

PowerShell, ventana 1: Claude Code
cd C:\proyectos\mi-app
claude
PowerShell, ventana 2: Codex
cd C:\proyectos\mi-app
codex

En Claude Desktop, la sesión de la pestaña Code tiene que apuntar a C:\proyectos\mi-app, no a una copia, el Escritorio o Descargas.

Mientras los dos puedan escribir, no los dejes editando los mismos archivos a la vez. Uno propone, tú revisas, el otro entra cuando el disco ya refleja lo que aceptaste.

11CLAUDE.md y AGENTS.md

CLAUDE.md y AGENTS.md

Cada uno tiene su archivo de instrucciones. Escribir las reglas solo en uno deja al otro sin ellas.

Quién lee qué, según la documentación actual
Claude CodeCodex
Archivo del proyectoCLAUDE.md o .claude/CLAUDE.mdAGENTS.md. Si existe AGENTS.override.md, ese manda en ese directorio.
Archivo personal%USERPROFILE%\.claude\CLAUDE.md%USERPROFILE%\.codex\AGENTS.md
Si solo existe AGENTS.mdClaude lo lee, desde la v2.1.277, porque no hay CLAUDE.md.Codex lo lee. Es su archivo normal.
Si existen los dosPor defecto lee CLAUDE.md y no AGENTS.md. Puedes importarlo o cambiar el ajuste.Lee AGENTS.md. No lee CLAUDE.md salvo que lo configures como nombre alternativo.

Codex concatena las instrucciones desde la raíz del repositorio hasta la carpeta actual y se detiene, por defecto, en 32 KiB. Claude apunta a menos de 200 líneas por CLAUDE.md: un archivo enorme se sigue menos.

Un archivo común y las reglas de cada uno

Pon en AGENTS.md lo que cualquier agente debe respetar: cómo se arranca el proyecto, cómo se prueba y qué no debe tocar. En CLAUDE.md importa ese archivo y añade solo lo que es de Claude.

AGENTS.md en la raíz del proyecto
# AGENTS.md

## Proyecto
- La app se arranca con `npm run dev`.
- Antes de dar una tarea por hecha, ejecuta `npm test`.
- No modifiques `.env` ni subas secretos.

## Reparto
- No escribas en archivos que otro agente esté editando en esta sesión.
- Deja el estado del trabajo en `HANDOFF.md` si otra sesión debe continuar.
CLAUDE.md que importa las reglas comunes
@AGENTS.md

## Claude Code
- Para cambios grandes, enseña el plan antes de editar.
- Si delegas en Codex, repite las reglas de este archivo en el encargo.
- No des por hecho que Codex ha leído el chat de esta sesión.

Dentro de Claude Code, /init puede proponer un primer CLAUDE.md. Si el archivo ya existe, sugiere mejoras y no lo borra. /context all muestra qué archivos de memoria cargó la sesión. En Codex, un prompt del estilo «resume las instrucciones que has cargado» sirve para comprobar AGENTS.md.

Si quieres que Claude lea siempre los dos archivos, la documentación permite poner las instrucciones de proyecto en claude-md-and-agents-md desde /config. El valor por defecto es leer CLAUDE.md o, solo en su ausencia, AGENTS.md.

Cómo recuerda Claude el proyecto · AGENTS.md en Codex

12Un escritor cada vez

Una rutina para la misma carpeta

  1. Tú escribes el objetivo en una frase y el criterio de «ya está».
  2. Un agente hace el cambio. El otro no escribe todavía.
  3. Revisas el diff. Si no lo entiendes, no lo aceptes.
  4. Cierras o dejas quieta esa sesión y abres la otra en la misma carpeta, ya con los archivos guardados.
  5. Le pides una revisión de lectura, o el siguiente trozo, y le señalas el archivo HANDOFF.md si hace falta contexto.

Un primer mensaje razonable para Claude:

Mensaje para Claude, en la carpeta del proyecto
Lee AGENTS.md y CLAUDE.md.
Explícame cómo se arranca este proyecto y no edites archivos todavía.

Y, cuando el cambio ya está en disco, para Codex:

Mensaje para Codex, después de guardar el trabajo de Claude
Lee AGENTS.md.
Revisa los archivos modificados. No los edites.
Dime qué está mal, con la ruta y el motivo.
No tienes el chat de Claude: apóyate solo en los archivos y en HANDOFF.md.

Codex tiene un modo de revisión propio, y el plugin añade /codex:review desde Claude. En la carpeta compartida, sin plugin, el mensaje anterior basta: le estás pidiendo que mire el disco, no que recuerde una conversación ajena.

13Plugin oficial de Codex

Delegar en Codex desde Claude Code

Esto es optativo. Si solo vas a abrir los dos programas sobre la misma carpeta, puedes saltarte el plugin. Si quieres pedirle a Claude que encargue un trabajo a Codex, instálalo dentro de una sesión de claude, en la carpeta del proyecto.

El plugin usa el codex que ya instalaste, tu sesión iniciada y la misma configuración. El repositorio pide Node.js 18.18 o posterior. /codex:setup puede ofrecer instalar Codex con npm si no lo encuentra.

Dentro de Claude Code, no en PowerShell
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

Si Codex está instalado y aún no has entrado, el propio README del plugin indica:

Dentro de Claude Code: iniciar sesión en Codex
!codex login

Qué puedes pedir

Revisión de solo lectura, en segundo plano
/codex:review --background
/codex:status
/codex:result
Encargar un arreglo concreto
/codex:rescue investiga por qué falla el test y propone el parche más pequeño
  • /codex:review no modifica archivos. Puede comparar con --base main.
  • /codex:adversarial-review cuestiona la decisión de diseño, no solo el detalle. También es de solo lectura.
  • /codex:rescue sí puede intentar un cambio, a través del subagente codex:codex-rescue.
  • --background deja la tarea corriendo. /codex:status y /codex:result informan. /codex:cancel la corta.
  • /codex:transfer crea un hilo de Codex con el transcript de esta sesión y te imprime un codex resume.

Puedes decirlo en lenguaje natural: «pídele a Codex que revise este cambio». Sigue siendo una delegación que el plugin ejecuta contra tu CLI local. Claude no se vuelve Codex, y Codex no hereda la memoria automática de Claude.

El modelo y el esfuerzo salen de tu config.toml de Codex si no pasas --model ni --effort. Un ejemplo de proyecto, en .codex/config.toml, solo se aplica cuando el proyecto es de confianza:

.codex/config.toml de ejemplo
model = "gpt-5.4-mini"
model_reasoning_effort = "high"

Los nombres de modelo cambian. Si ese identificador ya no existe en tu cuenta, omite el archivo y deja que Codex use su valor por defecto, o consulta la lista vigente en la documentación de modelos.

README del plugin openai/codex-plugin-cc · El otro plugin: OpenAI Developers

14Porque el chat no viaja solo

Pasar el contexto a mano

Cuando no usas el plugin, el traspaso es un archivo. Escríbelo tú o pídele al agente que lo deje antes de cerrar. El siguiente agente debe leerlo como una nota, no como una orden nueva para rehacerlo todo.

HANDOFF.md
# Traspaso

## Hecho
- Se añadió la validación del formulario en src/form.ts.

## Intención
- El siguiente paso es cubrir el caso de correo vacío.

## No repetir
- No cambies el diseño visual en esta tanda.

## Prueba
- `npm test` pasa en este commit.

## Bloqueo
- Falta decidir si el mensaje de error va en español o en inglés.

Al abrir la otra herramienta:

Primer mensaje de la sesión que continúa
Lee HANDOFF.md y el diff actual.
Continúa solo el punto «Intención».
No reabras lo que ya está en «Hecho» salvo que una prueba falle.
No tienes la conversación anterior: si falta un dato, pregunta.

/codex:transfer hace otra cosa: importa el transcript de Claude a un hilo nuevo de Codex, con las reglas de importación de sesiones externas. El origen tiene que estar bajo ~/.claude/projects. Después puedes seguir con codex resume. Es un corte y una copia, no una llamada en directo entre los dos chats.

15Para no pisarse

Git para que no se borren el uno al otro

Git no es una integración de Claude con Codex. Es la red que te permite deshacer. Instálalo desde git-scm.com o con WinGet.

PowerShell: Git for Windows
winget install --id Git.Git -e --source winget
git --version

La regla simple

  • Un agente escribe. El otro espera, o solo lee.
  • Commits pequeños, con un mensaje que diga qué cambió.
  • Nadie hace push --force. Si el remoto avanzó, se mira con calma.
  • Antes de una tanda nueva: git status --short y, si el proyecto ya tiene remoto, git fetch.

Carpetas separadas cuando sí trabajan en paralelo

Un worktree es otra carpeta, con otra rama, unida al mismo historial. Claude puede quedarse en el proyecto y Codex en la copia. Los commits se ven en los dos sitios. Los archivos en edición, no.

PowerShell: un worktree para Codex
cd C:\proyectos\mi-app
git status --short
git worktree add ..\mi-app-codex -b trabajo/codex
git worktree list
Dos ventanas, dos carpetas
cd C:\proyectos\mi-app
claude

cd C:\proyectos\mi-app-codex
codex

Un worktree no separa contraseñas, variables de entorno ni una base de datos que apunte al mismo sitio. Si copias .env, los dos tienen los mismos secretos. Integrar las ramas sigue siendo una decisión tuya: no se fusionan solas.

Git for Windows

16Qué mirar primero

Cuando un comando no responde

Síntomas frecuentes y el primer sitio donde mirar
Qué vesQué suele pasar
&& no es un separador válidoEstás en PowerShell con un comando de CMD. Usa el bloque de PowerShell.
irm no se reconoceEstás en CMD. Usa el instalador .cmd o abre PowerShell.
claude o codex no se reconoceLa instalación terminó, pero esa ventana no ve el PATH nuevo. Ábrela de nuevo. Si sigue, la documentación de Claude tiene una sección para reparar el PATH.
El instalador de Claude falla con 403 o un error de sintaxisNo reintentes a ciegas con npm. La página de setup enlaza la resolución según el mensaje exacto, y ofrece WinGet como alternativa.
npm avisa EBADENGINENode es anterior al que pide el paquete. Para Claude Code por npm hace falta Node 22 o posterior. El binario nativo no usa tu Node al ejecutarse, pero conviene instalar en una versión soportada.
La pestaña Code pide una suscripciónLa cuenta es el plan gratuito de claude.ai. Claude Code no entra en ese plan.
Codex no hace el encargo desde ClaudeFalta el plugin, falta /reload-plugins, o Codex no tiene sesión. Ejecuta /codex:setup.
Claude ignora AGENTS.mdHay un CLAUDE.md o un CLAUDE.local.md en el camino. Impórtalo con @AGENTS.md o cambia las instrucciones de proyecto. Hace falta Claude Code v2.1.277 o posterior para leerlo directo.
Los dos se pisan archivosEstán escribiendo a la vez en la misma carpeta. Para y revisa git diff. Para paralelo de verdad, usa worktrees.

17Límites y permisos

Límites que conviene no negociar

  • Tú aceptas el diff. Un agente que dice «listo» no sustituye la lectura.
  • No pongas claves en CLAUDE.md, AGENTS.md, HANDOFF.md ni en mensajes que luego se exporten.
  • .env se queda fuera de Git. Un worktree nuevo no lo recibe solo: si lo copias, sabes que lo copiaste.
  • Claude Code pide permiso para herramientas y comandos. Codex tiene /permissions y un sandbox. No los dejes en un modo ciego la primera tarde.
  • En Windows nativo, Claude Code no ofrece el sandbox de comandos. WSL 2 sí. Elige WSL si tu proyecto ya vive en Linux y quieres ese aislamiento.
  • Delegar con /codex:rescue puede editar archivos y consumir el cupo de las dos cuentas. Una revisión con /codex:review no edita, y también consume uso.
  • Ni Claude ni Codex deben publicar, pagar, borrar ramas o forzar un push si tú no lo has pedido en esa frase.

18Antes de dar el día por cerrado

Antes de cerrar el día

  • Los dos apuntan a la carpeta que crees, o a worktrees que controlas.
  • claude --version y codex --version responden, si usas los CLI.
  • AGENTS.md existe. Si también hay CLAUDE.md, importa las reglas comunes o aceptas que Claude no leerá AGENTS.md por defecto.
  • HANDOFF.md dice qué está hecho, qué sigue y qué no hay que rehacer. O usaste /codex:transfer a propósito.
  • git status --short no muestra sorpresas de los dos agentes a la vez.
  • Has leído el diff que vas a conservar.
  • No hay secretos en los archivos de instrucciones ni en el commit.
  • Sabes cuál de las dos maneras usaste hoy: carpeta compartida, o delegación pedida con el plugin.

19Documentación oficial

Dónde comprobarlo tú

Comprobado el 19 de noviembre de 2026. Si un comando de esta guía deja de coincidir con la página oficial, manda la página. Los productos cambian los nombres de los modelos y los cupos con más frecuencia que los instaladores.

Esta página no inicia sesión en ningún sitio, no guarda lo que copias y no envía la guía a un servidor propio. Compartir usa el mecanismo del navegador o, si no existe, copia el enlace en tu portapapeles.