Skip to content

Instalar Claude Code: listo en 10 minutos ​

En la lección anterior elegiste tu línea principal entre cuatro herramientas; en esta lección, en 10 minutos, completas tres tareas: instalar, verificar e iniciar sesión en Claude Code, llevando la herramienta al estado de «funcional». Esta página sigue la ruta de instalación nativa recomendada oficialmente, un solo comando, con actualización automática en segundo plano tras la instalación; los métodos alternativos como npm, Homebrew o WinGet se dejan para la próxima lección y no se tratan aquí.

No importa si nunca has usado una terminal: la guía oficial incluye instrucciones específicas para principiantes de terminal, y la primera frase dice «incluso si nunca has usado una terminal, puedes usar Claude Code». Esta lección empieza desde «dónde está la terminal y cómo abrirla». (Verificación de datos: 2026-11-04; los comandos y políticas se actualizan, prevalece la página oficial.)

Qué podrás hacer al terminar ​

  • En macOS, Linux/WSL o Windows, completar la instalación de Claude Code con un solo comando oficial
  • Usar claude --version para mostrar el número de versión y confirmar que el comando está instalado y que el sistema puede encontrarlo
  • Distinguir las dos rutas de inicio de sesión, la suscripción de Claude y la cuenta de Console, y completar el primer inicio de sesión (se inicia sesión una vez y las credenciales se guardan)
  • Iniciar Claude Code en el directorio del proyecto, hacer tu primera pregunta y ver con tus propios ojos cómo lee archivos y da respuestas
  • Cuando encuentres errores como command not found o un montón de HTML, saber en qué página buscar en 60 segundos

Tu situación actual ​

  • Buscas «tutorial de instalación de Claude Code»: uno dice que se instala con npm, otro con brew, y otros piden instalar antes un montón de dependencias; no sabes a cuál hacer caso y temes desordenar tu sistema
  • Nunca has usado una terminal: no sabes dónde está ni cómo abrirla; tras pegar el comando «no pasa nada», y no distingues si está descargando o si ya se rompió
  • Los comandos de Mac y Windows son distintos, y en Windows PowerShell y CMD son dos cosas diferentes; copias mal un comando, el error es incomprensible y te quedas atascado en el primer paso

Cuándo usar este método ​

Cuando necesitas:

  • Seguir la ruta de instalación nativa recomendada oficialmente e instalar, verificar e iniciar sesión en Claude Code de una sola vez
  • Mantener automáticamente la versión más reciente tras la instalación, sin querer actualizar manualmente cada mes
  • Empezar desde «cómo abrir la terminal», completando paso a paso incluso sin conocimientos previos

Y no quieres:

  • Perderte entre un montón de métodos de instalación como npm, Homebrew o WinGet; los métodos alternativos se explican todos en la próxima lección
  • Descubrir a mitad de la instalación que la versión del sistema, las políticas regionales o el tipo de cuenta no pasan el filtro
  • Buscar desesperadamente por todas partes tras un error, convirtiendo un problema pequeño de PATH que se resuelve en 30 segundos en un problema grande

🎒 Preparativos antes de empezar ​

  • Haber leído la lección anterior Cómo elegir entre cuatro herramientas y confirmar que tu línea principal es Claude Code; quienes no quieran tocar para nada la línea de comandos, vayan directamente a Métodos de instalación alternativos para ver la versión de escritorio de WorkBuddy
  • Un ordenador que cumpla los «requisitos del sistema» indicados abajo, con red capaz de acceder a claude.ai (el comando de instalación descarga el instalador desde claude.ai)
  • Una cuenta con la que puedas iniciar sesión, a elegir entre dos: suscripción de Claude (Pro desde $20/mes, también Max/Ultra/Team/Enterprise) o cuenta de Anthropic Console (API con pago por uso prepagado); la tabla completa de costes está en Comparación de precios
  • Una carpeta de proyecto para practicar; si aún no la tienes, no importa: la guía oficial dice que también se puede sin proyecto, Claude puede ayudarte a crear uno desde cero
  • 10 minutos de tiempo sin interrupciones

Requisitos del sistema ​

