Contenido detallado
🛡️ Modelo x entorno: la armadura de Iron Man
Claude Code trae la IA a dentro de tu computadora, en vez de solo conversar con ella en un sitio web. Piénsalo así: el el modelo es Tony Stark (el cerebro, la inteligencia) y el el entorno es la armadura de Iron Man — el cuerpo que permite que el cerebro lea archivos, ejecute comandos y manipule cosas de verdad.
El modelo es la inteligencia; el entorno (o IDE) es donde esa inteligencia actúa: lee, ejecuta y crea cosas en tu máquina.
Sin este concepto, todo se convierte en una magia confusa. Con él, entiendes por qué la misma IA funciona en distintos lugares y por qué importa elegir el entorno.
Modelo · entorno · IDE · "una tarea, una ventana".
✓ El modelo (Tony Stark)
- ✓Es el cerebro: razona, escribe, decide.
- ✓A solas es genial, pero no actúa en el mundo.
- ✓Puedes cambiar de modelo sin cambiar de entorno.
✓ El entorno (la armadura / IDE)
- ✓Le da «cuerpo» al modelo: lee y crea archivos.
- ✓Ejecuta comandos y conecta otras herramientas.
- ✓Hay varias «armaduras» — puedes cambiar cuando quieras.
💡 No te atasques con el término "IDE"
IDE quiere decir «entorno integrado de desarrollo». Por ahora, piensa en IDE solo como "el lugar donde trabaja el asistente". Nada más.
💻 Instalar Claude Code
Es hora de sacar la IA del navegador y ponerla en tu computadora. La instalación es el requisito previo para todo: sin instalar, no hay práctica. Un aviso importante antes de empezar: Claude Code exige plan de pago; el plan gratuito no lo incluye.
Descargar e instalar la aplicación oficial de Claude Code y conectar tu cuenta.
Es el punto de partida obligatorio. Todo lo que viene después supone que la app está instalada y que iniciaste sesión.
Instalación · iniciar sesión con la cuenta de Claude · plan de pago obligatorio.
Visita el sitio oficial
Abre claude.com/claude-code — la fuente oficial de instalación.
Descarga para tu sistema
Elige la versión para Windows, macOS o Linux. Funciona en los tres.
Instala y abre la aplicación
Sigue el instalador estándar de tu sistema y abre la app.
Inicia sesión con tu cuenta de Claude
Usa la misma cuenta del sitio y confirma que tenga plan de pago.
🧭 La interfaz por dentro
Antes de dar instrucciones, conoce la pantalla. Saber dónde está cada botón evita bloquearte justo al principio: historial de conversaciones, selector de modelo, modo de permisos, indicador de uso y ventana de contexto.
El recorrido por la pantalla: panel de conversaciones, selector de modelo, indicador de uso del plan y ventana de contexto.
Encontrar los controles es lo que te saca del "no sé ni por dónde empezar".
Panel de conversaciones · selector de modelo · indicador de uso · ventana de contexto · micrófono · adjuntar archivos.
🔎 Dónde mirar primero
- •El historial de proyectos suele quedar a un lado de la pantalla.
- •El selector de modelo y el modo de permisos están cerca del cuadro de texto.
- •El indicador de uso del plan y del contexto aparece junto al campo de mensaje.
🔐 Modos de permiso
El modo de permisos controla cuánta libertad le das al asistente — cuánto puede hacer por su cuenta, sin preguntarte. Es tu freno de seguridad: demasiada libertad demasiado pronto es una receta para llevarte sorpresas.
El control de cuánto actúa el asistente por su cuenta, desde lo más cauteloso hasta lo más audaz.
Es la diferencia entre experimentar con tranquilidad y desordenar archivos importantes sin querer.
Cuatro modos: preguntar antes · aceptar ediciones · modo de planificación · ignorar permisos.
✓ Seguro para empezar
- ✓Preguntar antes: confirma cada edición y cada comando. Ideal para proyectos desconocidos.
- ✓Aceptar ediciones: edita por su cuenta, pero todavía pide autorización para ejecutar comandos sensibles. Recomendado para empezar.
- ✓Modo de planificación: no ejecuta; primero piensa y propone un plan.
✗ Peligroso para principiantes
- ✗Ignorar permisos: no pregunta nada. Poderoso y peligroso.
- ✗Úsalo solo en un entorno aislado, cuando sepas exactamente qué hace.
- ✗Nunca en una computadora "real" con datos importantes.
💡 Consejo de oro
Empieza en "aceptar ediciones". Es lo bastante seguro para ganar fluidez sin tener que aprobar cada paso, y además te protege con los comandos más sensibles.
🧠 Ventana de contexto y el «deterioro»
Imagina a una persona genial, con un CI altísimo, pero con amnesia. La ventana de contexto es cuánto de la conversación puede recordar el modelo con precisión. Cuanto más larga es la conversación, peor la recuerda: es un fenómeno llamado "deterioro del contexto" (deterioro del contexto). De ahí la regla de oro: una tarea, una ventana.
El límite de cuánto recuerda bien el modelo de la conversación y por qué las conversaciones largas empeoran la calidad.
Gestionar el contexto separa a quienes obtienen resultados confiables de quienes reciben respuestas «confiadamente equivocadas».
Ventana de contexto · tokens · context rot · alucinación · "una tarea, una ventana".
📊 En la práctica: cuidado con las alucinaciones
- •El modelo puede alucinar (inventar con convicción) entre ~1% y ~10% de las veces.
- •Funciona peor en conversaciones largas: cuanto más llena está la ventana, mayor es el riesgo.
- •Protege tu contexto: empieza una conversación nueva para cada tarea.
Higiene rápida del contexto
/context # vê quanto da janela já foi usada /compact # resume a conversa, preservando o essencial /clear # zera tudo e começa do zero (refresh total)
⌨️ Slash commands y el modo plan
Los slash commands son comandos que se escriben con / que controlan la conversación y el contexto: tus herramientas de higiene diaria. Y para tareas grandes existe el modo de planificación: el asistente razona y propone un plan antes de ejecutar cualquier cosa.
Comandos rápidos para limpiar, resumir, medir y cambiar cosas, además de un modo que planifica antes de actuar.
Ahorran tiempo y tokens, y el modo plan reduce errores y retrabajo en tareas difíciles.
/clear · /compact · /context · /model · /cost · /init · /memory · modo de plan · intención declarada.
Los comandos esenciales del día a día
/clear apaga a conversa e começa do zero /compact resume a conversa preservando o essencial /context mostra quanto da janela já foi usada /model troca o modelo em uso /cost mostra uso de tokens e custo da sessão /init pede para o assistente conhecer a pasta/projeto /memory abre e edita os arquivos de memória (CLAUDE.md)
🗺️ El truco que funciona en el modo plan
Siempre di cuál es tu verdadera intención. Algo como: "Mi intención declarada es X. Te pido esto porque lo que quiero que sea verdad es ___." Dejar explícita la intención mejora mucho la respuesta.
Profundiza (opcional): /compact vs /clear
Usa /clear cuando cambias de tarea por completo y quieres una ventana limpia. Usa /compact cuando todavía estás en la misma tarea, pero la conversación se alargó: resume lo importante (decisiones y objetivo) y libera espacio sin perder el hilo. Una pequeña diferencia, un gran impacto en la calidad.
Autoevaluación (opcional): terminaste una tarea y vas a empezar otra muy diferente. ¿Qué comando debes usar?
✏️ Ejercicios
1. Instalación completada (fácil)
Instala Claude Code e inicia sesión. Criterio: la app se abre conectada a tu cuenta y puedes enviar un mensaje.
2. Primer archivo (fácil)
Pídele a la IA que cree una carpeta con dos archivos .md (como en el ejemplo guiado). Criterio: la carpeta y los dos archivos existen en la computadora, con contenido.
3. Higiene del contexto (medio)
Inicia una conversación, ejecuta /context, después /clear, y ejecuta /context de nuevo. Criterio: ves que el contexto cae casi a cero después del /clear.
4. Modo de planificación (medio)
Activa el modo de planificación y pide un plan para "organizar mi carpeta de Descargas", sin ejecutarlo. Criterio: el asistente devuelve un plan por etapas, sin modificar nada.
5. Intención declarada (medio)
Repite el ejercicio 4 incluyendo «Mi intención declarada es...». Criterio: el plan queda visiblemente más alineado con lo que quieres.
⌨️ Prompts listos
Ahora ya puedes ejecutar estos en proyectos reales. Cubren desde el primer archivo hasta el modo de planificación y la higiene del contexto. La base de datos completa está en Biblioteca → Prompts.
Tu primer comando (crea archivos)
Crea una carpeta llamada "cafe-gelado" en mi escritorio y escribe dos archivos .md dentro: "por-que-cafe-e-otimo.md" y "por-que-cafe-nao-e-otimo.md". Tres frases cortas en cada uno.
Modo de planificación, sin ejecutar
Mi carpeta de descargas está desordenada. Sin ejecutar nada todavía, devuélveme un PLAN por etapas para organizarla por tipo de archivo. Lo aprobaré antes de que actúes.
Intención declarada (canónico)
Mi intención declarada es: quiero entender, no solo recibir algo listo. Explícame qué es la "ventana de contexto" de Claude Code en 3 frases sencillas, como si nunca hubiera programado.
Original (EN):
My stated intention is ___. I'm asking you to do this because the thing I want to be true is ___.
Familiarizarse con un proyecto
Familiarize-se com esta pasta (rode a inicialização) e me diga, em 5 bullets, para que serve este projeto e quais são os arquivos mais importantes.
⚠️ Errores comunes
- ✗Creer que el plan gratuito es suficiente. No basta: Claude Code exige un plan de pago. Sin eso, lo instalas, pero no lo usas.
- ✗Dejar que la conversación se vuelva un monstruo. Mezclar diez tareas en una sola ventana lleva al deterioro del contexto. Usa
/clearentre tareas. - ✗Empezar en «ignorar permisos». En una computadora real, es como pedir que borre o desordene algo. Empieza en "aceptar ediciones".
- ✗Confiar ciegamente. El modelo puede alucinar. Revisa los resultados importantes, sobre todo en conversaciones largas.
- ✗Llenar el
CLAUDE.mdde texto. Por encima de ~200 palabras, empieza a contaminar el contexto. Sé breve y directo.
✅ Resumen del módulo
Lista de verificación de finalización
- ☐ Claude Code instalado y conectado a mi cuenta (plan de pago).
- ☐ Entiendo la diferencia entre el modelo (Tony Stark) y el entorno/IDE (la armadura).
- ☐ Sé ubicar: selector de modelo, modo de permisos, indicador de uso y ventana de contexto.
- ☐ Creé mi primera carpeta y mis archivos pidiéndoselo a la IA.
- ☐ Usé /context, /clear y /compact al menos una vez.
- ☐ Probé el modo plan con una intención declarada.
- ☐ Sé que «una tarea, una ventana» es la regla de oro.
Siguiente módulo:
1.3 — Sistema de memoria: cómo CLAUDE.md le da contexto duradero al asistente