🧰 Preparación: tu entorno

Un chatbot te devuelve texto. Preguntas, responde y ahí termina todo. No abre ningún archivo ni ejecuta ningún comando.

Sin entender este límite, esperas del chatbot algo que solo un agente puede hacer — y te frustras sin saber por qué.

Entrada de texto → salida de texto. Ninguna acción real en tu computadora.

Un agente de código lee archivos, escribe archivos, ejecuta comandos en la terminal y te devuelve un resultado que ya se produjo, no solo una descripción de lo que «podría» pasar.

Es esta capacidad de actuar la que transforma la «conversación» en «automatización real»: la base de todo lo demás del curso.

Herramientas (tools), ejecución real, resultado verificable.

Pensar en Claude Code como un empleado nuevo: le das la tarea, decide cómo hacerla, la ejecuta y vuelve para mostrarte el resultado.

Esta analogía orienta cómo pedir, cómo supervisar y cuándo confiar más o menos — tema central de la Trilha 0.6.

Delegación, supervisión, confianza creciente.

Un programa que se ejecuta en tu terminal, conectado a un modelo de IA de Anthropic, con permiso (que tú concedes) para leer y escribir archivos y ejecutar comandos.

Saber «qué es» disipa el misterio y te permite instalarlo y usarlo con confianza: ese es el tema del módulo 0.2.

Programa de terminal, modelo de IA, permiso concedido por ti.

Cada mensaje intercambiado consume «tokens» —la unidad de cobro de la IA— y una sesión típica de automatización simple cuesta desde unos pocos centavos hasta unos reales.

Sin esta idea, el costo se convierte en un miedo abstracto que frena el aprendizaje — es mejor enfrentar el número real.

Token, costo por sesión, estimación (no factura fija).

Instalar → entender la carpeta del proyecto → escribir el CLAUDE.md → aprender el modo de planificación → fijar las reglas de seguridad.

Ver el camino completo ayuda a no perderse — cada módulo se construye sobre el anterior.

Progresión: instalar, organizar, orientar, revisar, proteger.

Una ventana de texto simple donde escribes instrucciones y la computadora las ejecuta al instante, sin hacer clic en ningún ícono.

Es donde se ejecuta Claude Code. Perderle el miedo a la terminal es el primer escalón de todo el curso.

Prompt (el «cursor parpadeante» que espera una instrucción), escribir + Enter.

El camino recomendado en Windows es habilitar WSL (un Linux dentro de Windows) e instalarlo desde ahí.

Evita el 90% de los problemas de compatibilidad que aparecen al intentar instalar directamente en Windows puro.

WSL, terminal de Windows, reiniciar después de habilitarlo.

Abrir la aplicación Terminal (ya viene instalada) y pegar un único comando de instalación.

Es el camino más directo: sin una capa adicional como WSL.

Terminal nativo, script oficial de instalación.

cd cambia de carpeta; ls (Mac/Linux) o dir (Windows) muestra lo que hay dentro de ella.

Son los únicos dos comandos que usas todo el tiempo antes de llamar al agente.

Carpeta actual, navegación, listado.

Ejecutar un comando de versión y ver aparecer un número: señal de que la instalación salió bien.

Evita seguir adelante con una instalación dañada.

Comando de verificación, número de versión.

Escribir el comando que abre Claude Code dentro de una carpeta y enviar el primer mensaje.

Es el «hello world» del curso: a partir de aquí, todo es práctica.

Sesión, prompt de entrada, respuesta del agente.

Una carpeta común en tu computadora, dedicada a un proyecto: nada mágico, solo organización.

El agente solo ve lo que está dentro de la carpeta abierta; mezclar proyectos confunde el contexto.

Un proyecto = una carpeta = un contexto.

Una carpeta de proyecto con un historial de versiones guardado (mediante git): cada cambio queda registrado y se puede deshacer.

Es lo que permitirá «publicar» la automatización en la Trilha 4.

Repositorio (repo), historial de versiones, git.

Carpetas comunes: código fuente, archivos de configuración, el CLAUDE.md y una carpeta `.claude/` con skills y preferencias.

Reconocer estos nombres evita confusiones cuando el agente mencione alguno.

Código fuente, configuración, `.claude/`.

Los archivos están en tu computadora; solo el texto de la conversación y los fragmentos necesarios viajan hasta el modelo de IA para generar la respuesta.

Resuelve la duda «¿mis archivos quedan expuestos?» — tema retomado en el módulo 0.6.

Local vs. nube, qué se transmite en cada mensaje.

Crear una carpeta nueva, entrar en ella desde la terminal y abrir Claude Code allí.

Es el ritual que repetirás con cada automatización nueva del curso.

mkdir, cd, abrir el agente en la carpeta correcta.

