Lo que vas a construir
Vas a instalar Claude Code CLI, la herramienta de Anthropic que pone a Claude directamente en tu terminal. Tendras un asistente de IA que puede leer tus archivos, ejecutar comandos y entender el contexto completo de tu proyecto. Es como tener un desarrollador senior a tu lado, ayudandote desde la linea de comandos. Al terminar, podras pedirle a Claude que explique codigo, corrija bugs, cree tests y ejecute comandos por ti.
Paso 1: Instalar Claude Code
npm install -g @anthropic-ai/claude-code
Verifica la instalación:
claude --version
Paso 2: Configurar tu API Key
| Sistema | Comando |
|---|---|
| macOS/Linux | export ANTHROPIC_API_KEY="tu-key-aqui" |
| Windows PowerShell | $env:ANTHROPIC_API_KEY="tu-key-aqui" |
💡 Para hacerlo permanente, agrégalo a tu
.bashrco.zshrc
Paso 3: Iniciar Claude Code
Navega a tu proyecto y ejecuta:
cd mi-proyecto
claude
Claude ahora puede ver tus archivos y ayudarte.
¿Qué puede hacer?
| Pide esto | Claude hace |
|---|---|
| "Explica este archivo" | Lee y explica el código |
| "Corrige el bug en app.js" | Edita el archivo |
| "Crea un test para esta función" | Crea nuevo archivo |
| "Ejecuta los tests" | Corre npm test |
| "Instala express" | Corre npm install express |
Ejemplo práctico
$ claude
> ¿Qué hace el archivo index.js?
Claude lee el archivo y te explica...
> Agrega un endpoint GET /health que retorne { status: 'ok' }
Claude edita index.js y agrega el endpoint...
> Pruébalo
Claude ejecuta curl localhost:3000/health...
Comandos útiles dentro de Claude
| Comando | Acción |
|---|---|
/help | Ver ayuda |
/clear | Limpiar conversación |
/compact | Modo compacto |
Ctrl+C | Salir |
Si algo falló
| Error | Causa | Solución |
|---|---|---|
command not found: claude | No instalado | npm install -g @anthropic-ai/claude-code |
authentication_error | API key inválida | Verifica tu ANTHROPIC_API_KEY |
No such file or directory | Directorio vacío | Navega a un proyecto con archivos |
| Respuestas lentas | Modelo grande | Normal, Claude piensa... |
¿Cuándo usar Claude Code vs Chat web?
| Claude Code (CLI) | Claude.ai (Web) |
|---|---|
| Editar código en tu proyecto | Preguntas generales |
| Ejecutar comandos | Conversaciones largas |
| Contexto de archivos local | Subir archivos manualmente |
Aprende más
→ Editores y AI Assistants — Comparativa completa: Claude Code vs Copilot vs Cursor vs Aider
Próximo paso
→ Hola Mundo en Terminal — Comandos básicos → Mi Primer Repositorio — Git básico