Zero to Agent

Español

中文
English
Français
हिन्दी
العربية
Português
Русский

Español

中文
English
Français
हिन्दी
العربية
Português
Русский

Primera vez de uso: Ejecutando tu primer ejemplo ​

📚 Navegación de la serie: El artículo anterior 06 · Coding Plan: Planes de Suscripción y Facturación solucionó el problema del dinero y de elegir un plan. ¡Hoy, al fin podemos ensuciarnos las manos! Este artículo usará un script de Python extremadamente sencillo para llevarte a través de tu primer flujo de trabajo completo. Te sugiero seguir la lectura y hacerlo paso a paso para formar la memoria muscular, ¡de lo contrario de nada servirá leer!

Has instalado Claude Code y también has configurado la API (o iniciado sesión). Ahora abre la terminal. Es hora de darle uso de verdad.

No intentes refactorizar cien archivos para tu primer uso (te estrellarás y luego sentirás que la herramienta es inútil). Lo más importante ahora no es hacer algo complicado, sino conocer de manera segura cómo completas una tarea y terminas el ciclo.

Este artículo te guiará para hacer un "Calculador de Edad" en Python en 3 minutos. En el proceso verás de primera mano cómo funciona el Modo Plan (Plan Mode), cómo ejecuta comandos y cómo realiza pruebas automáticas. Y lo más importante: qué comandos debes utilizar (como /clear) cuando terminas el trabajo para prepararte para el siguiente.

Después de hacer este experimento con tus propias manos, conseguirás:

  • Conocer el ciclo de desarrollo "Crear → Corregir → Probar" en la vida real impulsado por IA.
  • Entender profundamente por qué el Modo Plan (Shift+Tab) es tu escudo protector al utilizar IA.
  • Incorporar /clear en tu memoria muscular y nunca más desperdiciar dinero enviando el historial de una conversación al modelo.

01 Prerrequisito: Inicializando un espacio limpio ​

Primero, no mezcles el experimento con tus proyectos formales. Vamos a un sitio seguro y creamos una nueva carpeta.

Abre la terminal y ejecuta lo siguiente (esto crea una carpeta en tu escritorio y entra en ella):

Para Mac / Linux:

bash
cd ~/Desktop
mkdir claude-demo && cd claude-demo

Para Windows (PowerShell):

powershell
cd ~/Desktop
mkdir claude-demo ; cd claude-demo

A continuación, inicia Claude Code dentro de esa carpeta vacía:

bash
claude

Explicación del inicio: A diferencia de otras herramientas, Claude Code se conecta automáticamente al directorio en el que te encuentras (se ancla al contexto actual). Lo que vea y modifique de aquí en adelante estará limitado a tu carpeta claude-demo y nada más. Por eso se recomienda iniciarlo en la raíz del proyecto correspondiente a tu tarea (o en la carpeta específica que vayas a tocar).

Muy bien, ahora que el prompt > está parpadeando en la interfaz interactiva, ¡tu viaje ha comenzado oficialmente!

02 Tu primer prompt y el encanto del Modo Plan ​

Ahora es cuando muchos usuarios inexpertos simplemente sueltan una frase larga ordenando: "Créame un archivo Python que calcule edades y hazlo rápido" – ¡Esto es muy arriesgado! Si tuvieras cien archivos y el modelo empezara a tocarlos al azar, tardarías más tiempo limpiando el desastre que lo que tomó estropearlo.

Usemos de inmediato el "arma secreta" introducida en la Sección 04 del artículo 03: el Plan Mode (Modo Plan).

En la interfaz de Claude Code, presiona Shift+Tab dos veces consecutivas. Fíjate en la esquina inferior derecha o en el estado, y asegúrate de que cambie a Plan.

Con el Modo Plan activado, escribe lo siguiente (puedes copiar y pegar directamente):

