Comenzando con Claude Code
Aprende cómo instalar, autenticar y comenzar a usar Claude Code.
Verificar los requisitos del sistema
- Sistemas Operativos: macOS 10.15+, Ubuntu 20.04+/Debian 10+, o Windows vía WSL
- Hardware: 4GB RAM mínimo
- Software:
- Red: Conexión a Internet requerida para autenticación y procesamiento de IA
- Ubicación: Disponible solo en países compatibles
Solución de problemas de instalación de WSL
Actualmente, Claude Code no se ejecuta directamente en Windows, y en su lugar requiere WSL. Si encuentras problemas en WSL:
-
Problemas de detección de SO/plataforma: Si recibes un error durante la instalación, WSL puede 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 usessudo
)
- Ejecutar
-
Errores de Node no encontrado: Si ves
exec: node: not found
al ejecutarclaude
, tu entorno WSL puede estar usando una instalación de Windows de Node.js. Puedes confirmar esto conwhich npm
ywhich node
, que deberían apuntar a rutas de Linux que comiencen con/usr/
en lugar de/mnt/c/
. Para solucionarlo, intenta instalar Node a través del administrador de paquetes de tu distribución de Linux o a través denvm
.
Instalar y autenticar
Instalar Claude Code
Install NodeJS 18+, then run:
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.
Navegar a tu proyecto
bash cd tu-directorio-de-proyecto
Iniciar Claude Code
bash claude
Completar la 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 OAuth. Requiere facturación activa en console.anthropic.com. 2. Aplicación Claude (con plan Pro o Max): Suscríbete al plan Pro o Max de Claude para una suscripción unificada que incluye tanto Claude Code como la interfaz web. Obtén más valor al mismo precio mientras administras 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 de nube existente.
Inicializar tu proyecto
Para usuarios primerizos, recomendamos:
Iniciar Claude Code
bash claude
Ejecutar un comando simple
bash resumir este proyecto
Generar una guía de proyecto CLAUDE.md
bash /init
Confirmar el archivo CLAUDE.md generado
Pide a Claude que confirme el archivo CLAUDE.md generado en tu repositorio.