Principiante 14 minIDE

Instalar Claude Code en Windows, Mac y Linux

Un portátil abierto ilumina con luz verde un escritorio oscuro.
Respuesta directa

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.

Por Mohamed Meguedmi·Actualización 2026-11-20·Probado en Windows 11

#¿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.

Métodos de instalación de Claude Code según el sistema (documentación de Anthropic, 18 de noviembre de 2026)
SistemaMétodoCommandeActualización automática
macOS, Linux, WSLScript nativo (recomendado)curl -fsSL https://claude.ai/install.sh | bashSí, en segundo plano
Windows (PowerShell)Script nativo (recomendado)irm https://claude.ai/install.ps1 | iexSí, en segundo plano
Windows (CMD)Script nativocurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdSí, en segundo plano
macOSHomebrewbrew install --cask claude-codeNo de forma predeterminada: brew upgrade claude-code
WindowsWinGetwinget install Anthropic.ClaudeCodeNo de forma predeterminada: winget upgrade Anthropic.ClaudeCode
Debian, Ubuntu, Fedora, RHEL, AlpineRepositorios apt, dnf y apk firmadosVer la documentación oficialNo: actualización del sistema
Todos (Node.js 22 o superior)npmnpm install -g @anthropic-ai/claude-code@latestSegún los permisos de la carpeta de npm

#Requisitos de configuración

El kit completo para aprovechar la IA local en tu Mac.

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.

  1. 01
    Abrir PowerShell
    Abre 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.
  2. 02
    Ejecutar el script de instalación
    Pega 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.
  3. 03
    Abrir una nueva terminal
    Cierra 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.
  4. 04
    Comprobar la versión
    Escribe 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.
  5. 05
    Instalar 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.
Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows (WinGet)
winget install Anthropic.ClaudeCode
→
¿WSL 2 o Windows nativo?
Elige Windows nativo para proyectos y herramientas de Windows. Elige WSL 2 si tus proyectos usan herramientas de Linux o si quieres el sandbox de comandos, que la documentación de Anthropic no admite en Windows nativo ni en WSL 1. En WSL, instala y ejecuta claude desde la terminal de WSL, no desde PowerShell.

#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.

macOS (Terminal, script nativo)
curl -fsSL https://claude.ai/install.sh | bash
macOS (Homebrew)
brew install --cask claude-code

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.

Linux (Ubuntu, Debian, Fedora…)
curl -fsSL https://claude.ai/install.sh | bash

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.

Linux (Alpine)
apk add bash curl

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.

!
Instalación con npm: nunca con sudo
El método npm requiere Node.js 22 o superior. La documentación de Anthropic desaconseja expresamente sudo npm install -g, que provoca problemas de permisos y riesgos de seguridad, y aclara que una instalación que necesita sudo no puede actualizarse sola. El script nativo evita este problema.
macOS, Linux, Windows (npm, Node.js 22+)
npm install -g @anthropic-ai/claude-code@latest

#¿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.

macOS, Linux, Windows
claude --version
claude doctor

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.

  1. 01
    Situarse en un proyecto
    En 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.
  2. 02
    Iniciar Claude Code
    Escribe 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.
  3. 03
    Plantear una primera pregunta
    Una 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.
  4. 04
    Preparar el proyecto
    Escribe /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.

macOS, Linux, WSL (desinstalación nativa)
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

#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.

Errores de instalación de Claude Code y sus soluciones (guía de solución de problemas de Anthropic, 18 de noviembre de 2026)
Mensaje mostradoCausaCorrección
command not found: claude / 'claude' is not recognizedCarpeta de instalación no incluida en el PATHAñadir ~/.local/bin (o %USERPROFILE%\.local\bin) al PATH y luego abrir una nueva terminal
The token '&&' is not a valid statement separatorComando de CMD pegado en PowerShellUsar el comando de PowerShell
'irm' is not recognized as an internal or external commandComando de PowerShell pegado en CMDUsar el comando de CMD
curl: (22) The requested URL returned error: 403Proxy o filtro de red, o país no compatibleComprobar la red o el proxy de la empresa
Aplicación no disponible en la regiónPaís no admitido por AnthropicClaude Code no está disponible en este país
not found en Alpinebash ou curl absentsapk add bash curl
macOS (zsh): añadir ~/.local/bin al PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Windows (PowerShell): añadir la carpeta al PATH del usuario
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

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.

