Como instalar Claude Code paso a paso

Que es Claude Code?

Claude Code es el agente de IA de Anthropic para la terminal. Edita archivos, ejecuta comandos, revisa PRs y gestiona tu proyecto completo desde la línea de comandos. Es la herramienta más potente para desarrollo asistido por IA.

En esta guia completa te enseñaremos a instalarlo desde cero, configurarlo con diferentes proveedores de IA, asegurarlo correctamente, y sacarle el maximo partido con consejos profesionales y flujos de trabajo reales. Al final, como bonus, te explicamos como potenciarlo con las 1136 skills de SKILLSBUNDLE.

Requisitos del sistema

Antes de empezar, asegurate de que tu sistema cumple estos requisitos:

• Sistema operativo: macOS 12+, Windows 10+ (64-bit) o Ubuntu 20+ / Debian 11+ / Fedora 38+
• RAM: 8 GB minimo (16 GB recomendado para proyectos grandes)
• Disco: 500 MB para la herramienta + espacio para tus proyectos
• Node.js 18+ (si la instalacion es via npm)
• Python 3.9+ (para herramientas como Aider y Hermes Agent)
• Git (para herramientas que trabajan con repositorios)
• Conexion a internet (para descargar e instalar; para IA en la nube)
• Terminal: bash, zsh o PowerShell

Metodos de instalacion

Hay varias formas de instalar Claude Code. Elige la que mejor se adapte a tu sistema y preferencias:

Instalador oficial (recomendado)

macOS/Linux/WSL: curl -fsSL https://claude.ai/install.sh | bash
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
El instalador oficial se actualiza automáticamente en segundo plano.

Homebrew (macOS/Linux)

brew install --cask claude-code # canal stable
brew install --cask claude-code@latest # canal latest
No se auto-actualiza: brew upgrade claude-code

WinGet (Windows)

winget install Anthropic.ClaudeCode
No se auto-actualiza: winget upgrade Anthropic.ClaudeCode

Linux (apt/dnf/apk)

# Debian/Ubuntu: configurar repositorio firmado
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc -o /etc/apt/keyrings/claude-code.asc
echo 'deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/apt stable main' | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update && sudo apt install claude-code
# Fedora: dnf, Alpine: apk

npm (avanzado)

npm install -g @anthropic/claude-code # requiere Node.js 22+
# El paquete npm descarga un binario nativo, no usa Node.js en runtime.

Verificar la instalacion

Una vez instalado, verifica que todo funciona:

claude --version
# Deberías ver: Claude Code 2.x.x

Si ves un error, revisa la seccion de solucion de problemas al final de la guia.

Configurar autenticacion y proveedores de IA

La mayoria de herramientas de IA requieren configurar al menos un proveedor de modelos. Aqui tienes las opciones disponibles para Claude Code:

Claude Pro/Max/Team

Cuenta de pago en claude.ai. Al ejecutar 'claude' se abre el navegador para autenticarte. Es el método recomendado para uso individual.

API Key de Anthropic

export ANTHROPIC_API_KEY=sk-ant-...
# Si está configurada, Claude Code salta el login y pide aprobar la key directamente.

Amazon Bedrock

Para equipos empresariales con AWS. Configura el gateway: claude gateway --config gateway.yaml

Google Cloud / Microsoft Foundry

Integración con Vertex AI y Azure. Claude Code soporta estos proveedores como terceros.

OpenRouter (alternativa)

export ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1
export ANTHROPIC_API_KEY=sk-or-...
# Usa OpenRouter como proxy para acceder a Claude a través de su API unificada.

Proveedores alternativos

No tienes por que limitarte a un solo proveedor. Aqui tienes una comparativa de los principales proveedores de IA que puedes usar:

Seguridad: mejores practicas

La seguridad es critica cuando usas herramientas de IA que tienen acceso a tu sistema. Sigue estas recomendaciones:

