Instalar Claude Code en Windows, Mac y Linux

Para instalar Claude Code, ejecuta en un terminal el comando oficial de Anthropic: curl -fsSL https://claude.ai/install.sh | bash en macOS, Linux y WSL, o irm https://claude.ai/install.ps1 | iex en PowerShell en Windows. Después, compruébalo con claude --version y escribe claude para iniciar sesión. Se necesita una suscripción de pago a Claude o una cuenta de Console: el plan gratuito no incluye Claude Code.
Claude Code se instala con un solo comando en Windows, macOS y Linux, pero los detalles cambian de un sistema a otro: PowerShell o CMD, WSL, Homebrew, repositorios de Linux, PATH que hay que corregir. Esta guía ofrece los comandos oficiales consultados el 18 de noviembre de 2026, cómo comprobar que todo funciona, los errores más comunes y, por último, la conexión con un modelo local mediante Ollama.
#¿Cómo instalar Claude Code? Requisitos previos y comandos oficiales
Claude Code se instala con un único comando oficial: curl -fsSL https://claude.ai/install.sh | bash en macOS, Linux y WSL, o irm https://claude.ai/install.ps1 | iex en PowerShell en Windows. Este script nativo es el método recomendado por Anthropic, porque se actualiza solo en segundo plano.
Claude Code es el agente de programación de Anthropic: un programa que se usa en el terminal, lee el código de un proyecto, modifica archivos y ejecuta comandos con tu aprobación. El programa se instala en tu equipo, pero el modelo de IA se ejecuta en los servidores de Anthropic: según la documentación oficial consultada el 18 de noviembre de 2026, es obligatorio tener conexión a Internet.
| Sistema | Método | Commande | Actualización automática |
|---|---|---|---|
| macOS, Linux, WSL | Script nativo (recomendado) | curl -fsSL https://claude.ai/install.sh | bash | Sí, en segundo plano |
| Windows (PowerShell) | Script nativo (recomendado) | irm https://claude.ai/install.ps1 | iex | Sí, en segundo plano |
| Windows (CMD) | Script nativo | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd | Sí, en segundo plano |
| macOS | Homebrew | brew install --cask claude-code | No de forma predeterminada: brew upgrade claude-code |
| Windows | WinGet | winget install Anthropic.ClaudeCode | No de forma predeterminada: winget upgrade Anthropic.ClaudeCode |
| Debian, Ubuntu, Fedora, RHEL, Alpine | Repositorios apt, dnf y apk firmados | Ver la documentación oficial | No: actualización del sistema |
| Todos (Node.js 22 o superior) | npm | npm install -g @anthropic-ai/claude-code@latest | Según los permisos de la carpeta de npm |
#Requisitos de configuración
Aprovecha nuestra experiencia y un recorrido guiado para elegir las herramientas adecuadas para tu Mac y usar tu IA en el día a día.
- Espacio en línea de por vida
- PDF + archivos
- Reembolsado 30 d
- Sistema
- macOS 13.0 o posterior, Windows 10 1809 o posterior (o Windows Server 2019), Ubuntu 20.04 o posterior, Debian 10 o posterior, Alpine Linux 3.19 o posterior.
- Hardware
- 4 GB de RAM como mínimo y un procesador x64 o ARM64. No se necesita tarjeta gráfica, ya que el modelo Claude se ejecuta de forma remota.
- Compte
- Una suscripción a Claude Pro, Max, Ultra, Team o Enterprise, o una cuenta de Claude Console de pago por uso. El plan gratuito de claude.ai no incluye Claude Code.
- País
- Claude Code solo está disponible desde los países admitidos por Anthropic; Francia es uno de ellos.
En cuanto al precio, la página oficial de Anthropic consultada el 18 de noviembre de 2026 muestra el plan Pro a 20 dólares al mes con facturación mensual, y precisa que Claude Code está incluido en todos los planes de pago, con los mismos límites de uso que el resto de la suscripción. El detalle de los planes y de las alternativas gratuitas se trata en la guía dedicada al precio de Claude Code.
#Instalar Claude Code en Windows: PowerShell, CMD o WSL
En Windows, Claude Code se instala desde PowerShell con irm https://claude.ai/install.ps1 | iex, sin permisos de administrador. Una alternativa es instalarlo en WSL 2, el subsistema de Linux para Windows, con el comando de Linux: es el único modo de Windows en el que se admite el sandbox de comandos.
- 01Abrir PowerShellAbre el menú Inicio, escribe PowerShell y ábrelo normalmente, sin «Ejecutar como administrador». El símbolo del sistema empieza por PS C:\Users\TuNombre>, lo que confirma que estás en PowerShell y no en el símbolo del sistema CMD.
- 02Ejecutar el script de instalaciónPega el comando irm https://claude.ai/install.ps1 | iex y confirma con Intro. El script descarga Claude Code sin mostrar ninguna barra de progreso: espera a que vuelva a aparecer el prompt antes de hacer otra cosa.
- 03Abrir una nueva terminalCierra la ventana de PowerShell y abre una nueva para que se reconozca la carpeta de instalación. El programa se coloca en %USERPROFILE%\.local\bin\claude.exe.
- 04Comprobar la versiónEscribe claude --version. Una instalación correcta muestra un número de versión seguido de (Claude Code). Si Windows responde que claude no se reconoce, aplica la corrección del PATH que se describe más abajo.
- 05Instalar Git for Windows (recomendado)Git for Windows es opcional, pero Anthropic lo recomienda: incluye Git Bash, que Claude Code usa para ejecutar sus comandos. Sin él, Claude Code recurre a PowerShell. Una instalación en WSL no lo necesita.
#Instalar Claude Code en Mac: script nativo o Homebrew
En Mac, Claude Code se instala abriendo la aplicación Terminal y ejecutando curl -fsSL https://claude.ai/install.sh | bash. Se necesita macOS 13.0 o posterior; se admiten tanto los Mac con Apple Silicon (ARM64) como los Mac Intel (x64). Homebrew es una alternativa, pero sin actualización automática.
Homebrew ofrece dos paquetes de Claude Code. El paquete claude-code sigue el canal estable, que suele ir alrededor de una semana por detrás y descarta las versiones con regresiones importantes. El paquete claude-code@latest recibe cada versión en cuanto se publica. De forma predeterminada, la actualización de Homebrew se hace manualmente con brew upgrade claude-code, o con brew upgrade claude-code@latest para el segundo paquete. Para que Claude Code ejecute por sí mismo esta actualización de Homebrew o WinGet, la documentación de Anthropic indica que debes establecer la variable de entorno CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE en 1.
El script nativo coloca el lanzador en ~/.local/bin/claude. Si la Terminal responde «command not found: claude», esa carpeta aún no está en el PATH de tu shell: la solución se indica en la sección dedicada a los errores.
#Instalar Claude Code en Linux: script, apt, dnf o Alpine
En Linux, Claude Code se instala con el mismo script que en Mac: curl -fsSL https://claude.ai/install.sh | bash, sin sudo. Anthropic también publica repositorios firmados apt (Debian, Ubuntu), dnf (Fedora, RHEL) y apk (Alpine) para los equipos en los que el software debe instalarse mediante el gestor de paquetes.
Alpine Linux y las demás distribuciones basadas en musl no incluyen ni bash ni curl de forma predeterminada. Sin ellos, el script de instalación falla con un error «not found». Instala primero esos dos paquetes y vuelve a ejecutar el comando de instalación.
Los repositorios apt, dnf y apk ofrecen cada uno un canal stable y un canal latest. Su configuración requiere varios comandos, entre ellos la verificación de la huella de la clave de firma de Anthropic: síguelos directamente en la página de instalación avanzada de la documentación oficial, enlazada al final de la guía. Estas instalaciones se actualizan con el sistema, por ejemplo sudo apt update && sudo apt upgrade claude-code.
#¿Cómo comprobar que Claude Code está bien instalado?
Para comprobar la instalación de Claude Code, abre una nueva terminal y escribe claude --version: debe aparecer un número de versión. El 18 de noviembre de 2026, la versión más reciente al principio del registro de versiones oficial es la 2.1.327, mientras que el canal estable distribuye la 2.1.311 según el registro de npm. Por tanto, un número más antiguo no es necesariamente un error: el paquete claude-code de Homebrew y los repositorios de Linux configurados de forma predeterminada siguen ese canal estable. Después, el comando claude doctor ofrece un diagnóstico completo.
El comando claude doctor muestra, sin abrir una sesión, el estado de la instalación, los errores en los archivos de ajustes y las advertencias con una corrección sugerida. Es lo primero que debes hacer cuando Claude Code se comporta de forma extraña tras una instalación o una actualización.
- 01Situarse en un proyectoEn el terminal, ve a la carpeta del proyecto en el que quieres trabajar con el comando cd seguido de la ruta de la carpeta. Claude Code trabaja con los archivos de la carpeta desde la que se inicia.
- 02Iniciar Claude CodeEscribe claude. La primera vez que lo ejecutas, Claude Code abre el navegador para que inicies sesión con tu cuenta de Claude (Pro, Max, Ultra, Team, Enterprise) o tu cuenta de Console. Si el navegador muestra un código en lugar de volver a la terminal, pega ese código en la terminal.
- 03Plantear una primera preguntaUna vez que inicies sesión, el prompt de Claude Code muestra la versión, el modelo y la carpeta de trabajo. Pregúntale, por ejemplo, «¿qué hace este proyecto?». Las credenciales quedan guardadas: ya no se te pedirá iniciar sesión en los siguientes arranques.
- 04Preparar el proyectoEscribe /init para que Claude Code analice el código y genere un archivo CLAUDE.md inicial, con los comandos de compilación y de prueba y las convenciones del proyecto. Escribe /help para ver la lista de comandos y /config para los ajustes.
#Actualizar o desinstalar Claude Code
Una instalación nativa de Claude Code se actualiza sola al iniciarse y en segundo plano; el comando claude update aplica de inmediato la última versión. En una instalación nativa en macOS, Linux o WSL, para desinstalar basta con eliminar el lanzador y la carpeta de versiones.
#Claude Code no encontrado o instalación bloqueada: los errores habituales
El error más frecuente tras instalar Claude Code es «command not found: claude» o «'claude' no se reconoce»: el programa está bien instalado, pero su carpeta, ~/.local/bin en Mac y Linux o %USERPROFILE%\.local\bin en Windows, no está en el PATH. El instalador lo indica en sus «Setup notes», pero no corrige el PATH por sí mismo.
| Mensaje mostrado | Causa | Corrección |
|---|---|---|
| command not found: claude / 'claude' is not recognized | Carpeta de instalación no incluida en el PATH | Añadir ~/.local/bin (o %USERPROFILE%\.local\bin) al PATH y luego abrir una nueva terminal |
| The token '&&' is not a valid statement separator | Comando de CMD pegado en PowerShell | Usar el comando de PowerShell |
| 'irm' is not recognized as an internal or external command | Comando de PowerShell pegado en CMD | Usar el comando de CMD |
| curl: (22) The requested URL returned error: 403 | Proxy o filtro de red, o país no compatible | Comprobar la red o el proxy de la empresa |
| Aplicación no disponible en la región | País no admitido por Anthropic | Claude Code no está disponible en este país |
| not found en Alpine | bash ou curl absents | apk add bash curl |
La corrección para zsh se aplica a macOS, cuyo shell predeterminado es zsh. En Linux con bash, la misma línea export se añade al archivo ~/.bashrc; en Mac con bash, va en ~/.bash_profile, porque el Terminal de macOS inicia bash como shell de inicio de sesión, que ignora ~/.bashrc. Un terminal abierto antes de la corrección conserva el PATH antiguo, y un terminal integrado en un editor como VS Code hereda el PATH del editor: cierra y vuelve a abrir la ventana, o el editor, antes de volver a probar claude --version.
#¿Cómo conectar Claude Code a VS Code?
Para usar Claude Code en VS Code, instala la extensión oficial Claude Code de Anthropic: abre la vista Extensiones con Cmd+Shift+X en Mac o Ctrl+Shift+X en Windows y Linux, busca «Claude Code» y haz clic en Instalar. Se necesita VS Code 1.94.0 o posterior y una cuenta de pago de Claude o una cuenta de Console.
La extensión de VS Code de Claude Code incluye su propia copia del programa para su panel de chat, pero no la añade al PATH. Para escribir claude en la terminal integrada de VS Code, sigue siendo necesaria la instalación independiente descrita más arriba. La extensión también se instala en Cursor y en los demás editores derivados de VS Code, a través del registro Open VSX.
#Conectar Claude Code a un modelo local con Ollama
Claude Code puede funcionar con un modelo local gracias a Ollama, que expone una API compatible con la de Anthropic. Una vez instalados Claude Code y Ollama, el comando ollama launch claude inicia Claude Code conectado a Ollama. La documentación de Ollama recomienda un modelo local configurado con un contexto de 64k tokens o más.
La documentación de Ollama también describe una configuración manual mediante variables de entorno, que dirige Claude Code al servidor local de Ollama en el puerto 11434. El ejemplo oficial usa el modelo qwen3.5, cuya etiqueta predeterminada en la biblioteca de Ollama corresponde a la versión 9B, de 6,6 a 7,6 GB; el modelo debe admitir llamadas a herramientas para que Claude Code pueda leer y modificar archivos.
¿Claude Code es gratis?+
¿Se necesita Node.js para instalar Claude Code?+
¿Se necesitan permisos de administrador para instalar Claude Code en Windows?+
¿Cómo instalar un plugin en Claude Code?+
¿Cómo configurar bien Claude Code después de instalarlo?+
¿Claude Code funciona sin conexión?+
¿Cómo actualizar Claude Code?+
#Fuentes y verificación del 18 de noviembre de 2026
Los comandos, requisitos previos, versiones y precios de esta guía se recopilaron el 18 de noviembre de 2026 en la documentación oficial de Claude Code, la página de precios de Anthropic, el registro de versiones del repositorio de GitHub de Anthropic y la documentación de Ollama; los comandos y los precios cambian a menudo, así que verifícalos antes de una instalación en una empresa.
- Fuente: instalación avanzada de Claude Code (Anthropic)
- Fuente: inicio rápido de Claude Code (Anthropic)
- Fuente: solución de problemas de instalación (Anthropic)
- Fuente: extensión de VS Code (Anthropic)
- Fuente: precios de los planes de Claude (Anthropic)
- Fuente: registro de versiones de Claude Code (GitHub, Anthropic)
- Fuente: Claude Code con Ollama (documentación de Ollama)
¿Un comentario, un error, una precisión? Avísanos, eso mejora la guía para todos.