Traducción automática en fase de mejora, sin revisión nativa todavía. Informa de errores en GitHub (se abre en una pestaña nueva).
Empezar

Requisitos previos e instalación

Instala Claude Code en pocos minutos. Requisitos previos (Node.js 18+, terminal, cuenta Anthropic), instalación por npm, autenticación con clave API o Max, y solución de errores habituales.

  • Tutorial
  • Herramientas
Publicado el Actualizado el

Actualizado en mayo de 2026

Tres cambios que debes conocer antes de instalar en mayo de 2026:

  • Se recomienda Node.js 22 (Node 18 dejó de tener soporte en abril de 2025 y Node 20 lo perderá en abril de 2026; algunos scripts de herramientas ya exigen Node 20+).
  • El plan Claude Max se ha convertido en la vía de autenticación más económica para un uso individual habitual (frente a ANTHROPIC_API_KEY con facturación por tokens consumidos). Elige según tu perfil de consumo.
  • La instalación mediante npm i -g @anthropic-ai/claude-code sigue siendo la única oficial. Desconfía de forks o paquetes no verificados. Consulta la página de seguridad para las comprobaciones de procedencia.

Requisitos previos

Antes de instalar Claude Code, comprueba que tienes estos tres elementos. Si te falta alguno, no te preocupes, te lo explicamos justo debajo.

Node.js 18 o superior

Claude Code funciona gracias a Node.js, el motor JavaScript que permite ejecutar código en el servidor. Necesitas al menos la versión 18 (se recomienda la versión 22 LTS).

Descárgalo en nodejs.org (ouvre un nouvel onglet) o usa un gestor de versiones como nvm.

La página nodejs.org/download ofrece un instalador oficial para Windows (.msi) además de una distribución binaria. Para la mayoría de usuarios, el instalador de Windows es suficiente.

Un terminal

Claude Code vive en el terminal. En macOS, usa Terminal o iTerm2. En Windows, usa PowerShell o WSL (Windows Subsystem for Linux). En Linux, cualquier emulador de terminal sirve.

Una suscripción Claude

Lo más simple y rentable: una suscripción Claude Pro, Max o Team desde claude.com (ouvre un nouvel onglet). Pro ya incluye Claude Code, Max añade 5x o 20x la capacidad de Pro, y Team está pensado para equipos con un workspace compartido.

Si prefieres pagar exactamente por lo que usas (uso muy puntual), puedes en su lugar crear una clave API en console.anthropic.com (ouvre un nouvel onglet). Consulta la sección Autenticación más abajo para ambos métodos.

Comprueba tu versión de Node.js

Abre tu terminal y escribe el siguiente comando:

Instalación de Claude Code

La instalación se hace con un único comando. Abre tu terminal y ejecuta:

Este comando instala Claude Code globalmente en tu máquina. Esto significa que el comando claude estará disponible desde cualquier carpeta de tu sistema.

Verifica la instalación

Después de instalar, comprueba que todo funciona:

Si el comando se reconoce y muestra un número de versión, la instalación se ha completado con éxito.

Autenticación

En el primer arranque, Claude Code te pedirá que te autentiques. Hay dos métodos disponibles.

Método 1: Clave API (pago por uso)

Es el método más flexible. Pagas únicamente lo que consumes.

1

Genera una clave API

Ve a console.anthropic.com (ouvre un nouvel onglet), inicia sesión y luego entra en API Keys y pulsa Create Key. Copia la clave generada (empieza por sk-ant-).

2

Configura la variable de entorno

Añade tu clave API en tu archivo de configuración del shell:

# Añade esta línea a tu ~/.bashrc o ~/.zshrc
export ANTHROPIC_API_KEY="sk-ant-tu-clave-aqui"


# Recarga tu configuración
source ~/.bashrc  # o source ~/.zshrc
3

Lanza Claude Code

Sitúate en una carpeta de proyecto y ejecuta el comando claude. La autenticación será automática gracias a la variable de entorno.

Método 2: Suscripción Claude Max / Pro / Team

Si tienes una suscripción Claude (Max, Pro o Team), puedes usar Claude Code sin una clave API separada.

1

Lanza Claude Code

Ejecuta simplemente el comando claude en tu terminal:

claude
2

Elige el método de autenticación

Claude Code te ofrece dos opciones. Selecciona Claude App:

? How would you like to authenticate?
> Claude App (Max subscription)
  Anthropic Console (API key)
3

Inicia sesión en tu navegador

Se abre automáticamente un navegador. Inicia sesión con tu cuenta Claude. Una vez autenticado, vuelve al terminal: Claude Code está listo.

Comparación de planes

Extracto de claude.com/pricing a 9 de mayo de 2026. Pro incluye Claude Code, Max añade 5x o 20x la capacidad de Pro. Para las cifras actualizadas, abre claude.com/pricing.

Essai gratuit

Gratuitcrédit de démarrage inclus

Pour tester Claude Code avant de vous engager. Crédit offert à l'inscription.

  • Crédit d'essai à l'inscription
  • Accès à Claude via clé API
  • Facturation à l'usage après le crédit
  • Pas d'abonnement requis
  • Idéal pour découvrir l'outil
Créer un compte
Recommandé pour commencer

Claude Max

~20 €par mois

L'abonnement idéal pour une utilisation régulière de Claude Code. Accès inclus sans clé API séparée.

  • Accès illimité à Claude Code
  • Pas de clé API à gérer
  • Claude.ai web inclus
  • Annulation à tout moment
  • Idéal pour un usage quotidien
S'abonner à Claude Max

Claude Code API

À l'usageselon la consommation

Pour les développeurs qui préfèrent payer exactement ce qu'ils consomment, sans abonnement fixe.

  • Paiement à l'utilisation
  • Clé API nécessaire
  • Contrôle fin des coûts
  • Intégration dans des scripts
  • Idéal pour des usages ponctuels
Voir les tarifs API

Les prix sont indicatifs et peuvent varier. Consultez anthropic.com/pricing pour les tarifs officiels.

Solución de problemas: errores habituales

"command not found: node" o versión demasiado antigua

Node.js no está instalado o tu versión es demasiado antigua.

# Instalar nvm (gestor de versiones de Node.js)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash


# Reiniciar el terminal y luego:
nvm install 22
nvm use 22


# Comprobar
node --version
# v22.x.x

"EACCES: permission denied"

npm no tiene permisos para instalar paquetes globales.

Solución 1: Configurar el prefijo de npm (recomendado)

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc


# Relanza la instalación
npm install -g @anthropic-ai/claude-code

Solución 2: Usar nvm

Si usas nvm, los problemas de permisos se gestionan automáticamente.

"command not found: claude"

El terminal no encuentra el comando claude después de la instalación.

# Comprueba dónde instala npm los paquetes globales
npm config get prefix


# La subcarpeta bin/ de esa ruta debe estar en tu PATH
# Si has configurado ~/.npm-global:
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Si cerraste y volviste a abrir tu terminal después de instalar y el problema persiste, comprueba que la carpeta bin de npm esté realmente en tu variable PATH.

"API key not found" o "Invalid API key"

# Comprueba que la variable está definida
echo $ANTHROPIC_API_KEY


# Si no aparece nada, la variable no está configurada
# Comprueba tu archivo de configuración del shell
cat ~/.bashrc | grep ANTHROPIC


# Asegúrate de que la clave empieza por sk-ant-
# y que no ha sido revocada en console.anthropic.com

Próximos pasos

Claude Code está instalado y ya estás autenticado. Pasemos a configurar tu entorno para sacarle el máximo partido a la herramienta.

Páginas de la sección Empezar