ElementoRequisito oficial
Sistema operativomacOS 13.0+; Windows 10 1809+ (o Windows Server 2019+); Ubuntu 20.04+ / Debian 10+ / Alpine 3.19+
Memoria y procesador4 GB+ de memoria; procesador x64 o ARM64
RedRequiere conexión a internet
ShellBash, Zsh, PowerShell o CMD
RegiónLista de regiones admitidas por Anthropic (ver el recuadro informativo abajo)

⚠️ Política regional: verifica antes de instalar

La «Supported Regions Policy» de Anthropic (versión vigente de 2026-11-12) establece claramente: sus productos, incluidos Claude.ai, Claude Code y la plataforma de API, solo se ofrecen en los países y regiones de la lista; la lista no incluye China continental, Hong Kong ni Macao (Japón, Singapur, Corea del Sur y Taiwán sí están en la lista). El texto original de la política indica: los países y regiones fuera de la lista no cuentan con soporte, incluidos los usuarios que se encuentren en regiones no admitidas.

Este tutorial solo expone los hechos de la política, no ofrece ninguna forma de eludirla, ni interpreta que «la lista no incluye China continental» signifique «es completamente imposible de usar allí»; la política puede actualizarse, prevalece la versión más reciente de la página oficial.

Idea central ​

La línea principal de la instalación de Claude Code son solo tres cosas: abrir la terminal → pegar un comando oficial → abrir una nueva terminal para verificar. El inicio de sesión y la primera pregunta son el remate, que suman 10 minutos.

Por qué esta lección sigue la ruta de «instalación nativa», la recomendada oficialmente:

Ruta de instalaciónCaracterística en una fraseEn qué página se explica
Instalación nativa (recomendada oficialmente)Un solo comando; tras instalar se actualiza automáticamente en segundo plano y se mantiene en la última versiónHilo principal de esta lección
npm / Homebrew / WinGet / apt, etc.Para usuarios con cadenas de herramientas ya existentes; tras instalar no se actualiza automáticamente (excepto npm)Próxima lección métodos alternativos de instalación
Claude Code de escritorio / WorkBuddy de escritorioNo tocas la terminal para nada«Consejos avanzados» de esta lección + próxima lección

Antes de empezar, recuerda tres ideas clave que te evitarán el 90% de los errores de principiante:

  1. Durante la descarga es normal que «no se muestre ningún progreso». Tras ejecutar el comando de instalación, la ventana parece no responder; la documentación oficial lo dice claramente: al descargar Claude Code no se muestra el progreso. No se ha colgado, no cierres la ventana.
  2. Después de instalar hay que abrir una ventana de terminal nueva para verificar. La ventana antigua no reconoce el comando recién instalado (PATH no se ha actualizado); si sale command not found, lo más probable es que no hayas abierto una ventana nueva.
  3. La terminal es solo una ventana de «escribir → Enter → ejecutar». No se puede hacer clic en su contenido con el ratón; muévete con las teclas de dirección. La oficial escribió una guía específica para principiantes de la terminal, y los pasos de esta lección se basan en ella.

Hazlo conmigo ​

Paso 1: abre la terminal: la primera puerta para instalar Claude Code ​

Por qué: Claude Code es una herramienta que se usa dentro de la terminal; todos los comandos de esta lección ocurren en una ventana de terminal. Ábrela primero.

Según tu sistema:

  • macOS: pulsa Cmd + Space para abrir Spotlight, escribe Terminal y pulsa Enter
  • Linux: pulsa Ctrl + Alt + T, o busca «Terminal» en el menú de aplicaciones
  • Windows: pulsa Win + X y elige Windows PowerShell (o «Terminal»)

En Windows, fíjate bien: PowerShell y CMD son dos programas de línea de comandos distintos. Se distinguen por el inicio de cada línea: PowerShell tiene PS (por ejemplo PS C:\>); CMD no. La ruta principal de Windows en esta lección usa PowerShell.

Deberías ver: una ventana nueva con un cursor parpadeando: esa es la terminal, donde escribes los comandos.

  • Comprobación: puedo decir si lo que abrí es la terminal de macOS/Linux o Windows PowerShell