• API Key: nunca la subas a Git. Usa variables de entorno y un .env en .gitignore.
• Binary integrity: Anthropic firma cada release con GPG (fingerprint: 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE). Verifica: gpg --verify manifest.json.sig manifest.json
• En macOS: el binario está notarizado por Apple. Verifica: codesign --verify --verbose ./claude
• En Windows: firmado por Anthropic PBC. Verifica: Get-AuthenticodeSignature .\claude.exe
• Usa claude doctor para diagnóstico de seguridad y configuración.
• Genera tokens de larga duración para CI/CD: claude setup-token (nunca compartas API keys en scripts de CI).
• Mantén Claude Code actualizado: las actualizaciones incluyen parches de seguridad críticos.

Consejos profesionales

Una vez que Claude Code funciona, estos consejos te ayudaran a usarlo como un experto:

• Usa claude -p para consultas rápidas sin entrar en modo interactivo: claude -p 'explica esta función'
• Crea un CLAUDE.md en la raíz de tu proyecto con el contexto de tu equipo: estilo de código, convenciones, arquitectura.
• Usa claude --watch para que observe cambios de archivos y actúe automáticamente.
• Los comandos de sesión: /login (re-autenticar), /model (cambiar modelo), /cost (ver uso de tokens).
• Para CI/CD: claude setup-token genera un token de larga duración. Nunca uses API keys directamente en scripts.
• Activa claude -c para continuar la conversación más reciente en el directorio actual.
• Usa claude -r para retomar una conversación anterior por ID.
• Configura el nivel de permisos: Auto mode (recomendado) vs. Plan mode (más control).

Flujos de trabajo recomendados

Estos son los casos de uso mas potentes de Claude Code:

• Code review de PRs: copia el diff y pide 'revisa este PR por seguridad, calidad y rendimiento'
• Refactorización: señala el archivo con 'mejora la estructura de este módulo manteniendo la API pública'
• Debugging: pega el error y el contexto con 'encuentra la causa raíz de este bug'
• Documentación: 'genera docstrings para todas las funciones públicas de este archivo'
• Generación de tests: 'crea tests unitarios con Jest para este componente cubriendo happy path, errores y edge cases'
• Automatización de deploys: 'crea un script de deploy que ejecute tests, build y despliegue a producción'
• Análisis de seguridad: 'revisa este código en busca de vulnerabilidades OWASP Top 10'
• Migración de código: 'traduce este código de Python a TypeScript manteniendo la lógica de negocio'

Solucion de errores comunes

command not found: claude

El binario no está en el PATH. Solución: export PATH=$PATH:$(npm config get prefix)/bin (si instalaste con npm) o reinstala con el instalador oficial.

Error 403 al instalar con curl

El instalador no pudo descargar el script. Solución: usa un método alternativo (Homebrew, WinGet, npm) o verifica que tu red no bloquee claude.ai.

syntax error near unexpected token '<'

El script de instalación se descargó incompleto (HTML en lugar del script). Solución: reintenta con curl -fsSL o usa el instalador de PowerShell en Windows.

Autenticación fallida

La API key o la sesión han expirado. Solución: ejecuta /login dentro de la sesión o export ANTHROPIC_API_KEY=... de nuevo.

El modelo no responde (timeout)

Problema de conexión o cuota excedida. Solución: verifica tu conexión, revisa el estado de Anthropic, y considera bajar a un modelo más rápido.

Claude Code no edita archivos

El modo de permisos puede estar restringido. Solución: en Auto mode, Claude Code edita archivos automáticamente. En Plan mode, pide confirmación. Usa /permissions para ver el modo actual.

Error: Node.js 22+ required

Si instalaste con npm y tu Node.js es viejo. Solución: actualiza Node.js o usa el instalador nativo (no requiere Node.js en runtime).

Consumo excesivo de tokens

Las sesiones largas acumulan contexto. Solución: usa claude -p para consultas puntuales, y reinicia sesiones periódicamente. Monitorea con /cost.

Preguntas frecuentes

¿Puedo usar varios proveedores a la vez?

Si, la mayoria de herramientas permiten configurar multiples modelos. Puedes usar uno rapido (Haiku, GPT-4o-mini) para tareas simples y uno potente (Opus, GPT-5) para tareas complejas.

