01
Claude Desktop
La aplicación gráfica. La pestaña Code es Claude Code sin terminal.
01Inicio
01Cómo usar esta guía
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
La aplicación gráfica. La pestaña Code es Claude Code sin terminal.
02
El mismo agente, en PowerShell, CMD o Windows Terminal.
03
El agente de OpenAI. CLI local, aplicación y, si lo pides, un plugin.
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
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.
| Herramienta | Dónde vive | Qué recuerda |
|---|---|---|
| Claude Desktop | Aplicació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 Code | Comando 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. |
| Codex | Comando 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
Abrir la misma carpeta en los dos programas los pone delante de los mismos archivos. Ahí acaba lo automático.
~/.claude. Codex no la lee.~/.codex. Claude no la usa como memoria propia.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
Manera A
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
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
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 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
Varias instrucciones que circularon en 2025 quedaron cortas. Esta página usa lo que dicen hoy los sitios oficiales.
irm https://claude.ai/install.ps1 | iex. No pide Node.js.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.openai/codex-plugin-cc. Hay que instalarlo y pedir el comando. No arranca sola.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.@AGENTS.md dentro de CLAUDE.md si quieres que Claude vea las dos cosas.07La pestaña Code
Guía de inicio de Claude Desktop · Referencia de la pestaña Code
08La terminal
Abre PowerShell. El aviso muestra PS al principio. No hace falta ejecutarlo como administrador.
irm https://claude.ai/install.ps1 | iexLa descarga puede quedarse en silencio un rato. Cuando termine, cierra esa ventana, abre otra y comprueba:
claude --version
claude doctorclaude --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.
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.
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdwinget install Anthropic.ClaudeCodenpm install -g @anthropic-ai/claude-code@latestWinGet y npm no se actualizan solos. El instalador nativo sí, en segundo plano. Para forzar una actualización nativa: claude update.
cd C:\proyectos\mi-app
claudeLa 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:
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}09CLI de OpenAI
El CLI oficial se instala con un script. Ábrelo en una ventana nueva de PowerShell.
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"codex --version
cd C:\proyectos\mi-app
codexEn 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.
npm install -g @openai/codexTambié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
Elige una ruta corta, sin sorpresas de permisos. Ejemplo: C:\proyectos\mi-app.
mkdir C:\proyectos\mi-app
cd C:\proyectos\mi-app
git init
git status --shortA partir de aquí, las dos herramientas deben usar esa misma ruta.
cd C:\proyectos\mi-app
claudecd C:\proyectos\mi-app
codexEn 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
Cada uno tiene su archivo de instrucciones. Escribir las reglas solo en uno deja al otro sin ellas.
| Claude Code | Codex | |
|---|---|---|
| Archivo del proyecto | CLAUDE.md o .claude/CLAUDE.md | AGENTS.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.md | Claude lo lee, desde la v2.1.277, porque no hay CLAUDE.md. | Codex lo lee. Es su archivo normal. |
| Si existen los dos | Por 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.
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
## 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.@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.
12Un escritor cada vez
HANDOFF.md si hace falta contexto.Un primer mensaje razonable para Claude:
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:
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
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.
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setupSi Codex está instalado y aún no has entrado, el propio README del plugin indica:
!codex login/codex:review --background
/codex:status
/codex:result/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:
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
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.
# 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:
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 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.
winget install --id Git.Git -e --source winget
git --versiongit status --short y, si el proyecto ya tiene remoto, git fetch.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.
cd C:\proyectos\mi-app
git status --short
git worktree add ..\mi-app-codex -b trabajo/codex
git worktree listcd C:\proyectos\mi-app
claude
cd C:\proyectos\mi-app-codex
codexUn 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.
16Qué mirar primero
| Qué ves | Qué suele pasar |
|---|---|
&& no es un separador válido | Estás en PowerShell con un comando de CMD. Usa el bloque de PowerShell. |
irm no se reconoce | Estás en CMD. Usa el instalador .cmd o abre PowerShell. |
claude o codex no se reconoce | La 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 sintaxis | No 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 EBADENGINE | Node 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ón | La cuenta es el plan gratuito de claude.ai. Claude Code no entra en ese plan. |
| Codex no hace el encargo desde Claude | Falta el plugin, falta /reload-plugins, o Codex no tiene sesión. Ejecuta /codex:setup. |
| Claude ignora AGENTS.md | Hay 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 archivos | Están escribiendo a la vez en la misma carpeta. Para y revisa git diff. Para paralelo de verdad, usa worktrees. |
17Límites y permisos
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./permissions y un sandbox. No los dejes en un modo ciego la primera tarde./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.18Antes de dar el día por cerrado
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.19Documentación oficial
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.