Claude Code: guía completa del agente de desarrollo de Anthropic

Claude Code es el agente de desarrollo en terminal creado por Anthropic. No es un autocompletado de código ni un chatbot con acceso a archivos. Es un agente autónomo que lee tu proyecto, ejecuta comandos, edita archivos, crea commits y resuelve problemas complejos de ingeniería sin salir de tu terminal.

En 2026, Claude Code se ha convertido en la herramienta de referencia para desarrolladores que quieren multiplicar su productividad sin renunciar al control. A diferencia de los editores con IA integrada, Claude Code opera directamente sobre tu entorno real: tu sistema de archivos, tu terminal, tus herramientas. No hay sandbox ni simulación.

Esta guía reúne todo lo que necesitas saber sobre Claude Code, desde la instalación hasta arquitecturas avanzadas con subagentes y CI/CD. Cada sección enlaza al artículo especializado donde puedes profundizar.

Qué es Claude Code

Claude Code es un agente agentic que funciona dentro de tu terminal. Cuando lo ejecutas con el comando claude, analiza tu proyecto, entiende la estructura de archivos, lee el código fuente y puede realizar acciones reales: crear archivos, modificar código existente, ejecutar tests, hacer commits de git y mucho más.

La diferencia fundamental con otras herramientas de IA para código es el nivel de autonomía. Claude Code no sugiere: ejecuta. Le describes lo que quieres ("refactoriza este módulo para usar inyección de dependencias") y él lee el código, planifica los cambios, los implementa y verifica que los tests pasen.

Bajo el capó, Claude Code utiliza los modelos Sonnet y Opus de Anthropic con una ventana de contexto de hasta 1 millón de tokens. Esto significa que puede leer proyectos enteros (cientos de archivos) y mantener coherencia a lo largo de sesiones largas de trabajo.

Instalación y primeros pasos

Instalar Claude Code lleva menos de 2 minutos. Necesitas Node.js 18+ y una cuenta de Anthropic con plan Max o Team. El comando de instalación es un simple npm install -g @anthropic-ai/claude-code y después ejecutas claude en la raíz de tu proyecto.

La primera vez que lo ejecutas, Claude Code te redirige al navegador para autenticarte con tu cuenta de Anthropic. Después de eso, está listo para trabajar. No hay configuración adicional obligatoria, aunque el verdadero poder viene cuando configuras CLAUDE.md (siguiente sección).

Claude Code funciona en Mac, Windows (via WSL2 o terminal nativa) y Linux. En Windows, la experiencia óptima es con WSL2, aunque la terminal nativa también funciona para la mayoría de casos.

CLAUDE.md: el cerebro de tu proyecto

CLAUDE.md es el archivo de configuración más importante de Claude Code. Es un archivo Markdown que colocas en la raíz de tu proyecto y que Claude Code lee automáticamente al inicio de cada sesión. Funciona como una "memoria persistente" que le dice al agente cómo es tu proyecto, qué convenciones sigue, qué patrones usar y qué errores evitar.

Un buen CLAUDE.md transforma completamente la calidad de las respuestas. Sin él, Claude Code es un agente genérico. Con él, se convierte en un desarrollador que conoce tu stack, tus convenciones y tus preferencias.

Hay tres niveles de CLAUDE.md: el global (~/.claude/CLAUDE.md, que aplica a todos tus proyectos), el de proyecto (en la raíz del repo) y los de directorio (para instrucciones específicas de subcarpetas). Los tres se combinan automáticamente.

Comandos esenciales

Claude Code tiene dos tipos de comandos: los slash commands (que escribes dentro de una sesión, como /help, /clear, /compact) y los comandos de terminal (que ejecutas desde tu shell, como claude, claude -p "prompt", claude commit).

Los comandos más usados en el día a día: /compact para comprimir el contexto cuando la sesión se alarga, /clear para reiniciar, claude commit para generar commits semánticos automáticamente, y el modo pipe (echo "pregunta" | claude) para integraciones con scripts.

Sistema de memoria

La memoria de Claude Code funciona en varias capas. A corto plazo, el contexto de la conversación actual (hasta 1M tokens). A medio plazo, los archivos CLAUDE.md que persisten entre sesiones. Y a largo plazo, la memoria automática que Claude Code genera cuando le dices "recuerda esto" o cuando detecta patrones que debería retener.

