Si quieres ser tu propio jefe, deberías apartar 30 minutos para ti.
Porque hoy te explicaré cómo construir un agente de IA verdaderamente funcional en una sola tarde, sin ningún conocimiento de programación.
No confundas lo que estoy a punto de contarte con un chatbot. Un chatbot espera una pregunta y da una respuesta. Un agente funciona de manera diferente: le das un objetivo, y él mismo define los pasos, lee archivos, ejecuta comandos y continúa por su cuenta hasta que el trabajo está hecho. No gestionas cada movimiento; solo trazas la ruta.
Esta diferencia es importante porque ya no estás escribiendo indicaciones una por una. Mientras tú atiendes otro trabajo, el trabajo avanza por sí solo.
¿QUÉ SE REQUIERE?
Todo lo que necesitas antes de la instalación está aquí:
- Un plan de Claude de pago (Pro, $20/mes, incluye Claude Code)
- Mac (macOS), Windows o Linux
- Internet
- 30-45 minutos de tiempo libre
No se requieren conocimientos de programación. Cada comando está escrito completo; solo tendrás que copiar y pegar, y presionar Enter.
No hay costos adicionales. No gastas ni un solo centavo aparte de la suscripción.
INSTALACIÓN: APLICACIÓN DE ESCRITORIO, SIN TERMINAL
La forma más fácil para un principiante es la aplicación de escritorio. Pone todo el poder de Claude Code en tus manos sin necesidad de aprender a usar la terminal.
Descarga la aplicación de escritorio adecuada para tu sistema operativo a través de claude.ai. En Mac, abre el archivo .dmg y arrastra Claude a la carpeta de Aplicaciones; en Windows, ejecuta el instalador. Abre la aplicación, inicia sesión con tu cuenta y haz clic en la pestaña Code en el centro superior.
Si la pestaña Code solicita una actualización de plan, significa que tu plan actual no cubre Claude Code. Si solicita un inicio de sesión en línea, completa el inicio de sesión y reinicia la aplicación. En cualquier caso, eventualmente llegarás a un espacio de trabajo vacío.
El éxito aquí significa: un cuadro de indicación vacío, una pestaña Code activa y sin mensajes de error. Todo lo que construyas de ahora en adelante vivirá en esta área.
¿QUÉ CONSTRUIREMOS?
Construiremos un agente único y claro; avanzaremos con el mismo agente hasta el final del artículo.
Su tarea es esta: leerá los archivos de texto en una carpeta, encontrará los que tengan títulos faltantes y escribirá un informe llamado missing-titles.txt que liste los archivos que necesitan ser corregidos para ti.
Una tarea pequeña pero real. Incluye las tres cosas básicas que un agente debe hacer: leer archivos, tomar decisiones y escribir resultados. Y es lo suficientemente simple como para que puedas verificar con tus propios ojos si funciona o no.
PASO 1: CONFIGURAR LA CARPETA DE TRABAJO
Crea una carpeta llamada my-agent en tu escritorio. El agente trabajará aquí; solo podrá ver y tocar el interior de esta carpeta, por lo que todo se mantiene seguro.
Dentro de my-agent, crea una segunda carpeta llamada articles. El agente buscará aquí los archivos que revisará.
Crea cuatro archivos de texto plano dentro de articles: post-one.txt, post-two.txt, post-three.txt, post-four.txt. Abre dos de ellos y escribe esto al principio:
Title: My Article
Deja los otros dos completamente vacíos. El trabajo del agente es exactamente encontrar estos vacíos.
La estructura de tu carpeta debe ser my-agent/articles/, que contenga cuatro archivos .txt, dos con títulos y dos sin ellos.
PASO 2: ESCRIBIR EL ARCHIVO DE INSTRUCCIONES CLAUDE.md
CLAUDE.md es un archivo de texto plano que Claude Code lee al inicio de cada sesión. Piénsalo como las instrucciones fijas de tu agente, una descripción del trabajo que nunca olvida.
Dentro de la carpeta my-agent (no dentro de articles), crea un nuevo archivo llamado CLAUDE.md. Ábrelo en cualquier editor de texto—Bloc de notas en Windows, TextEdit en Mac—y pega esto exactamente:
# Mi Agente de Verificación de Archivos ## Tu Tarea Revisa cada archivo .txt en la carpeta /articles.
## Qué buscar Un archivo válido comienza con esta línea: Title: Si la primera línea no comienza con "Title:", el título del archivo falta.
## Qué hacer 1. Lee cada archivo .txt dentro de /articles uno por uno. 2. Anota qué archivos tienen títulos faltantes. 3. Crea un archivo llamado missing-titles.txt en la carpeta principal. 4. Escribe cada nombre de archivo que no pasó la verificación en este archivo, uno por línea. 5. Si todos los archivos son válidos, escribe "All files have titles." en missing-titles.txt.
## Qué no hacer No edites ningún archivo de artículo. Solo lee. Solo escribe en el archivo missing-titles.txt.
Guárdalo. Este es todo el cerebro de tu agente. Claude Code lo leerá antes que cualquier otra cosa.
El archivo my-agent/CLAUDE.md está creado y contiene las instrucciones anteriores, eso es todo.
PASO 3: DIRIGIR CLAUDE CODE A LA CARPETA
Abre la aplicación de escritorio de Claude Code, haz clic en el ícono de la carpeta o en la opción "Abrir carpeta", y ve a la carpeta my-agent. Selecciona y confirma.
Claude Code leerá automáticamente tu archivo CLAUDE.md. No verás ningún mensaje de confirmación; esto ocurre silenciosamente en segundo plano cada vez que abres una carpeta.
Si estás usando una terminal, abre la terminal y ejecuta esto:
cd ~/Desktop/my-agent claude
El comando cd significa "cambiar directorio"; te mueve dentro de la carpeta my-agent. Escribir claude inicia la sesión desde esa carpeta.
PASO 4: EJECUTAR EL AGENTE
Escribe esto exactamente en el cuadro de indicación en la parte inferior de la interfaz de Claude Code:
Lee cada archivo .txt en la carpeta articles. Encuentra cualquier archivo que falte una línea de Title al principio. Escribe los resultados en missing-titles.txt según las instrucciones en CLAUDE.md.
Presiona Enter. Y observa.
Claude Code te mostrará todo lo que hace mientras trabaja: qué archivo lee, qué encuentra en cada uno y qué escribe. Esta transparencia es intencional. Puedes ver cada acción antes de que ocurra y detenerla si algo parece extraño.
Claude lee los cuatro archivos, detecta los dos sin títulos y crea el archivo missing-titles.txt en tu carpeta my-agent. Cuando lo abras, deberías ver los dos nombres de archivo escritos uno debajo del otro.
ERROR MÁS COMÚN: EL AGENTE DICE "HECHO" PERO EL ARCHIVO ESTÁ VACÍO
Esto suele ocurrir cuando el agente crea el archivo missing-titles.txt pero no escribe nada dentro. La razón es casi siempre que la instrucción en CLAUDE.md es demasiado vaga.
Solución: Abre CLAUDE.md y haz las instrucciones de salida más concretas. En lugar de "Lista los archivos", escribe "escribe cada nombre de archivo en su propia línea, por ejemplo: post-two.txt". Poner un ejemplo concreto en la instrucción hace que la salida sea concreta cada vez.
Si el agente escribe el nombre de archivo incorrecto o se salta uno, asegúrate de que tus archivos de artículo realmente tengan la extensión .txt, no .txt.txt. Esto sucede a menudo en Windows cuando las extensiones de archivo están ocultas. Activa "mostrar extensiones de archivo" desde la configuración del Explorador de archivos y verifica.
PASO 5: VERIFICAR Y EXPANDIR
Abre el archivo missing-titles.txt y verifica que esos dos archivos que dejaste en blanco estén listados. Si es correcto, significa que tu agente funcionó correctamente de principio a fin.
Ahora tienes un agente funcional. Vive en my-agent, toma sus instrucciones de CLAUDE.md, y puedes ejecutarlo de nuevo con la misma indicación cuando agregues nuevos archivos a la carpeta articles.
El siguiente paso claro: actualiza CLAUDE.md y haz que también verifique si cada archivo tiene más de cinco líneas. Agrega esto debajo del encabezado "Qué buscar":
**Un archivo válido también contiene contenido de más de 5 líneas. Si un archivo tiene 5 líneas o menos, márcalo también como "demasiado corto" junto a la verificación del título.**
Ejecuta el agente de nuevo con la misma indicación. Ahora verificará dos cosas en lugar de una; no hiciste cambios en tu indicación, solo cambió el archivo de instrucciones.
¿QUÉ HICISTE Y POR QUÉ ES IMPORTANTE?
Construiste un agente que lee archivos, toma decisiones, escribe resultados y hace esto sin que tú supervises cada paso. Este es el patrón básico para cada agente más avanzado que construirás de ahora en adelante.
La parte que escala es CLAUDE.md. Cada nueva regla, nueva verificación y nuevo formato de salida que agregues allí cambia lo que el agente hace sin que tú cambies cómo lo ejecutas. La indicación permanece igual, la instrucción evoluciona.
Pasos naturales desde aquí: verificar más tipos de archivos, escribir el informe en un formato diferente como CSV, o hacer que la verificación se repita automáticamente en ciertos intervalos.
Felicidades, has dado el primer paso; el resto está en tus manos, en proporción a tu imaginación.
Actúa antes de que la brecha se amplíe.
No olvides guardar y compartir, y apoya comentando.
