Objetivo del tema
Presentar Claude Code en profundidad: qué es un agente de código y qué lo diferencia de un chat o de un autocompletado, cómo funciona su bucle agéntico con herramientas, qué formas de uso existen, cómo se paga, cómo protege tu proyecto y en qué escenarios aporta más valor al trabajo diario.
Claude Code es el agente de programación con inteligencia artificial creado por Anthropic, diseñado para trabajar directamente en tu terminal. Presentado como vista previa de investigación en febrero de 2025 y disponible de forma general desde mayo de 2025, es la herramienta insignia del enfoque que Anthropic llama codificación agéntica: en lugar de sugerir fragmentos de código para copiar y pegar, Claude Code trabaja en tu proyecto. Lee el repositorio, planifica, edita archivos, ejecuta comandos, corre los tests y corrige sus propios errores hasta completar la tarea que le encargaste.
Todo comienza con un solo comando, claude, ejecutado en la carpeta de tu proyecto. A partir de ahí se establece una conversación con acceso real a tu entorno: el agente puede explorar la estructura, consultar el historial de Git, buscar patrones en miles de archivos y proponer (o aplicar, según los permisos) los cambios necesarios. Sus características distintivas son:
Busca y lee código, configuración, historial e instrucciones del repositorio.
Edita archivos y usa las herramientas instaladas en el entorno autorizado.
Ejecuta tests, linters y builds, e interpreta sus resultados.
Resume cambios, evidencia disponible, riesgos y trabajo pendiente.
CLAUDE.md, sin exigir servidores de indexación ni configuración pesada.Para entender el valor de Claude Code conviene compararlo con las dos generaciones anteriores de asistentes de IA para programar: los chats web y los autocompletados dentro del editor.
| Aspecto | Chat web (claude.ai) | Autocompletado en el editor | Claude Code |
|---|---|---|---|
| Contexto | Solo lo que pegas en la conversación. | El archivo o las líneas abiertas. | Todo el repositorio: descubre archivos con Grep y Glob y lee las convenciones de CLAUDE.md. |
| Salida | Texto y bloques de código para copiar. | Sugerencias de línea o de función. | Cambios reales aplicados a tus archivos, con diff visible. |
| Ejecución | Ninguna. | Ninguna. | Ejecuta comandos, tests, builds, Git y contenedores. |
| Verificación | Manual. | Manual. | Ejecuta los tests, lee el resultado y corrige hasta validar. |
| Iteración | Cada paso depende de vos. | Cada sugerencia se acepta una por una. | Bucle agéntico autónomo con puntos de control humanos. |
| Caso ideal | Consultas, diseño y aprendizaje. | Escribir código repetitivo con velocidad. | Tareas de desarrollo completas, de la idea al commit. |
La diferencia de fondo está en el bucle agéntico. Cuando le encargás una tarea, Claude Code la aborda como lo haría un desarrollador experimentado:
En cada paso que modifica o ejecuta algo, el sistema de permisos decide si la acción avanza al instante, pide aprobación o queda bloqueada. Ese equilibrio entre autonomía y control es la seña de identidad del producto.
El bucle agéntico es posible porque el modelo dispone de un conjunto de herramientas nativas, cada una con alcance y permisos propios:
| Herramienta | Qué hace |
|---|---|
Read, Write, Edit |
Leen, crean y modifican archivos. La aprobación previa depende del modo de permisos; el diff debe revisarse siempre antes del commit. |
Glob y Grep |
Localizan archivos por patrón de nombre y buscan contenido con expresiones regulares en proyectos de cualquier tamaño. |
Bash |
Ejecuta comandos del sistema: tests, builds, migraciones, Git, Docker, y cualquier utilidad disponible en tu terminal. |
WebFetch y WebSearch |
Consultan documentación oficial y buscan información actualizada sin salir del flujo de trabajo. |
| Agentes y tareas | Delegan subtareas en agentes especializados o sesiones paralelas, cuando la superficie y el plan lo permiten. |
| Plan de trabajo | Mantiene pasos y estados visibles para que puedas seguir y corregir el rumbo de tareas largas. |
Servidores MCP |
Agregan herramientas externas: bases de datos, navegadores, APIs internas, Slack, Figma y cualquier servicio con un servidor MCP. |
Un ejemplo de sesión ayuda a visualizar el flujo. Si le pedimos arreglar un test que falla, el agente podría trabajar así:
> npm test falla en la suite de pagos. Encuentra la causa y corrígela.
[Bash] npm test -- pagos → 1 test fallido en impuestos.js
[Read] src/pagos/impuestos.js
[Grep] tasa_iva en src/ → una sola definición, en impuestos.js
[Edit] src/pagos/impuestos.js → redondeo a 2 decimales antes de acumular
[Bash] npm test -- pagos → 10 tests aprobados
Claude: El test fallaba porque el cálculo acumulaba centavos sin redondear.
Corregí el redondeo en calcular_impuesto() y los 10 tests pasan.Fíjate que el agente no preguntó dónde estaba el error: lo investigó, formuló una hipótesis, la aplicó y la verificó con los tests. Esa combinación de búsqueda, edición y ejecución es lo que convierte a Claude Code en un compañero de trabajo y no en un generador de texto.
Claude Code se adapta a distintos estilos de trabajo, siempre sobre los mismos modelos y la misma configuración:
claude dentro del proyecto y ofrece conversación continua, comandos slash, historial de sesiones y atajos de teclado.claude -p "..." ejecuta una tarea única y devuelve el resultado, ideal para scripts, cron jobs y pipelines de CI/CD.| Entorno | Dónde corre | Cuándo elegirlo |
|---|---|---|
| Local | Tu computadora | Necesitas archivos, herramientas y configuración local. |
| Nube | Máquina virtual administrada | Quieres delegar tareas que continúen sin tu equipo encendido. |
| Remote Control | Tu computadora, controlada desde web o móvil | Quieres cambiar de interfaz conservando el entorno local. |
Las capacidades básicas del bucle son las mismas, pero cambian las credenciales disponibles, la red, la persistencia y el sistema de archivos. Antes de delegar, identifica siempre dónde se ejecutará la tarea.
Estos son los primeros comandos de la CLI que conviene conocer:
claude --version # versión instalada
claude # abre la sesión interactiva
claude "Resume la arquitectura del proyecto" # arranca con un prompt
claude -p "¿Cuántos TODOs hay?" # modo no interactivo
claude -c # continúa la última conversación
claude -r # retoma una sesión anterior
claude update # actualiza a la última versiónDentro de la sesión interactiva, los comandos slash controlan todo el entorno: /help (ayuda), /init (genera el CLAUDE.md), /model (cambia de modelo), /compact (resume la conversación para liberar contexto), /agents (gestiona subagentes), /mcp (servidores MCP) y /ide (conecta el editor). Los estudiaremos en profundidad en el tema 9.
Claude Code funciona con los modelos de la familia Claude de Anthropic y ofrece dos vías de acceso:
En cuanto a la familia de modelos: Opus destaca en tareas complejas y de larga duración (refactors grandes, decisiones de arquitectura), Sonnet es el equilibrio entre capacidad y velocidad (y el modelo por defecto), y Haiku prioriza velocidad y bajo costo para tareas simples. El comando /model cambia de modelo en caliente, /usage muestra el consumo del plan y /cost reporta el gasto acumulado en modo API.
Evita cargos inesperados: una variable ANTHROPIC_API_KEY puede tener prioridad sobre una suscripción iniciada. Comprueba proveedor, cuenta y modelo con /status antes de una tarea extensa.
| Aspecto | Suscripción Claude.ai | Anthropic API |
|---|---|---|
| Costo | Fijo mensual según el plan. | Por tokens consumidos. |
| Límites | Cupos por período que se renuevan automáticamente. | Solo tu presupuesto y tus cuotas de velocidad. |
| Ideal para | Desarrollo diario e interactivo. | Scripts, CI/CD y uso intensivo medible. |
| Control de consumo | Comando /usage. |
Comando /cost y panel de la Console. |
El diseño de Claude Code parte de una premisa clara: la autonomía solo es útil si el desarrollador mantiene el control. De esa premisa derivan sus decisiones más importantes:
git push --force o auditar cada comando ejecutado.El sandbox protege principalmente los comandos Bash y sus procesos hijos; las herramientas integradas de archivos siguen sus propias reglas de permisos. No es una licencia para aprobar todo: dependencias maliciosas, prompt injection, secretos visibles y comandos destructivos siguen requiriendo criterio humano.
Regla de oro para empezar: trabaja sobre un repositorio con Git al día, revisa el diff antes de aceptar cada cambio y deja que el agente ejecute los tests. La confianza se gana verificando: a medida que valides su trabajo podrás ampliar permisos con reglas específicas en lugar de aprobar cada acción a mano.
Claude Code acompaña todo el ciclo de desarrollo:
En los próximos temas repasaremos la historia y el contexto del proyecto (tema 2), los requisitos y la instalación paso a paso (temas 3 y 4), la autenticación y la elección de modelos (tema 5), la memoria del proyecto con CLAUDE.md (tema 6), la interfaz interactiva y sus atajos (tema 7), el modo Plan (tema 8) y los comandos esenciales (tema 9). Después aplicaremos todo en dos proyectos guiados con Express y FastAPI (temas 10 y 11), integraremos la herramienta con editores, Git y GitHub (temas 12 y 13) y cerraremos con las extensiones avanzadas: subagentes, hooks, MCP y automatización (temas 14 a 18).
Cuando completes la instalación, empieza en un repositorio de práctica y con Git limpio. No uses como primer ejercicio producción, infraestructura compartida ni una carpeta que contenga varios proyectos.
cd proyecto-de-practica
git status
claudeExplora este repositorio sin modificar archivos. Resume su propósito, estructura, comandos de prueba y dos riesgos que debería conocer. Cita los archivos que respaldan cada conclusión. Después propone una mejora pequeña, pero no la implementes.
Este encargo comprueba lectura, búsqueda y síntesis sin autorizar cambios. Contrasta el resumen con el proyecto, revisa las rutas citadas y usa /status para confirmar cuenta y modelo. Luego activa modo Plan y pide una implementación pequeña con un test verificable.
Claude Code no necesita lenguaje especial, pero sí una definición de terminado. Un encargo útil reúne:
| Componente | Pregunta | Ejemplo |
|---|---|---|
| Objetivo | ¿Qué comportamiento debe cambiar? | “Agrega validación al formulario de registro”. |
| Alcance | ¿Qué puede y qué no puede tocar? | “No cambies la base de datos ni agregues paquetes”. |
| Contrato | ¿Qué entrada y salida se esperan? | “Correo inválido devuelve 422 con el campo code”. |
| Evidencia | ¿Cómo se demuestra? | “Ejecuta npm test y reporta el resultado”. |
| Entrega | ¿Qué debe resumir? | “Lista archivos modificados, decisiones y riesgos”. |
Para una tarea compleja, pide primero investigación y plan. Para una corrección incierta, separa diagnóstico de implementación. Para trabajo crítico, exige revisión humana aunque todas las pruebas estén en verde.
Un agente puede producir cambios convincentes y equivocados. Su capacidad depende del contexto disponible, las herramientas, las pruebas y la claridad del objetivo. No sabe automáticamente:
Conserva autoridad humana sobre secretos, datos personales, pagos, cambios legales, IAM, producción, migraciones irreversibles y acciones Git destructivas. Pide explicación y evidencia; no conviertas la fluidez del texto en una señal de certeza.
| Momento | Comprueba |
|---|---|
| Antes | Directorio correcto, git status conocido, cuenta y proveedor correctos, objetivo y límites explícitos. |
| Durante | Plan razonable, permisos mínimos, comandos comprensibles y ausencia de secretos en prompts o salidas. |
| Después | Diff revisado, tests ejecutados, efectos manuales comprobados y trabajo pendiente documentado. |
| Antes del commit | Ningún archivo accidental, credencial, artefacto generado o cambio fuera del alcance. |
Consulta la descripción oficial, la guía sobre cómo funciona el bucle y la documentación de seguridad cuando cambien las capacidades o las políticas del producto.
En resumen: Claude Code combina modelos, contexto y herramientas en un bucle que puede investigar, actuar y verificar. Su valor no está en eliminar la supervisión, sino en desplazarla: menos trabajo mecánico y más atención a objetivos, límites, evidencia y consecuencias. En el próximo tema repasaremos la historia y el contexto que dieron origen a la herramienta.