Primeros pasos con Claude Code
Aprende cómo instalar, autenticar y empezar a usar Claude Code.
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:
- 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:
-
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 usessudo
)
- Ejecutar
-
Errores de Node no encontrado: Si ves
exec: node: not found
al ejecutarclaude
, tu entorno WSL podría estar usando una instalación de Node.js de Windows. Puedes confirmarlo conwhich npm
ywhich 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 mediantenvm
.
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
Iniciar Claude Code
Completar autenticación
Claude Code ofrece múltiples opciones de autenticación:
- 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.
- 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.
- 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:
Iniciar Claude Code
Ejecutar un comando simple
Generar una guía del proyecto CLAUDE.md
Confirmar el archivo CLAUDE.md generado
Pide a Claude que confirme el archivo CLAUDE.md generado en tu repositorio.
Was this page helpful?