Cómo Instalar Claude Code y Ejecutar Tu Primera Tarea de IA
Instala Claude Code en cualquier plataforma y ejecuta tu primera tarea de codificación autónoma en menos de 10 minutos. Esta guía cubre instalación, configuración y tus primeros prompts reales.
Claude Code es la herramienta de codificación agéntica de Anthropic. Se ejecuta en tu terminal, lee todo tu proyecto, edita archivos, ejecuta comandos e itera sobre los resultados. Esta guía te lleva de cero a tu primera sesión productiva en menos de 10 minutos.
Cómo se instala Claude Code
Claude Code se instala con un solo comando en macOS, Linux o WSL. En Windows, usa PowerShell.
macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell
irm https://claude.ai/install.ps1 | iexMétodos alternativos
| Método | Comando |
|---|---|
| Homebrew (macOS) | brew install claude-code |
| npm (cualquier plataforma) | npm install -g @anthropic-ai/claude-code |
| Extensión VS Code | Busca "Claude Code" en el marketplace de VS Code |
| Plugin JetBrains | Busca "Claude Code" en el marketplace de JetBrains |
Verifica la instalación:
claude --version
# Claude Code 2.x.xCómo inicias tu primera sesión
Navega a cualquier directorio de proyecto y escribe `claude`. Claude Code lee la estructura de tu proyecto y construye contexto automáticamente. No necesitas configurar nada para empezar.
cd tu-proyecto
claudeVerás un prompt donde puedes escribir instrucciones en lenguaje natural. Claude Code entiende tu proyecto porque lee tus archivos, no porque tú se los expliques.
Cuáles son buenos primeros prompts
Empieza con tareas que te ayuden a entender lo que Claude Code puede hacer. Estos prompts funcionan bien para una primera sesión:
# Entender el proyecto
> "Qué hace este proyecto? Dame una visión general de alto nivel."
# Encontrar problemas
> "Hay bugs obvios o code smells en esta base de código?"
# Tomar acción
> "Escribe pruebas para el módulo de autenticación, ejecútalas y corrige los fallos"
# Tarea de múltiples pasos
> "Añade validación de entrada al formulario de registro de usuario,
escribe pruebas unitarias y haz commit con un mensaje descriptivo"El último ejemplo muestra el verdadero poder de Claude Code: escribe código, ejecuta pruebas, lee la salida, corrige fallos y hace commit. Todo en un prompt. Esa es la diferencia entre una herramienta de chat y un agente.
Qué hace diferente a Claude Code de otras herramientas de IA
| Capacidad | Claude Code | Herramientas basadas en chat |
|---|---|---|
| Acceso a archivos | Lee cualquier archivo de tu proyecto | Solo lo que pegues |
| Ejecución | Ejecuta comandos en tu terminal | Sin ejecución |
| Iteración | Corrige sus propios errores | Tú copias y pegas las correcciones |
| Git | Crea commits, ramas, PRs | Sin integración git |
| Memoria | CLAUDE.md persiste entre sesiones | Sin memoria |
Cómo configurar CLAUDE.md para mejores resultados
Crea un archivo CLAUDE.md en la raíz de tu proyecto. Claude Code lo lee al inicio de cada sesión. Le dice al agente sobre las convenciones de tu proyecto, stack tecnológico y reglas.
# Crear CLAUDE.md automáticamente
claude /init
# O escribir uno manualmente
cat > CLAUDE.md << 'EOF'
# Contexto del Proyecto
App Next.js 14 con TypeScript y Tailwind CSS.
## Comandos
- npm run dev — iniciar servidor de desarrollo
- npm run test — ejecutar pruebas
## Convenciones
- Usar server components por defecto
- Nunca usar `any` en TypeScript
EOFConsulta nuestra guía detallada sobre mejores prácticas de CLAUDE.md para configuración avanzada.