aprende a instalar Claude Code, escribir tu primer agente desde cero, y terminar con algo real: un agente funcional que lee una carpeta, detecta problemas y escribe un informe, sin necesidad de experiencia en programación.
un chatbot espera que le hagas una pregunta y la responde. un agente de IA es diferente: le das un objetivo y él mismo determina los pasos, lee archivos, ejecuta comandos y toma acción por su cuenta hasta que el trabajo está hecho. no estás guiando cada movimiento. estás definiendo el destino.
esa diferencia es importante porque cambia lo que puedes automatizar. no estás escribiendo instrucciones una por una. estás construyendo algo que hace el trabajo mientras tú te concentras en otra cosa.
Lo que necesitas antes de empezar
esto es todo lo que requieres antes de tocar un solo comando:
- una cuenta de Claude con un plan de pago (Pro a $20/mes es el mínimo; Claude Code está incluido)
- una Mac con macOS 13 o superior, o una PC con Windows, o una máquina Linux
- una conexión a internet
- aproximadamente 30 a 45 minutos para la configuración completa y la primera construcción
no se necesita experiencia previa en programación. cada comando de esta guía está escrito completo. solo copias, pegas y presionas Enter.
costo de seguir esta guía: $0 además de tu suscripción. Claude Code está incluido en todos los planes de pago de Claude.
Instalar Claude Code (ruta de la aplicación de escritorio, sin necesidad de terminal)
la ruta más sencilla para un principiante es la aplicación de escritorio. te brinda todo el poder de Claude Code sin tener que aprender comandos de terminal primero.
ve a claude.ai y descarga la aplicación de escritorio para tu plataforma. en macOS, abre el archivo .dmg y arrastra Claude a la carpeta de Aplicaciones. en Windows, ejecuta el instalador. inicia la aplicación, inicia sesión con tu cuenta de Claude y haz clic en la pestaña Code en el centro superior de la pantalla.
si la pestaña Code te pide que actualices tu plan, tu plan actual no incluye Claude Code. si te pide que inicies sesión en línea, completa el inicio de sesión y reinicia la aplicación. de cualquier manera, una vez dentro, llegarás a un espacio de trabajo limpio.
cómo se ve el éxito: ves un cuadro de entrada en blanco con la pestaña Code activa y sin mensajes de error. ese es tu espacio de trabajo del agente. todo lo que construyas vive aquí.
Lo que vas a construir
vas a construir un agente específico y lo usarás a lo largo de toda esta guía.
la tarea del agente: leer una carpeta de archivos de texto, encontrar cualquier archivo que no tenga una línea de título al inicio y escribir un informe llamado missing-titles.txt que liste cada archivo que necesita corrección.
esta es una tarea real y útil. muestra todos los comportamientos centrales de un agente: leer archivos, tomar decisiones y escribir resultados. y es lo suficientemente simple como para verificar a simple vista cuando funciona.
Paso 1: Crear tu carpeta de trabajo
crea una nueva carpeta en tu Escritorio llamada my-agent. aquí es donde trabajará el agente. solo puede ver y tocar archivos dentro de esta carpeta, lo que mantiene todo seguro y contenido.
dentro de my-agent, crea una segunda carpeta llamada articles. aquí es donde el agente buscará archivos para revisar.
ahora crea cuatro archivos de texto plano dentro de articles. nómbralos post-one.txt, post-two.txt, post-three.txt y post-four.txt. abre dos de ellos y agrega esto como la primera línea:
1Title: My Article
deja los otros dos archivos completamente vacíos. la tarea del agente es encontrar esos vacíos.
cómo se ve el éxito: la estructura de tu carpeta es my-agent/articles/ y contiene cuatro archivos .txt, dos con una línea de título y dos sin ella.
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. son las instrucciones permanentes de tu agente, el equivalente a una descripción de 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, incluido el Bloc de notas en Windows o TextEdit en Mac, y pega esto exactamente:
1# My File Checker Agent23## Your job45Check every .txt file inside the /articles folder.67## What to look for89A valid file starts with a line that reads exactly: Title:1011If the first line does not start with "Title:", the file is missing its title.1213## What to do14151. Read every .txt file in /articles one by one.162. Note which files are missing the Title line.173. Write a file called missing-titles.txt in the main folder.184. In that file, list every filename that failed the check, one per line.195. If all files pass, write "All files have titles." in missing-titles.txt instead.2021## What not to do2223Do not edit any of the article files. Read only. Write only to missing-titles.txt.
guarda el archivo. este es el cerebro completo de tu agente. Claude Code lo leerá antes de hacer cualquier cosa.
cómo se ve el éxito: tienes un archivo en my-agent/CLAUDE.md que contiene las instrucciones anteriores.
Paso 3: Apuntar Claude Code a tu carpeta
abre la aplicación de escritorio de Claude Code y haz clic en el ícono de carpeta o en la opción "Abrir carpeta" para navegar hasta tu carpeta my-agent. selecciónala y confirma.
Claude Code leerá tu archivo CLAUDE.md automáticamente. no verás un mensaje de confirmación para esto; ocurre en segundo plano cada vez que abres una carpeta.
si estás usando la terminal en lugar de la aplicación de escritorio, abre tu terminal y ejecuta:
1cd ~/Desktop/my-agent2claude
el comando cd significa "cambiar directorio". te mueve a tu carpeta my-agent. escribir claude inicia la sesión del agente desde dentro de esa carpeta.
Paso 4: Ejecutar el agente
en el cuadro de entrada en la parte inferior de la interfaz de Claude Code, escribe esto exactamente:
1Read every .txt file in the articles folder. Find any file missing a Title line at the top. Write the results to missing-titles.txt as instructed in CLAUDE.md.
presiona Enter. observa lo que sucede.
Claude Code te mostrará su trabajo mientras se ejecuta: qué archivos está leyendo, 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 incorrecto.
cómo se ve el éxito: Claude lee cuatro archivos, identifica dos sin título y crea missing-titles.txt en tu carpeta my-agent. abre ese archivo y deberías ver los dos nombres de archivo listados, uno por línea.
Error común de principiante: el agente dice que terminó pero el archivo está vacío
esto sucede cuando el agente escribe missing-titles.txt pero en realidad no pone nada dentro. la causa casi siempre es una instrucción en CLAUDE.md que es demasiado vaga.
la solución: abre CLAUDE.md y haz que las instrucciones de salida sean más explícitas. en lugar de "enumera los archivos", escribe "escribe cada nombre de archivo en su propia línea, así: post-two.txt". los ejemplos concretos en tus instrucciones producen resultados concretos cada vez.
si el agente escribe los nombres de archivo incorrectos u omite uno, verifica que tus archivos de artículo tengan realmente la extensión .txt y no .txt.txt, lo que puede ocurrir en Windows cuando las extensiones de archivo están ocultas. activa "mostrar extensiones de archivo" en la configuración del Explorador de archivos para verificarlo.
Paso 5: Verificar y ampliar
abre missing-titles.txt y confirma que lista exactamente los dos archivos que dejaste vacíos. si lo hace, tu agente funcionó correctamente de principio a fin.
ahora tienes un agente funcional. vive en my-agent, lee desde CLAUDE.md y se puede ejecutar cada vez que coloques nuevos archivos en la carpeta articles y uses la misma instrucción.
el siguiente paso claro: actualiza CLAUDE.md para que también verifique que cada archivo tenga más de cinco líneas. agrega esto debajo de "What to look for":
1A valid file also has more than 5 lines of content.2If a file has 5 lines or fewer, flag it as "too short" alongside the title check.
ejecuta el agente nuevamente con la misma instrucción. ahora revisará dos cosas en lugar de una, sin cambios en tu instrucción, solo un cambio en el archivo de instrucciones.
Lo que acabas de construir y por qué es importante
construiste un agente que lee archivos, toma decisiones y escribe resultados, sin que supervises cada paso. ese es el patrón central detrás de cada agente más avanzado que construyas en el futuro.
el archivo CLAUDE.md es la parte que escala. cada nueva regla, nueva verificación o nuevo formato de salida que agregues allí cambia lo que el agente hace sin que cambies la forma en que lo ejecutas. la instrucción se mantiene igual. las instrucciones evolucionan.
a partir de aquí, las extensiones naturales son: revisar más tipos de archivos, escribir el informe en un formato diferente como CSV, o ejecutar la verificación en un horario usando la función incorporada Routines de Claude Code.
¿preguntas sobre algún paso? déjalas abajo.
