Cómo instalar la CLI de Claude Code en 2026: Guía completa de configuración

AI Perks

AI Perks ofrece acceso a descuentos exclusivos, créditos y ofertas en herramientas de IA, servicios en la nube y APIs para ayudar a startups y desarrolladores a ahorrar dinero.

Explora todos los AI Perks

Cómo instalar Claude Code CLI en 2026

Para instalar Claude Code, ejecuta npm install -g @anthropic-ai/claude-code@latest en tu terminal. La instalación tarda aproximadamente 30 segundos. Verifica con claude --version, luego autentícate con claude auth login para empezar a usarlo.

Claude Code requiere Node.js 18 o posterior. Una vez instalado, se ejecuta en macOS, Linux y Windows con los mismos comandos. Y mientras lo configuras, AI Perks puede conseguirte créditos gratuitos de Anthropic por valor de $1,000-$25,000+ para potenciar Claude Code sin coste alguno.

Ahorra tu presupuesto en créditos de IA

Buscar ofertas para

OpenAI,

Anthropic,

Lovable,

Notion

Changelog

TodosGratisAsociaciones

Buscar ofertas para

OpenAI,

Anthropic,

Lovable,

Notion

Changelog

TodosGratisAsociaciones

Software	Creditos Aprox	Condiciones	Indice De Aprobacion	Acciones

Promociona tu SaaS

Llega a más de 90.000 fundadores en todo el mundo que buscan herramientas como la tuya

Aplicar ahora

Requisitos del sistema

Comprueba tu versión de Node.js:

node --version

Si es inferior a 18, instala la última LTS desde nodejs.org o utiliza nvm.

AI Perks

AI Perks ofrece acceso a descuentos exclusivos, créditos y ofertas en herramientas de IA, servicios en la nube y APIs para ayudar a startups y desarrolladores a ahorrar dinero.

Explora todos los AI Perks

Instalar Claude Code en macOS

Paso 1: Instalar Node.js (si aún no lo tienes)

Usa Homebrew:

brew install node

O descarga desde nodejs.org.

Paso 2: Instalar Claude Code

npm install -g @anthropic-ai/claude-code@latest

Paso 3: Verificar la instalación

claude --version

Deberías ver un número de versión impreso (por ejemplo, 1.x.x).

Paso 4: Autenticarse

claude auth login

Esto abrirá un navegador para iniciar sesión a través de tu cuenta de Anthropic.

Instalar Claude Code en Linux

Paso 1: Instalar Node.js (Ubuntu/Debian)

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Para otras distribuciones (Fedora, Arch, etc.), usa tu gestor de paquetes.

Paso 2: Instalar Claude Code

npm install -g @anthropic-ai/claude-code@latest

Si obtienes errores de permisos, no uses sudo con npm. En su lugar, arregla el prefijo de npm:

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

Luego reinstala.

Paso 3: Verificar y autenticarse

claude --version
claude auth login

Instalar Claude Code en Windows

Paso 1: Instalar Node.js

Descarga el instalador de Windows desde nodejs.org y ejecútalo. Asegúrate de que la opción "Add to PATH" esté marcada durante la instalación.

Paso 2: Abrir PowerShell o Terminal

Abre PowerShell (o Windows Terminal) como Administrador.

Paso 3: Instalar Claude Code

npm install -g @anthropic-ai/claude-code@latest

Paso 4: Verificar la instalación

claude --version

Si claude no se reconoce, reinicia tu terminal o comprueba que la carpeta bin global de npm esté en tu PATH:

npm config get prefix

Añade la ruta resultante (con \ appended) a tu variable de entorno PATH del sistema.

Paso 5: Autenticarse

claude auth login

Métodos de autenticación

Claude Code soporta tres métodos de autenticación:

Método 1: Inicio de sesión OAuth (Más fácil)

claude auth login

Abre un navegador para iniciar sesión a través de tu cuenta de Anthropic. Ideal para uso personal con una suscripción Pro/Max.

Método 2: Clave API (Recomendado para créditos gratuitos)

Establece tu clave API de Anthropic como una variable de entorno:

macOS/Linux:

export ANTHROPIC_API_KEY="sk-ant-..."
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc  # o ~/.bashrc

Windows (PowerShell):

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-...', 'User')

Esta es la mejor opción para usar créditos gratuitos de Anthropic de AI Perks en lugar de una suscripción de pago.

Método 3: Archivo de configuración

Edita ~/.claude/auth/credentials.json:

{
  "api_key": "sk-ant-...",
  "auth_type": "api_key"
}

Configuración inicial: Verifica que todo funciona

Después de la instalación y autenticación:

Prueba la funcionalidad básica

claude

Deberías ver el REPL de Claude Code. Prueba una pregunta:

Hola! Qué modelo estás ejecutando?

Claude debería responder con un saludo e indicar el modelo activo.

Prueba operaciones de archivos

Navega a la carpeta de un proyecto:

cd ~/projects/my-app
claude

Pídele a Claude que lea tu README:

Puedes leer el archivo README.md y resumir este proyecto?

Si Claude lee y responde, tu configuración funciona.

Errores comunes de instalación y soluciones

Error: npm ERR! EACCES permission denied

No tienes permiso para escribir en la carpeta global de npm. Solución:

