Ruta Modular
de Operador IA
Aprende a operar Claude Code, GitHub, automatizaciones y sistemas IA por módulos prácticos. Sin días fijos. Sin código previo. A tu ritmo.
Glosario rápido
12 términosConsulta los que no conozcas. No hace falta memorizar ninguno ahora.
CLI ▼
Command Line Interface. La pantalla de texto donde escribes comandos directamente al sistema, sin botones ni menús.
Terminal ▼
El programa que da acceso a la CLI. En Mac: Terminal o iTerm2. En Windows: PowerShell o Windows Terminal.
VS Code ▼
Visual Studio Code. El editor de código más usado. Gratuito. Desde aquí editarás casi todos tus proyectos.
Git ▼
Sistema de control de versiones. Registra cada cambio en tus archivos con un mensaje. Si algo se rompe, puedes volver atrás.
GitHub ▼
Plataforma donde subes tus repositorios Git. La nube de tu código. También conecta con Cloudflare Pages para publicar.
Repo ▼
Repositorio. La carpeta de tu proyecto con todo su historial de cambios. Puede ser local o estar en GitHub.
Commit ▼
Un punto de guardado con mensaje. "Añadí README." "Arreglé bug." Cada commit es una foto de tu proyecto en ese momento.
API ▼
Puerta de acceso a una herramienta externa. Le envías una solicitud y recibes una respuesta. Así se comunican los servicios.
MCP ▼
Model Context Protocol. Extensión que conecta a Claude con sistemas reales: archivos locales, GitHub, bases de datos.
CLAUDE.md ▼
Archivo de instrucciones persistentes para Claude. Le dice qué es el proyecto, cómo trabajar y qué evitar hacer.
Deploy ▼
Publicar un proyecto en internet. Convierte código local en una URL accesible desde cualquier navegador.
Cloudflare Pages ▼
Plataforma de hosting gratuito para proyectos estáticos. Conectas tu repo y el sitio se actualiza en cada push.
Preparar contexto
⏱ 15 minAl terminar
Tienes un documento con tu contexto operativo listo para darle a Claude al inicio de cualquier proyecto.
Claude no tiene memoria entre sesiones. Sin contexto, trabaja de forma genérica. Con contexto, trabaja de forma precisa. Este módulo te enseña a crear ese contexto antes de empezar cualquier tarea.
Por qué importa
La mayoría de outputs mediocres de IA no vienen de la herramienta, vienen de la falta de contexto. Un documento bien escrito te ahorra media hora de correcciones en cada sesión.
Tengo historial de trabajo contigo en conversaciones previas. Extrae un resumen estructurado con estos bloques: - Nombre de mi proyecto o área de trabajo principal - Herramientas que uso habitualmente - Mis objetivos actuales - Mi estilo de trabajo preferido con IA - Lo que NO quiero que hagas cuando trabajamos juntos - Cualquier regla de trabajo que hayamos establecido juntos Formato: Markdown. Máximo 30 líneas. Sin decoración ni relleno.
Ver ejercicio paso a paso ▼
Objetivo
Crear un documento personal de contexto operativo que puedas darle a Claude al inicio de cualquier proyecto.
Antes de empezar
Abre VS Code o cualquier editor. No necesitas instalar nada para este módulo.
Pasos
- 1 Crea un archivo llamado
mi-contexto.mden una carpeta de tu elección. - 2 Escribe estas secciones: Quién soy, Proyectos activos, Herramientas que uso, Cómo prefiero trabajar, Lo que NO quiero que Claude haga.
- 3 Sé concreto. Una línea por punto. Sin párrafos innecesarios.
- 4 Si tienes historial en Claude.ai, usa el prompt de arriba para extraer el contexto automáticamente.
Resultado esperado
Un archivo mi-contexto.md de 20–30 líneas con información densa y útil sobre ti y tu trabajo.
Error común
Escribir demasiado. El contexto debe ser preciso, no exhaustivo. Si pasa de 30 líneas, recorta.
Cómo saber que está bien
Puedes darle el archivo a Claude en una nueva sesión y él sabe cómo trabajar contigo sin que tengas que explicar nada básico.
Entorno de trabajo
⏱ 20 minAl terminar
Terminal abierta, carpeta de práctica creada y VS Code funcionando con tu primer archivo.
No puedes operar sistemas digitales sin conocer el entorno donde viven. La terminal es el cockpit desde donde controlas todo. VS Code es donde editas y revisas. Este módulo te da las herramientas mínimas para empezar.
Por qué importa
Muchos principiantes evitan la terminal durante meses. Es el error más caro que puedes cometer. Todo lo que harás en los siguientes módulos requiere moverse por ella con soltura básica.
Ver ejercicio paso a paso ▼
Objetivo
Abrir la terminal, crear una carpeta de práctica y abrir el entorno de trabajo en VS Code.
Antes de empezar
Descarga e instala VS Code desde code.visualstudio.com si todavía no lo tienes.
Pasos
- 1 Abre la terminal. Mac:
Cmd+Espacio→ "Terminal". Windows: tecla Windows → "PowerShell". - 2 Ejecuta
mkdir operador-practicapara crear tu carpeta de práctica. - 3 Ejecuta
cd operador-practicapara entrar en ella. - 4 Ejecuta
touch README.md(Mac/Linux) oni README.md(Windows) para crear un archivo. - 5 Ejecuta
code .para abrir la carpeta en VS Code.
Resultado esperado
VS Code abierto con la carpeta operador-practica y el archivo README.md visible en el explorador lateral.
Error común
Usar nombres de carpetas con espacios. Evítalos: usa guiones en lugar de espacios (operador-practica, no operador practica).
Cómo saber que está bien
Ves el archivo README.md en el panel izquierdo de VS Code y puedes editarlo.
Claude Code
⏱ 20 minAl terminar
Claude Code instalado y usado para generar documentación real dentro de tu proyecto.
Claude Code no es un chatbot. Es un asistente que trabaja dentro de tu proyecto: lee archivos, escribe código, ejecuta acciones y propone soluciones en contexto. Sabe lo que hay en tu carpeta. Eso cambia todo.
Por qué importa
Usar Claude desde un chat web y usarlo desde Claude Code son dos experiencias completamente distintas. Uno responde preguntas. El otro ejecuta trabajo dentro de tu proyecto.
Actúa como redactor de documentación técnica. Analiza este proyecto y crea un README.md que incluya: - Qué hace este proyecto en una sola línea - Por qué existe - Cómo instalarlo y ejecutarlo - Estructura de archivos y carpetas relevante - Próximos pasos o cómo contribuir Tono: claro y directo. Sin lenguaje innecesariamente técnico.
Ver ejercicio paso a paso ▼
Objetivo
Instalar Claude Code y completar tu primera tarea real: generar documentación para tu proyecto.
Antes de empezar
Necesitas Node.js instalado. Compruébalo con: node --version. Si no aparece un número, descárgalo en nodejs.org.
Pasos
- 1 Instala Claude Code:
npm install -g @anthropic-ai/claude-code - 2 Navega a tu carpeta:
cd operador-practica - 3 Inicia Claude Code:
claude - 4 Usa el prompt de arriba o escríbele directamente: "Crea un README.md que explique que esta es mi carpeta de práctica para aprender a operar sistemas IA."
- 5 Lee el resultado completo. Edita cualquier cosa que no sea correcta o que no represente bien tu proyecto.
Resultado esperado
Un README.md con contenido generado por Claude y revisado por ti. El archivo tiene sentido y no contiene información inventada.
Error común
Aceptar el output de Claude sin leerlo. Claude puede inventar detalles que no existen. Siempre revisa antes de guardar.
Cómo saber que está bien
El README describe con precisión qué es tu carpeta de práctica y no contiene ninguna afirmación falsa.
README.md revisado y correcto GitHub y seguridad
⏱ 25 minAl terminar
Primer repositorio subido a GitHub con commits claros y .gitignore configurado para no exponer información sensible.
Git registra cada cambio con un mensaje. GitHub guarda esos registros en la nube. Sin Git, tu trabajo no tiene historial y no puede desplegarse fácilmente. Sin .gitignore, puedes subir claves API o contraseñas por accidente.
Por qué importa
Git no es solo para programadores. Es para cualquiera que quiera no perder trabajo, colaborar con otros o publicar proyectos en internet. La seguridad del .gitignore no es opcional: una clave API filtrada en GitHub puede generar facturas de cientos de euros en horas.
Ver ejercicio paso a paso ▼
Objetivo
Inicializar Git en tu proyecto, hacer un primer commit seguro y subir el repo a GitHub.
Antes de empezar
Crea una cuenta gratuita en github.com si todavía no tienes una.
Pasos
- 1 Dentro de
operador-practica, ejecutagit init - 2 Crea un archivo
.gitignorey añade estas líneas:.DS_Store,node_modules/,.env - 3 Ejecuta
git add .y luegogit commit -m "inicio: carpeta de práctica de operador IA" - 4 En github.com, crea un nuevo repo vacío llamado
operador-practica. Copia la URL. - 5 Ejecuta
git remote add origin TU_URLy luegogit push -u origin main
Resultado esperado
Tu carpeta operador-practica visible en github.com con el README y al menos un commit con mensaje claro.
Error común
Hacer el primer commit sin tener .gitignore. Si subes un .env con claves API antes de añadir el .gitignore, esas claves quedan en el historial aunque luego las borres.
Cómo saber que está bien
Abres la URL del repo en GitHub desde otro navegador y ves tus archivos sin ningún archivo .env o de credenciales.
CLAUDE.md y memoria
⏱ 20 minAl terminar
Un archivo CLAUDE.md en tu proyecto que le da contexto persistente a Claude sin que tengas que repetirlo en cada sesión.
Claude no recuerda entre sesiones, pero puede leer archivos. Un CLAUDE.md bien escrito es el manual de instrucciones de tu proyecto. Claude lo lee al iniciar y sabe exactamente cómo comportarse: qué hacer, qué evitar, cómo hablar.
Por qué importa
Sin CLAUDE.md, cada sesión empieza de cero. Con CLAUDE.md, cada sesión empieza alineada con tus objetivos, tu estilo y tus reglas. La diferencia se acumula en horas ahorradas.
Actúa como arquitecto de proyectos. Crea un CLAUDE.md para este proyecto con: - Descripción y objetivo principal - Stack técnico utilizado - Convenciones de estilo o código - Lo que NO debes hacer en este proyecto - Cómo añadir módulos o nuevas secciones - Tono y voz del proyecto si aplica Sé conciso. Sin relleno. Máximo 40 líneas.
Ver ejercicio paso a paso ▼
Objetivo
Crear un CLAUDE.md para operador-practica con objetivo, stack, estilo y restricciones.
Antes de empezar
Piensa en 3 cosas que quieres que Claude sepa de este proyecto antes de empezar a trabajar en él.
Pasos
- 1 Abre
operador-practicaen VS Code. - 2 Crea un archivo
CLAUDE.mden la raíz del proyecto. - 3 Usa el prompt de arriba en Claude para que te ayude a completarlo.
- 4 Revisa el resultado. Ajusta lo que no encaje con tu proyecto real. Elimina lo que sea genérico.
- 5 Haz commit:
git add CLAUDE.md && git commit -m "añadir CLAUDE.md"
Resultado esperado
Un CLAUDE.md de 20–40 líneas con reglas claras y contexto útil. En la próxima sesión, Claude lee el archivo y ya sabe cómo trabajar.
Error común
Escribir reglas contradictorias o demasiado generales como 'sé útil' o 'trabaja bien'. Las reglas deben ser específicas: 'no añadas dependencias sin justificación', 'usa siempre español'.
Cómo saber que está bien
Abres una nueva sesión de Claude Code en la misma carpeta y, sin explicar nada, él ya sabe qué es el proyecto y cómo trabajar en él.
Prompts operativos
⏱ 20 minAl terminar
Sabes estructurar peticiones que producen trabajo directamente usable, no respuestas genéricas que hay que reescribir.
Un prompt genérico produce resultados genéricos. Un prompt operativo tiene rol, contexto, estructura y límites. La diferencia puede ser media hora de trabajo extra en correcciones o un entregable que usas tal cual.
Por qué importa
La mayoría de la gente usa la IA como si fuera un buscador. La IA no es un buscador. Es un colaborador que necesita briefing. Sin briefing, produce trabajo genérico. Con briefing, produce trabajo específico.
Actúa como analista de flujos de trabajo. Analiza esta tarea repetitiva: [describe la tarea en detalle] Responde: 1. Pasos que la componen, desglosados sin omitir ninguno 2. Qué pasos son automatizables y cuáles no, con justificación 3. Qué herramienta resolvería cada parte automatizable 4. Qué partes requieren supervisión humana obligatoria 5. Estimación de tiempo ahorrado si se implementara la automatización Sé específico. No generalices.
Ver ejercicio paso a paso ▼
Objetivo
Transformar una petición vaga en un prompt operativo y comparar los resultados lado a lado.
Pasos
- 1 Piensa en una tarea concreta que quieras delegar a Claude. Por ejemplo: redactar un email, resumir un documento, crear una lista de tareas.
- 2 Escribe la versión vaga en una línea: "Escríbeme un email para un cliente", "Resume este texto", "Dame ideas para esto".
- 3 Ahora reescríbela añadiendo: rol de Claude, quién es el receptor, tono esperado, formato del output, extensión máxima.
- 4 Envía ambas versiones a Claude y compara los resultados en paralelo.
- 5 Anota la diferencia. ¿Cuál usarías sin editar? ¿Qué parte del contexto fue la que más cambió el output?
Resultado esperado
Un prompt operativo escrito por ti que produce un output que usarías directamente, sin edición significativa.
Error común
Añadir contexto que no es relevante para la tarea. El contexto debe ser denso y pertinente, no extenso.
Cómo saber que está bien
El output del prompt operativo no necesita reescritura para usarse. El output del prompt vago sí la necesita.
Automatizaciones
⏱ 25 minAl terminar
Has identificado al menos una tarea de tu trabajo que puede sistematizarse y tienes un mapa de cómo hacerlo.
Automatizar no significa programar. Significa pensar en pasos: qué hago, qué parte puede hacer una máquina, qué necesito supervisar. Este módulo es sobre diseñar antes de construir.
Por qué importa
La mayoría de la gente automatiza antes de entender qué está automatizando. El resultado son sistemas frágiles que se rompen cuando algo cambia. Mapear primero ahorra horas después.
Ver ejercicio paso a paso ▼
Objetivo
Mapear una tarea repetitiva propia y detectar qué partes son automatizables, cuáles necesitan supervisión y cuáles requieren criterio humano.
Pasos
- 1 Elige una tarea que hagas al menos una vez por semana. Cuanto más concreta, mejor.
- 2 Escribe todos los pasos de esa tarea, en orden, sin omitir ninguno. Incluye incluso los más pequeños.
- 3 Para cada paso, pon una etiqueta:
automatizable(máquina sola),supervisado(IA + revisión tuya),humano(requiere tu criterio). - 4 Identifica el paso que más tiempo o energía mental te consume.
- 5 Diseña cómo sería ese paso si lo ejecutara Claude. ¿Qué información necesitaría? ¿Qué produciría? ¿Cómo lo revisarías?
Resultado esperado
Un documento con el mapa de la tarea, etiquetado por tipo (automatizable / supervisado / humano) y una propuesta de flujo mejorado.
Error común
Intentar automatizar todo de golpe. Empieza por el paso más repetitivo y menos crítico. Los sistemas pequeños que funcionan valen más que los grandes que no terminan.
Cómo saber que está bien
Puedes describir el sistema en 5 líneas y explicarle a alguien cómo funcionaría sin usar palabras técnicas.
Publicar y mejorar
⏱ 20 minAl terminar
Algo publicado con una URL real, accesible desde cualquier navegador, y una lista de mejoras documentadas para la siguiente versión.
Publicar cierra el ciclo. Convierte trabajo privado en trabajo real. Aprende a desplegar algo pequeño en menos de 10 minutos. Después escribe qué cambiarías: así empieza la iteración.
Por qué importa
Los proyectos que no se publican no reciben feedback, no mejoran y eventualmente se abandonan. Lo imperfecto que funciona y existe siempre vale más que lo perfecto que no llega a salir.
Ver ejercicio paso a paso ▼
Objetivo
Desplegar operador-practica en Cloudflare Pages y documentar mejoras para v2.
Antes de empezar
Asegúrate de que el proyecto tiene al menos un archivo de contenido y está subido a GitHub.
Pasos
- 1 Entra en
dash.cloudflare.com→ Workers & Pages → Create → Pages. - 2 Conecta tu cuenta de GitHub y selecciona el repo
operador-practica. - 3 Si es HTML estático: deja Build command vacío, output directory
/. Si es Astro: Build commandnpm run build, outputdist. - 4 Haz click en Save and Deploy. En ~60 segundos tienes una URL pública.
- 5 Crea
mejoras-v2.mdcon al menos 3 cosas concretas que cambiarías o añadirías si empezaras de nuevo.
Resultado esperado
URL pública activa que carga desde cualquier navegador, más un archivo mejoras-v2.md con al menos 3 puntos concretos.
Error común
Esperar a que esté 'perfecto' para publicar. No existe el perfecto antes de publicar. Existe el imperfecto que recibe feedback y mejora.
Cómo saber que está bien
La URL carga en un navegador que no es el tuyo. El archivo mejoras-v2.md tiene puntos concretos, no vagos.
Completar la ruta no significa saberlo todo. Significa que ya tienes un sistema mínimo para aprender, construir, publicar y mejorar.
Ver Onboarding →