Cuando la mayoría de desarrolladores descubren Claude Code, lo usan como un chatbot avanzado: hacen una pregunta, reciben una respuesta, copian el código. Útil, pero esto apenas roza la superficie de lo que es posible.
La verdadera potencia de Claude Code está en su modo agente: la capacidad de ejecutar tareas complejas de forma autónoma, usando herramientas reales sobre tu entorno de desarrollo.
¿Qué es exactamente el modo agente?
En modo agente, Claude Code no solo genera texto. Puede:
- Leer y escribir ficheros de tu proyecto
- Ejecutar comandos en la terminal
- Correr tests y analizar los resultados
- Hacer búsquedas en el codebase
- Encadenar múltiples acciones hasta completar una tarea
La diferencia es fundamental. En vez de decirte "añade este código", Claude Code puede añadirlo él mismo, ejecutar los tests, ver que uno falla, corregirlo y volver a ejecutar los tests hasta que todo pase.
Un ejemplo real: implementar una nueva feature
Imagina que quieres añadir autenticación con JWT a una API Express. Con Claude Code en modo agente:
claude "Implementa autenticación JWT en esta API Express.
Usa el patrón que ya existe en src/middleware/,
añade los tests en test/auth/ y asegúrate de que
todos los tests existentes siguen pasando."Claude Code hará lo siguiente de forma autónoma:
- Leer la estructura del proyecto
- Analizar
src/middleware/para entender el estilo - Crear el middleware JWT
- Actualizar las rutas que lo necesitan
- Escribir los tests
- Ejecutar
npm test - Si algo falla, leer el error y corregirlo
- Repetir hasta que todo esté verde
Las herramientas disponibles para el agente
Claude Code tiene acceso a un conjunto de herramientas que puedes controlar:
| Herramienta | Qué hace |
|---|---|
Read | Lee ficheros del proyecto |
Write | Crea o modifica ficheros |
Bash | Ejecuta comandos de terminal |
Glob | Busca ficheros por patrón |
Grep | Busca texto en el código |
Puedes configurar exactamente qué herramientas puede usar y cuáles requieren tu aprobación explícita mediante el fichero settings.json de Claude Code.
CLAUDE.md: el contexto persistente del agente
Una de las claves para que el agente funcione bien es el fichero CLAUDE.md en la raíz de tu proyecto. Este fichero le dice a Claude Code todo lo que necesita saber sobre tu proyecto:
# Mi Proyecto
## Stack técnico
- Node.js 20 + TypeScript
- Express 4.x
- PostgreSQL con Prisma ORM
- Jest para testing
## Convenciones
- Usar async/await, nunca callbacks
- Tests deben tener al menos 80% de cobertura
- Commits en formato Conventional Commits
## Directorios
- src/api/ → controladores REST
- src/services/ → lógica de negocio
- src/models/ → tipos TypeScriptCon este contexto, el agente toma decisiones coherentes con tu proyecto sin que tengas que explicarlo cada vez.
Control sobre la autonomía: cuándo aprobar y cuándo no
El modo agente no significa perder el control. Claude Code distingue tres niveles de autonomía:
Nivel 1 — Solo pregunta: El agente propone cambios y espera tu aprobación antes de ejecutar cualquier acción.
Nivel 2 — Aprobación selectiva: Las lecturas y búsquedas son automáticas, pero escrituras y comandos requieren tu OK.
Nivel 3 — Totalmente autónomo: Para flujos de CI/CD o tareas de mantenimiento programadas.
Puedes configurarlo globalmente o por tipo de herramienta:
claude config set autoApprove reads # Lecturas automáticas
claude config set autoApprove none # Todo requiere aprobaciónCasos de uso donde el modo agente brilla
Refactorización masiva
claude "Renombra la función getUserById a findUserById en todos
los ficheros del proyecto, actualiza los imports y los tests."Migración de dependencias
claude "Migra de Moment.js a date-fns. Sustituye todas las
llamadas de la API de Moment por sus equivalentes en date-fns."Generación de documentación
claude "Genera JSDoc para todas las funciones públicas de
src/services/ que no tengan documentación."Revisión de seguridad
claude "Analiza el proyecto buscando vulnerabilidades comunes:
SQL injection, XSS, secrets hardcodeados, dependencias
con CVEs conocidos. Genera un informe en SECURITY.md"El futuro: agentes multi-step con memory
Las últimas versiones de Claude Code introducen capacidades de memoria persistente entre sesiones. Esto significa que el agente puede recordar decisiones de arquitectura, preferencias de estilo y contexto del proyecto entre conversaciones, haciéndolo cada vez más eficiente a medida que trabaja contigo.
Descubre el libro completo en Amazon y domina Claude Code de principio a fin.
