Cómo usar Claude Code para programar con IA

Claude Code es la herramienta oficial de Anthropic que vive en tu terminal y entiende el contexto completo de tu repositorio. Se instala como paquete global de npm, así que necesitas Node.js 18 o superior. Comprueba tu versión con node --version antes de empezar. La instalación descarga el CLI y lo deja disponible como el comando claude en cualquier directorio. En España y LATAM funciona igual: no hay restricciones de región para el CLI, aunque necesitas una cuenta de Anthropic con facturación activa o un plan Claude que incluya Code. Tras instalar, verifica que el binario responde ejecutando claude --version. Si el comando no se encuentra, revisa que la carpeta global de npm esté en tu PATH.

# Comprueba Node
node --version

# Instala Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Verifica la instalación
claude --version

La primera vez que ejecutas claude dentro de un proyecto, se abre un flujo de autenticación en el navegador. Inicias sesión con tu cuenta de Anthropic y autorizas el acceso; el token se guarda de forma segura en tu máquina. Si prefieres usar una API key directamente (por ejemplo en entornos CI o servidores sin navegador), puedes exportar la variable ANTHROPIC_API_KEY. El modelo por defecto es claude-opus-4-8, ideal para tareas de razonamiento complejo sobre código, aunque puedes cambiarlo si buscas respuestas más rápidas. Una vez autenticado, Claude Code lee automáticamente los archivos del directorio actual para construir contexto, respetando tu .gitignore para no exponer secretos.

# Autenticación interactiva (abre el navegador)
cd mi-proyecto
claude

# Alternativa para CI o servidores sin navegador
export ANTHROPIC_API_KEY="sk-ant-..."

El archivo CLAUDE.md es el corazón de un buen flujo con Claude Code. Se coloca en la raíz del proyecto y Claude lo lee automáticamente en cada sesión. Ahí documentas las convenciones de tu equipo: comandos de build y test, estilo de código, estructura de carpetas y cualquier regla que no quieras repetir en cada prompt. Es como el onboarding que darías a un dev nuevo. Cuanto más claro sea, menos correcciones tendrás que hacer después. Puedes tener un CLAUDE.md general en la raíz y otros específicos en subdirectorios para monorepos. Mantenlo conciso: no es documentación exhaustiva, sino las reglas operativas que Claude debe respetar siempre.

# CLAUDE.md

## Comandos
- Instalar: npm install
- Tests: npm test
- Lint: npm run lint

## Convenciones
- TypeScript estricto, sin any
- Componentes funcionales con hooks
- Nombres de variables en inglés, comentarios en español
- Commits siguiendo Conventional Commits

## Estructura
- src/components: componentes UI
- src/lib: lógica de negocio
- tests junto al archivo que prueban

Con el contexto listo, ya puedes pedir cambios reales. Dentro de la sesión interactiva escribes instrucciones en lenguaje natural y Claude Code propone ediciones concretas en tus archivos, mostrándote un diff antes de aplicarlo. Puedes pedir refactorizaciones, corrección de bugs, añadir tests o migrar sintaxis. La clave es ser específico: menciona archivos, funciones o el comportamiento esperado. Claude Code no solo escribe: ejecuta comandos, corre tus tests y ajusta el resultado si algo falla, todo con tu aprobación. Revisa cada diff antes de aceptar; eres tú quien mantiene el control del código que entra al repositorio.

# Dentro de la sesión de Claude Code
> Refactoriza src/lib/auth.js para usar async/await
  en lugar de promesas encadenadas y añade manejo de errores

> Añade tests unitarios para la función validarEmail
  en src/lib/validators.js usando Jest

> Encuentra por qué el test de login falla y arréglalo

Claude Code también funciona en modo no interactivo, perfecto para scripts y automatización. Con la bandera -p (print) le pasas un prompt, ejecuta la tarea y devuelve el resultado sin abrir la sesión interactiva. Esto lo hace ideal para hooks de git, pipelines de CI o tareas repetitivas como generar changelogs, revisar un PR o resumir cambios. Puedes encadenarlo con otras herramientas de Unix mediante pipes. Por ejemplo, generar mensajes de commit a partir del diff staged, o pedir una revisión rápida de seguridad antes de hacer push. Combinado con tu CLAUDE.md, respeta las convenciones del equipo sin intervención manual.

# Generar un mensaje de commit desde los cambios staged
git diff --staged | claude -p "Escribe un mensaje de commit\nsiguiendo Conventional Commits para estos cambios"

# Revisión rápida antes de push
claude -p "Revisa los cambios sin commit y señala\nposibles bugs o problemas de seguridad"

Para sacarle partido de verdad, intégralo en tu rutina. Úsalo para explorar código heredado que no conoces ('explícame cómo funciona el módulo de pagos'), para escribir tests que siempre pospones, o para hacer de pair programmer en features complejas. Los slash commands como /clear reinician el contexto entre tareas distintas y /cost te muestra el gasto de la sesión. Puedes crear comandos personalizados guardándolos en .claude/commands para tareas específicas de tu proyecto. La mentalidad correcta es tratarlo como un colega senior que conoce todo el repositorio: le delegas trabajo bien definido y revisas su output. Con la práctica, reducirás horas de trabajo repetitivo y podrás centrarte en decisiones de arquitectura.

# Comandos útiles dentro de la sesión
/clear      # limpia el contexto para una nueva tarea
/cost       # muestra tokens y coste de la sesión
/init       # genera o actualiza CLAUDE.md

# Comando personalizado en .claude/commands/review.md
# Contenido del archivo:
Revisa este código buscando problemas de rendimiento
y sugiere mejoras concretas con ejemplos.