Paso 2: pega el comando de instalación y empieza la instalación de Claude Code ​

Por qué: la instalación nativa es la ruta recomendada oficialmente: un solo comando descarga el instalador desde claude.ai y completa la instalación; después se actualiza automáticamente en segundo plano, así que no tendrás que actualizar manualmente en el futuro.

Usuarios de macOS / Linux / WSL ​

Copia este comando, pégalo en la terminal (en macOS usa Cmd + V, en Linux Ctrl + Shift + V) y pulsa Enter:

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

Usuarios de Windows ​

Pégalo en PowerShell (Ctrl + V o clic derecho) y pulsa Enter:

powershell
irm https://claude.ai/install.ps1 | iex

irm se encarga de descargar el script de instalación y iex de ejecutarlo.

Si lo que abriste es CMD (la línea no empieza con PS), usa este comando:

batch
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

💡 Usuarios de Windows: conviene instalar Git for Windows de paso

La recomendación oficial para usuarios de Windows es instalar Git for Windows: con él, Claude Code podrá usar la herramienta Bash; sin él también funciona, pero Claude Code pasará a usar PowerShell. Durante la instalación, dale a Next todo el tiempo y deja los valores predeterminados. Quienes usen WSL no necesitan instalarlo.

Deberías ver: tras ejecutar el comando no se muestra ningún progreso: la descarga ocurre en segundo plano y la ventana parece «no responder»; es normal, no la cierres. Al terminar, se imprimirá Claude Code successfully installed!.

  • Comprobación: he visto Claude Code successfully installed! (si hay un error, no te asustes: revisa abajo «Avisos de errores comunes» o salta directamente a qué hacer si no se instala para una consulta rápida de 60 segundos)

Paso 3: abre una terminal nueva y verifica la instalación con claude --version ​

Por qué: se verifican dos cosas: que el comando está instalado y que el sistema lo encuentra (PATH correcto). Hay que ejecutarlo en una ventana de terminal recién abierta: la ventana antigua no reconoce el comando recién instalado.

Abre una ventana de terminal nueva (puedes cerrar la anterior) y escribe:

bash
claude --version

Deberías ver: un número de versión seguido de (Claude Code), por ejemplo:

text
2.1.211 (Claude Code)

El número de versión cambia con las actualizaciones; fíate del que te salga a ti.

Practica aquí primero para coger soltura. Abajo tienes una terminal de práctica que no ejecuta comandos de verdad:

Práctica: verificar la instalaciónSolo reconoce los comandos de esta lección, no los ejecuta de verdad

$claude --version

2.1.211 (Claude Code)

Si aparece command not found: claude (macOS/Linux) o 'claude' is not recognized (Windows): el directorio de instalación aún no está en el PATH. Al terminar, el instalador imprimió en Setup notes el comando exacto para corregirlo; los pasos completos están en qué hacer si no se instala.

  • Comprobación: claude --version ha mostrado un número de versión con (Claude Code)

Paso 4: entra en el directorio del proyecto, inicia por primera vez e inicia sesión ​

Por qué: Claude Code trabaja en el «directorio actual»: entra primero en la carpeta de tu proyecto antes de iniciarlo, para que lea los archivos de ese proyecto.

Escribe en la terminal (cambia la ruta por la de tu propio proyecto):

bash
cd /path/to/your/project
claude

¿Aún no tienes proyecto? No pasa nada: palabras textuales de la guía oficial: no hace falta tener un proyecto, Claude puede ayudarte a empezar uno nuevo. Basta con entrar en cualquier carpeta donde guardes archivos de práctica.

El primer inicio pedirá que inicies sesión; sigue las instrucciones para completar la autenticación en el navegador. Hay dos caminos de cuenta:

Tipo de cuentaQué esPara quién
Suscripción de Claude (Pro / Max / Ultra / Team / Enterprise, recomendada oficialmente)cuenta de suscripción de claude.ai, Pro desde $20/mesla mayoría de usuarios individuales
Cuenta de Anthropic Consolecrédito prepagado de API según consumo; al iniciar sesión por primera vez se crea automáticamente un espacio de trabajo «Claude Code» para ver el gasto de forma centralizadadesarrolladores que prefieren pagar por uso

