# Aprende a programar con IA: guía práctica para empezar

URL: https://agentvera.dev/es/blog/learn-to-code-with-ai/ · Publicado: 2026-10-27

Usa un agente de programación con IA como tutor, no como máquina expendedora: prompts que explican primero, estilos de aprendizaje, modo plan y proyectos pequeños.

**En resumen:**

- Un agente de programación con IA puede ser un tutor paciente si le pides que explique antes de escribir y que deje las partes importantes para que las escribas tú.
- El estilo de salida Learning de Claude Code marca huecos con TODO(human) para que los escribas tú; el modo plan te deja leer y cuestionar un enfoque antes de que cambie ningún archivo.
- Haz proyectos pequeños que te importen, lee cada diff, pregunta por qué y, de vez en cuando, vuelve a construir algo sin el agente para comprobar qué has aprendido de verdad.

Para aprender a programar con IA, usa el agente de programación como tutor y no como una máquina expendedora de código: pídele que explique antes de escribir, que deje partes clave para que las escribas tú, lee cada cambio que haga y pregunta por qué hasta que la respuesta tenga sentido. Combínalo con proyectos pequeños que de verdad quieras hacer y, de vez en cuando, vuelve a construir algo sin el agente para ver qué se te ha quedado.

Esta guía es para quien empieza desde cero o casi. Da por hecho que tienes una terminal y un agente de programación con IA como Claude Code, Codex o Gemini CLI (o que estás a punto de elegir uno). Si quieres construir cosas rápido y no te importa mucho aprender el código que hay debajo, te conviene más leer [cómo hacer vibe coding](/es/blog/how-to-vibe-code/ "Cómo hacer vibe coding"). Este artículo es para cuando quieres que la habilidad se quede contigo.

## Por qué un agente puede ser un buen profesor (y cómo puede ser uno malo)

Un [agente de programación](/es/glossary/coding-agent/ "Qué es un agente de programación") lee tus archivos, ejecuta comandos y edita código en tu proyecto. Para alguien que aprende, eso es muy potente: puede mirar *tu* código, explicar *tu* error y mostrarte la corrección en contexto, a las 2 de la madrugada, sin cansarse de la misma pregunta.

También puede hacer todo el trabajo por ti. Si el agente escribe 400 líneas y tú pulsas aceptar, tienes un programa pero ninguna habilidad nueva. La diferencia no está en la herramienta; está en cómo le pides las cosas.

| Uso como máquina expendedora | Uso como tutor |
| --- | --- |
| “Hazme una app de tareas.” | “Quiero hacer una app de tareas para aprender JavaScript. ¿Qué partes tiene y cuál debería escribir primero?” |
| Aceptar todos los cambios | Leer el diff y preguntar por cada línea que no entiendas |
| Pegar el error y aceptar la corrección | “Explícame qué significa este error antes de corregirlo. ¿Dónde me equivoqué?” |
| Siguiente función, siguiente prompt | Volver a construir la función tú solo al día siguiente, sin ayuda |

## Prepara al agente para enseñar

### Dile quién eres

Los agentes se adaptan al contexto. Una nota breve al principio de la sesión, o en el archivo de instrucciones de tu proyecto (`CLAUDE.md` para Claude Code, `AGENTS.md` para Codex), cambia el tono de todo lo que viene después:

```text
Estoy aprendiendo a programar. Este proyecto es para practicar.
- Explica los conceptos con palabras sencillas antes de enseñar código.
- Prefiere pasos pequeños. Después de cada paso, para y déjame probarlo.
- Cuando haya que elegir, dime las opciones y por qué elegirías una.
- No escribas más de unas 20 líneas de una vez salvo que te lo pida.
- Si me equivoco, dame primero una pista, no la respuesta.
```

### Usa un estilo de salida para aprender (Claude Code)

Claude Code tiene estilos de salida que cambian cómo responde. A octubre de 2026, dos de ellos están pensados para aprender:

- **Explanatory** añade notas breves de “Insight” sobre por qué tomó ciertas decisiones de implementación y qué patrones usa tu código, sin dejar de hacer la tarea.
- **Learning** va más allá: comparte esas notas y además deja piezas pequeñas y significativas para que las escribas tú, marcadas con `TODO(human)` en el código, y espera a que las completes.

Cámbialo con `/output-style learning` o desde `/config` → Output style, o ponlo en tu archivo de ajustes:

```json
{
  "outputStyle": "Learning"
}
```

Los dos estilos dan respuestas más largas y gastan más tokens, algo razonable mientras aprendes. Vuelve al estilo por defecto cuando pases de estudiar a construir.