text
Escribe un script en Python llamado age.py. Este script recibirá un año de nacimiento a través de argumentos en la línea de comandos, calculará y luego imprimirá la edad basándose en el año actual. Por favor, dame el plan de ejecución primero.

Presiona Enter.

Lo que verás: Claude NO creará archivos ni ejecutará comandos en tu nombre inmediatamente. En su lugar, el sistema regresará un esquema en texto parecido a este:

text
Plan de Acción:
1. Crear el archivo `age.py`.
2. Escribir el código en Python:
   - Importar `sys` y `datetime`.
   - Leer el parámetro de entrada `sys.argv[1]`.
   - Obtener el año en curso y restar el año de nacimiento.
   - Manejar la excepción si el parámetro no se proporcionó o no es válido.
3. Proporcionar un comando para probar el script.

¿Estás de acuerdo con este plan? (Presiona "y" o Enter para aceptar)

Este paso es crucial. Piénsalo como tener a un junior pidiéndote revisión del diseño antes de escribir código. Al usar el Modo Plan te aseguras de que el modelo haya entendido bien tus intenciones y no cause estragos (los famosos "side effects") antes de dejarle actuar.

Como el plan parece razonable, simplemente responde:

text
Sí, procede a implementarlo.

(Al decirle "Sí" o simplemente presionar Enter para aprobar si usa un aviso formal, él sale automáticamente del estado pasivo temporal de plan).

03 Actuando y Observando (El ciclo en movimiento) ​

Después de que des luz verde, el "Agentic Loop (Pensar → Actuar → Observar)" del que hemos hablado se pone en marcha frente a tus ojos.

Observa la pantalla con detenimiento. Claude no te soltará de golpe un enorme bloque de código para que lo copies a mano. Verás que en la terminal aparecen líneas con íconos o recuadros que indican que está usando herramientas (Tools):

  1. Ejecución de herramienta: WriteFile o EditFile -> Aparecerá algo como "Creando age.py...". Aquí es posible que te lance una pregunta de permisos (Dependiendo de si usaste el modo seguro Shift+Tab, tal vez tengas que presionar y para autorizar la creación del archivo).
  2. Reporte: Informará "Archivo age.py creado y el código fue guardado."

Una vez completado, si usas ls u otra terminal paralela, verás que age.py realmente existe en tu computadora y tiene contenido útil.

Pero el ciclo aún no ha terminado, ¡necesitamos que lo pruebe! Sin salir del chat, escríbele la siguiente orden de prueba:

text
Ejecuta el script para probarlo. Pásale el año 1990 como parámetro.

Ahora verás una herramienta diferente en acción:

  1. Ejecución de herramienta: RunCommand o Bash -> Está ejecutando el equivalente a python3 age.py 1990.
  2. Observación: La terminal captura la salida, por ejemplo: Tienes 36 años. (si asumimos 2026).
  3. Reporte: Claude lee esa salida del comando que él mismo corrió y te informa en texto amigable: "El script se ejecutó correctamente y la salida es..."

¡Felicidades! Acabas de presenciar cómo la IA modificó un archivo local y corrió un comando bash de manera totalmente independiente.

04 El bug intencionado (Solucionando problemas) ​

Para ver el verdadero poder de una IA agente (y no solo un simple autocompletador), vamos a crearle un problema, o simular que un usuario la usa mal.

Escribe esto:

text
Prueba el script de nuevo pero no le pases ningún parámetro.

¿Qué sucede? Claude intentará ejecutar algo como python3 age.py. Como le faltan los argumentos de línea de comandos, Python inevitablemente lanzará un error tipo IndexError: list index out of range y la ejecución del script fallará miserablemente.

