Requisitos de Claude Code: Mac, Windows y Linux (2026)

Aviso antes de seguir leyendo: esta guía trata sobre Claude Code, la herramienta de codificación CLI basada en terminal de Anthropic. No trata sobre la app Electron de Claude Desktop (eso es claude-desktop-system-requirements), ni es un plugin de Cursor o una extensión de VS Code. Varias de las guías mejor posicionadas para esta consulta se equivocan en esto. Si llegaste aquí esperando la app de chat o una integración con el IDE, la guía de Claude Desktop de arriba y la app de navegador claude.ai son probablemente lo que buscas.

Uso Claude Code como mi interfaz principal de codificación cada día laborable: en una máquina de desarrollo Windows, una estación Threadripper llamada hopper que aloja los LLM más grandes mediante un puente local con LM Studio, y un puñado de equipos de clientes. El listón hardware para Claude Code en sí es bajo (el modelo corre en la nube de Anthropic, no en tu máquina), así que el coste real de una instalación de Claude Code cae en otro sitio: elección de ruta de instalación, versión de Node, compatibilidad de terminal, política de red y la sobrecarga de orquestación cuando Claude Code ejecuta media docena de subagentes en paralelo contra tu codebase. Esta guía cubre todo eso desde la perspectiva de alguien que vive en la CLI a diario.

Qué es Claude Code (y qué no es)

Claude Code es una interfaz de línea de comandos (CLI: una herramienta que ejecutas en una terminal, sin ventana gráfica propia) que envuelve la API de Anthropic y añade un bucle agéntico por encima. Ejecutas claude en un directorio de proyecto. Claude lee tus archivos, planifica un cambio, lo ejecuta, lanza los tests e itera. El modelo en sí —Sonnet 4 por defecto, Opus para razonamiento pesado (Opus 4.8 en el momento de escribir esto, pero Anthropic publica versiones nuevas cada pocas semanas, así que comprueba el banner que se imprime al lanzar claude)— corre en los servidores de Anthropic. El trabajo de tu máquina es alojar el proceso del CLI, ejecutar las herramientas de desarrollo a las que Claude llama y streamar tokens de ida y vuelta.

El tutorial para principiantes de Tech With Tim lo expone sin rodeos: "Claude Code no es una aplicación de escritorio. De hecho se ejecuta directamente dentro de tu shell o tu terminal." El artículo no ha envejecido porque la confusión no ha desaparecido: los principiantes siguen llegando a las búsquedas de Claude Code esperando el cliente de chat Electron y rebotan cuando encuentran una CLI.

Tres cosas que Claude Code NO es, porque el SERP está ahora mismo lleno de artículos que se equivocan en esto:

1. No es la app de Claude Desktop. Claude Desktop es el cliente de chat Electron. Tiene ventana, panel lateral e interfaz de Connectors para servidores MCP. Claude Code no tiene nada de eso. Son productos distintos con requisitos distintos.
2. No es un plugin de IDE. Claude Code no se instala dentro de Cursor, Windsurf o VS Code como una extensión en la forma en que lo hacen las propias funciones de IA de esos IDE. Se ejecuta junto a tu editor en un panel de terminal. La extensión de Anthropic para VS Code / Cursor que puedes instalar desde el marketplace muestra la interfaz de terminal de Claude Code dentro del editor: el CLI subyacente es el mismo.
3. No es un LLM local. Claude Code no ejecuta un modelo en tu hardware. No hay requisito de GPU. No necesitas una 3090 ni una 4090. Si has visto lo contrario, ese artículo probablemente pensaba en un ejecutor de LLM local como Ollama o LM Studio: categoría de herramienta completamente distinta.

La advertencia honesta: Anthropic sí publica una extensión de VS Code que muestra Claude Code dentro del editor, y Cursor tiene integración nativa con los modelos de Claude para su propio agente. Ambas existen. Ninguna es Claude Code en sí mismo: el CLI es el sustrato; esas son superficies por encima.

Requisitos oficiales (la especificación publicada por Anthropic)

De la documentación de Anthropic a junio de 2026:

Tras la instalación, claude --version debería devolver algo como:

2.1.167 (Claude Code)