Codex y Gemini CLI no tienen esos mismos estilos integrados, pero el bloque de instrucciones de arriba te lleva casi al mismo sitio.

### Usa el modo plan para leer antes de que cambie nada

El modo plan deja que el agente mire tu proyecto y proponga un enfoque sin editar archivos. En Claude Code entras con Shift+Tab o `/plan`. Para quien aprende, es una lección gratis: ves cómo descompondría el problema un programador con experiencia y puedes cuestionar cada paso antes de que se escriba una sola línea.

```text
/plan Quiero añadir una función que guarde mi lista de tareas en un archivo
para que no se pierda al reiniciar. Explícame el plan como si nunca hubiera
trabajado con archivos. ¿Qué va a cambiar, en qué archivos y por qué?
```

Haz preguntas de seguimiento sobre el plan: “¿Por qué JSON y no un archivo de texto plano?” “¿Qué pasa si el archivo todavía no existe?” Luego decide si lo escribes tú, lo escribe el agente o os repartís el trabajo. [El modo plan de Claude Code](/es/blog/claude-code-plan-mode/ "Modo plan de Claude Code") explica en detalle cómo funciona.

## Elige proyectos pequeños que de verdad quieras hacer

Los tutoriales enseñan sintaxis; los proyectos enseñan a programar. Un buen primer proyecto es lo bastante pequeño para terminarlo en unas pocas sesiones y lo bastante útil para que te importe que funcione.

| Proyecto | Qué te enseña |
| --- | --- |
| Lista de tareas en la línea de comandos | Variables, listas, bucles, leer la entrada, guardar en un archivo |
| Página web personal | Estructura HTML, maquetación con CSS, publicar un sitio |
| Juego de preguntas o de adivinar | Condiciones, números aleatorios, llevar la puntuación, bucles de juego |
| Calculadora de propinas o de presupuesto | Funciones, números y redondeo, validación de la entrada |
| Un bot pequeño para una app de chat | APIs, tokens y variables de entorno, eventos |
| Una API web mínima | Rutas, JSON, códigos de estado HTTP, pruebas con curl |

Si quieres versiones guiadas, [crea una web con IA](/es/blog/build-website-with-ai/ "Crea una web con IA") y [haz un juego con IA](/es/blog/make-a-game-with-ai/ "Haz un juego con IA") recorren dos de estos de principio a fin.

Empieza cada proyecto pidiéndole al agente la versión más pequeña que funcione y luego hazla crecer función a función:

```text
Estoy haciendo una lista de tareas en la línea de comandos en Python para aprender.
¿Cuál es la primera versión más pequeña que funciona? Enumera los pasos.
No escribas el código todavía. Intentaré el paso 1 yo solo y te lo enseñaré.
```

## Lee cada diff

Cada cambio que hace el agente aparece como un diff: las líneas eliminadas en rojo y las añadidas en verde. Leer diffs es una de las habilidades más útiles que puedes desarrollar, porque es exactamente lo que hacen los desarrolladores profesionales todo el día en la revisión de código.

Para cada cambio, hazte tres preguntas:

1. ¿Qué ha cambiado?
2. ¿Por qué ahí y no en otro sitio?
3. ¿Qué se rompería si quitara esta línea?

Si no sabes responder alguna, pregúntale al agente:

```text
En el cambio que acabas de hacer en app.py, explícame las líneas 12 a 20
una a una. ¿Por qué usaste un diccionario en lugar de una lista aquí?
```

`git diff` en la terminal muestra lo mismo si tu herramienta no enseña bien los diffs. Y ya que hablamos de eso: aprende pronto los comandos básicos de git (`git init`, `git status`, `git add`, `git commit`, `git diff`, `git log`). Haz commit después de cada paso que funcione. Cuando el agente rompa algo, siempre podrás volver atrás, y eso hace que experimentar dé mucho menos miedo.

## Pregunta por qué, y vuelve a preguntar

El hábito que separa aprender de copiar es preguntar por qué. Algunas preguntas que funcionan bien:

- “Explícamelo como si solo supiera variables y bucles.”
- “¿Qué suele hacer mal un principiante aquí?”
- “Enséñame una versión más sencilla, aunque sea menos eficiente. Luego dime qué mejora la versión buena.”
- “¿Cómo se llama este concepto, para poder leer sobre él?”
- “Hazme un test de tres preguntas sobre el código que acabamos de escribir.”

La última es sorprendentemente eficaz. Si no sabes responder el test del agente, todavía no lo has aprendido, y ahora sabes exactamente qué repasar.