¿Funciona sin conexion a internet?

Solo si usas modelos locales con Ollama, LM Studio o llama.cpp. Los modelos en la nube requieren conexion permanente.

¿Cual es el mejor proveedor para empezar?

OpenRouter: una sola API key, 300+ modelos, facturación consolidada. Puedes probar todos los modelos sin comprometerte con uno.

¿Como protejo mis API keys?

Usa variables de entorno (export CLAVE=valor), nunca las incluyas en el codigo, anade .env a .gitignore, y usa un gestor de secrets como 1Password o Bitwarden.

¿Puedo compartir mi configuracion con el equipo?

Comparte el archivo de configuracion sin las API keys. Usa variables de entorno para los secrets y documenta que variables necesita cada miembro del equipo.

Comparativa: como se compara con otras herramientas

Configuracion avanzada

Claude Code ofrece varias opciones de configuracion avanzada:

• CLAUDE.md: crea este archivo en la raiz de tu proyecto para definir el contexto, estilo de codigo y reglas que Claude Code seguira.
• Modo de permisos: Auto mode (recomendado) vs Plan mode (mas control). Configura con /permissions.
• Release channel: elige entre stable (estable, 1 semana de retraso) y latest (ultima version).
• Variable ANTHROPIC_BASE_URL: para usar proxies como OpenRouter: export ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1
• Logs y debug: claude doctor para diagnostico completo del sistema, configuracion y red.
• Tokens CI/CD: claude setup-token genera tokens de larga duracion para automatizacion.

Ejemplos de uso reales

Estos son prompts reales que puedes usar para empezar a trabajar inmediatamente con tu herramienta recien instalada. Copia y pega, adapta segun tu proyecto:

# 1. Code review de un PR
claude "Revisa este diff por vulnerabilidades de seguridad, code smells y problemas de rendimiento"

# 2. Refactorizacion con contexto
claude "El archivo src/services/auth.ts tiene logica duplicada. Refactoriza extrayendo
funciones comunes y manteniendo la API publica. Crea tests para las nuevas funciones."

# 3. Debugging con contexto completo
claude "El test test_login_failure() falla intermitentemente en CI. Aqui esta el log de error:
[ERROR] Connection refused: localhost:5432
Encuentra la causa raiz y propon una solucion."

# 4. Documentacion automatica
claude -p "Genera documentacion en formato JSDoc para todas las funciones exportadas en src/utils/"

# 5. Generacion de tests
claude -p "Crea tests unitarios con Jest para src/components/UserProfile.tsx
cubriendo: renderizado, interaccion del usuario, estados de carga y error, y edge cases"

Bonus: Potencia Claude Code con 1136 skills de SKILLSBUNDLE

Ahora que Claude Code funciona perfectamente con tu proveedor de IA favorito, es momento de llevarlo al siguiente nivel. SKILLSBUNDLE te ofrece 1136 skills profesionales listos para usar.

Los skills son archivos de instrucciones que tu herramienta carga automaticamente segun el contexto. Con SKILLSBUNDLE obtienes:

• 40 verticales: marketing, finanzas, desarrollo web, SEO, diseno, y mas
• 15 tipos de uso: creacion de contenido, analisis de datos, automatizacion
• Skills transversales: code review, testing, documentacion, seguridad
• Optimizados y probados: cada skill ha sido refinado para dar resultados consistentes

Instalar los skills es directo:

# 1. Compra SKILLSBUNDLE en skillsbundle.com
# 2. Descarga skills.zip
# 3. Descomprime y copia las skills al directorio de tu herramienta
unzip skills.zip -d ~/skillsbundle-pack
cp -r ~/skillsbundle-pack/skills/* ~/claude-code/skills/
# 4. Verifica
ls ~/claude-code/skills/ | wc -l   # Deberias ver 1136

Una vez copiados, cada vez que uses Claude Code con un prompt que toque una vertical, la skill correspondiente se cargara automaticamente.

Incluye 1136 skills, actualizaciones gratuitas y soporte prioritario