Los instaladores nativos (el script de instalación por curl en Mac y Linux, el comando irm de PowerShell en Windows) empaquetan el runtime. La ruta alternativa de npm (npm install -g @anthropic-ai/claude-code) necesita Node.js preinstalado y añade los fallos de instalación más comunes: más sobre esto abajo.

Merece la pena saberlo de entrada: a partir de 2026, Anthropic ha reclasificado las rutas de instalación por homebrew y npm como rutas legacy y dirige las nuevas instalaciones a los instaladores nativos. El recorrido de configuración de 2026 de Leon van Zyl lo capta directamente: "estas instalaciones nativas son las recomendadas." Los artículos que siguen liderando con npm install -g son sobre todo contenido previo a 2026 que no se ha actualizado.

Lo que necesitas

El mínimo de 4 GB de RAM de Anthropic es técnicamente cierto y operativamente engañoso. La propia huella de Claude Code es pequeña. El proceso del CLI mantiene el contexto de tu conversación en memoria y streamea tokens hacia y desde la API. La presión de memoria viene de lo que Claude Code hace en tu nombre.

La mayoría de los equipos con los que hablo subestiman esto por un factor de 4. Claude Code orquesta subagentes que lanzan procesos en paralelo contra tu codebase. Ejecuta tu suite de tests. Arranca un servidor de desarrollo. Levanta un contenedor Docker para un test de integración. Abre un navegador para comprobaciones end-to-end. Para cuando un plan agéntico de cinco pasos está a medias de ejecución tienes el CLI más varios procesos lanzados más tu sesión de editor existente más las herramientas de desarrollo compitiendo por la RAM.

Un cuadro realista:

• 8 GB de RAM mueven Claude Code bien para proyectos pequeños (una app Next.js, una herramienta CLI, un servicio Go pequeño) cuando Claude hace una sola cosa a la vez.
• 16 GB de RAM son el suelo para desarrollo en serio. Claude Code más VS Code más un servidor de desarrollo corriendo más el ejecutor de tests más un contenedor Docker se sitúan en torno a 10-12 GB usados.
• 32 GB de RAM es lo que recomendaría si ejecutas Claude Code contra un monorepo grande o con varios subagentes trabajando en paralelo en work-trees.

Merece la pena conocer un hilo de Reddit r/ClaudeCode titulado "Why does running Claude Code often use 20-40GB of RAM?": la respuesta en los comentarios resultó ser un hook de audio personalizado mal comportado que el usuario había enganchado al ciclo de finalización del agente, no Claude Code en sí. El proceso del CLI en reposo mantiene el contexto de tu conversación en memoria y por lo demás se mantiene modesto. Si ves 20 GB+ en el Administrador de tareas, mira tus hooks antes de culpar al CLI.

GPU: no hace falta. No hay inferencia local. Tu dGPU está en reposo mientras Claude Code se ejecuta, salvo que tus herramientas de desarrollo (paso a través de GPU para Docker, trabajos de entrenamiento de ML, tests 3D basados en navegador) la usen. La pregunta de "¿necesito una 3090?" que aparece en Reddit confunde Claude Code con el alojamiento de LLM local; son problemas distintos.

Disco: 200 MB para el CLI es preciso. La ruta alternativa de npm tira de Node y un pequeño grafo de dependencias, llevando la instalación a unos 500 MB-1 GB. La presión real de disco viene de que Claude Code crea ramas en work-trees cuando los subagentes se ejecutan en paralelo: cada subagente obtiene un directorio de trabajo clonado. Un monorepo con cinco subagentes en paralelo necesita cinco copias de tu repo en disco durante la sesión.

CPU: Claude Code es ligero de CPU en reposo y con ráfagas de CPU cuando los subagentes se lanzan. Cualquier Intel de 8.ª generación o M1 de Apple Silicon o equivalente es suficiente.

La documentación de Anthropic es técnicamente correcta en el mínimo de "4 GB de RAM, 200 MB de disco" para el CLI solo. Simplemente deja de ser cierto en el momento en que Claude Code hace algo útil con ello.

Ruta de instalación en cada SO

macOS

El instalador nativo es ahora la ruta canónica:

curl -fsSL https://claude.ai/install.sh | bash
claude --version

La salida de una instalación correcta se parece a:

Downloading Claude Code installer...
Detected: macOS 14.5 (Apple Silicon)
Installing to ~/.local/bin/claude...
Adding to PATH in ~/.zshrc...
Done. Restart your shell or run: source ~/.zshrc

