Verificar requisitos del sistema

  • Sistemas operativos: macOS 10.15+, Ubuntu 20.04+/Debian 10+, o Windows vía WSL
  • Hardware: Mínimo 4GB RAM
  • Software:
    • Node.js 18+
    • git 2.23+ (opcional)
    • CLI de GitHub o GitLab para flujos de trabajo con PR (opcional)
    • ripgrep (rg) para búsqueda mejorada de archivos (opcional)
  • Red: Conexión a Internet requerida para autenticación y procesamiento de IA
  • Ubicación: Disponible solo en países soportados

Solución de problemas de instalación de WSL

Actualmente, Claude Code no se ejecuta directamente en Windows y requiere WSL. Si encuentras problemas en WSL:

  1. Problemas de detección de OS/plataforma: Si recibes un error durante la instalación, WSL podría estar usando npm de Windows. Intenta:

    • Ejecutar npm config set os linux antes de la instalación
    • Instalar con npm install -g @anthropic-ai/claude-code --force --no-os-check (NO uses sudo)
  2. Errores de Node no encontrado: Si ves exec: node: not found al ejecutar claude, tu entorno WSL podría estar usando una instalación de Node.js de Windows. Puedes confirmarlo con which npm y which node, que deberían apuntar a rutas de Linux que empiecen con /usr/ en lugar de /mnt/c/. Para solucionarlo, intenta instalar Node a través del gestor de paquetes de tu distribución Linux o mediante nvm.

Instalar y autenticar

1

Instalar Claude Code

Install NodeJS 18+, then run:

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

Do NOT use sudo npm install -g as this can lead to permission issues and security risks. If you encounter permission errors, see configure Claude Code for recommended solutions.

2

Navegar a tu proyecto

cd your-project-directory 
3

Iniciar Claude Code

claude
4

Completar autenticación

Claude Code ofrece múltiples opciones de autenticación:

  1. Consola de Anthropic: La opción predeterminada. Conéctate a través de la Consola de Anthropic y completa el proceso de OAuth. Requiere facturación activa en console.anthropic.com.
  2. Aplicación Claude (con plan Max): Suscríbete al plan Max de Claude para obtener una suscripción única que incluye tanto Claude Code como la interfaz web. Obtén más valor por el mismo precio mientras gestionas tu cuenta en un solo lugar. Inicia sesión con tu cuenta de Claude.ai. Durante el lanzamiento, elige la opción que coincida con tu tipo de suscripción.
  3. Plataformas empresariales: Configura Claude Code para usar Amazon Bedrock o Google Vertex AI para implementaciones empresariales con tu infraestructura en la nube existente.

Inicializar tu proyecto

Para usuarios nuevos, recomendamos:

1

Iniciar Claude Code

claude
2

Ejecutar un comando simple

summarize this project
3

Generar una guía del proyecto CLAUDE.md

/init 
4

Confirmar el archivo CLAUDE.md generado

Pide a Claude que confirme el archivo CLAUDE.md generado en tu repositorio.