## Evita depender de copiar y pegar

El verdadero peligro de aprender con IA es sentirte productivo mientras aprendes poco. Unas cuantas reglas te mantienen honesto:

- **Escribe tú el núcleo.** Deja que el agente escriba el código repetitivo y la configuración; tú escribes la función que es el objetivo del ejercicio.
- **Pistas antes que respuestas.** Cuando te atasques, pide una pista, luego una pista mayor y después la respuesta.
- **Reconstruye sin ayuda.** Un día después de terminar una función, bórrala (git guarda una copia) y vuelve a escribirla con el agente cerrado. Lo que no sabes reconstruir no lo has aprendido.
- **Explícalo con tus palabras.** Escribe un comentario de dos líneas encima de cada función con tus propias palabras. Si no puedes, pídele al agente que te lo explique hasta que puedas.
- **Lee primero los mensajes de error.** Antes de pegarle un error al agente, léelo e intenta adivinar qué significa. Luego compara tu suposición con la explicación del agente.

## Depurar es el mejor profesor

Aprenderás más de los bugs que de las funciones nuevas. Cuando algo se rompa, resiste las ganas de decir “arréglalo”:

```text
Mi programa falla con el error de abajo. No lo arregles todavía.
1. Explícame qué significa el mensaje de error con palabras sencillas.
2. Dame una pista sobre dónde mirar.
3. Si aun así no lo encuentro, enséñame cómo lo localizarías tú.

TypeError: can only concatenate str (not "int") to str
```

Después de la corrección, pregunta cómo podrías haberlo encontrado más rápido la próxima vez: imprimir valores, leer el stack trace, ejecutar una parte cada vez. Esa es la habilidad que perdura. [Depurar código con IA](/es/blog/debug-code-with-ai/ "Depurar código con IA") profundiza en este ciclo.

## Elegir una herramienta y lo que cuesta

No necesitas la configuración más cara para aprender. En términos generales, a octubre de 2026:

- **Claude Code** necesita un plan de pago de Claude (Pro, Max, Team o Enterprise) o créditos de API; el plan gratuito de Claude no lo incluye. Sus estilos de salida Learning y Explanatory lo hacen muy adecuado para estudiar. Consulta [precios de Claude Code](/es/blog/claude-code-pricing/ "Precios de Claude Code") para más detalles.
- **Codex** está incluido en los planes de ChatGPT, incluidos algunos más baratos y gratuitos, con límites de uso que varían según el plan.
- **Gemini CLI** y otros agentes tienen sus propias opciones gratuitas y de pago, que cambian a menudo; consulta la página oficial de precios antes de comprometerte.
- **Los modelos locales** se ejecutan en tu propio ordenador sin coste por token, aunque suelen ser más flojos que los grandes modelos alojados. [Ejecutar un agente de programación con un LLM local](/es/blog/local-llm-coding-agent/ "Agente de programación con un LLM local") explica la configuración.

Los precios y los límites cambian. Elige una herramienta, apréndela bien y cambia solo cuando tengas un motivo concreto.

## Aprender con AgentVera

AgentVera es una app de escritorio para macOS, Windows y Linux que ejecuta Claude Code, Codex, Gemini CLI y otros agentes CLI en paneles uno al lado de otro. Algunas de sus funciones vienen especialmente bien cuando estás aprendiendo:

- **[Recorrido del proyecto](/es/features/project-tour-and-code-map/ "Recorrido del proyecto y mapa de código"):** abre cualquier proyecto y pide un recorrido. Una sesión de Claude Code en solo lectura explica cómo está organizado el código, y un grafo de módulos muestra qué archivos dependen de cuáles. Útil cuando abres un proyecto de ejemplo y no sabes por dónde empezar.
- **[Editor y terminal](/es/features/editor-and-terminal/ "Editor y terminal"):** lee código en el editor integrado, selecciona una línea confusa y pulsa ⌘⇧L para enviársela a un agente con tu pregunta. La pestaña Changes muestra cada diff lado a lado o unificado.
- **[Workspace](/es/features/workspace/ "Workspace"):** ten un panel “tutor” en modo plan que solo explica, junto a un panel “constructor” donde tú y el agente escribís código. Las preguntas no ensucian la sesión de construcción.
- **[Checkpoints](/es/features/checkpoints-and-replay/ "Checkpoints y replay"):** cada turno se guarda, así que puedes volver a antes de que un experimento saliera mal e intentarlo otra vez.
- **[Revisión de código](/es/features/code-review/ "Revisión de código"):** un modelo revisor mira los cambios de cada turno y señala problemas con archivo y línea, lo que te da una segunda explicación de lo que podría fallar.