El script instala un binario nativo, configura tu PATH y registra el auto-actualizador. No necesita Node.js. La ruta legacy de Homebrew (brew install anthropic/tap/claude-code) sigue funcionando, pero Anthropic ahora la marca como alternativa más que como recomendación principal.

Tras la instalación, ejecuta claude desde cualquier directorio de proyecto. La primera ejecución pide autenticación. Ver la sección siguiente.

Windows

Dos rutas válidas según tu terminal:

Windows nativo (PowerShell 7+):

irm https://claude.ai/install.ps1 | iex
claude --version

Salida de instalación correcta:

Downloading Claude Code installer...
Detected: Windows 11 (x64)
Installing to %USERPROFILE%\.local\bin\claude.exe...
Adding to PATH...
Done. Open a new PowerShell window.

WSL2 / Ubuntu bajo Windows: usa el comando curl de Mac/Linux de arriba. Dentro de WSL, Claude Code se comporta igual que en Linux nativo.

Muchos desarrolladores de Windows prefieren la ruta WSL porque las operaciones agénticas del sistema de archivos se comportan de forma más predecible contra un sistema de archivos Linux que contra rutas de Windows con espacios. Ambas rutas son viables; ninguna es más rápida. Elige la que coincida con tu shell de desarrollo existente.

Un truco real de Windows que merece la pena señalar, del recorrido de Tech With Tim: cuando el propio Claude Code intenta instalar una dependencia (Git, en su caso), PowerShell a menudo se niega con un error de permisos y tienes que cerrar, hacer clic derecho en el icono de PowerShell y "Ejecutar como administrador" antes de que el siguiente intento funcione. La documentación de instalación pasa esto por alto. La solución no tiene glamour: si ves un error de permisos a los 30 segundos, relanza el shell como admin y reintenta; tu sesión de Claude Code se reanuda bien.

Si estás en Windows gestionado por corporación: el instalador nativo a veces falla silenciosamente porque la política de grupo bloquea el editor. Pide a IT que ponga en lista blanca el certificado de editor de Anthropic, o usa la ruta alternativa de npm dentro de WSL.

Linux

curl -fsSL https://claude.ai/install.sh | bash
claude --version

Salida de instalación correcta:

Downloading Claude Code installer...
Detected: Ubuntu 22.04 LTS (x64)
Installing to ~/.local/bin/claude...
Adding to PATH in ~/.bashrc...
Done. Restart your shell or run: source ~/.bashrc

El script soporta Ubuntu, Debian, RHEL, Fedora y la mayoría de derivadas. Si estás en una distro de soporte a largo plazo que trae un Node más antiguo (Ubuntu 20.04 trae Node 12), el instalador nativo gestiona su propio runtime: no necesitas instalar Node primero para esta ruta.

La ruta alternativa de npm funciona en cualquier distro que tenga Node 18+ instalado. Si necesitas específicamente la ruta de npm (p. ej., quieres versiones fijas o estás dentro de un contenedor restringido sin curl), instala Node desde NodeSource primero:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install nodejs
npm install -g @anthropic-ai/claude-code

ripgrep es una dependencia en tiempo de ejecución que Claude Code usa para la búsqueda rápida en el codebase. La mayoría de distros la tienen como ripgrep en el gestor de paquetes.

Autenticación: claude login

Tras la instalación, la primera invocación de claude dispara OAuth. Claude Code abre un navegador, te inicia sesión en tu cuenta de Anthropic Console y almacena un token en ~/.claude/credentials.json.

claude login

El primer arranque abre tu navegador, te guía por el inicio de sesión de Anthropic y almacena el token. Una vez te has identificado con éxito:

Authentication successful.
Logged in as: you@yourcompany.com (Pro plan)
Token stored at: ~/.claude/credentials.json

La documentación oficial de configuración de Anthropic lleva el paso a paso canónico si algo ha cambiado desde este artículo.

Dos recorridos de 2026 que crucé enmarcan la elección de autenticación de la misma forma: las suscripciones Claude Pro / Max / Teams / Enterprise y las claves API de pago por uso ambas funcionan, y la contrapartida es real. Las suscripciones limitan tu gasto (los límites de tasa se reinician cada pocas horas; no puedes rebasar tu límite mensual): como dice Leon van Zyl, "nunca superarás tu cuota mensual de suscripción." Las claves API son de pago por uso y sin límite: la advertencia plana de Leon es que "estos costes de API pueden volverse muy caros muy rápido."

