Guía de instalación y configuración de Claude Code
Guía de Instalación y Configuración de Claude Code
¡Bienvenido a la guía completa de instalación y configuración de Claude Code! Esta guía te acompañará a través de todo lo que necesitas para que Claude Code funcione en tu sistema.
¿Qué es Claude Code?
Claude Code es la herramienta oficial de línea de comandos (CLI) de Anthropic que lleva el poder de Claude AI directamente a tu terminal. Está diseñada para desarrolladores que desean integrar la asistencia de IA en su flujo de trabajo de codificación, ofreciendo características como:
- Modo de conversación interactiva
- Edición de archivos y análisis de código
- Integración con herramientas externas a través de MCP (Protocolo de Contexto de Modelo)
- Capacidades de automatización
- Sistema de permisos enfocado en la seguridad
Requisitos del Sistema
Antes de instalar Claude Code, asegúrate de que tu sistema cumpla con estos requisitos:
- Node.js: Versión 16 o superior (se recomienda 18+)
- RAM: 4GB mínimo (se recomienda 8GB+ para proyectos grandes)
- Conexión a internet: Necesaria para las llamadas a la API
- Clave API: Desde la Consola de Anthropic
Plataformas Compatibles
Claude Code funciona en: - macOS: Intel y Apple Silicon - Linux: Ubuntu 18+, Debian 10+, CentOS 7+ - Windows: Windows 10/11 (se recomienda WSL)
Métodos de Instalación
Método 1: Instalación con NPM (Recomendado)
La forma más sencilla de instalar Claude Code es a través de npm:
# Instalación global
npm install -g @anthropic-ai/claude-code
# Verificación de la instalación
claude --version
Método 2: macOS con Homebrew
Para usuarios de macOS, puedes usar Homebrew:
# Instalar Node.js si no está instalado
brew install node
# Instalar Claude Code
npm install -g @anthropic-ai/claude-code
# Si tienes problemas con la ruta, ejecuta:
export PATH="$PATH:$(npm bin -g)"
Método 3: Arch Linux AUR
Para usuarios de Arch Linux:
# Usando yay
yay -S claude-code
# O usando paru
paru -S claude-code
Método 4: Docker (Contenedorizado)
Para entornos conteinerizados:
# Descargar la imagen de Docker
docker pull ghcr.io/rchgrav/claudebox:latest
# Ejecutar Claude Code en un contenedor
docker run -it -v "$PWD":"$PWD" -w "$PWD" \
ghcr.io/rchgrav/claudebox:latest
Método 5: Windows con WSL
Para usuarios de Windows (enfoque recomendado):
- Habilitar WSL 2 e instalar Ubuntu.
- Dentro de Ubuntu, ejecuta:
sudo apt update && sudo apt install -y nodejs npm
npm install -g @anthropic-ai/claude-code
Configuración Inicial
Paso 1: Obtén tu Clave API
- Visita Anthropic Console
- Crea una cuenta o inicia sesión
- Navega a la sección de Claves API
- Genera una nueva clave API
Paso 2: Configura la Clave API
Establece tu clave API como una variable de entorno:
# Establecer temporalmente
export ANTHROPIC_API_KEY="sk-tu-clave-aqui"
# Hacerla permanente - elige tu shell:
# Para Bash
echo 'export ANTHROPIC_API_KEY="sk-tu-clave-aqui"' >> ~/.bashrc
source ~/.bashrc
# Para Zsh
echo 'export ANTHROPIC_API_KEY="sk-tu-clave-aqui"' >> ~/.zshrc
source ~/.zshrc
# Para Fish
echo 'set -gx ANTHROPIC_API_KEY "sk-tu-clave-aqui"' >> ~/.config/fish/config.fish
Paso 3: Configuración Básica
Configura Claude Code con tus preferencias:
# Configuración interactiva
claude config
# Establecer valores predeterminados básicos
claude config set -g model claude-sonnet-4
claude config set -g verbose true
claude config set -g outputFormat text
Paso 4: Probar la Instalación
Verifica que todo funciona correctamente:
# Prueba de funcionamiento básico
claude "¡Hola, Claude!"
# Prueba de modo de impresión
claude -p "¿Cuánto es 2+2?"
# Verificación de estado ("health check")
claude /doctor
Opciones de Configuración
Variables de Entorno
Aquí tienes algunas variables de entorno útiles que puedes configurar:
# Deshabilitar la telemetría
export DISABLE_TELEMETRY=1
# Deshabilitar el reporte de errores
export DISABLE_ERROR_REPORTING=1
# Deshabilitar las llamadas a modelos no esenciales
export DISABLE_NON_ESSENTIAL_MODEL_CALLS=1
# Establecer el máximo de tokens de pensamiento
export MAX_THINKING_TOKENS=50000
Ajustes de Seguridad
Para usuarios preocupados por la seguridad:
# Establecer herramientas permitidas
claude config set allowedTools "Edit,View"
# Ajustes del diálogo de confianza
claude config set hasTrustDialogAccepted
claude config set hasCompletedProjectOnboarding
Primeros Pasos
Modo Interactivo
Inicia Claude Code en modo interactivo:
claude
Esto abre un REPL donde puedes tener conversaciones con Claude.
Modo de Una Sola Vez ("One-Shot")
Para consultas rápidas:
claude -p "Explica este mensaje de error"
Con Pregunta Inicial
Comienza con una pregunta específica:
claude "Ayúdame a depurar este script de Python"
Solución de Problemas de Instalación
Problemas Comunes
- Comando no encontrado: Asegúrate de que el binario global de npm esté en tu PATH.
- Errores de permisos: Intenta usar
sudoconnpm install(no recomendado) o corrige los permisos de npm. - Problemas con la clave API: Verifica que tu clave API esté configurada correctamente.
- Problemas de red: Revisa tu conexión a internet y la configuración de proxy.
Verificación de Estado ("Health Check")
Ejecuta el comando de verificación de estado para diagnosticar problemas:
claude /doctor
La salida esperada debe incluir: - ✅ API Key: Valid - ✅ Network: Connected - ✅ Model Access: Available
Obtener Ayuda
Si encuentras problemas:
- Consulta la documentación oficial
- Usa el comando
/bugdentro de Claude Code - Verifica que tu versión de Node.js sea 16+
- Intenta reinstalar Claude Code
¿Qué Sigue?
Ahora que tienes Claude Code instalado y configurado, puedes:
- Aprender comandos básicos - Explora la referencia de comandos
- Configurar la integración de MCP - Conecta herramientas y servicios externos
- Configurar ajustes de seguridad - Establece permisos y medidas de seguridad
- Explorar funciones avanzadas - Automatización, scripts y flujos de trabajo
Referencia Rápida
Comandos Esenciales
claude # Iniciar modo interactivo
claude "tu pregunta" # Iniciar con pregunta inicial
claude -p "consulta" # Consulta de una sola vez
claude -c # Continuar última sesión
claude config # Menú de configuración
claude --version # Comprobar versión
claude --help # Mostrar ayuda
Archivos de Configuración
- Configuración global:
~/.claude.json - Configuración del proyecto:
settings.json(varía según el proyecto) - Memoria del proyecto:
CLAUDE.md(en la raíz del proyecto)
¡Felicidades! Ya tienes Claude Code instalado y listo para usar. El siguiente paso es explorar los comandos y características que hacen de Claude Code una herramienta de desarrollo tan poderosa.