Tras iniciar sesión una vez, las credenciales se guardan y no tendrás que volver a hacerlo en futuros inicios. (Avanzado: si has definido la variable de entorno ANTHROPIC_API_KEY, Claude Code te preguntará si quieres usarla y, al confirmar, se omite el aviso de inicio de sesión.)

Deberías ver: el navegador abre la página de autenticación y, al terminar, vuelves a la terminal: aparece el prompt de Claude Code, con el número de versión, el modelo actual y el directorio de trabajo arriba. Escribe /help para ver los comandos disponibles.

  • Comprobación: inicio de sesión completado; en la terminal aparece un prompt con el número de versión, el modelo y el directorio de trabajo

Paso 5: haz la primera pregunta y confirma que Claude Code funciona de verdad ​

Por qué: claude --version solo demuestra que «está instalado»; hacer una pregunta y ver que lee los archivos y responde es lo que demuestra que «funciona».

Escribe en Claude Code:

text
what does this project do?

Deberías ver: Claude analiza los archivos de tu proyecto y da un resumen; cuando necesita un archivo, lo lee por sí mismo, sin que tengas que copiar y pegar código manualmente.

Una más: pregúntale qué sabe hacer:

text
what can Claude Code do?

Tres operaciones útiles de inmediato: /help ver los comandos disponibles; Esc interrumpir a Claude mientras se está ejecutando; exit o pulsar dos veces Ctrl+D para salir.

  • Pequeña comprobación: Claude respondió a mi primera pregunta — los cinco pasos de la instalación completados

Punto de control ✅ ​

  • Completé la instalación de Claude Code con el comando oficial nativo (macOS/Linux/WSL o Windows PowerShell/CMD, cada uno con su comando correspondiente)
  • Abrí una nueva terminal y ejecuté claude --version, que imprimió el número de versión + (Claude Code)
  • Completé el primer inicio de sesión (suscripción de Claude o cuenta de Console, a elegir entre las dos) y sé que las credenciales quedan guardadas, sin necesidad de volver a iniciar sesión cada vez
  • Inicié Claude Code en el directorio de mi proyecto, hice mi primera pregunta y obtuve respuesta
  • Sé que la instalación nativa se actualiza automáticamente en segundo plano, y sé que si hay errores puedo consultar ¿Qué hacer si no se instala? para una consulta rápida

Aviso de errores comunes ​

❌ Tras pegar el comando «no pasa nada», y creyendo que se colgó, cerré la ventana ​

Durante la descarga, el comando de instalación nativa no muestra ningún progreso y la ventana parece bloqueada — la documentación oficial indica claramente que esto es normal. Espera a que imprima Claude Code successfully installed! antes de tocar nada. Con una conexión lenta, este paso puede tardar un rato.

❌ Tras instalar, ejecuto claude en la ventana antigua y aparece command not found / 'claude' is not recognized ​

Causa: el directorio de instalación aún no está en el PATH de esa ventana. Lo correcto: abrir una nueva ventana de terminal y ejecutar claude --version de nuevo; si sigue sin funcionar, corrige el PATH con el comando que imprime el Setup notes al final del instalador — los pasos completos están en ¿Qué hacer si no se instala?.

❌ Ejecuté en PowerShell un comando de CMD (o al revés) ​

  • Si ves The token '&&' is not a valid statement separator → estás en PowerShell ejecutando un comando de CMD
  • Si ves 'irm' is not recognized → estás en CMD ejecutando un comando de PowerShell

Para distinguirlos, mira el inicio de la línea: PowerShell tiene PS, CMD no. Basta con volver a ejecutar el comando correspondiente.

❌ El comando de instalación imprime un montón de HTML / syntax error near unexpected token '<' ​

Causa: la dirección de instalación devolvió una página web en lugar del script de instalación. Guía oficial de solución de problemas: primero vuelve a ejecutarlo una vez; si la página dice "App unavailable in region", es por política regional — los hechos están en el recuadro «Política regional» más arriba; este tutorial no ofrece métodos para sortearla; en otros casos puedes usar Homebrew (brew install --cask claude-code, se explica en detalle en la próxima lección) o consultar ¿Qué hacer si no se instala?.

