Guía completa para empezar con Claude Code 2026 | De cero a usarlo en tu trabajo real en 7 pasos

“He escuchado hablar de Claude Code, pero no sé por dónde empezar.”

Eso fue exactamente lo que sentí cuando lo usé por primera vez. Podía escribir claude en la terminal y ver que algo pasaba — pero no tenía ninguna idea de cómo meterlo en mi día a día como desarrollador.

En esta guía te cuento todo lo que hice para pasar de cero a usar Claude Code en proyectos reales, organizado en 7 pasos concretos. Si ya lo instalaste pero no sabés qué hacer con él, esta guía es para vos.

---

Paso 1: Instalación y configuración inicial

Instalación

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

Necesitás Node.js 18 o superior. Después de instalar, verificá la versión con claude --version.

Configurar tu API Key

Claude Code usa la API de Anthropic. Creá una cuenta en console.anthropic.com y obtené tu API key.

# Opción 1: Variable de entorno (recomendado)
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# Opción 2: Configurarla cuando arrancás claude por primera vez
claude
# → Te va a pedir que ingreses tu API key

Primera prueba de funcionamiento

claude -p "Hello! Please introduce yourself."

Si esto funciona, la configuración está lista.

---

Paso 2: Crear un CLAUDE.md para contarle a Claude sobre tu proyecto

Claude Code lee automáticamente CLAUDE.md en la raíz de tu proyecto. Si escribís ahí la información del proyecto, no tenés que explicarla cada vez.

Así era mi primer CLAUDE.md, bien simple:

# Nombre del proyecto

## Stack tecnológico
- TypeScript + Node.js
- PostgreSQL (Prisma)
- React + Vite

## Comandos habituales
- Servidor de desarrollo: npm run dev
- Tests: npm test
- Build: npm run build

## Reglas
- Los comentarios van en español
- Nombres de funciones en camelCase en inglés

Con eso alcanza. Claude Code va a entender que “este proyecto usa TypeScript y los tests corren con npm test.”

El primer error que cometí: Empecé a usar Claude Code sin CLAUDE.md y en cada conversación tenía que explicar “este proyecto es TypeScript.” Dedicale 5 minutos al principio y todas las conversaciones siguientes serán mucho más fluidas.

---

Paso 3: Elegir tus primeras “tareas de práctica”

Si arrancás con algo complejo de entrada, es fácil que pienses: “esto es más difícil de usar de lo que esperaba.” Mejor empezá con estas tareas:

Lista de tareas para principiantes (Dificultad baja)

# 1. Pedir una explicación de código
claude -p "Read src/auth/login.ts and explain what this file does"

# 2. Pedir un code review
claude -p "Review the code in src/utils/date.ts and tell me what could be improved"

# 3. Hacer que escriba tests
claude -p "Write unit tests for the getUserById function in src/api/users.ts"

# 4. Generar un README
claude -p "Create a README.md for this project"

Todas estas tareas son de “solo lectura” o “agregar un archivo nuevo.” Dejá las tareas que modifican código existente para cuando ya te sientas cómodo con Claude Code.

---

Paso 4: Aprender cuándo usar el modo interactivo vs. el modo one-shot

Claude Code tiene dos formas principales de uso.

Modo interactivo (claude)

cd mi-proyecto
claude

Tu terminal se convierte en un REPL donde podés tener varias idas y vueltas. Ideal para trabajo iterativo — “modificá esto con esta intención,” “mejor deshacé ese cambio.”

Modo one-shot (claude -p "...")

claude -p "List every place in src/api/ that still has a TODO comment"

Se ejecuta una vez y devuelve el resultado. Perfecto para scripts y pipelines de CI.

Mi regla personal: Modo interactivo para implementaciones complejas, modo one-shot para investigación, verificación y tareas rutinarias.

---

Paso 5: Configurar permisos para trabajar con seguridad

Como Claude Code puede modificar archivos y ejecutar comandos, configurar permisos desde el principio te va a dar tranquilidad.

Creá .claude/settings.json:

{
  "permissions": {
    "allow": [
      "Read(**)",
      "Glob(**)",
      "Grep(**)",
      "Bash(npm run *)",
      "Bash(git log*)",
      "Bash(git diff*)",
      "Bash(git status*)"
    ],
    "deny": [
      "Bash(rm -rf*)",
      "Bash(git push --force*)"
    ],
    "ask": [
      "Write(**)",
      "Edit(**)",
      "Bash(git commit*)",
      "Bash(git push*)"
    ]
  }
}

Con esta configuración:

• Se ejecuta automáticamente: Leer archivos, buscar, correr tests
• Siempre pregunta: Escribir archivos, git commit y push
• Bloqueado permanentemente: rm -rf y git push --force

Empezá poniendo muchas operaciones en ask y pasalas a allow a medida que vayas ganando confianza.

---

Paso 6: Aprender a escribir instrucciones efectivas

Una de las primeras cosas que vas a notar es que la calidad de los resultados de Claude Code depende mucho de cómo redactás tus instrucciones.

Ejemplos malos vs. buenos

# ❌ Demasiado vago
claude -p "Arreglá el login"

# ✅ Específico y con alcance claro
claude -p "
Fix the login function in src/api/auth.ts (around line 42):
- No handling when the password field is empty — should return a 400 error
- Error messages are English-only — return them in English and Spanish too
Follow the existing error handling pattern in src/utils/errors.ts
"

Tres consejos clave:

1. Especificá nombres de archivo y número de línea — reduce drásticamente el tiempo de exploración
2. Describí el comportamiento esperado en concreto — “hacelo mejor” no funciona
3. Indicá las restricciones — “seguí el patrón existente”, “no toques otros archivos”

---

Paso 7: Integrarlo en tu flujo de trabajo diario

Una vez que tenés los fundamentos claros, incorporalo a tu rutina. Acá van los patrones que yo uso todos los días.

Revisión matutina

# Resumen de los commits de ayer
claude -p "Run git log --oneline -10 and give me a plain-English summary of what changed"

Para resolver bugs

claude
# → Pegá el log de error y decí "mirá este error log y encontrá la causa"

Generar descripciones de PR

claude -p "
Review the changes in git diff main...feature/add-search and write a GitHub PR description in markdown.
Include: purpose of the changes, implementation approach, and how to test it.
"

Ayuda con code reviews

claude -p "
Review the changed files in this PR:
$(git diff --name-only main...HEAD)

Prioritize flagging any security issues and performance concerns.
"

---

Los obstáculos más comunes al principio y cómo superarlos

Obstáculo 1: “Se siente lento”

Claude Code se vuelve más lento a medida que la conversación crece. Ejecutá /compact cada 30–60 minutos para comprimir el historial.

# Dentro del REPL de Claude Code
/compact

Obstáculo 2: “Intenta leer demasiados archivos”

Simplemente agregá “no necesitás leer nada más” en tu instrucción.

# Antes
"Fix the bug in src/"

# Después
"Read only src/api/auth.ts and fix the bug there. You don't need to read any other files."

Obstáculo 3: “Me preocupa el costo”

Por defecto usa el modelo Opus de alta capacidad, pero para tareas sencillas Sonnet es más que suficiente.

# Cambiar modelo durante la sesión
/model claude-sonnet-4-6

---

Resumen: qué hacer en tu primera semana

Día 1:   Instalar + escribir el CLAUDE.md
Día 2-3: Probar tareas básicas (explicar código, code reviews)
Día 4-5: Configurar permisos y probar edición real de archivos
Día 6-7: Integrarlo en tu propio flujo de trabajo

Cuanto más uses Claude Code, más fuerte se vuelve tu intuición de “cuándo usarlo.” Pasá tu primera semana pidiendo explicaciones de código y haciendo que escriba tests — y después andá escalando a tareas más complejas de a poco.

Este sitio (claudecode-lab.com) funciona enteramente con Claude Code — la generación de artículos, la traducción y el deploy están automatizados todos los días. Al principio pensé “¿en serio eso es posible?” — hoy no me imagino desarrollar sin Claude Code. Animate a probarlo.

Artículos relacionados

• Guía de optimización de velocidad de Claude Code
• Guía completa para reducir los costos de la API de Claude Code en un 90%
• Guía completa de seguridad para Claude Code
• Mejores prácticas para CLAUDE.md