Si ejecutas Claude Code con un presupuesto de proyecto personal, toma la suscripción. Si lo ejecutas dentro de una organización con seguimiento de costes medido, la clave API te da una factura por token más limpia. La Anthropic Console requiere una recarga mínima de 5 $ si tomas la ruta de clave API.

Tres trampas comunes:

1. Proxies corporativos. Si tu red bloquea las conexiones salientes a console.anthropic.com, el flujo de OAuth se atasca. Configura las variables de entorno HTTPS_PROXY y HTTP_PROXY antes de ejecutar claude login, o usa una clave API directamente (export ANTHROPIC_API_KEY=sk-ant-...).
2. Cuentas de Claude.ai en el tier gratuito. Las cuentas del tier gratuito sirven para la app de chat pero no para la ruta de API del CLI. Añade un método de pago a tu workspace de Console o elige una suscripción de pago antes de preguntarte por qué claude sigue devolviendo 401.
3. Estado de OAuth por usuario. Claude Code almacena su token por usuario. Si haces sudo claude, eres un usuario distinto sin token. Ejecuta claude login como el usuario que ejecutará el CLI.

Si quieres saltarte OAuth por completo y usar una clave API, exporta ANTHROPIC_API_KEY en tu perfil de shell. El CLI comprueba la variable de entorno antes de disparar el flujo del navegador.

claude doctor: la herramienta de diagnóstico

Cuando Claude Code arranca, ejecuta comprobaciones ligeras de inmediato y muestra cualquier problema no resuelto en el banner de bienvenida. La línea de estado te pide que ejecutes el diagnóstico completo. Aquí va una sesión real —esta guía se escribió desde dentro del propio Claude Code— mostrando el patrón en acción:

La línea 1 setup issue: MCP · /doctor es la superficie; claude doctor es la profundidad.

claude doctor

Ejecutar /doctor (o claude doctor desde la línea de comandos) imprime el diagnóstico real en línea dentro de tu sesión:

claude doctor recorre la instalación: versión de Node, presencia de ripgrep, acceso de red a la API, estado de autenticación, integridad del archivo de configuración. La salida marca exactamente qué está roto. La mayoría de problemas de instalación que veo en foros comunitarios —"claude command not found", "auth keeps failing", "agent never completes"— los diagnostica claude doctor con un solo comando.

Merece la pena señalarlo: los tutoriales de Claude Code más populares de 2026 no demuestran este comando en absoluto. Tres vídeos con una audiencia combinada de más de un millón de espectadores y ninguno ejecuta claude doctor en pantalla. El diagnóstico existe, la documentación de Anthropic lo cubre, y es la herramienta de primera línea más útil cuando algo va mal. Que los tutoriales se lo salten es en sí mismo un modo de fallo que merece la pena apuntar. Lee la salida del doctor antes de leer el hilo de Reddit.

Dónde falla la configuración

He recorrido suficientes instalaciones de Claude Code para tener una opinión firme sobre qué se rompe. Cuatro modos de fallo, en orden de frecuencia.

1. PATH no configurado tras la instalación. Los instaladores nativos registran Claude Code en el PATH para shells nuevos, no para el shell en el que ejecutaste la instalación. Abre una sesión nueva de terminal o ejecuta source ~/.zshrc (o tu equivalente) antes de probar claude --version. El error de "command not found" 30 segundos después de una instalación correcta es casi siempre esto.

2. Versión de Node demasiado antigua al usar la ruta alternativa de npm. El paquete npm requiere Node 18 como mínimo. Las distros de soporte a largo plazo (Ubuntu 20.04, RHEL 8) traen Node 12 o 14. El comando de instalación parece tener éxito pero claude no arranca con un error críptico de Node. La solución no tiene glamour: instala un Node más moderno vía NodeSource o nvm antes de la instalación por npm, no después. La ruta del instalador nativo evita esto por completo.

3. PowerShell se niega a instalar dependencias. El tutorial de Tim lo sufrió en directo: cuando Claude Code pidió a PowerShell que instalara Git, el shell lanzó un error de permisos. La solución es relanzar PowerShell como administrador —clic derecho, "Ejecutar como administrador"— y reintentar. El estado de tu conversación de Claude Code sobrevive al reinicio del shell.

