Claude Code: un agente construido para la base de código

Módulo 1 · Fundamentos del producto · Lección 1 de 3

Al terminar esta lección podrás explicar qué es Claude Code, cómo opera dentro de un repositorio y por qué eso es distinto de una interfaz de chat.

Qué es: Claude Code trabaja dentro de la base de código. Eso cambia lo que realmente puede hacer.

La mayoría de las herramientas de IA se sitúan fuera del trabajo. Claude Code se sitúa dentro.

	Interfaz de chat	Claude Code
Qué hace	Responde preguntas y genera texto.	Lee, edita, ejecuta y repite el bucle.
Acceso	No tiene acceso a tus archivos, tu terminal ni el contexto del proyecto.	Lee y escribe archivos directamente, ejecuta comandos bash y edita en toda la base de código.
Estado entre mensajes	No conserva estado entre mensajes. Sirve para redactar y explicar, pero no para construir.	Mantiene el contexto de la sesión y sigue trabajando hasta que la tarea está terminada.

Cómo funciona: lee, planifica, actúa y verifica contigo antes de seguir.

Claude Code no genera código y se detiene. Trabaja en un bucle agéntico (agentic loop) hasta que la tarea está terminada o tú lo pausas.

flowchart LR
  O["1. Observar (Observe)"] --> P["2. Planificar (Plan)"]
  P --> A["3. Actuar (Act)"]
  A --> V["4. Verificar (Verify)"]
  V -- "Algo debe corregirse o seguir" --> O
  V -- "Tarea terminada o pausada" --> F["Fin del bucle"]

1. Observar (Observe)

Lee los archivos relevantes, el contexto de la terminal y el historial del proyecto. Construye una comprensión del estado actual antes de planificar nada.

En la práctica: busca en el código con grep, abre los archivos que considera relevantes y lee la salida reciente de la terminal. No asume la estructura de tu proyecto; primero lo mira.

2. Planificar (Plan)

Divide la tarea en pasos. Decide qué archivos tocar, qué comandos ejecutar y en qué orden.

Para tareas más grandes puede presentar el plan para tu revisión antes de actuar, de modo que apruebas el enfoque en lugar de reaccionar a los cambios una vez aplicados.

3. Actuar (Act)

Edita archivos, ejecuta comandos bash y llama a herramientas. Cada acción queda registrada y es visible en la terminal, no es una salida simulada en una ventana de chat.

Cada llamada a una herramienta es una operación real sobre la máquina. Ves el diff, el comando y su salida, lo que hace que el trabajo sea auditable en lugar de opaco.

4. Verificar (Verify)

Muestra el resultado y espera tu aprobación. Si algo necesita corrección, vuelve a Observar. Tú mantienes el control del ciclo.

¿Un test falla? ¿La salida es inesperada? Lo realimenta en una nueva pasada de Observar e intenta de nuevo, hasta que la tarea esté terminada o tú la pauses.

Verificar realimenta Observar. El bucle se repite hasta que la tarea está terminada o tú lo pausas.

El bucle no se detiene hasta que la tarea esté terminada o tú la pauses. Cada llamada a una herramienta (edición de archivo, comando bash, búsqueda) queda registrada y es revisable. Eso es lo que hace seguro autorizar la operación autónoma.

Dónde se ejecuta: la CLI es el núcleo; todo lo demás es un envoltorio alrededor del mismo agente.

Mismo modelo. Mismo bucle agéntico. La superficie cambia el punto de integración, no la inteligencia.

Las cuatro superficies comparten el mismo modelo y el mismo bucle agéntico. Una distinción importante: la CLI tiene acceso nativo al sistema de archivos y a la terminal a nivel del sistema operativo. Desktop, Web y Mobile alcanzan esas mismas capacidades solo cuando el desarrollador invoca explícitamente las herramientas de agente de Claude Code desde esas superficies, no directamente desde el sistema operativo anfitrión. Esa diferencia en la superficie de acceso importa al definir qué puede hacer un despliegue.

flowchart LR
  CLI["CLI"] --> NAT["Acceso nativo (sistema operativo)"]
  IDE["Extensiones de IDE"] --> NAT
  SDK["Agent SDK"] --> NAT
  WEB["Desktop / Web / Mobile"] --> ACO["Acceso acotado: solo si el desarrollador invoca las herramientas del agente"]

CLI (acceso nativo)

Acceso a la terminal nativa con el conjunto completo de capacidades de Claude Code. Es la interfaz principal para la mayoría de los flujos de trabajo de desarrollo y el punto de referencia para todas las decisiones de configuración.

Superficie de acceso: directa, a nivel del sistema operativo. El sistema de archivos y la terminal están disponibles sin ninguna invocación adicional. Es la línea base contra la que se mide cualquier otra superficie.