Mezclar varios proyectos en una sola carpeta o abrir el agente en la carpeta equivocada (p. ej., en la raíz del usuario).

Evita que el agente «vea» y modifique por accidente archivos de otros proyectos.

Un proyecto por carpeta, abrirlo siempre en el lugar correcto.

Un archivo de texto simple, en la raíz del proyecto, que el agente lee automáticamente cada vez que abre la carpeta.

Es la forma de «enseñarle» reglas fijas al agente sin repetirlas en cada conversación.

Lectura automática, reglas persistentes.

Cada nueva sesión de conversación «olvida» la conversación anterior. CLAUDE.md es la forma de darle continuidad mínima al agente.

Explica por qué poner información clave allí y no solo decirla de palabra.

Sesión nueva, memoria en cero, contexto persistente mediante archivo.

Un CLAUDE.md de 20 líneas bien escritas orienta mejor que uno de 500 líneas genéricas: el agente lo lee todo y el exceso de información diluye lo que importa.

Es el error más común de quienes empiezan: «documentarlo todo» en el archivo equivocado.

Señal frente a ruido, primero las reglas esenciales.

Un modelo listo de CLAUDE.md breve que adaptas a tu proyecto (completo en el módulo 0.4).

Copiar un buen ejemplo es más rápido que aprender la estructura desde cero.

Secciones: objetivo, reglas, comandos, qué nunca hacer.

Si el proyecto crece, los detalles adicionales van en archivos separados a los que apunta el CLAUDE.md, no dentro de él.

Prepara el terreno para el concepto de skills, que se profundiza en la Trilha 3.

Remitir en vez de recargar.

Pedir "resume este proyecto" justo después de escribir el archivo — si la respuesta coincide con lo que escribiste, funcionó.

Es el ejercicio final de la ruta, realizado en el módulo 0.6.

Verificación práctica, feedback inmediato.

Un modo en el que el agente escribe el paso a paso de lo que pretende hacer y espera tu aprobación antes de ejecutar cualquier cosa.

Es la red de seguridad más sencilla del curso: lo ves antes de que ocurra.

Plan, aprobación, ejecución condicionada.

Pides algo → el agente escribe el plan → lo lees, editas o apruebas → solo entonces lo ejecuta de verdad.

Completa la comprensión visual de este ciclo (diagrama completo en el módulo 0.5).

Pedido → plan → revisión → ejecución.

Tareas grandes, que modifican muchos archivos o implican borrar/publicar cosas: siempre en modo de plan. Tareas pequeñas y reversibles: opcional.

Usarlo siempre frena el ritmo; no usarlo nunca es arriesgado: el equilibrio importa.

Riesgo de la tarea, reversibilidad.

Puedes pedir un ajuste al plan («hazlo sin el paso 3», «usa otro nombre de carpeta») antes de aprobarlo.

Corregir el plan es mucho más barato que deshacer una ejecución.

Comentarios antes de la acción, costo de corrección.

Pasos vagos ("ajustar los archivos necesarios"), o que mencionan borrar/sobrescribir algo que no pediste.

Saber reconocer esto es lo que hace que el modo de plan valga la pena.

Especificidad, alcance del plan.

Pedir algo pequeño en modo plan y observar el plan generado antes de aprobarlo.

La práctica vale más que la teoría: ver un plan real fija el concepto.

Repetición, familiaridad con el flujo.

Los comandos que borran varias carpetas/archivos de una vez siempre requieren modo plan y una lectura atenta.

Es la categoría de error más costosa y más difícil de revertir.

Irreversibilidad, revisión obligatoria.

"Producción" es el entorno en vivo, usado por personas reales, a diferencia del entorno de prueba, que está aislado.

Se profundiza en la Ruta 4, pero la regla de oro nace aquí: nunca publiques sin revisar.

Producción, entorno de prueba.

Dejar claro en el CLAUDE.md que nada se publica (sitio, post, correo electrónico) sin tu aprobación explícita.

Una regla escrita en el archivo se lee siempre: evita una publicación accidental.

Regla explícita, aprobación humana en el circuito.

Una tabla con lo que puedes autorizar de inmediato y lo que siempre debes revisar antes (completa en el módulo 0.6).

Sirve como referencia rápida cuando surge una duda en medio de una tarea.

Confianza gradual, lista de verificación.

Crear el proyecto, escribir el CLAUDE.md y pedirle al agente que resuma su propio proyecto: así se cierra el ciclo de la Trilha 0.

Es la prueba de que el entorno está listo para la Ruta 1.

Verificación final, "entorno listo".

Con el terminal, el proyecto, CLAUDE.md, el modo plan y las reglas de seguridad listos, la Trilha 1 presenta el framework WAT.

Cierra la ruta con claridad sobre el siguiente paso.

Transición de trilha, entorno listo.