¿Qué es Claude Code?
Qué diferencia a un agente de una herramienta de autocompletado, el loop que se repite en cada turno y cuándo conviene usar Claude Code (y cuándo no).
Un agente, no un autocompletado
Las herramientas de IA para programar se dividen en dos familias bien distintas:
Asistentes de autocompletado
Copilot en su modo clásico, por ejemplo: sugieren la próxima línea o el próximo bloque mientras vos escribís. La decisión de qué hacer la seguís tomando vos, todo el tiempo.
Agentes (Claude Code)
Les das un objetivo en lenguaje natural y ellos deciden el plan, qué archivos leer, qué herramientas usar (buscar en el código, correr tests, editar archivos, ejecutar comandos de shell) y cuándo el trabajo está terminado.
Esa diferencia no es de grado, es de naturaleza. Con un agente, la calidad del resultado depende menos de tu velocidad de tipeo y más de la calidad de tus instrucciones, de la memoria que le diste sobre el proyecto y de los límites que le pusiste. Este manual está organizado justamente en torno a esos tres ejes.
El loop del agente
En cada turno, Claude Code repite un ciclo simple:
Cada vuelta de ese loop pasa por el sistema de permisos (Permisos y seguridad operativa) antes de ejecutarse. Eso es lo que te permite darle autonomía sin perder control.
Qué lo distingue de un asistente conversacional
- Vive en tu terminal (o en tu IDE, o en la web/desktop), con acceso real al filesystem y a la shell de tu proyecto — no a un sandbox aislado sin contexto.
- Tiene memoria persistente del proyecto vía
CLAUDE.md, así no tenés que volver a explicarle el stack y las convenciones en cada sesión (Memoria y contexto). - Es extensible: podés darle nuevas capacidades con Skills, delegar trabajo a Subagentes especializados, forzar comportamientos deterministas con Hooks (Skills, Subagentes y Hooks), conectarlo a herramientas externas vía MCP, y empaquetar todo eso en un Plugin para compartirlo.
- El nivel de autonomía es configurable, desde “preguntame antes de tocar cualquier archivo” hasta “corré sin preguntar en este contenedor aislado” (Permisos y seguridad operativa).
Cuándo conviene usarlo (y cuándo no)
Claude Code rinde mejor en tareas con un resultado verificable: implementar una feature con requisitos concretos, depurar un bug reproducible, escribir tests, explorar un codebase desconocido, refactorizar con una red de seguridad de tests existentes. Rinde peor cuando la tarea es ambigua (“mejorá el código”), demasiado grande para revisar en un diff razonable, o cuando el criterio de éxito es puramente subjetivo. Prompting profesional da el marco para convertir pedidos ambiguos en instrucciones verificables.
Documentación relacionada: overview oficial y cómo funciona el agent loop.
Una consecuencia que conviene anticipar: un agente escribe código mucho más rápido de lo que un equipo puede revisarlo, así que el cuello de botella se corre del tipeo al criterio. Saber qué hace bueno a un diseño y qué protege realmente un test pasa a ser más importante, no menos.