# No uses sudo. En su lugar, cambia el prefijo de npm:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Añade la exportación a tu ~/.zshrc o ~/.bashrc para que sea permanente.

Error: command not found: claude

Después de la instalación, el comando claude no se encuentra. Causas:

1. Terminal no reiniciada - Cierra y vuelve a abrir tu terminal
2. PATH sin el bin de npm - Ejecuta echo $(npm config get prefix)/bin y añádelo al PATH
3. Configuración de shell incorrecta - Para zsh, edita ~/.zshrc; para bash, edita ~/.bashrc

Error: Node.js version too old

Claude Code requiere Node.js 18+. Actualiza:

# macOS (Homebrew)
brew upgrade node

# Linux (nvm)
nvm install 20
nvm use 20

# Windows
# Descarga la última LTS desde nodejs.org

Error: Authentication failed

• Verifica que tu clave API empiece por sk-ant-
• Comprueba que no haya sido revocada en console.anthropic.com
• Asegúrate de que no haya espacios adicionales en tu variable de entorno ANTHROPIC_API_KEY
• Intenta regenerar la clave

Error: Cannot find module '@anthropic-ai/claude-code'

La instalación no se completó. Intenta:

npm cache clean --force
npm install -g @anthropic-ai/claude-code@latest --force

Potencia Claude Code con créditos gratuitos de Anthropic

Claude Code requiere una suscripción de pago ($20-$200/mes) o créditos API para funcionar realmente. Los créditos gratuitos de Anthropic a través de AI Perks cubren el coste de la API en su totalidad.

Total potencial: $4,500 - $156,000+ en créditos gratuitos de Claude

Después de instalar Claude Code, configúralo con una clave API potenciada por créditos gratuitos y omite la facturación de suscripción por completo.

Paso a paso: Instalar + Ejecutar Claude Code gratis

Paso 1: Instalar Claude Code

npm install -g @anthropic-ai/claude-code@latest

Paso 2: Obtener créditos gratuitos de Anthropic

Suscríbete a AI Perks y solicita programas de créditos. La mayoría de las decisiones llegan en una semana.

Paso 3: Generar una clave API

Inicia sesión en console.anthropic.com y crea una clave API en Settings > API Keys.

Paso 4: Configurar Claude Code

export ANTHROPIC_API_KEY="sk-ant-..."

Añade esto a la configuración de tu shell para que sea persistente.

Paso 5: Empezar a codificar

claude

Cada pregunta ahora se basa en tu saldo de créditos gratuitos. No se requiere suscripción.

Preguntas frecuentes

¿Cuánto tiempo tarda en instalarse Claude Code?

La instalación tarda entre 30 y 60 segundos a través de npm, asumiendo que Node.js 18+ ya está instalado. Si necesitas instalar Node.js primero, añade 5-10 minutos. Verifica el éxito con claude --version.

¿Necesito una suscripción de pago para instalar Claude Code?

No, la instalación es gratuita. Solo necesitas una suscripción de Anthropic de pago o créditos API para usar Claude Code realmente. Los créditos gratuitos por valor de $1,000-$25,000+ a través de AI Perks eliminan el coste por completo.

¿Puedo instalar Claude Code en varias máquinas?

Sí, instálalo en tantas máquinas como quieras. La instalación en sí es gratuita. Tu cuenta de Anthropic, claves API y créditos se comparten entre máquinas; el uso desde cualquier máquina cuenta para el mismo saldo.

¿Cómo instalo Claude Code en un servidor (CI/CD)?

Utiliza el mismo comando npm install, luego configúralo a través de una variable de entorno (ANTHROPIC_API_KEY). Para CI/CD, almacena la clave API como un secreto e inyéctala durante la ejecución del pipeline. Los créditos gratuitos a través de AI Perks financian el uso de CI/CD a $0.

¿Puedo instalar Claude Code sin Node.js?

No, Claude Code requiere Node.js 18+ para funcionar. No hay binarios independientes distribuidos oficialmente por Anthropic. Usa nvm o el gestor de paquetes de tu sistema operativo para instalar Node.js si es necesario.

¿Cómo instalo una versión específica de Claude Code?

Instala con el indicador de versión: npm install -g @anthropic-ai/claude-code@1.2.0 (reemplaza con la versión deseada). Consulta las versiones disponibles en el changelog de GitHub.

¿Qué ocurre después de instalar Claude Code?

Ejecuta claude --version para verificar, luego claude auth login (o establece ANTHROPIC_API_KEY). Inicia con claude desde cualquier carpeta de proyecto. Claude puede leer tu código, sugerir cambios y ejecutar tareas. Con créditos gratuitos a través de AI Perks, el uso ilimitado cuesta $0.

Instalar Claude Code + Obtener créditos gratuitos de Anthropic

Instalar Claude Code lleva 30 segundos. Potenciarlo gratis requiere una suscripción a AI Perks:

• $1,000-$25,000+ en créditos gratuitos de Anthropic
• Estrategias de apilamiento para más de $50,000 de financiación
• Más de 200 beneficios adicionales para startups más allá de los créditos de IA
• Guías actualizadas para cada versión de Claude Code

Suscríbete en getaiperks.com →

Instala Claude Code en 30 segundos. Poténcialo gratis en getaiperks.com.