Claude Code empezó como una herramienta experimental de terminal a finales de 2024. En marzo de 2026 es el agente de codificación más usado por desarrolladores que trabajan con bases de código reales: el 4% de los commits públicos de GitHub —unos 135.000 al día— llevan ya su firma, y el 90% del código interno de Anthropic se escribe con asistencia de IA. Si todavía lo usas como un chatbot mejorado para preguntar dudas de código, estás perdiendo el 80% de su potencial.
Esta guía cubre lo que realmente importa: configuración que marca la diferencia desde el primer día, los comandos que uso cada semana, las novedades de marzo 2026 (voice mode, /loop, contexto de 1 millón de tokens) y el flujo de trabajo que convierte Claude Code en un multiplicador real de productividad.
Instalación y requisitos
Necesitas Node.js 18 o superior. La instalación es global:
npm install -g @anthropic-ai/claude-code
# Actualizar a la última versión (2.1.76 en marzo 2026)
npm update -g @anthropic-ai/claude-code
# Verificar versión
claude --versionPuedes autenticarte con tu suscripción Claude (Pro o Max) o con una API key. Para uso intensivo diario, la suscripción Max a 100$/mes sale más barata que pagar por tokens. Para uso esporádico o proyectos puntuales, la API key con Haiku 4.5 es la opción más económica.
# Con suscripción Claude
claude auth login
# Con API key directamente
export ANTHROPIC_API_KEY=sk-ant-...
claudeCLAUDE.md: el archivo que más cambia los resultados
El CLAUDE.md es el documento de contexto que Claude Code lee al iniciar una sesión en tu proyecto. Sin él, Claude empieza cada sesión desde cero sin saber nada de tu stack, tus convenciones ni lo que no debe tocar. Con él, el primer prompt ya produce resultados útiles.
Puedes generarlo automáticamente con /init dentro de una sesión, pero el resultado suele ser genérico. Lo que funciona es un CLAUDE.md conciso y específico:
# Mi Proyecto
## Stack
- Next.js 15, React 18, TypeScript 5.7 strict
- Tailwind CSS 3.4, SCSS módulos
- Supabase REST API como fuente principal de datos
- Deploy: Vercel (rama master → producción automática)
## Comandos clave
- `npm run dev` — servidor de desarrollo (puerto 3000)
- `npm run build` — build de producción
- `npm test` — Jest + React Testing Library
- `npm run typecheck` — TypeScript sin emitir
## Convenciones
- Componentes: PascalCase, functional, named exports
- Hooks personalizados en src/hooks/ con prefijo use
- Tests junto al código en __tests__/
- Nunca usar `any` salvo en mappers de Supabase
- content_md tiene prioridad sobre content en posts
## NO tocar
- src/graphql/apollo-client.ts (legacy, pendiente migración)
- .env.local (nunca committear)
- La rama master despliega en Vercel automáticamenteMantén el CLAUDE.md bajo 200 líneas. Más largo y Claude empieza a ignorar partes. Añade solo lo que cambia el comportamiento por defecto, no lo que Claude ya sabe hacer bien.
El flujo Explore-Plan-Code-Commit
El flujo que más productividad genera no es hacer preguntas puntuales. Es asignar tareas completas:
Explore primero: antes de tocar nada en un área desconocida.
claude "Explícame cómo funciona el sistema de caché de posts antes de que cambie nada"Plan antes de implementar: para cambios que afecten a varios archivos.
claude "Quiero añadir paginación cursor-based al endpoint de posts. Dame un plan detallado antes de escribir código"Code con contexto completo: Claude edita ficheros, ejecuta tests y corrige errores sin que tengas que intervenir.
claude "Implementa el plan anterior. Ejecuta los tests cuando termines y dime si todos pasan"Commit atómico: pide commits descriptivos con el contexto del cambio.
claude "Haz un commit con mensaje descriptivo en formato conventional commits"Novedades de marzo 2026
Voice mode con /voice
La novedad más llamativa del mes es el modo voz. Se activa con /voice dentro de una sesión y funciona con push-to-talk: mantienes la barra espaciadora para hablar y sueltas para enviar. No es escucha continua, es un mecanismo controlado.
# Dentro de una sesión activa
/voice
# Mantén ESPACIO para hablar → suelta para enviarSoporta 20 idiomas en marzo 2026, incluyendo español. Especialmente útil cuando tienes las manos ocupadas o quieres dictar un prompt largo sin teclear.
/loop para tareas programadas
/loop convierte Claude Code en un cron job dentro de tu sesión. Ejecuta un prompt a intervalos regulares:
# Revisar el estado del build cada 5 minutos
/loop 5m comprueba el estado del build y avísame si hay errores
# Monitorizar logs en tiempo real
/loop 2m revisa los últimos logs y resúmeme si hay algo anómalo
# Revisar PRs pendientes cada hora
/loop 1h lista los PRs abiertos que llevan más de 24h sin revisiónPara proyectos en producción es especialmente valioso como monitor ligero durante un deploy delicado.
Contexto de 1 millón de tokens
Desde v2.1.75, el contexto de 1 millón de tokens está activo por defecto en los planes Max, Team y Enterprise. Esto permite cargar bases de código grandes enteras sin compresión del contexto.
# Análisis de toda la base de código sin truncar
claude "Analiza todos los componentes de src/components y dame un informe de deuda técnica"
# Comparación entre ramas
claude "Compara los cambios entre main y feature/nuevo-blog y dame un resumen de impacto"ultrathink para razonamiento profundo
ultrathink es una palabra clave que añades al prompt para forzar un nivel de razonamiento más profundo en ese turno específico. Útil para problemas de arquitectura o debugging complejo:
claude "ultrathink: ¿por qué el bundle de producción pesa 40% más que hace dos semanas?"Comandos esenciales que uso cada día
# Continuar la última sesión
claude --continue
# Iniciar sesión con nombre para identificarla
claude -n "migración-supabase"
# Ejecutar un prompt no interactivo y salir
claude -p "¿Cuántos tests hay en el proyecto y cuál es la cobertura actual?"
# Ver el contexto actual de la sesión
/context
# Resetear la conversación sin cerrar la sesión
/clear
# Ver estadísticas de uso de tokens
/stats
# Ejecutar un comando shell directamente
!npm run build
!git log --oneline -10Errores comunes al empezar con Claude Code
Dar prompts demasiado vagos. "Mejora el código" no sirve. "Revisa src/components/ContactSection.tsx y elimina el estado duplicado de privacidad entre el componente padre y el formulario" sí sirve. Cuanto más específico el contexto, mejor el resultado.
No aprovechar el CLAUDE.md. Si cada sesión tienes que explicar el stack del proyecto, estás perdiendo tiempo. El CLAUDE.md existe para eso.
Aprobar cambios sin revisar. Claude Code puede ejecutar comandos y modificar archivos. Revisa siempre los diffs antes de aceptar, especialmente en operaciones de escritura en base de datos o deploys.
Usar Opus para todo. Opus es el modelo más potente pero también el más caro (~5x más que Haiku). Para tareas de exploración, búsqueda en archivos o preguntas simples, usa /model claude-haiku-4-5-20251001 y reserva Opus para los problemas que realmente lo necesitan.
No salir de sesiones largas. Las sesiones muy largas acumulan contexto irrelevante. Para cambiar de tarea, mejor abrir una sesión nueva con /new o claude -n "nueva-tarea".
Buenas prácticas para equipos
Comparte el CLAUDE.md en el repositorio. Igual que el .editorconfig o el .eslintrc, el CLAUDE.md debe estar versionado para que todos los desarrolladores del equipo tengan el mismo contexto de partida.
Crea comandos personalizados en .claude/commands/. Son archivos Markdown con prompts reutilizables para las tareas más frecuentes del equipo:
# .claude/commands/revisar-pr.md
Revisa el diff actual con estos criterios:
1. TypeScript estricto — sin any implícitos
2. Tests necesarios para la nueva lógica
3. Impacto en el bundle de producción
4. Accesibilidad WCAG 2 AA en componentes nuevos
Devuelve la revisión en formato de comentario de PR.Usa Claude Code con worktrees para paralelizar trabajo:
git worktree add ../feature-chat chat
cd ../feature-chat
claude -n "feature-chat" # Sesión independiente sin interferir con la rama principalConclusión
Claude Code en 2026 ya no es un experimento. Es una herramienta de producción con 1M de tokens de contexto, voice mode, tareas programadas con /loop y un modelo Opus 4.6 que entiende bases de código completas. La diferencia entre usarlo bien y usarlo regular no está en el modelo, está en el CLAUDE.md y en el flujo de trabajo: Explore → Plan → Code → Commit.
Instálalo, escribe un CLAUDE.md para tu proyecto más activo y dale una semana. El retorno en tiempo ahorrado es inmediato y medible.