i
Sin terminal: la aplicación de escritorio
La documentación de Anthropic también ofrece la aplicación de escritorio de Claude para usar Claude Code sin terminal, en macOS, Windows y Linux (versión beta en Linux). Requiere el mismo inicio de sesión con una cuenta de pago de Claude.

#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.

macOS, Linux, Windows (con Ollama instalado)
ollama launch claude

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.

macOS, Linux (Bash o Zsh)
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3.5
!
Configuración no admitida por Anthropic
La documentación de Claude Code indica que Anthropic no ofrece soporte para usar Claude Code con modelos distintos de Claude a través de una pasarela. La conexión con Ollama funciona según la documentación de Ollama, pero cualquier problema corresponde a Ollama, no al soporte de Anthropic. La calidad depende en gran medida del modelo local y de la memoria disponible.
Preguntas frecuentes
¿Claude Code es gratis?+
El programa Claude Code se instala gratis, pero usarlo con los modelos Claude requiere una suscripción de pago (Pro, Max, Ultra, Team, Enterprise) o una cuenta de Console de pago por uso. Según la documentación de Anthropic consultada el 18 de noviembre de 2026, el plan gratuito de claude.ai no incluye Claude Code. La conexión a un modelo local mediante Ollama sustituye los modelos Claude por un modelo de tu equipo, fuera del soporte de Anthropic.
¿Se necesita Node.js para instalar Claude Code?+
No, Node.js ya no es necesario para instalar Claude Code con el script nativo, Homebrew, WinGet o los repositorios de Linux. Solo el método npm requiere Node.js 22 o posterior, y la documentación precisa que el programa instalado es un binario nativo que no usa Node.js en tiempo de ejecución. El script nativo sigue siendo el método recomendado.
¿Se necesitan permisos de administrador para instalar Claude Code en Windows?+
No. La documentación de Anthropic indica que el comando de instalación de Claude Code se ejecuta desde PowerShell o CMD sin abrir la terminal como administrador. El programa se instala en la carpeta del usuario, en %USERPROFILE%\.local\bin.
¿Cómo instalar un plugin en Claude Code?+
En una sesión de Claude Code, el comando /plugin abre un panel que muestra los plugins de los catálogos configurados, y /plugin install seguido del nombre y del catálogo, por ejemplo commit-commands@claude-plugins-official, abre la ficha del plugin antes de instalarlo. La documentación de Anthropic recuerda que un plugin puede ejecutar hooks y servidores MCP: lee su ficha antes de instalarlo.
¿Cómo configurar bien Claude Code después de instalarlo?+
Después de instalar Claude Code, ejecuta /init en tu proyecto para generar un archivo CLAUDE.md que describe los comandos de compilación, de pruebas y las convenciones. La configuración se modifica con /config o en el archivo ~/.claude/settings.json. El comando claude doctor señala los archivos de configuración no válidos y los problemas de instalación.
¿Claude Code funciona sin conexión?+
No. La documentación de Anthropic indica que se necesita una conexión a Internet para usar Claude Code, porque los modelos Claude se ejecutan en los servidores de Anthropic. Con Ollama y un modelo local, las solicitudes al modelo se quedan en tu equipo, pero la documentación de Anthropic no describe un funcionamiento totalmente sin conexión: considera este punto como no garantizado.
¿Cómo actualizar Claude Code?+
Una instalación nativa de Claude Code se actualiza sola, al iniciarse y en segundo plano, y claude update fuerza la actualización inmediata. De forma predeterminada, las instalaciones con Homebrew, WinGet, apt, dnf y apk no se actualizan solas: usa brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode o la actualización del sistema Linux. Para Homebrew y WinGet, la variable CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 deja esta actualización en manos de 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.

¿Esta guía te ha ayudado?

¿Un comentario, un error, una precisión? Avísanos, eso mejora la guía para todos.