Entender cómo funciona la memoria es crítico para sesiones largas. Cuando el contexto se llena, Claude Code empieza a "olvidar" las primeras interacciones. El comando /compact comprime el contexto manteniendo lo esencial, pero es mejor tener la información clave en CLAUDE.md que depender del contexto de conversación.

Skills y extensiones

Las skills son extensiones que amplían las capacidades de Claude Code. Puedes instalar skills de la comunidad con npx skills add nombre/skill o crear las tuyas propias como archivos Markdown con instrucciones especializadas. Una skill puede ser desde un experto en SEO hasta un auditor de seguridad o un generador de commits optimizado.

El sistema de skills convierte a Claude Code en una plataforma extensible. En lugar de tener un agente genérico, puedes cargar skills específicas para cada tarea: una skill de review de código, otra de generación de tests, otra de documentación técnica.

Subagentes

Los subagentes son instancias de Claude Code que el agente principal puede crear para delegar tareas. Cuando Claude Code necesita investigar algo complejo, puede lanzar un subagente que trabaja en paralelo con un scope acotado. El subagente explora, analiza y devuelve un resumen al agente principal.

Este patrón es fundamental para tareas complejas. En lugar de un agente que intenta hacerlo todo (anti-pattern monolithic agent), el coordinador delega subtareas específicas: "investiga cómo funciona este módulo", "busca todos los usos de esta función", "analiza las dependencias de este paquete".

Worktrees: trabajo en paralelo

Los worktrees de git permiten tener múltiples copias de trabajo del mismo repositorio en paralelo. Claude Code aprovecha esto para trabajar en varias ramas simultáneamente sin interferencias. Puedes tener un agente refactorizando en una rama mientras otro implementa una feature nueva en otra.

Esta capacidad es especialmente valiosa en proyectos grandes donde los cambios en una rama podrían romper el trabajo en otra. Cada worktree tiene su propio directorio y su propio estado de git, eliminando conflictos.

Plan Mode

Plan Mode es un modo de operación donde Claude Code analiza y planifica antes de ejecutar. En lugar de ir directamente a editar archivos, primero genera un plan detallado de los cambios que va a hacer, te lo muestra para aprobación y solo entonces ejecuta. Es ideal para cambios complejos donde quieres revisar la estrategia antes de tocar código.

Puedes activar Plan Mode con el atajo Shift+Tab o configurarlo como comportamiento por defecto. Es especialmente útil en refactorizaciones grandes, migraciones y cualquier cambio que afecte a múltiples archivos.

CI/CD y modo headless

Claude Code puede ejecutarse sin intervención humana en pipelines de CI/CD. El modo headless (claude -p "tarea" --headless) permite integrar Claude Code en GitHub Actions, GitLab CI o cualquier pipeline de automatización. Casos de uso: code review automático en PRs, generación de tests para código nuevo, actualización de documentación y triaje de issues.

En modo headless, Claude Code recibe un prompt, ejecuta la tarea y devuelve el resultado por stdout. No hay interacción, no hay preguntas. Es ideal para automatizaciones que se ejecutan en segundo plano.

Claude Code en equipo

Cuándo varios desarrolladores usan Claude Code en el mismo proyecto, la coordinación es clave. El archivo CLAUDE.md del proyecto actúa como la "fuente de verdad" compartida: convenciones de código, patrones aprobados, anti-patterns a evitar, reglas de naming. Todos los miembros del equipo comparten las mismas instrucciones.

Los planes Team de Anthropic añaden funcionalidades específicas: gestión centralizada de permisos, dashboards de uso, políticas de seguridad y control de qué herramientas puede usar cada rol.

Planes y precios

Claude Code se incluye en los planes Max y Team de Anthropic. No tiene un precio separado. El plan Max cuesta 20 USD/mes (Sonnet ilimitado, Opus con límites mensuales). El plan Team cuesta 30 USD/usuario/mes con funcionalidades de gestión empresarial.

La pregunta clave no es cuánto cuesta, sino cuánto ahorra. Un desarrollador que usa Claude Code de forma efectiva ahorra entre 5 y 15 horas semanales. A un coste medio de 40 EUR/hora, el ROI mensual es de 800 a 2.400 EUR por 20 USD de suscripción.