Extensiones de IDE (acceso nativo)

Disponibles para VS Code y JetBrains, muestran el mismo agente en línea dentro del editor. Reducen el cambio de contexto sin cambiar lo que Claude Code puede hacer.

Superficie de acceso: igual que la CLI, ya que la extensión ejecuta el agente local. El editor es un envoltorio, no una versión reducida del producto.

Agent SDK (acceso nativo)

Acceso programático para casos de uso de pipelines y automatización. Permite a los equipos de ingeniería incorporar Claude Code en CI/CD, en herramientas propias o en flujos de trabajo con varios agentes.

Superficie de acceso: la que conceda el entorno anfitrión. En CI/CD tiene el acceso del runner; el alcance lo define el lugar donde lo ejecutas.

Desktop / Web / Mobile (acceso acotado)

Ejecuta tareas en la nube, sin necesidad de un entorno local. Adecuado para trabajo orientado al negocio que no requiere acceso al sistema de archivos ni a la terminal.

Superficie de acceso: alcanza el sistema de archivos y la terminal solo cuando el desarrollador invoca explícitamente las herramientas del agente, no directamente desde el sistema operativo anfitrión. Esta es la distinción que importa al definir el alcance de un despliegue.

Comprueba tu comprensión

¿Qué es verdad sobre Claude Code? Indica si cada afirmación es verdadera o falsa.

1. “Claude Code usa un nivel de modelo distinto al de Claude.ai.”

Ver respuesta

Falso. Claude Code se ejecuta con la misma familia de modelos (Haiku, Sonnet, Opus) que cualquier otro producto de Claude. La elección del modelo es una decisión de configuración que se toma al desplegar, no algo integrado en el producto. La idea errónea habitual aquí es que “herramienta para desarrolladores” implica un modelo especializado o simplificado. No es así. Estás configurando el acceso a la misma gama de modelos, y puedes ejecutar Opus a través de Claude Code igual que a través de Claude.ai.

2. “Claude Code puede ejecutar comandos bash y editar archivos en la máquina donde está instalado.”

Ver respuesta

Verdadero. Esto es lo que diferencia a un agente de una ventana de chat: Claude Code tiene herramientas que interactúan con el entorno real, incluidos el sistema de archivos, la terminal y las APIs externas. Esas herramientas son configurables y el administrador puede acotarlas o restringirlas. Si respondiste Falso, la confusión probable es que “herramienta de IA” suena a algo que genera resultados para que copies y pegues. Claude Code no se detiene en generar código: escribe el archivo, ejecuta el test y lee el resultado, todo en la máquina donde se está ejecutando.

3. “La extensión de IDE da a Claude Code capacidades distintas a las de la CLI.”

Ver respuesta

Falso. La extensión de IDE y la CLI llaman al mismo agente, se ejecutan con el mismo modelo y tienen acceso al mismo conjunto de herramientas. La superficie cambia el punto de integración, que es cómo invocas Claude Code y dónde aparece la salida, no la capacidad subyacente. Si respondiste Verdadero, la razón probable es que la terminal parece más “técnica” y, por tanto, más potente. Esa intuición aquí es errónea. Una extensión de IDE en VS Code no es una versión más ligera; es el mismo agente expuesto en otro envoltorio. La distinción que sí importa es la superficie de acceso, no la etiqueta de la superficie. Consulta la cuadrícula de superficies de la sección anterior para ese matiz.

Idea central para llevar: Claude Code es el mismo agente sin importar el punto de acceso. Las superficies son envoltorios. La inteligencia, el bucle y el conjunto de herramientas son constantes. Lo que varía es la integración. Guárdalo en mente para la primera conversación con un cliente.

Ideas clave

Al terminar esta lección puedes explicar qué es Claude Code, cómo funciona su bucle agéntico y por qué es categóricamente distinto de una interfaz de chat, sin importar qué superficie use el cliente o el desarrollador.

• Claude Code trabaja dentro de la base de código: lee, edita, ejecuta comandos y sigue en el bucle hasta terminar la tarea.
• El bucle tiene cuatro pasos (Observar, Planificar, Actuar y Verificar), y Verificar realimenta a Observar.
• La CLI es la superficie de referencia; las extensiones de IDE y el Agent SDK usan el mismo agente, el mismo modelo y el mismo conjunto de herramientas.
• La superficie cambia el punto de integración, no la inteligencia; lo que sí varía es la superficie de acceso: nativa (CLI, IDE, SDK) o acotada (Desktop / Web / Mobile).
• Claude Code usa la misma familia de modelos que el resto de productos de Claude; la elección del modelo es una decisión de configuración.

Siguiente: Selección de modelos Claude