Hay también una versión menos obvia de esto: si tu máquina entra en suspensión a mitad de sesión o si has cambiado de red (p. ej., cambiado de VPN), Claude Code puede perder su keep-alive contra la API. La recuperación normalmente es simplemente reescribir tu prompt; si el agente no responde nunca, sal con /exit y relanza claude. Tu historial de conversación se pierde pero tus archivos de proyecto están intactos.

4. Estado de autenticación perdido entre sesiones. Claude Code almacena su token de OAuth en ~/.claude/credentials.json. Si ejecutas Claude Code como un usuario distinto (sudo, un runner de CI, un perfil de shell distinto), el token no está ahí. El agente falla silenciosamente al autenticarse y se comporta como si nunca te hubieras identificado. Ejecuta claude login como el usuario que ejecutará el CLI. Si ejecutas en CI, usa una clave API en una variable de entorno, no OAuth.

El quinto que merece la pena mencionar: firewalls corporativos que bloquean el HTTPS saliente a api.anthropic.com o que hacen un man-in-the-middle de la conexión TLS con un certificado corporativo. Ambos producen errores confusos. Si estás en una máquina gestionada y nada más funciona, probablemente es esto. Consúltalo con tu equipo de IT.

Un checklist práctico de los primeros diez minutos tras la instalación

Una vez que claude --version devuelve algo sensato, recorre esto. Cada ítem es algo que los vídeos de practicantes de 2026 señalan como tropiezo de principiante.

1. Ejecuta claude doctor. Confirma la versión de Node, la presencia de ripgrep, el acceso de red a la API, el estado de autenticación y la integridad de la configuración. Casi todo problema de instalación antes de que te cueste un hilo de Reddit.
2. Ejecuta /terminal-setup dentro de claude. Tal cual viene, Enter envía el prompt y no hay forma de añadir un salto de línea a mitad del mensaje. /terminal-setup configura shift+Enter como salto de línea. El recorrido de configuración de Leon van Zyl señala esto como el primer tropiezo de los diez minutos con el que se topa la mayoría.
3. Comprueba /context. Muestra tu uso de tokens del presupuesto de 200.000 tokens por conversación. Te sorprenderá lo rápido que una sesión agéntica larga lo quema. Usa /clear entre tareas no relacionadas en lugar de dejar que Claude Code auto-compacte.
4. Decide tu modelo con /model. Sea cual sea el Opus insignia actual de Anthropic cuando leas esto (Opus 4.8 en el momento de escribir esto —visible en el banner de arranque de cualquier sesión de Claude Code en ejecución—). Sonnet 4 para uso diario, Haiku para tareas cortas y baratas. No dejes Opus puesto para todo; el coste se acumula.

1. Cuida la carpeta .claude. Claude Code escribe estado por proyecto en .claude/ de tu directorio de trabajo en el momento en que empieza a editar archivos. Añade .claude/credentials.json a tu gitignore de proyecto si aparece ahí. El archivo .claude/settings.json (permisos por proyecto) sí se puede commitear.

Más allá del checklist, la referencia completa de comandos slash está a una pulsación: teclea /help desde cualquier sesión de Claude Code y la lista completa de comandos se desplaza:

De qué no trata este artículo

Si estás configurando la app Electron de Claude Desktop, ver claude-desktop-system-requirements. Si quieres una guía de servidores MCP que extienden Claude Code, ver los mejores MCPs para Claude Code. Si quieres el recorrido de hooks y subagentes, ver la guía de hooks de Claude Code.

Si buscaste "Claude Code" esperando una función de IA nativa del IDE, el agente integrado de Cursor o el modo de codificación de la app de Claude Desktop de Anthropic son las entradas más fáciles para usuarios no-CLI.

Por dónde seguir

Deja la instalación limpia, ejecuta claude doctor, elige tu modelo y habrás terminado con la fase de configuración. Las partes interesantes de Claude Code —subagentes, hooks, skills, el branching en work-trees que hace posibles los flujos de trabajo agénticos en paralelo— asumen todas que el CLI está instalado limpiamente y la autenticación funciona. Los tutoriales que cubren esas funciones asumen esta base.

Merece la pena dejarlo bien primero.