Claude Code vs Cursor vs Copilot

Las tres herramientas más usadas para desarrollo con IA en 2026 son Claude Code (Anthropic), Cursor (Anysphere) y GitHub Copilot (Microsoft). Cada una tiene un enfoque distinto: Claude Code es un agente en terminal con autonomía máxima, Cursor es un IDE completo con IA integrada y Copilot es un plugin de autocompletado para VS Code.

La elección depende de tu flujo de trabajo. Si prefieres trabajar en terminal y quieres máxima autonomía, Claude Code. Si prefieres una interfaz visual con IA integrada, Cursor. Si solo necesitas autocompletado sin cambiar de editor, Copilot. Muchos desarrolladores combinan varias.

Templates y configuraciones

Los templates de Claude Code son configuraciones pre-hechas de CLAUDE.md y settings para diferentes tipos de proyectos. Un template para Next.js incluye convenciones de App Router, patrones de Server Components y reglas de naming. Un template para FastAPI incluye patrones de dependency injection, estructura de routers y convenciones de testing.

Usar un buen template acelera dramáticamente el setup inicial. En lugar de escribir CLAUDE.md desde cero, partes de una configuración probada y la adaptas a tu proyecto.

Managed agents

Los managed agents son la evolución de Claude Code hacia sistemas multi-agente gestionados. En lugar de un solo agente trabajando en tu proyecto, puedes definir equipos de agentes especializados: uno para backend, otro para frontend, otro para testing, un coordinador que distribuye tareas. Cada agente tiene su propio scope, permisos y configuración.

Este patrón es especialmente potente en proyectos grandes con múltiples dominios. El coordinador analiza la tarea, la descompone en subtareas y las asigna al agente especializado correcto. Es la diferencia entre tener un desarrollador junior que intenta hacerlo todo y un equipo senior con roles definidos.

Para principiantes

Si nunca has usado Claude Code, el mejor punto de partida es la guía para principiantes. Cubre desde qué necesitas antes de empezar hasta tu primera sesión productiva, pasando por los conceptos fundamentales que necesitas entender antes de lanzarte a funcionalidades avanzadas.

Para la configuración específica de settings (permisos de herramientas, modelo por defecto, límites de ejecución), la guía de settings cubre todo en detalle.

Todos los artículos sobre Claude Code

Esta pillar page conecta los 17 artículos del cluster de Claude Code. Aquí tienes el índice completo para navegar al tema que necesites:

1. Qué es Claude Code y cómo usarlo: definición, arquitectura y casos de uso del agente de Anthropic.
2. Cómo instalar Claude Code paso a paso: requisitos, instalación en todos los sistemas operativos y primera sesión.
3. CLAUDE.md: guía completa para configurar Claude Code: el archivo de configuración clave, estructura y ejemplos.
4. Claude Code vs Cursor vs Copilot: cuál elegir: comparativa de las 3 herramientas de desarrollo con IA líderes.
5. Comandos de Claude Code: referencia completa: slash commands, CLI flags, modo pipe y atajos.
6. Claude Code para principiantes: guía de inicio rápido para quienes empiezan desde cero.
7. Configuración de Claude Code: settings.json: permisos, hooks, modelos y comportamiento personalizado.
8. Memoria en Claude Code: capas de memoria, context window y estrategias para sesiones largas.
9. Skills de Claude Code: extensiones que amplían las capacidades del agente.
10. Claude Code en equipo: configuración compartida, plan Team y trabajo colaborativo.
11. Claude Code gratis: límites y planes: costes reales, límites por modelo y optimización de gasto.
12. Mejores templates de Claude Code: configuraciones por stack listas para copiar.
13. Claude Managed Agents: guía de orquestación: sistemas multi-agente con coordinador y workers.
14. Claude Code Plan Mode: planificación antes de ejecución para cambios complejos.
15. Subagentes en Claude Code: delegación de tareas con agentes secundarios.
16. Worktrees en Claude Code: trabajo paralelo en múltiples ramas de git.
17. Claude Code en CI/CD: modo headless: automatización en pipelines de integración continua.