Todo esto está en el plan gratuito. Para empezar, sigue [primeros pasos con AgentVera](/es/blog/getting-started-with-agentvera/ "Primeros pasos con AgentVera") o [descarga AgentVera](/es/download/ "Descargar AgentVera") directamente.

## Un plan de inicio de cuatro semanas

Si quieres estructura, esta es una forma de aprovechar tu primer mes:

1. **Semana 1: lo básico con un tutor.** Elige un lenguaje (Python o JavaScript son primeras opciones habituales). Usa el estilo Learning o el bloque de instrucciones de arriba. Escribe programas diminutos: saludar al usuario, sumar números, recorrer una lista. Pídele al agente que te haga un test al final de cada sesión.
2. **Semana 2: tu primer proyecto.** Construye la lista de tareas en la línea de comandos en pasos pequeños. Haz commit después de cada paso que funcione. Lee cada diff.
3. **Semana 3: algo visible.** Haz una página web personal o un juego pequeño. Usa el modo plan antes de cada función y cuestiona el plan.
4. **Semana 4: reconstruye y amplía.** Vuelve a construir el proyecto de la semana 2 sin el agente. Después añade una función que diseñes tú, usando el agente solo para pistas y revisión.

Cuando ya te sientas cómodo leyendo y cambiando código, [programación en pareja con IA](/es/blog/ai-pair-programming/ "Programación en pareja con IA") muestra cómo trabajar con un agente como compañero de equipo en lugar de como profesor. Y cuando tus proyectos empiecen a manejar inicios de sesión o datos de usuarios, [encontrar vulnerabilidades de seguridad con IA](/es/blog/find-security-vulnerabilities-with-ai/ "Encuentra vulnerabilidades de seguridad con IA") es un buen siguiente paso.

## Conclusión

La IA hace que aprender a programar sea más rápido solo si sigues siendo tú quien aprende. Dile al agente que estás aprendiendo, usa un estilo de salida para aprender o instrucciones que expliquen primero, planifica antes de cambiar nada y haz proyectos pequeños que te importen. Lee cada diff, pregunta por qué, pide pistas antes que respuestas y demuéstrate lo que sabes reconstruyéndolo sin ayuda. El agente puede explicarte cualquier cosa que le preguntes; tu trabajo es seguir preguntando.

## Preguntas frecuentes

**¿Puedo aprender a programar con IA si empiezo desde cero?** Sí, siempre que uses la IA para que te explique y te guíe, y no para producir programas terminados que no lees. Empieza con proyectos pequeños, pídele que explique cada paso antes de escribir código y escribe tú las partes centrales.

**¿Usar IA me impedirá aprender a programar de verdad?** Puede pasar, si solo copias y pegas. El riesgo está en cómo la usas. Preguntar por qué, leer los diffs, escribir partes tú mismo y reconstruir cosas pequeñas sin ayuda hacen que lo aprendido se quede en tu cabeza y no en el historial del chat.

**¿Qué herramienta de programación con IA es mejor para aprender?** Sirve cualquier agente que sepa explicar código y trabajar en modo plan. Claude Code tiene los estilos de salida Explanatory y Learning, pensados para esto. Codex y Gemini CLI también funcionan si les pides que te enseñen. Elige uno que puedas pagar y quédate con él una temporada.

**¿Necesito un plan de pago para aprender a programar con IA?** No necesariamente. A octubre de 2026 algunos agentes tienen planes gratuitos con límites, y puedes ejecutar modelos locales en tu propio ordenador. Claude Code necesita un plan de pago de Claude o créditos de API. Consulta la página de precios actual de cada herramienta antes de elegir.

**¿Cuál debería ser mi primer proyecto?** Algo pequeño que vayas a usar tú: una lista de tareas en la línea de comandos, una página web personal, un juego de preguntas, una calculadora de propinas o un bot sencillo. Lo bastante pequeño para terminarlo en unas pocas sesiones y lo bastante útil para que te importe que funcione.

---

**Sobre AgentVera.** AgentVera es una app de escritorio para macOS, Windows y Linux, desarrollada por Solviera Teknoloji. Ejecuta 18 agentes de programación con IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) en paralelo, por proyecto, en terminales reales con las instalaciones y sesiones de CLI del propio usuario. El plan gratuito tiene agentes ilimitados. Descargar: https://agentvera.dev/es/download/ · Precios: https://agentvera.dev/es/pricing/