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 a 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 actúa por su cuenta hasta completar la tarea. No estás controlando cada movimiento, solo estás definiendo el destino.
Esa diferencia importa porque cambia lo que puedes automatizar. No estás escribiendo indicaciones 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 posterior, 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 en esta guía está escrito por completo. Solo copias, pegas y presionas Enter.
Costo de seguir esta guía: $0 adicional a tu suscripción. Claude Code está incluido en todos los planes de pago de Claude.
Instalar Claude Code (ruta de la app de escritorio, sin necesidad de terminal)
La forma más fácil para un principiante es la aplicación de escritorio. Te da todo el poder de Claude Code sin necesidad de 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 tu carpeta de Aplicaciones. En Windows, ejecuta el instalador. Inicia la app, inicia sesión con tu cuenta de Claude y haz clic en la pestaña Código en la parte superior central de la pantalla.
Si la pestaña Código te pide que actualices tu plan, significa que 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, terminarás en un espacio de trabajo limpio una vez que estés dentro.
Cómo saber que funcionó: ves un cuadro de indicación en blanco con la pestaña Código 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 principio 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 verificarlo visualmente cuando funcione.
Paso 1: Crea 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 archivos vacíos.
Cómo saber que funcionó: 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: Escribe 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# Mi agente verificador de archivos23## Tu trabajo45Revisa cada archivo .txt dentro de la carpeta /articles.67## Qué buscar89Un archivo válido comienza con una línea que dice exactamente: Title:1011Si la primera línea no comienza con "Title:", el archivo no tiene título.1213## Qué hacer14151. Lee cada archivo .txt en /articles uno por uno.162. Anota qué archivos no tienen la línea Title.173. Escribe un archivo llamado missing-titles.txt en la carpeta principal.184. En ese archivo, lista cada nombre de archivo que no pasó la verificación, uno por línea.195. Si todos los archivos pasan, escribe "Todos los archivos tienen título." en missing-titles.txt.2021## Qué no hacer2223No edites ninguno de los archivos de artículos. Solo leer. Escribir solo en missing-titles.txt.
Guarda el archivo. Este es todo el cerebro de tu agente. Claude Code lo leerá antes de hacer cualquier cosa.
Cómo saber que funcionó: tienes un archivo en my-agent/CLAUDE.md y contiene las instrucciones anteriores.
Paso 3: Apunta Claude Code a tu carpeta
Abre la aplicación de escritorio de Claude Code y haz clic en el ícono de la carpeta o en la opción "Abrir carpeta" para navegar a 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 por esto; ocurre silenciosamente 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 de directorio". Te mueve a tu carpeta my-agent. Escribir claude inicia la sesión del agente desde esa carpeta.
Paso 4: Ejecuta el agente
En el cuadro de indicación en la parte inferior de la interfaz de Claude Code, escribe exactamente esto:
1Lee cada archivo .txt en la carpeta articles. Encuentra cualquier archivo que no tenga una línea Title al principio. Escribe los resultados en missing-titles.txt según lo indicado en 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 saber que funcionó: 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 principiantes: 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 las instrucciones de salida más explícitas. En lugar de "lista 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 o se salta uno, verifica que tus archivos de artículo tengan realmente la extensión .txt y no .txt.txt, lo que puede suceder 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: Verifica y amplía
Abre missing-titles.txt y confirma que lista exactamente los dos archivos que dejaste vacíos. Si es así, 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 ejecutes la misma indicació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 "Qué buscar":
1Un archivo válido también tiene más de 5 líneas de contenido.2Si un archivo tiene 5 líneas o menos, márcalo como "demasiado corto" junto con la verificación del título.
Ejecuta el agente nuevamente con la misma indicación. Ahora revisará dos cosas en lugar de una, sin cambios en tu indicació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 construirás.
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 hace el agente sin que cambies la forma en que lo ejecutas. La indicación sigue siendo la misma. Las instrucciones evolucionan.
A partir de aquí, las extensiones naturales son: revisar más tipos de archivo, escribir el informe en un formato diferente como CSV, o ejecutar la verificación en un horario programado usando la función de Rutinas integrada de Claude Code.
¿Preguntas sobre algún paso? Déjalas abajo.
