💬 El chatbot solo responde
¿Eres nuevo aquí? Uno chatbot es un programa que conversa: tú escribes una pregunta y te devuelve una respuesta en texto. Eso es todo. Piensa en un mostrador de información: la persona que atiende te explica dónde está la sala, pero no va a abrirte la puerta.
Herramientas como ChatGPT en el modo predeterminado funcionan así: son excelentes para explicar, resumir y traducir, pero el resultado queda en la pantalla. Si quieres que algo ocurra de verdad en tu computadora (crear un archivo, enviar un correo, publicar un sitio), el chatbot por sí solo no puede hacerlo.
💡 Concepto principal
Chatbot = entrada de texto, salida de texto. Nada cambia fuera de la ventana de conversación.
- •Preguntas «¿cómo hago un resumen de ventas?» y te explica los pasos.
- •Todavía tienes que abrir la hoja de cálculo, copiar, pegar y calcular a mano.
🔎 Ver por dentro
Cuando conversas con un chatbot puro, nada cambia en tu computadora: el texto que genera vive solo dentro de la ventana de conversación, en un servidor distante. No se crea ningún archivo en tu carpeta, no se ejecuta ningún comando ni se envía ningún correo electrónico. Por eso, después de recibir una buena respuesta, todavía tienes que hacer el trabajo manual de copiar, pegar y aplicar eso en algún lugar real: el chatbot te dio el mapa, pero no recorrió el camino.
🛠️ El agente toma la herramienta y hace el trabajo
Uno agente de código es diferente: tiene acceso a herramientas — cosas que ejecuta por su cuenta, como abrir un archivo, ejecutar un comando en la terminal (el cuadro de texto que da órdenes directamente a la computadora; encontrarás más información en el módulo 0.2) o buscar información en internet. Decide qué herramienta usar, la usa, revisa el resultado y ajusta si algo salió mal.
Leyenda: el pedido entra por la izquierda, el agente elige la herramienta correcta en el «cajón», la ejecuta y te devuelve algo ya hecho, no solo una explicación.
🔍 Por dentro
- Herramienta (tool): una acción concreta que el agente puede ejecutar por sí solo: leer, escribir, ejecutar, buscar.
- Ciclo: pensar → elegir herramienta → usar → comprobar el resultado → repetir hasta terminar.
⚠️ Error común de principiante
La primera vez que el agente pide permiso para ejecutar un comando o modificar un archivo, mucha gente se asusta y cancela todo, pensando que algo se rompió. No se rompió: esa pausa es el propio agente consultándote antes de actuar, exactamente el comportamiento que queremos (ver módulo 0.6). El tropiezo real es lo contrario: aprobar todo en «modo automático» sin entender qué se está pidiendo. Lee la línea de la solicitud antes de aprobar: es rápido y evita retrabajo.
🏢 La analogía del empleado
Piensa en Claude Code como un empleado nuevo, muy capaz y muy rápido, pero que todavía no conoce las costumbres de la casa. Le das la tarea («organiza estos informes»), decide cómo hacerla (abre la carpeta, lee los archivos, crea la hoja de cálculo), la ejecuta y vuelve para mostrarte lo que hizo. Al principio supervisas de cerca; con el tiempo, confías más, exactamente como con un empleado de verdad.
✓ Empleado bien orientado
- ✓Recibe instrucciones claras y el contexto que necesita (el CLAUDE.md del módulo 0.4)
- ✓Muestra el plan antes de actuar en tareas grandes
- ✓Avisar cuando algo salió distinto de lo esperado
✗ Empleado sin supervisión
- ✗Recibe una orden vaga («resuelve eso») y adivina el resto
- ✗Ejecuta cambios grandes sin avisarte antes
- ✗Nadie revisa el resultado antes de publicarlo
💡 Consejo práctico
Trata las primeras semanas como un período de prueba: pide tareas pequeñas, revisa lo que hace y solo después confíale tareas más grandes. Ese es exactamente el tema que cierra la trilha, en el módulo 0.6.
La curva de confianza, en tres fases
-
1
Semana 1 — cerca: tareas pequeñas y aisladas (renombrar archivos, resumir un texto), lees todo antes de aceptar.
-
2
Semanas 2-4 — supervisión ligera: tareas con más pasos (organizar una carpeta completa), revisas el plan, pero no cada línea.
-
3
Después — delegación real: rutinas que se ejecutan por sí solas en horarios fijos (ruta 6), con los permisos ya calibrados.
🖥️ Qué es Claude Code, concretamente
¿Eres nuevo aquí? Uno modelo de IA es el «cerebro»: el programa entrenado para entender el lenguaje y decidir qué hacer (es el mismo tipo de tecnología que está detrás de ChatGPT). El Claude Code es un programa que se ejecuta en tu terminal y conecta ese cerebro con herramientas reales en tu computadora: lee y escribe archivos, ejecuta comandos, y solo hace eso dentro de la permiso que le concedas: tú decides cuánto puede actuar por su cuenta.
Abres la terminal en una carpeta
El programa pasa a «ver» solo lo que está dentro de esa carpeta: el proyecto (módulo 0.3).
Escribes lo que quieres en portugués
Sin sintaxis especial — una frase normal, como se lo pedirías a un colega.
Actúa y muestra el resultado
Dentro de los límites de permisos que definiste (se explica en profundidad en el módulo 0.6).
Leyenda: la carpeta que abres es el límite del agente. Solo se busca en la web si se usa una herramienta específica de búsqueda — y aun así, dentro de lo que permitas.
🔎 Mira por dentro: lo que va a internet y lo que se queda en tu PC
Tus archivos están en tu computadora: abrir, leer y escribir dentro de la carpeta del proyecto no envía nada afuera. Lo que viaja hasta los servidores del proveedor del modelo es el texto de la conversación: tu instrucción y los fragmentos de archivo que el agente necesita "consultar" para responder. Así es como el cerebro (el modelo de IA) procesa la solicitud y decide qué hacer: el procesamiento pesado no ocurre en tu notebook.
💰 El costo de una sesión, en la práctica
¿Eres nuevo aquí? Token es la unidad que mide «cuánto texto» se procesó: más o menos, un fragmento de palabra. Cada mensaje tuyo y cada respuesta del agente consume tokens, y eso es lo que determina el costo.
📊 Estimación didáctica (no es una factura fija)
- Tarea pequeña (cambiar nombres de archivos, escribir un texto breve): unos pocos centavos.
- Sesión de automatización típica (como los de los Builds de este curso): entre R$ 0,50 y R$ 3,00.
- Sesión larga y compleja (muchas idas y vueltas, mucho código): puede superar los R$ 10.
Números aproximados: varían según el plan y el modelo. La idea aquí no es memorizar los precios, sino perder el miedo a «voy a gastar una fortuna sin saberlo».
⚠️ Atención
Las sesiones que se quedan "conversando en círculos" (el agente que intenta y falla repetidas veces) consumen más tokens de lo normal. Si lo notas, detente, revisa el pedido e inicia una sesión nueva: sale más barato que insistir.
✓ Uso consciente
- ✓Pide una cosa a la vez y comprueba el resultado antes de seguir
- ✓Cierra la sesión cuando termina la tarea, en vez de dejarla abierta «por si acaso»
✗ Uso desperdiciado
- ✗Pide lo mismo de distintas maneras, esperando que "lo capte" de alguna forma
- ✗Pega archivos gigantes completos cuando solo necesitaba un fragmento pequeño
⚠️ Confusión común: plan fijo × cobro por uso
Mucha gente mezcla dos cosas diferentes: existen planes de suscripción (un valor mensual fijo, con un límite de uso incluido) y existe cobro por consumo de tokens (pagas solo por lo que usas, sin mensualidad). El número que aparece arriba es el consumo en tokens; cuánto se traduce en un costo real depende de cuál de los dos modelos elegiste. No hay una única respuesta: aquí lo importante es entender la unidad, no memorizar un precio.
🗺️ El mapa de la Trilha 0
Con el modelo mental fijado, el resto de la trilha es 100 % práctico: instalar sin miedo (0.2), entender la carpeta del proyecto (0.3), escribir tu primer CLAUDE.md (0.4), aprender el modo plan (0.5) y cerrar con las reglas de seguridad que se aplican a todo el curso (0.6).
🎯 Concepto principal
- •0.2 instala → 0.3 organiza → 0.4 orienta → 0.5 revisa → 0.6 protege.
- •Cada módulo se basa en el anterior: no te saltes ninguno.
💡 Consejo práctico
Si solo guardas una frase de este módulo, que sea esta: un agente de código es un empleado que hace, no un chatbot que explica. Cada decisión de diseño del resto del curso: permisos, CLAUDE.md, modo de plan, existe para que ese «hacer» sea seguro y predecible. Cuando un concepto nuevo te resulte confuso más adelante, vuelve aquí y pregúntate: ¿esto ayuda al agente a actuar mejor o a actuar con más seguridad? Casi siempre es una de las dos cosas.
Verificación rápida (opcional): ¿cuál es la diferencia principal entre un chatbot y un agente de código?