Consejos avanzados (opcional) ​

¿No quieres tocar la terminal para nada? Hay dos salidas.

  • Claude Code versión de escritorio: aplicación de escritorio oficial, sin pasar por la terminal; el sitio oficial ofrece descargas para macOS y Windows, con los mismos requisitos de cuenta que la versión de terminal
  • WorkBuddy versión de escritorio: la ruta alternativa sin línea de comandos de este tutorial — desarrollada por Tencent, con inicio de sesión escaneando un código QR en WeChat; los pasos de instalación están en Instalación de métodos alternativos

¿Ya tienes una cadena de herramientas? npm, Homebrew, WinGet y apt/dnf/apk también pueden instalar Claude Code; de ellos, Homebrew, WinGet y apt/dnf/apk no se actualizan automáticamente tras la instalación (solo la instalación nativa lo hace); npm sí se actualiza automáticamente, pero requiere que el directorio global de npm sea escribible — los comandos y reglas de actualización de cada método se explican de forma unificada en la próxima lección.

La terminal no es la única forma. Claude Code también tiene extensiones para VS Code / JetBrains, versión web y otras formas — primero deja funcionando la versión de terminal; las demás formas se desarrollan en Uso de Claude Code.

Resumen de la lección ​

✅ La ruta principal de instalación de Claude Code = abrir la terminal → pegar un comando de instalación nativo → abrir una nueva terminal y verificar con claude --version → iniciar sesión → hacer la primera pregunta. Completados los cinco pasos, la herramienta queda en estado «funcional».

✅ La instalación nativa se actualiza automáticamente en segundo plano; los métodos alternativos como Homebrew/WinGet no se actualizan automáticamente (npm es la excepción, se actualiza automáticamente dependiendo de los permisos del directorio global), se explica en la próxima lección.

✅ Dos rutas de inicio de sesión: suscripción de Claude (Pro desde $20/mes, recomendado oficialmente) o cuenta de Console (API con pago por uso anticipado); con un solo inicio de sesión las credenciales quedan guardadas.

✅ Requisitos del sistema: macOS 13.0+ / Windows 10 1809+ / Ubuntu 20.04+ etc.; a partir de 4 GB de memoria.

✅ Hechos sobre la política regional: la lista de regiones admitidas por Anthropic (versión vigente desde 2026-11-12) no incluye China continental — solo se exponen los hechos, sin consejos para sortearla.

✅ Ante errores, no entres en pánico: command not found, errores de HTML, uso incorrecto de PowerShell/CMD — todo se puede identificar en 60 segundos en ¿Qué hacer si no se instala?.

Repaso de los comandos clave:

ComandoFunciónPlataforma aplicable
curl -fsSL https://claude.ai/install.sh | bashInstalación nativamacOS / Linux / WSL
irm https://claude.ai/install.ps1 | iexInstalación nativaWindows PowerShell
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdInstalación nativaWindows CMD
claude --versionVerificar la instalaciónTodas las plataformas
cd /path/to/your/project y luego claudeEntrar en el proyecto y hacer el primer arranqueTodas las plataformas

Avance de la próxima lección ​

La ruta principal ya está instalada, pero aún falta hablar de los métodos alternativos. Próxima lección: Instalación de métodos alternativos: npm, Homebrew, WinGet y la versión de escritorio de WorkBuddy.

Aprenderás:

  • Comandos y criterios de elección de los tres métodos alternativos npm / Homebrew / WinGet (la versión estable de Homebrew va con aproximadamente una semana de retraso y no se actualiza automáticamente tras la instalación)
  • Ruta alternativa totalmente sin línea de comandos: descarga, instalación e inicio de sesión con código QR de WeChat de la versión de escritorio de WorkBuddy
  • Cómo actualizar cada método de instalación: la instalación nativa se actualiza automáticamente; Homebrew/WinGet y similares requieren actualización manual (npm es la excepción)
  • Cómo decidir si quedarte en la ruta principal o cambiar a un método alternativo
gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.