iannov

¿Cómo instalar Claude Code en Windows?

Iannov no está afiliado a Anthropic. Claude y Claude Code son marcas de Anthropic.

En Windows hay dos caminos: la app de escritorio de Claude, que descargas, instalas y abres en la pestaña Code, o la terminal, donde pegas un comando en PowerShell. Si no programas, empieza por la app: ya incluye Claude Code y no escribes comandos. En los dos casos necesitas un plan de pago de Claude.

¿App de escritorio o terminal: cuál me conviene?

Desliza para ver la tabla →

App de escritorioTerminal (PowerShell)
Cómo se veUna app con ventanas, botones y chatUna pantalla de texto donde escribes comandos
InstalaciónDescargas un instalador y lo ejecutasPegas un comando en PowerShell
Ver los cambiosUna vista que te muestra qué cambió y te deja aprobarTodo se lee como texto
Conviene si…No programas y quieres ver lo que pasaYa usas la terminal o quieres el camino de los programadores

Mi recomendación para un dueño de negocio es la app. Puedes instalar la terminal después si algún día la necesitas: las dos usan el mismo motor.

¿Qué necesito antes de instalar?

  • Windows: la documentación pide Windows 10 versión 1809 o posterior y 4 GB de RAM, con conexión a internet.
  • Un plan de pago de Claude (Pro, Max, Ultra, Team o Enterprise). El plan gratuito no incluye Claude Code. Los precios están en la guía de precio de Claude Code.
  • Estar en una región compatible con Anthropic. México está en la lista.

¿Cómo instalo la app de escritorio en Windows?

  1. Descarga el instalador desde la página de descarga de Claude. Hay uno para equipos con procesador x64 (la mayoría) y otro para Windows ARM64.
  2. Ejecuta el instalador y abre Claude desde el menú Inicio.
  3. Inicia sesión con tu cuenta.
  4. Haz clic en la pestaña Code, arriba en la barra lateral.
  5. Elige Open folder… y selecciona una carpeta de prueba. Ahí escribes lo que quieres que haga.

La app incluye Claude Code: no instalas nada más. Si al hacer clic en Code te pide actualizar, es que tu cuenta no tiene un plan de pago.

¿Cómo instalo Claude Code desde PowerShell?

  1. Abre el menú Inicio, escribe «PowerShell» y ábrelo. No hace falta ejecutarlo como administrador. Sabrás que es PowerShell porque la línea empieza con PS C:\.
  2. Pega este comando y presiona Enter:
    irm https://claude.ai/install.ps1 | iex
  3. Espera. El instalador no muestra avance mientras descarga, así que parece que no pasa nada. Cuando termine, cierra la ventana y abre una nueva.
  4. Escribe claude --version. Si aparece un número de versión, quedó instalado.
  5. Abre la terminal en la carpeta de tu proyecto, escribe claude y sigue las instrucciones del navegador para iniciar sesión.

También existe winget install Anthropic.ClaudeCode si usas winget. Ese método no se actualiza solo. Git for Windows es opcional, pero Anthropic lo recomienda: sin él, Claude Code ejecuta los comandos con PowerShell en vez de Bash.

Los comandos cambian con el tiempo. Copia siempre el vigente de la documentación oficial de instalación.

¿Qué errores son comunes y qué significan?

«'claude' is not recognized» o «command not found»

La instalación terminó, pero Windows aún no sabe dónde está el programa. Cierra la terminal, abre una nueva y prueba claude --version. Si sigue igual, la documentación tiene una sección para corregir el PATH.

«The token '&&' is not a valid statement separator»

Pegaste el comando de CMD en PowerShell. Fíjate en el inicio de la línea: con PS estás en PowerShell y necesitas el comando de PowerShell.

«'irm' is not recognized as an internal or external command»

Es lo contrario: pegaste el comando de PowerShell en CMD. Abre PowerShell y pégalo ahí.

Pide actualizar cuando hago clic en Code

Tu cuenta no tiene plan de pago. Suscríbete a uno y vuelve a abrir la pestaña.

Error 403 al instalar o al abrir Code

Un 403 al instalar suele ser un proxy o filtro de red que bloquea la descarga, o que Claude Code no está disponible en tu región. Al abrir Code suele ser un problema de inicio de sesión. Anthropic tiene una página que une cada mensaje con su solución: solución de problemas de instalación.

¿Qué le escribo la primera vez?

Algo pequeño, en una carpeta de prueba, y pidiendo el plan antes de que cambie nada. Por ejemplo:

Haz una página sencilla para mi negocio con el nombre, los horarios y un botón de WhatsApp. Antes de crear archivos, dime qué vas a hacer.

Si quieres ensayar antes con alguien que te corrige, el ejercicio «Tu primer encargo» hace justo esto en un simulador. Más contexto en qué es Claude Code.