Presta atención a cómo responde Claude ante un error (esta es la maravilla del "ciclo"). A diferencia de un chat normal en la web donde tú tendrías que copiar el error y pegarlo de nuevo, Claude Code ya lo hizo:

  1. Observó el fallo: Su herramienta de ejecución (Bash/Terminal) devolvió un error (código de salida diferente de 0) con el rastro del error.
  2. Pensó por su cuenta: "Ah, me dio IndexError porque no atrapo la excepción cuando la lista argv no tiene el elemento [1]".
  3. Se corrigió sin que se lo pidieras (o sugerirá la corrección): Probablemente dirá algo como "El script ha fallado por falta de parámetros. Voy a editar el archivo para incluir el manejo del error y que imprima un mensaje amistoso en su lugar".
  4. Volvió a actuar: Usará la herramienta Replace o Edit para arreglar age.py.
  5. Volvió a observar: Ejecutará python3 age.py de nuevo (ahora debería salir un mensaje como "Por favor ingresa tu año de nacimiento").

(Nota: A veces, según tu nivel de seguridad, te pedirá permiso antes de modificar el archivo tras el fallo. Simplemente dile "Arréglalo" o acepta su sugerencia).

Este bucle de auto-corrección es lo que te ahorrará el 80% del tiempo de copia y pega entre IDEs y ventanas de navegador. ¡No eres tú arreglando el código, es tu compañero revisando su propia salida de terminal y aplicando los parches!

05 Terminar y limpiar la mesa (El comando más vital) ​

Ya tienes tu flamante archivo age.py resistente a errores. El instinto común aquí es seguir escribiendo cosas como "Ahora haz un frontend para calcular esto" en la misma sesión de chat.

¡Para, no lo hagas! Si sigues en el mismo hilo, todos los errores de terminal (como el IndexError), las discusiones previas sobre la planificación, y los cientos de tokens consumidos en el pasado se re-enviarán como contexto (Memory) en cada futura instrucción (te recordamos lo mencionado sobre el consumo de la factura en el artículo 06).

Por consiguiente, cuando has cerrado el ciclo de trabajo de una "función" o "tarea", siempre limpia el historial.

En el input escribe:

text
/clear

Al hacerlo, la pantalla arrojará algo como Conversation history cleared. Tu historial previo de esa sesión ha sido archivado localmente (lo puedes revisar más tarde con la terminal o leyendo la memoria), pero el modelo empezará de cero, ahorrándote valiosos tokens y problemas de memoria confusa.

06 Resumen y Recapitulación ​

¡Enhorabuena! Has dominado el ciclo fundamental de Claude Code. Usando tan solo 3 comandos has pasado de no tener nada a tener código funcional y auditado.

Repasemos los pasos esenciales de este "Flujo de trabajo para la Primera Vez":

Pasos de la PrácticaLo que hiciste y por qué es importante
Punto de anclajeAbriste la terminal e iniciaste claude dentro del proyecto vacío. Evitaste mezclarlo con otros.
Protección inicialEntraste al Modo Plan (Shift+Tab x2) para prevenir modificaciones locas por parte del IA, aprobando la idea antes de tirar una línea de código.
Bucle AutónomoViste las herramientas de Lectura de Archivo y Terminal (Comandos) trabajando por su cuenta y retroalimentando a la IA sin tu intervención directa.
AutocorrecciónIndujiste un error para ver cómo Claude auto-analiza el registro (log) y repara el archivo defectuoso él mismo.
Limpieza finalEjecutaste /clear como punto final al completar la tarea para salvar el consumo (tokens) en la siguiente tarea.

Si mantienes esta forma de trabajar (Planificar → Aprobar → Dejarlo Auto-Corregirse → Limpiar), habrás superado a la gran mayoría de los principiantes en programación con IA. Usar Claude Code no se trata de "mandar y rezar para que funcione", sino de ser el supervisor que aprueba sus planes de construcción.

Siguiente artículo: 08 · Uso con VS Code – Hasta ahora hemos ejecutado cosas en un terminal simple. ¿Qué pasa si te gusta programar en Visual Studio Code? ¿Se llevan bien? ¡Descubre en el próximo capítulo cómo integrar de manera perfecta Claude Code con tu editor diario favorito!

Lecturas recomendadas ​