Cómo instalar Claude Code y Codex CLI en Windows
Los comandos exactos de PowerShell, CMD, WinGet y npm para instalar Claude Code y Codex CLI en Windows 10 y 11, cuándo elegir WSL y cómo corregir «claude no se reconoce» y los demás errores que te vas a encontrar.
Las dos CLI se instalan hoy en Windows con una sola línea. Casi todos los problemas llegan después de esa línea: una terminal que no encuentra el comando, una directiva de ejecución que bloquea npm, una distribución antigua de WSL 1, un comando pegado en el shell equivocado. Esta guía da los comandos exactos de cada método de instalación, y luego los errores y sus soluciones.
Lo que se dice de las dos CLI viene de la documentación de Anthropic y de OpenAI y de los propios scripts de instalación, leídos el 16 de noviembre de 2026, con Claude Code 2.1.318 y Codex CLI 0.169.0. Las dos herramientas cambian rápido: si un comando de abajo falla, revisa la página oficial enlazada en cada sección.
La respuesta corta. Abre PowerShell, no CMD, y ejecuta:
irm https://claude.ai/install.ps1 | iex
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
Después abre una terminal nueva y ejecuta claude --version y codex --version. Si Windows responde que claude no se reconoce, la corrección del PATH está en la tabla de errores, más abajo.
Lo que necesita cada CLI en Windows
| Claude Code | Codex CLI | |
|---|---|---|
| Versión de Windows | Windows 10 1809 o posterior, Windows Server 2019 o posterior | Windows 11 recomendado, Windows 10 reciente sin garantías («best effort») |
| Procesador | x64 o ARM64, nunca 32 bits | x64 o ARM64 |
| Cuenta | Un plan de pago de Claude o una cuenta de Console | Un plan de ChatGPT o una clave API de OpenAI |
| Node.js | Solo para el método npm, versión 22 o posterior | Solo para el método npm |
| Git for Windows | Opcional | No es necesario |
| Sandbox en Windows nativo | No, solo en WSL 2 | Sí, su propio sandbox de Windows |
| Permisos de administrador para instalar | No | No |
Dos filas de esta tabla sorprenden. Claude Code ya no exige Git for Windows: sin él, usa PowerShell como herramienta de shell. Y Codex aísla sus comandos en un sandbox en Windows nativo, mientras que Claude Code solo lo hace dentro de WSL 2.
Instalar Claude Code en Windows
La página de instalación de Anthropic da cuatro métodos. El instalador nativo es el recomendado: no necesita Node.js y se actualiza solo en segundo plano.
| Método | Comando |
|---|---|
| PowerShell (recomendado) | irm https://claude.ai/install.ps1 | iex |
| CMD | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| WinGet | winget install Anthropic.ClaudeCode |
| npm (Node.js 22+) | npm install -g @anthropic-ai/claude-code@latest |
Lo que deja cada método:
- Instalador nativo:
claude.exeen%USERPROFILE%\.local\bin, las versiones en%USERPROFILE%\.local\share\claude. El instalador te avisa cuando.local\binno está en tu PATH, y no lo añade por ti. - WinGet: sin actualizaciones automáticas. Actualizas con
winget upgrade Anthropic.ClaudeCode, y Anthropic advierte que una actualización puede fallar mientras Claude Code está en marcha, porque Windows bloquea el ejecutable. - npm: con un Node.js anterior a la 22, la instalación termina con un aviso
EBADENGINE.
Para quedarte una versión por detrás de la última, en el canal estable:
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
Luego comprueba la instalación. claude --version muestra la versión, y claude doctor hace un diagnóstico de solo lectura de la instalación y de sus ajustes.
Si tienes Git for Windows, Claude Code busca Git Bash en C:\Program Files\Git, luego en C:\Program Files (x86)\Git, y luego el git de tu PATH. Para forzar otro, define CLAUDE_CODE_GIT_BASH_PATH en el bloque env de tu settings.json. Debe apuntar a un archivo llamado bash.exe o sh.exe, no git-bash.exe.
Instalar Codex CLI en Windows
La página de Windows de OpenAI lo deja claro: usa Codex de forma nativa con su sandbox de Windows por defecto, y elige WSL cuando tus herramientas ya viven en Linux. Una fuente se ha quedado atrás: la página de instalación del repositorio de GitHub todavía dice «Windows 11 via WSL2». La documentación oficial ha cambiado, y el instalador también.
| Método | Comando |
|---|---|
| Instalador de PowerShell | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| npm | npm install -g @openai/codex |
El instalador de PowerShell es el más sencillo. Leer el script muestra lo que hace: instala Codex en %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, añade esa carpeta al PATH de tu usuario y a la sesión actual, y te pide que abras una ventana nueva de PowerShell. Ejecutar el mismo comando otra vez actualiza Codex. Con npm, actualizas ejecutando de nuevo el comando de instalación.
Después inicia sesión. Ejecuta codex y elige Sign in with ChatGPT, o ejecuta codex login. En una máquina sin navegador, codex login --device-auth te da un código para escribir en otro dispositivo. codex login status te dice con qué cuenta has iniciado sesión.
El sandbox de Windows
Codex tiene tres implementaciones de sandbox en Windows:
mxc: la recomendada, sin configuración de administrador. Requiere Windows 11 24H2 (build 26100.9278) o 25H2 (build 26200.9278).elevated: la alternativa preferida. Requiere una configuración única aprobada por un administrador.unelevated: un aislamiento de red más débil, y ninguna ruta de solo lectura.
La elección se hace en config.toml:
[features]
prefer_mxc = true
[windows]
sandbox = "elevated" # or "unelevated"
Si el sandbox falla con el error 1385, Windows ha rechazado el tipo de inicio de sesión de la cuenta del sandbox. En ese caso OpenAI pide CODEX_HOME/.sandbox/sandbox.log. No compartas nunca lo que hay en .sandbox-secrets/.
¿Windows nativo o WSL?
| Nativo (PowerShell, CMD) | WSL 2 | |
|---|---|---|
| Instalar Claude Code | irm https://claude.ai/install.ps1 | iex | curl -fsSL https://claude.ai/install.sh | bash dentro de WSL |
| Instalar Codex | el instalador de PowerShell | curl -fsSL https://chatgpt.com/codex/install.sh | sh dentro de WSL |
| Sandbox de Claude Code | no disponible | disponible, con bubblewrap y socat |
| Sandbox de Codex | el sandbox de Windows | el sandbox de Linux |
| Dónde guardar el repositorio | en cualquier sitio | bajo ~/, no bajo /mnt/c/ |
Elige WSL 2 cuando tu proyecto se compila y se ejecuta en Linux de todos modos, o cuando quieres que Claude Code aísle en un sandbox los comandos que ejecuta. Quédate en nativo cuando tu proyecto es un proyecto de Windows: .NET, scripts de PowerShell, rutas de Windows por todas partes.
Tres reglas si vas por WSL:
- WSL 2, nunca WSL 1. Codex dejó de admitir WSL 1 en la versión 0.115. El sandbox de Claude Code rechaza WSL 1 con
Sandboxing requires WSL2, y las instalaciones en WSL 1 pueden fallar conExec format error. Convierte una distribución conwsl --set-version <DistroName> 2. - Instala y ejecuta dentro de WSL. Ejecuta el comando de Linux en la terminal de WSL, no en la de PowerShell. Ejecutar el Node.js de Windows desde WSL es lo que produce
exec: node: not found: instala Node.js en la propia distribución, con su gestor de paquetes o con nvm. - Guarda el código en el sistema de archivos de Linux. Los dos proveedores te dicen que mantengas el repositorio fuera de
/mnt/c/, y Anthropic señala que las búsquedas de Claude Code ahí son menos completas. Clónalo en tu carpeta personal de Linux.
«claude no se reconoce» y los demás errores
| Lo que ves | Por qué | Solución |
|---|---|---|
'claude' is not recognized as an internal or external command (CMD), The term 'claude' is not recognized (PowerShell) | %USERPROFILE%\.local\bin no está en tu PATH | Añadirlo al PATH del usuario (comandos más abajo) y abrir una terminal nueva |
| Sigue sin reconocerse después de añadirlo | La terminal, o el editor que la contiene, arrancó antes del cambio | Cerrar y volver a abrir la terminal, y el editor si la terminal vive dentro de él |
| No se reconoce justo después de una actualización | Una actualización interrumpida a mitad del cambio no dejó ningún claude.exe | Renombrar el claude.exe.old.* más reciente a claude.exe (comando más abajo) |
'irm' is not recognized | Pegaste la línea de PowerShell en CMD | Abrir PowerShell, o usar la línea de CMD |
The token '&&' is not a valid statement separator | Pegaste la línea de CMD en Windows PowerShell | Usar la línea de PowerShell |
npm.ps1 cannot be loaded because running scripts is disabled on this system | La directiva de ejecución bloquea el lanzador de PowerShell de npm | Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, o llamar a npm.cmd |
| Un error sobre Windows de 32 bits en un PC de 64 bits | Abriste «Windows PowerShell (x86)» desde el menú Inicio | Abrir el PowerShell de 64 bits normal |
claude abre la app de escritorio en lugar de la CLI | Una app de escritorio de Claude antigua dejó un Claude.exe en WindowsApps, por delante de la CLI en el PATH | Actualizar la app de escritorio de Claude |
requires either Git for Windows (for bash) or PowerShell | Claude Code no encontró ninguno de los dos shells | Instalar Git for Windows, o comprobar que PowerShell está en el PATH |
EBADENGINE durante npm install | Node.js es anterior a la 22 | Actualizar Node.js, o usar el instalador nativo |
La corrección del PATH, en PowerShell, para el usuario actual, sin permisos de administrador:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
Para ver dónde busca Windows antes de cambiar nada:
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
where.exe claude
El cambio de nombre tras una actualización rota:
Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe
Sobre la directiva de ejecución: Windows PowerShell 5.1, el que viene con Windows, usa Restricted por defecto en los equipos cliente, y por eso un portátil recién estrenado bloquea npm.ps1. El ámbito CurrentUser no necesita permisos de administrador. El instalador nativo de Claude y el de Codex no se ven afectados: irm | iex y -ExecutionPolicy ByPass nunca cargan un archivo de script desde el disco.
Actualizar y desinstalar
| Claude Code | Codex CLI | |
|---|---|---|
| Actualizar ahora | claude update (nativo), winget upgrade Anthropic.ClaudeCode, o volver a ejecutar la instalación con npm | codex update en las versiones que lo admiten, volver a ejecutar el instalador de PowerShell, o npm install -g @openai/codex |
| Actualizaciones automáticas | solo con la instalación nativa, se desactivan con DISABLE_AUTOUPDATER=1 | no documentadas |
| Desinstalar | borrar %USERPROFILE%\.local\bin\claude.exe y %USERPROFILE%\.local\share\claude, o winget uninstall Anthropic.ClaudeCode, o npm uninstall -g @anthropic-ai/claude-code | borrar la carpeta de instalación, o npm uninstall -g @openai/codex |
| Ajustes que quedan en el disco | %USERPROFILE%\.claude y %USERPROFILE%\.claude.json | %USERPROFILE%\.codex |
Lo que aprendimos ejecutando CLI de agentes en Windows
AgentsRoom lanza Claude Code, Codex y las demás CLI de agentes una al lado de otra, y su versión para Windows nos enseñó dónde se rompen estas instalaciones en cuanto salen de la terminal. Hay cuatro cosas que vale la pena saber aunque nunca uses nuestra app.
Un programa abierto desde el menú Inicio conserva el PATH con el que arrancó. Instalas Claude Code, añades .local\bin al PATH, y una app de escritorio que ya estaba abierta sigue sin encontrar claude. Reiniciar la terminal no basta para las apps que lanzan CLI por ti. AgentsRoom vuelve a leer el PATH del usuario y de la máquina en el registro cuando busca una CLI, para que una instalación que acaba de funcionar no aparezca como ausente.
npm no instala un .exe. npm install -g @openai/codex escribe tres archivos en %APPDATA%\npm: codex, codex.cmd y codex.ps1. Un programa que lanza codex directamente recibe spawn codex ENOENT, porque Windows solo añade .exe a un nombre sin extensión. Tu terminal te lo oculta, ya que PowerShell y CMD leen PATHEXT. Es una razón más para preferir los instaladores nativos, que sí instalan un ejecutable.
Los lanzadores de npm necesitan Node.js al ejecutarse. Si instalas Node.js y después una CLI en la misma sesión, el lanzador .cmd se encuentra pero falla con «node is not recognized» en cualquier programa abierto antes de que Node.js estuviera en el PATH. El mismo síntoma aparece con un gestor de versiones de Node cuyos lanzadores apuntan a una versión que no está activa.
Crear un proceso cuesta mucho más en Windows. Medimos de 20 a 80 ms para crear un proceso en Windows, frente a 1 a 3 ms en macOS, y cada comprobación de archivo cuesta más porque el antivirus la inspecciona. Nuestra primera detección de CLI probaba cada carpeta, cada nombre y cada extensión, y congelaba la app hasta un segundo en Windows. Leer cada carpeta una sola vez lo resolvió.
En la app, el asistente de instalación instala una CLI que falta con el instalador del propio proveedor para tu sistema (irm https://claude.ai/install.ps1 | iex para Claude Code, el script de OpenAI para Codex), recurre a npm cuando el script falla, y lo ejecuta en una terminal que puedes seguir. Cuando una CLI no arranca, CLI Doctor lee el error y el comando exacto, y luego te dice qué se rompió. Cuando las dos CLI responden a --version, la guía de primeros pasos toma el relevo, y el anuncio de la versión para Windows explica lo que hace la app en Windows.
Preguntas frecuentes
¿Cómo instalo Claude Code en Windows?
Abre PowerShell y ejecuta irm https://claude.ai/install.ps1 | iex. En CMD, usa en su lugar la línea install.cmd de la página de instalación de Anthropic, y con WinGet ejecuta winget install Anthropic.ClaudeCode. El binario queda en %USERPROFILE%\.local\bin, que el instalador no añade a tu PATH: añádelo tú si claude no se reconoce, luego abre una terminal nueva y ejecuta claude --version.
¿Necesito WSL para usar Claude Code o Codex en Windows?
No. Los dos funcionan de forma nativa en PowerShell o CMD en Windows 10 y 11. WSL 2 vale la pena cuando tu proyecto ya vive en Linux, o cuando quieres el sandbox de Claude Code, que no funciona en Windows nativo. Usa WSL 2, no WSL 1: Codex dejó de admitir WSL 1 en la versión 0.115.
¿Por qué Windows dice que 'claude' no se reconoce justo después de instalarlo?
El instalador nativo deja claude.exe en %USERPROFILE%\.local\bin y muestra un aviso si esa carpeta no está en tu PATH, pero no modifica el PATH por sí mismo. Añade la carpeta al PATH de tu usuario, luego cierra y vuelve a abrir la terminal, y también el editor si la terminal se ejecuta dentro de él. Una terminal que ya estaba abierta conserva su PATH antiguo.
¿Claude Code necesita Git for Windows?
Ya no. La página de instalación de Anthropic presenta Git for Windows como opcional: sin él, Claude Code usa PowerShell como herramienta de shell. Con él, Claude Code encuentra Git Bash en C:\Program Files\Git, y puedes indicar otro bash.exe con el ajuste CLAUDE_CODE_GIT_BASH_PATH.
¿Puedo instalar Codex CLI en Windows sin Node.js?
Sí. El instalador de PowerShell de OpenAI descarga un Codex independiente, lo coloca en %LOCALAPPDATA%\Programs\OpenAI\Codex\bin y añade esa carpeta al PATH de tu usuario. Solo el método npm, npm install -g @openai/codex, necesita Node.js.
¿PowerShell o CMD para instalarlos?
PowerShell. Los dos comandos oficiales de una línea son comandos de PowerShell, y los errores más frecuentes vienen de pegar una línea de PowerShell en CMD o al revés: 'irm' is not recognized (o «'irm' no se reconoce» en un Windows en español) significa que estás en CMD, y '&&' is not a valid statement separator significa que estás en PowerShell. Usa el PowerShell de 64 bits, no la entrada «Windows PowerShell (x86)» del menú Inicio.
Descargar AgentsRoom
Ejecuta todos tus agentes de IA, en todos tus proyectos, desde una sola ventana.
App complementaria: supervisa tus agentes en movimiento
Usa Claude, Codex, Antigravity CLI u otro proveedor de IA.
Envía bugs y peticiones directamente a tu backlog público.
Agentes que lees como una conversación
Cada agente tiene un rol, una cara y un hilo que lees como una app de mensajería.

Seguir leyendo
Modo de voz en Codex, OpenCode, Antigravity y Claude Code: ¿qué CLI tiene uno?
Revisamos cinco CLI de agentes de código y dos apps el 13 de octubre de 2026. Codex CLI y oh-my-pi mantienen una conversación hablada, Claude Code y Antigravity CLI solo dictan en el prompt, OpenCode no trae nada integrado. Cómo lanzar cada uno, a dónde va el audio y lo que cuesta la voz en tokens.
Leer el artículo¿El Remote Control de Claude Code consume más tokens? ¿Y Codex tiene uno?
Dos preguntas que la gente escribe en Google desde que Anthropic lanzó Remote Control: si pilotar una sesión de Claude Code desde el móvil cuesta más tokens, y si existe un equivalente para Codex. Respuestas cortas: no, un turno es un turno lo escriba donde lo escriba, y sí pero solo existe la mitad. Esto es lo que es realmente Remote Control, cómo medir usted mismo la cuestión de los tokens en cuatro comandos, qué hace hoy codex remote-control, y cómo un control remoto móvil que nunca habla con un proveedor cambia las cuentas.
Leer el artículoCómo quitar Co-Authored-By Claude de tus commits de git
Claude Code firma tus commits con un trailer Co-Authored-By y tus pull requests con una línea Generated with Claude Code. El ajuste que los quita, el archivo donde ponerlo y cómo limpiar los commits que ya subiste.
Leer el artículo