Glosario (Amigable para principiantes): Traduciendo la jerga técnica al lenguaje cotidiano de una sola vez
📚 Navegación de la serie: El artículo anterior 51 Resolución de problemas frecuentes (FAQ / Troubleshooting) eliminó uno por uno los errores y comportamientos extraños que con mayor frecuencia te bloquean. Este artículo hace algo más básico y que debería haberse hecho antes: traducir al lenguaje cotidiano todos los términos que han ido apareciendo a lo largo del tutorial. Agentic loop, ventana de contexto, MCP, subagent, skill, hook, checkpoint, modo de permisos, headless, transport... Tras más de cincuenta capítulos, se han acumulado un montón de términos; esta página te servirá como tarjeta de consulta rápida: si no tienes claro qué significa algún término, vuelve aquí para consultarlo.
Todos dicen que «debes leer el glosario de principio a fin para sentar las bases», pero a decir verdad, esa es la forma más inútil de leerlo.
Al aprender cualquier herramienta nueva, memorizar el glosario de la A a la Z como si fuera un texto escolar es casi siempre un esfuerzo en vano: una vez memorizado, lo olvidarás al instante, porque ninguno de esos términos ha «ocurrido» en tus manos en ese momento. Los términos técnicos son algo que realmente recuerdas solo cuando te tropiezas con ellos y te hacen tropezar.
Por lo tanto, no pretendo que «leas» este artículo, sino que lo «consultes». Es una tarjeta de consulta rápida, no una lección. Sigue estudiando y usando la herramienta con normalidad, y el día en que te quedes atascado pensando «¿qué demonios es este transport?» o «¿qué es el auto-compact?», vuelve a esta página, busca el término, lee una frase y una analogía, y sigue trabajando; esa es la forma correcta de usar un glosario.
Analogía: La lista de materiales pegada en la pared de una obra en construcción. Nadie en la obra se parará a memorizar la lista de principio a fin, pero cuando llega cada tubería o cada panel, el maestro echa un vistazo a la lista: «Ah, esto es una viga de carga, aquello es un conector de tubería de agua», y continúa con el trabajo una vez emparejados. Esta tabla funciona de la misma manera: no es para leerla entera, sino para «poder consultarla cuando te topes con algo». A continuación, agrupo los términos por «temas» en varias familias (los conceptos de la misma familia están interrelacionados, por lo que es más fácil recordarlos juntos que en orden alfabético), y cada entrada consta de la tríada: «Término → Explicación sencilla → Analogía».
Después de leer esto (o más bien, de volver aquí mientras lo uses en el futuro) obtendrás:
- Los términos principales que han aparecido en todo el tutorial, explicados detalladamente con lenguaje sencillo y analogías.
- Clasificados por «familias temáticas», agrupando conceptos similares para aclarar la relación entre ellos de paso.
- Los elementos principales tienen marcado el número de artículo «ver capítulo NN», por si deseas profundizar e ir directo al grano.
- Una comparación de «los pares de términos más fáciles de confundir», para diferenciarlos de un vistazo en caso de conflicto.
- Un pequeño ejercicio práctico: utilizar el servidor de documentación integrado oficial para consultar definiciones autorizadas de cualquier término en Claude en cualquier momento.
01 Familia del bucle de agentes: Cómo se pone en marcha el «trabajo» de Claude
Esta familia es la base más importante que debes entender primero. Responde a una pregunta fundamental: ¿cuál es la diferencia real entre Claude Code y un IA de chat web, y por qué puede «ponerse manos a la obra» por sí mismo? Casi todos los demás términos giran en torno a este bucle.
Analogía: Una línea de ensamblaje que gira por sí misma. Las IA de chat normales funcionan de la forma «tú preguntas, ella responde», como una ventanilla de pedidos; Claude Code es una línea de ensamblaje que gira por sí misma: una vez que recibe una tarea, toma el material, lo procesa, realiza el control de calidad y, tras dar una vuelta, decide si necesita dar otra vuelta. Los siguientes términos son las diferentes piezas de esta línea de ensamblaje.
Agentic loop (Bucle de agentes)
Explicación sencilla: El ciclo por el cual Claude pasa repetidamente al procesar cada tarea: recopilar contexto → tomar medidas → verificar resultados → si no es suficiente, dar otra vuelta hasta completarlo.
Analogía: El ritmo de un chef al saltear. No se trata de echar todos los ingredientes a la olla de una sola vez y listo, sino de «añadir ingredientes → saltear → probar el punto de sal → ajustar si falta», aproximándose paso a paso al plato final. Cada «probadita» (los resultados devueltos por las herramientas) le dice hacia dónde ir en el siguiente paso. Puedes detener el proceso o cambiar el rumbo en cualquier momento. (Ver capítulo 03)
Agentic coding (Programación agéntica)
Explicación sencilla: Una forma de trabajar donde la IA puede leer archivos, ejecutar comandos y modificar código de manera autónoma, mientras tú observas al lado para corregir el rumbo o simplemente te alejas, en lugar de que te dé un bloque de texto para que lo escribas tú mismo.
Analogía: Contratar a un maestro que sabe poner manos a la obra, en lugar de comprar un manual de instrucciones. El manual solo te dice «cómo hacerlo», mientras que el maestro lo hace directamente por ti. Claude Code pertenece al tipo que puede poner manos a la obra, gracias a las herramientas que tiene en sus manos. (Ver capítulo 01)
Agentic harness (Arnés agéntico)
Explicación sencilla: Todo el conjunto periférico que «arma» a un modelo de lenguaje para convertirlo en un agente de programación capaz de trabajar: acceso a archivos, ejecución en shell, control de permisos, carga de memoria y el bucle que encadena las acciones. Claude Code es el arnés (caparazón), y Claude es el modelo que lleva dentro.
Analogía: El chasis y el motor del coche. El mismo motor (modelo) instalado en diferentes chasis ofrece experiencias de conducción abismalmente distintas. El harness es como el chasis del coche de Claude Code; determina qué cosas puede tocar el modelo y bajo qué reglas se pone a trabajar. (Ver capítulo 03)
Tool (Herramienta)
Explicación sencilla: Acciones reales que Claude puede ejecutar: leer archivos, modificar código, ejecutar comandos en el shell, buscar en la web, enviar subagent; sin herramientas, solo podría hablar y responder con texto.
Analogía: Los equipos en los puestos de la línea de ensamblaje. De nada sirve tener un cerebro brillante si no hay brazos mecánicos, cintas transportadoras o sensores para realizar el trabajo real. Las herramientas son las «manos» de Claude, y cada vez que usa una, devuelve un resultado que alimenta su próxima decisión en el bucle de agentes. (Ver capítulo 03)
Turn (Turno)
Explicación sencilla: Un turno completo que va desde que envías un mensaje hasta que Claude termina por completo su respuesta; entre medias, puede invocar herramientas cualquier cantidad de veces.
Analogía: Haces un pedido y la cocina sirve un plato. Tú expresas una necesidad («el pedido»), y no tienes que preocuparte por cómo Claude corta, saltea o emplata (llamando a un montón de herramientas) durante el proceso; la entrega final de todo el conjunto cuenta como «un plato servido». Una sesión está formada por muchos turnos encadenados. (Ver capítulo 03)
Verification loop (Bucle de verificación)
Explicación sencilla: El mecanismo que le permite a Claude saber que «el trabajo realmente se ha terminado, no solo lo parece»: le proporcionas una prueba ejecutable (test, build, comparación de capturas de pantalla) y él modificará repetidamente el código hasta que la prueba pase.
Analogía: Comprobar las respuestas antes de entregar la tarea. Cuando no hay una respuesta estándar, «terminar» depende enteramente de la intuición; al darle una respuesta con la que pueda auto-verificarse, modificará el código hasta que sea correcto, en lugar de escribirlo una sola vez y entregarlo. Para tareas largas ejecutadas sin supervisión, esto es vital: sin ello, el único que juzga si se ha terminado es él mismo. (Ver capítulo 49)
Extended thinking (Pensamiento extendido)
Explicación sencilla: El proceso de razonamiento paso a paso visible del modelo antes de responder formalmente, mostrado en cursiva gris en la terminal; se puede controlar cuánto piensa mediante MAX_THINKING_TOKENS o ajustando el effort level.
Analogía: Hacer cálculos en una hoja de borrador antes de resolver el problema. En lugar de responder de inmediato, primero escribe el proceso de deducción; de este modo, puedes ver «cómo piensa» y es más fácil localizar qué paso falló si comete un error. (Ver capítulo 35)
Effort level (Nivel de esfuerzo)
Explicación sencilla: Una configuración que controla cuánto «presupuesto de pensamiento» gasta Claude en cada turno; a mayor nivel, piensa de forma más profunda, lenta y costosa; a menor nivel, es más rápido y económico.
Analogía: Cuánto tiempo asignar a una pregunta en un examen. Marcas la respuesta de inmediato en las preguntas de opción múltiple (bajo effort), y dedicas diez minutos más a reflexionar sobre la pregunta final compleja (alto effort). Para tareas sencillas, bájalo para ahorrar dinero; para problemas difíciles, súbelo para mejorar la calidad. (Ver capítulo 35)
💡 Resumen en una frase: Esta familia describe el mecanismo de funcionamiento para que Claude «ponga manos a la obra»: el núcleo es el bucle de agentes de «pensar → actuar → observar», las herramientas son sus manos, el harness es el caparazón que arma al modelo, el extended thinking es su borrador de cálculos, el effort level es el presupuesto de tiempo asignado para pensar, y el bucle de verificación es su control de calidad.
02 Familia del contexto: Qué tan grandes son la «memoria» y el «escritorio» de Claude
Al dominar la primera familia, te toparás de inmediato con la segunda: la memoria de Claude no es infinita. Todos los términos de esta familia giran en torno a «cuánto puede recordar a la vez, qué hacer cuando se llena y cómo limpiarlo al cambiar de tarea». Si alguna vez te has preguntado «¿por qué se olvidó de lo que dije antes?», la respuesta está aquí.
Analogía: Una mesa de trabajo de tamaño limitado. Te apoyas en la mesa para dibujar; la superficie tiene un tamaño limitado; a medida que acumulas planos, libros de referencia y borradores, tarde o temprano no cabrán y tendrás que ordenar. La «memoria» de Claude es esta mesa, y los siguientes términos explican «qué tan grande es la mesa y qué hacer cuando se llena».
Context window (Ventana de contexto)
Explicación sencilla: La «memoria de trabajo» de una sesión que contiene el historial de conversación, el contenido de los archivos, la salida de los comandos, el CLAUDE.md, las skills cargadas y las instrucciones del sistema: tiene este tamaño y se llena hasta el límite.
Analogía: El área de la superficie de la mesa de trabajo. Cuanto más grande sea la mesa, más documentos podrás abrir al mismo tiempo; cuando se llene, para poner cosas nuevas primero tendrás que retirar las antiguas. Ejecutar /context te permite ver qué hay actualmente sobre la mesa y qué está ocupando espacio. (Ver capítulo 19)
Token
Explicación sencilla: La unidad mínima de medida que el modelo utiliza para procesar texto, equivalente aproximadamente a «de medio a un carácter chino, o parte de una palabra en inglés»; el tamaño de la ventana de contexto y la facturación se calculan en tokens.
Analogía: El «número de palabras facturables» de un texto. Al igual que los envíos por correo se cobran por peso, el modelo calcula la «cantidad» en tokens: todo lo que ingresas y todo lo que produce se convierte en tokens que se suman al espacio ocupado en la mesa de trabajo y a la factura. (Los detalles subyacentes de los tokens pertenecen a conceptos a nivel de modelo, no se detallan en este tutorial; basta con saber esto).
Compaction (Compresión)
Explicación sencilla: Cuando la ventana de contexto está a punto de llenarse, se resume automáticamente la conversación a una «versión simplificada» para liberar espacio: primero se eliminan las salidas de herramientas antiguas y luego se resume el diálogo; se puede activar manualmente ejecutando /compact.
Analogía: Organizar los papeles sucios de la mesa en una sola hoja de puntos clave. Al no caber más borradores en la mesa, escribes las conclusiones clave en una hoja y retiras el resto: la estructura principal de la información permanece, pero ocupa menos espacio. Nota: El CLAUDE.md y la auto memory del directorio raíz del proyecto se conservan y se vuelven a leer del disco durante la compresión; solo las cosas habladas temporalmente en el chat pueden perderse en la compresión. (Ver capítulo 19)
Auto-compact (Compresión automática)
Explicación sencilla: La compresión que el sistema activa automáticamente cuando el contexto se acerca al límite, sin que tú tengas que pedirlo.
Analogía: La descarga automática en una línea de producción. Cuando la tolva de material está casi llena, la cinta transportadora se activa sola para descargar el exceso, sin que tengas que pulsar ningún botón. Hace lo mismo que /compact manual, la única diferencia es «quién pulsa el botón de inicio». (Ver capítulo 19)
Session (Sesión)
Explicación sencilla: Una conversación vinculada a tu directorio actual que tiene su propia ventana de contexto independiente; /clear abre una nueva sesión, y las anteriores se guardan y se pueden recuperar con /resume.
Analogía: Cambiar a una tarea completamente nueva, limpiando la mesa antes de empezar. Dejar los borradores de la tarea anterior en la mesa solo estorbaría; limpiar la mesa (abrir una nueva sesión) y empezar desde cero despeja la mente. El registro de cada sesión se guarda en ~/.claude/projects/, por lo que incluso si cierras la terminal, puedes continuar la conversación anterior con claude -c. (Ver capítulo 19)
CLAUDE.md
Explicación sencilla: El manual de instrucciones permanente que escribes para Claude; se carga automáticamente en cuanto se inicia una sesión y contiene reglas que siempre están vigentes, como convenciones del proyecto, comandos de construcción y «hacer siempre X».
Analogía: El manual de bienvenida para un nuevo empleado. El empleado que llega cada día podría ser un «novato con amnesia», pero mientras el manual esté clavado allí, lo leerá al empezar a trabajar y conocerá las reglas del lugar. Se recomienda mantenerlo por debajo de las 200 líneas; si es demasiado largo, traslada la información de referencia a una skill. (Ver capítulo 18)
Auto memory (Memoria automática)
Explicación sencilla: Las notas que Claude escribe para sí mismo basándose en tus correcciones y preferencias; se guardan por repositorio git en ~/.claude/projects/ y se carga el inicio del índice al comenzar la sesión.
Analogía: Las dos hojas de papel pegadas junto a la pantalla, pero escritas por él mismo. CLAUDE.md son las reglas que tú has clavado, mientras que la auto memory son las notas que él mismo toma: apuntes como «la última vez me corrigió para que no usara npm», de modo que no vuelva a cometer el mismo error. Hacen pareja: una la escribes tú y la otra él. (Ver capítulo 25)
Rules (Archivos de reglas)
Explicación sencilla: Archivos de instrucciones modulares ubicados en .claude/rules/ que se cargan junto con CLAUDE.md; pueden limitarse mediante paths: para cargarse «solo cuando Claude lea archivos que coincidan», manteniendo el contexto optimizado.
Analogía: Normas de construcción por especialidad, consultando solo la que se necesita. CLAUDE.md es la norma general que todos leen primero; rules son los manuales de «normas de electricistas» o «normas de fontaneros», que se consultan solo cuando se realiza el trabajo correspondiente, evitando que lo irrelevante ocupe espacio en la mesa. (Ver capítulo 13)
Output style (Estilo de salida)
Explicación sencilla: Una configuración que modifica las instrucciones del sistema de Claude para ajustar el comportamiento, tono y formato de sus respuestas; incluye los modos Default, Proactive, Explanatory y Learning.
Analogía: El mismo presentador cambiando el estilo de un programa. Es la misma persona, pero el tono y el ritmo de un «noticiero» y un «programa de comedia» son completamente diferentes. El output style ajusta este «tono del programa», y es algo diferente a CLAUDE.md (que se introduce como un mensaje del usuario). (Ver capítulo 32)
💡 Resumen en una frase: Esta familia trata sobre «la memoria y la forma de hablar»: la ventana de contexto es la superficie de la mesa de trabajo, el token es la unidad de medida, la compresión es la acción de ordenar cuando la mesa se llena, la sesión es un inicio de trabajo independiente, CLAUDE.md / auto memory / rules son las notas pegadas al borde de la mesa, y el output style es cambiar el estilo de comunicación.
03 Familia de los puntos de extensión: Cómo «equipar» a Claude
Esta familia es el núcleo de este tutorial: cómo personalizar a Claude para que pase de «listo para usar» a «adaptado a tu trabajo». El capítulo 30 explica específicamente cómo elegirlos; aquí solo ofrecemos una consulta rápida con explicaciones sencillas y analogías. Su punto en común: todos son ganchos que se insertan en diferentes partes del bucle de agentes.
Analogía: El mismo trabajador, pero equipado con diferentes paquetes de herramientas. Que el trabajador llegue a su puesto no es suficiente: si le das un manual de trabajo (CLAUDE.md), algunos libros de recetas especializadas (skill), un adaptador de conexión externo (MCP), algunos ayudantes externos (subagent) y algunos puntos de control automáticos (hook), el trabajo que podrá realizar estará a un nivel completamente diferente. Conozcámoslos uno por uno.
Skill (Habilidad)
Explicación sencilla: Un archivo SKILL.md que contiene un conjunto de conocimientos, rutinas o procesos; Claude lo carga automáticamente cuando es relevante, y tú también puedes invocarlo activamente mediante /<nombre>.
Analogía: Atajos en el móvil. Al pulsar «modo casa», se ejecuta automáticamente una serie de acciones como apagar las luces, encender el aire acondicionado y poner música; no tienes que repetir todo el proceso cada vez. Una skill es el atajo de Claude: guarda una rutina repetitiva en una sola instrucción para invocarla con un clic. Normalmente solo ocupa una línea de descripción, y su contenido completo se carga en el contexto solo cuando se necesita (lo que oficialmente se denomina divulgación progresiva). (Ver capítulo 26)
Subagent (Subagente)
Explicación sencilla: Un asistente especializado con una ventana de contexto independiente, sus propias instrucciones del sistema y permisos de herramientas; le delegas una tarea y él te devuelve solo el resumen de las conclusiones al diálogo principal.
Analogía: Subcontratar un trabajo a un asistente de recados. Le pides que revise treinta archivos para buscar un número; él realiza la búsqueda exhaustiva fuera de tu vista sin interferir en tu trabajo, y al volver solo te dice: «Lo encontré, es este». La clave es el aislamiento del contexto: el proceso intermedio no ensucia tu mesa de trabajo principal. Existen tres tipos integrados: Explore, Plan y genérico. (Ver capítulo 23)
Hook (Gancho)
Explicación sencilla: Una acción que se ejecuta automáticamente en un momento fijo del ciclo de vida de Claude Code (antes de ejecutar una herramienta, después de modificar un archivo, al iniciar la sesión...); puede ser un comando de shell, un script, una notificación, etc.
Analogía: Un punto de control automático en la línea de montaje. Cada vez que la cinta transportadora pasa por una estación, el punto de control sella automáticamente: se activa inevitablemente al llegar al evento, sin depender de la supervisión humana ni de la iniciativa de la IA. Esta es la diferencia fundamental con CLAUDE.md: escribir en CLAUDE.md es una «petición», un hook es una «garantía». (Ver capítulo 33)
Command / slash command (Comando / Comando de barra diagonal)
Explicación sencilla: Instrucciones reutilizables que puedes invocar escribiendo /nombre en el prompt; los integrados (/clear, /model, /compact) controlan la sesión, y los personalizados son esencialmente «skills que se activan con /<nombre>».
Analogía: Botones fijos en un mando a distancia. /clear es como el «botón de reinicio», y /deploy es como el «botón de publicación en un clic» que tú mismo has pegado: al pulsarlo, ejecuta ese proceso fijo. Hoy en día, la recomendación oficial es utilizar skill para empaquetar comandos de varios pasos. (Ver capítulo 36)
Plugin (Complemento)
Explicación sencilla: Empaquetar skill, hook, subagent y servidor MCP en una sola unidad instalable; al instalarlo una vez, todo el conjunto de puntos de extensión queda disponible.
Analogía: Una maleta empacada antes de salir de viaje. No llevarás la camisa, la maquinilla de afeitar y el cargador sueltos en los brazos, sino que los meterás todos organizados en la maleta. El plugin es esa maleta: si necesitas el mismo equipamiento para otro proyecto, basta con instalar este plugin. Las skills internas también admiten espacios de nombres (como /my-plugin:review), por lo que instalar varios plugins no genera conflictos de nombres. (Ver capítulo 24)
Plugin marketplace (Mercado de complementos)
Explicación sencilla: La fuente para distribuir y obtener plugins; puedes añadir uno o más mercados y elegir qué plugins instalar desde ellos.
Analogía: Instalar una tienda de aplicaciones en el móvil. En la tienda de aplicaciones hay un montón de Apps (plugins) expuestas, y tú instalas las que necesitas. Cuidado con la procedencia: el riesgo de instalar un plugin de origen desconocido es el mismo que el de descargar un .exe de un sitio web extraño y hacer doble clic para ejecutarlo. (Ver capítulo 38)
💡 Resumen en una frase: Esta familia trata de «añadir equipamiento»: las skills son atajos, los subagents son ayudantes externos, los hooks son puntos de control automáticos, los commands son botones del mando a distancia, los plugins son maletas de equipamiento y el marketplace es la tienda de aplicaciones; todos ellos se insertan en diferentes partes del bucle de agentes.
04 Familia MCP: La interfaz que conecta a Claude con el «mundo exterior»
Dentro de los puntos de extensión, MCP se menciona por separado porque viene con su propia familia de pequeños términos (transport, server, scope...), donde los principiantes suelen equivocarse al copiar comandos. El capítulo 22 está dedicado por completo a esto; aquí identificamos a sus «miembros familiares» uno por uno.
Analogía: Un adaptador de corriente con múltiples puertos. El portátil solo tiene uno o dos puertos, por lo que no puedes conectar HDMI, cable de red ni memorias USB; si conectas un adaptador de puertos, todo se conecta a través de un solo cable. MCP es ese adaptador para Claude: al conectarlo una vez, las herramientas de un montón de servicios externos aparecen ante él.
MCP (Model Context Protocol, Protocolo de Contexto de Modelos)
Explicación sencilla: Un estándar de código abierto que especifica «cómo conectan las herramientas de IA con los datos y servicios externos»; el servidor MCP conecta a Claude con cientos de integraciones como Slack, Jira, bases de datos, navegadores, etc.
Analogía: El estándar de interfaz unificado USB. Hace años, cada dispositivo tenía un tipo de enchufe diferente, lo que era un caos; tras la unificación de USB, cualquier dispositivo puede conectarse al mismo puerto. MCP es este «estándar USB» para que la IA se conecte a herramientas externas: una sola conexión permite usarlo en cualquier lugar. (Ver capítulo 22)
MCP server (Servidor MCP)
Explicación sencilla: Un «conector» específico implementado según el estándar MCP que viene con un conjunto de herramientas (por ejemplo, el servidor de GitHub incluye «leer PR», «abrir issue»); al conectarlo, estas herramientas aparecen ante Claude.
Analogía: Un dispositivo específico conectado al adaptador. El adaptador es el estándar (MCP), y la impresora o el disco duro conectados son los dispositivos específicos (server): cada server te proporciona una capacidad externa. (Ver capítulo 22)
Transport (Método de transporte)
Explicación sencilla: La forma en que Claude Code y el servidor MCP «se comunican» entre sí; habitualmente son dos: stdio (proceso local) y http (alojamiento remoto), además del ya obsoleto sse.
Analogía: Dispositivos en el adaptador; algunos están en la mesa y otros al otro lado de la pared. stdio es un pequeño programa que Claude ejecuta en segundo plano en tu propia máquina (justo a la mano), e http es un servicio remoto conectado a una URL (al otro lado de la pared). La mayoría de los fallos al copiar comandos ocurren aquí: stdio no requiere especificar transport, pero http requiere escribir --transport http. (Ver capítulo 22)
Scope (Ámbito)
Explicación sencilla: En «qué proyectos se puede usar un servidor MCP y si se comparte con el equipo»: local (solo el proyecto actual, privado), project (escrito en .mcp.json, compartido mediante git), user (todos tus proyectos).
Analogía: Cómo compartir una impresora en la oficina. Conectada solo a tu ordenador (local), añadida al inventario del departamento para que la use todo el equipo (project), o llevada por ti mismo a cada sala de reuniones (user): tres formas de ubicarla que corresponden a tres ámbitos. (Ver capítulo 22)
MCP Tool Search (Búsqueda de herramientas MCP)
Explicación sencilla: Un mecanismo para ahorrar contexto: al iniciar, solo se cargan los nombres de las herramientas, y solo cuando Claude realmente necesita usar una herramienta específica, se descarga su descripción completa bajo demanda.
Analogía: Mirar primero los títulos del menú y ver la receta detallada solo al pedir el plato. Si hay cientos de platos en el menú, no leerás los ingredientes detallados de cada uno al principio: escaneas los títulos, decides cuál pedir y luego consultas sus detalles. De este modo, un montón de servidores MCP inactivos no ocuparán espacio en la mesa de trabajo en vano. (Ver capítulo 22)
💡 Resumen en una frase: MCP es el estándar USB para «conectarse al mundo exterior»: los server son conectores específicos, transport es el método de conexión (stdio local / http remoto), y scope define en qué proyectos se puede usar este conector; evalúa la confianza antes de conectar servidores de terceros.
05 Familia de seguridad y permisos: Si Claude «te pregunta o no» antes de actuar
Dado que Claude puede actuar y conectarse al exterior, «si hará de las suyas sin control» se convierte en un problema ineludible. Esta familia trata sobre «los mecanismos de control antes de que actúe», desde «preguntar antes de hacer» hasta «bloquear directamente ciertas operaciones». Los capítulos 20 y 21 lo explican a fondo; aquí tienes una consulta rápida.
Analogía: Varias capas de protección al conducir un coche. Cinturón de seguridad, airbags, señales de límite de velocidad: una capa te cuida de no cometer locuras tú mismo, otra sirve de respaldo si ocurre un accidente, y otra define estrictamente «esta línea no se puede cruzar». Los mecanismos de seguridad de Claude también están estructurados en capas; los siguientes términos corresponden a cada una de ellas.
Permission mode (Modo de permisos)
Explicación sencilla: La «actitud base» de Claude al actuar en una sesión: hay seis niveles oficiales que van desde preguntarte en cada paso (default), aceptar cambios automáticamente (acceptEdits), investigar sin realizar cambios (plan), actuar directamente sin preguntar (bypassPermissions), auditoría automática (auto) hasta aprobación silenciosa (dontAsk); explicación completa en el capítulo 35.
Analogía: El nivel de autonomía que le das a un becario antes de que actúe. Para el mismo becario, puedes exigirle que «pregunte antes de hacer cualquier cosa» o delegarle la libertad de «resolver estos pequeños asuntos por su cuenta». El modo es este nivel de autonomía que configuras, y se puede alternar en la CLI pulsando Shift+Tab. (Ver capítulo 35)
Plan mode (Modo de planificación)
Explicación sencilla: Un modo de permisos en el que Claude solo lee, busca e investiga, sin tocar tus archivos originales; primero te presenta el plan de modificaciones para que lo apruebes y solo actúa cuando le das el visto bueno.
Analogía: Hacer planos antes de remodelar y mostrártelos antes de derribar paredes. No se le permite tomar el martillo de inmediato; primero debe dibujar el plano indicando «esta pared se derriba, aquella tubería se desvía» para que lo confirmes antes de iniciar la obra. Es la opción más segura antes de realizar cambios grandes. (Ver capítulo 35)
Auto mode (Modo automático)
Explicación sencilla: Un modo de permisos en el que un modelo clasificador independiente supervisa en segundo plano cada operación para bloquear accesos no autorizados, infraestructura sospechosa e inyecciones de prompts, en lugar de preguntarte con ventanas emergentes en cada paso; actualmente es una versión preliminar de investigación.
Analogía: Un guardia de seguridad en la puerta que solo revisa credenciales sin mirar la mercancía. Se enfoca exclusivamente en vigilar «si la operación excede los límites» y nunca puede ver el contenido devuelto por las herramientas, por lo que las instrucciones maliciosas ocultas en los resultados de las herramientas no pueden influir en su decisión. (Ver capítulo 35)
Permission rule (Regla de permisos)
Explicación sencilla: Elementos de configuración detallados para permitir (allow), preguntar (ask) o denegar (deny) basados en «el nombre de la herramienta y el patrón de argumentos», que se evalúan en orden deny → ask → allow, donde la primera coincidencia gana.
Analogía: Reglas específicas de acceso en un sistema de control de puertas. «Esta tarjeta puede entrar al piso 3, pero no a la sala de servidores Goat»: las reglas son más detalladas que el «modo de permisos» base y representan un control preciso sobrepuesto a este. (Ver capítulo 20)
Sandboxing (Aislamiento en sandbox)
Explicación sencilla: Aplicar un aislamiento a nivel de sistema operativo para archivos y red a la herramienta Bash: Claude se ejecuta libremente dentro de los límites que definas, sin tener que pedir aprobación emergente para cada comando.
Analogía: Conducir en una pista de pruebas cerrada donde los muros son reales. Puedes conducir tan rápido como quieras dentro de la pista porque los muros de alrededor son reales y no te permitirán salir. El sandbox es ese muro y es una capa de protección diferente a las reglas de permisos. (Ver capítulo 21)
Prompt injection (Inyección de prompts)
Explicación sencilla: Instrucciones maliciosas ocultas en archivos, páginas web o resultados de herramientas que intentan desviar a Claude para que haga cosas que nunca le has pedido.
Analogía: Recibir una llamada de estafa telefónica que sigue un guion. El tono del interlocutor es normal, pero el contenido es «transfiere dinero ahora mismo como te indico»: la inyección de prompts es este «guion» introducido en los datos que podría desviar a Claude al leerlo. El riesgo es especialmente alto al usar servidores MCP que recopilan contenido externo. (Ver capítulo 21)
Checkpoint (Punto de restauración)
Explicación sencilla: Un «punto de restauración» que se crea automáticamente cada vez que envías un prompt, tomando una instantánea antes de que Claude modifique archivos; pulsa dos veces Esc (con el cuadro de entrada vacío) o usa /rewind para abrir el menú de retroceso, donde puedes elegir restaurar el código, la conversación o ambos a un prompt anterior. Es local de la sesión y es independiente de git.
Analogía: Guardar y cargar partida en un videojuego. Si das un paso en falso, cargas una partida guardada anterior para volver a intentarlo, sin tener que empezar desde el principio. Ten en cuenta que no realiza un seguimiento de los cambios realizados mediante la herramienta Bash; para estos, debes confiar en git u otros medios. (Ver capítulo 37)
💡 Resumen en una frase: Esta familia representa las «capas de control antes de actuar»: el modo de permisos es la línea base (si te pregunta o no), las reglas de permisos son las directrices detalladas, el sandbox es el muro de aislamiento físico, el auto mode es el guardia que revisa credenciales y el checkpoint es el sistema de guardado y carga; la inyección de prompts es el tipo de «ataque de guion» que se debe prevenir.
06 Familia de modos de entrada y ejecución: Desde dónde lo usas y cómo se ejecuta
La última familia es la más diversa, pero todas giran en torno a la misma pregunta: dónde y de qué manera interactúas con Claude Code. Terminal, VS Code, navegador o integrado en scripts para ejecutarse automáticamente: las formas son distintas, pero el motor subyacente es el mismo.
Analogía: El mismo trabajador llegando al puesto de diferentes maneras. Puede venir a trabajar a tu oficina (terminal / editor), trabajar a distancia en línea (navegador) o puedes enviarle una orden de trabajo para que la resuelva automáticamente (llamada de script). El trabajador y su habilidad son los mismos, solo cambia «dónde y cómo se presenta a trabajar».
Surface (Interfaz de usuario)
Explicación sencilla: Cualquier lugar desde el cual accedes a Claude Code: CLI, VS Code, JetBrains, aplicación de escritorio o claude.ai; todas las interfaces comparten el mismo motor, por lo que tu CLAUDE.md, configuraciones y skills funcionan de la misma manera en cualquier lugar.
Analogía: Diferentes modelos de la misma marca de coche que comparten el mismo sistema de infoentretenimiento. Los sedanes y los SUV tienen formas exteriores distintas, pero la interfaz y la lógica de funcionamiento del sistema son exactamente iguales, lo que reduce a cero la curva de aprendizaje. Cambiar de interfaz para usar Claude Code ofrece la misma sensación. (Ver capítulo 08)
Non-interactive mode (Modo no interactivo)
Explicación sencilla: Se ejecuta con -p (o --print): ejecuta un solo prompt, devuelve el resultado y sale, sin entrar en una sesión de diálogo; está diseñado específicamente para CI, scripts y tuberías de automatización. En la documentación antigua se le llamaba headless mode, pero es lo mismo.
Analogía: Enviar una orden de trabajo; él hace el trabajo, entrega el resultado y se va sin conversar. En lugar de un diálogo de ida y vuelta, es un «haz esto y dame el resultado». Su equivalente en Python / TypeScript es el SDK de Agentes (Agent SDK). (Ver capítulo 45)
Agent SDK (SDK de Agentes)
Explicación sencilla: El paquete de desarrollo (Python / TypeScript) que traslada las capacidades de Claude Code a tu propio programa, permitiéndote controlarlo en el código como si invocaras una función.
Analogía: Extraer el mecanismo interno de una cafetera e instalarlo en tu propio producto. Ya no se trata de usar una cafetera existente, sino de tomar el motor interno para construir una tú mismo. El modo no interactivo es la versión de línea de comandos, y el Agent SDK es la versión «escrita en código». (Ver capítulo 45)
Claude Code on the web (Versión web)
Explicación sencilla: Claude Code ejecutándose en el navegador, donde las tareas se realizan en un sandbox en la nube (a diferencia de «Remote Control», donde el código permanece en tu máquina local y solo la interfaz es remota).
Analogía: Alquilar un ordenador en la nube temporal que se destruye tras su uso. El trabajo se realiza en una máquina temporal en la nube, sin ocupar tu entorno local. (Ver capítulo 11)
Bare mode (Modo básico)
Explicación sencilla: Iniciar con --bare para omitir el descubrimiento automático de hooks, skills, plugins, servidores MCP, auto memory y CLAUDE.md; solo se aplican los parámetros que pases explícitamente; sirve para buscar «un comportamiento idéntico incluso al cambiar de máquina» en CI y scripts.
Analogía: Viajar solo con una maleta de mano y dejar todo lo demás en casa. Se borran todas las «configuraciones personalizadas locales» y se viaja solo con la tarea misma, de modo que se obtenga el mismo resultado sin importar en qué máquina se ejecute. (Ver capítulo 34)
Worktree isolation (Aislamiento por árbol de trabajo)
Explicación sencilla: Un método de aislamiento que utiliza -w o define isolation: worktree en la configuración del subagent, permitiendo que Claude trabaje en un git worktree independiente y una rama separada bajo .claude/worktrees/, de modo que sus cambios no entren en conflicto con otros agentes paralelos.
Analogía: El mismo conjunto de planos, pero asignando a cada equipo de construcción una obra independiente. Varios equipos trabajan al mismo tiempo, cada uno en su propio terreno, de modo que nadie derribe los muros construidos por otros. Es clave para evitar conflictos al ejecutar múltiples sesiones en paralelo. (Ver capítulo 41)
Remote Control (Control remoto) / Teleport (Teletransporte)
Explicación sencilla: Remote Control consiste en tomar el control de la sesión que se ejecuta en tu máquina local desde el móvil o el navegador (el código permanece en tu máquina, solo la interfaz es remota); Teleport (/teleport) hace lo contrario, atrayendo una sesión en la nube a tu terminal local para continuar trabajando en ella.
Analogía: Instalar un control remoto en el ordenador de la oficina. Remote Control es como controlar el ordenador de tu casa desde tu móvil cuando estás fuera (el trabajo se ejecuta en casa); teleport es como «teletransportar» un trabajo no terminado en la nube a la máquina frente a ti para continuar con él. (Ver capítulo 11)
💡 Resumen en una frase: Esta familia describe «dónde se usa y cómo se ejecuta»: surface es la interfaz (comparten el mismo motor), el modo no interactivo (antes headless) es la ejecución mediante órdenes de trabajo, el Agent SDK consiste en integrarlo en código, la versión web se ejecuta en un sandbox en la nube, el bare mode es un inicio limpio, el aislamiento por worktree evita conflictos en paralelo, y Remote Control / teleport permiten alternar el control entre la máquina local y la nube.
07 Los pares más fáciles de confundir, consúltalos al dudar
Cuando hay muchos términos, siempre hay algunos que se parecen y generan dudas al usarlos. Hemos seleccionado los pares con los que los principiantes suelen dudar más para compararlos directamente, ayudándote a aclararlos de un vistazo en caso de duda. Esta tabla representa también un cierre transversal de las seis familias anteriores.
| Pareja fácil de confundir | Diferencia clave | Separación rápida en una frase |
|---|---|---|
| Skill vs Subagent | En qué contexto entra el contenido | Las skills se cargan en tu mesa principal; los subagents usan su propia mesa y solo devuelven las conclusiones. (Ver capítulo 30) |
| CLAUDE.md vs Skill | Cuándo se cargan | CLAUDE.md se carga automáticamente en cada sesión; las skills se cargan solo al usarse. (Ver capítulo 30) |
| Hook vs Reglas de permisos | Qué controlan | Un hook es «ejecutar una acción al activarse un evento»; una regla de permisos es un juicio de sí/no sobre «si esta herramienta está permitida». (Ver capítulo 30) |
| Subagent vs Agent team | Si puedes hablar directamente con él | Un subagent se ejecuta en una sola sesión y solo informa al diálogo principal; un agent team está formado por múltiples sesiones completas con las que puedes conversar directamente con cualquiera. (Ver capítulo 29) |
| Session vs Turn | Granularidad | Una sesión es un diálogo completo (contexto independiente); un turno es la ida y vuelta de «tú dices algo → él responde». (Ver capítulo 03) |
Compaction vs /clear | Si se conserva el contenido antiguo | La compresión resume el diálogo antiguo para conservarlo; /clear limpia la mesa para abrir una nueva sesión. (Ver capítulo 19) |
| Permission mode vs Reglas de permisos | Nivel de detalle | El modo de permisos es la línea base general (si te pregunta o no); las reglas de permisos son directrices específicas sobrepuestas a este (si este comando está permitido). (Ver capítulo 20) |
| stdio vs http (transport) | Dónde se ejecuta el server | stdio es un proceso levantado en segundo plano en la máquina local; http es un servicio remoto conectado a una URL. (Ver capítulo 22) |
| CLAUDE.md vs auto memory | Quién lo escribe | CLAUDE.md son las reglas permanentes que tú escribes; la auto memory son las notas que Claude escribe para sí mismo. (Ver capítulo 25) |
En esta tabla, los principiantes suelen confundir al menos cuatro o cinco parejas al comenzar. El caso más típico es skill y subagent: al principio, es muy común intentar resolver una tarea como «leer todo el directorio para buscar código muerto» mediante una skill, lo que termina llenando el diálogo principal con el proceso de lectura de archivos, dándose cuenta tras un par de intentos de que: los trabajos sucios que solo requieren conclusiones deben delegarse a un subagent, no meterse en una skill.
💡 Resumen en una frase: Para los pares que se confunden, basta con recordar «su dimensión clave de diferencia»: skill/subagent depende de en qué contexto entra, CLAUDE.md/skill de cuándo se carga, mode/reglas del nivel de detalle, y stdio/http de dónde se ejecuta el server.
08 Práctica: Deja que Claude actúe como un «diccionario vivo» para consultar definiciones autorizadas en cualquier momento
No basta con tener esta tabla: los términos se actualizan, este artículo es estático, pero la documentación oficial está viva. El método de consulta más seguro es dejar que el propio Claude consulte la tabla de términos oficial. El «servidor de documentación oficial» que conectamos en el capítulo 22 viene como anillo al dedo: no requiere inicio de sesión ni configuración, basta con conectarlo para preguntar. Esta sección te guiará para usarlo como tu «diccionario vivo» personal.
Este servidor es un servicio HTTP alojado de forma remota, por lo que requiere conexión a internet para agregarlo.
Paso 1: Conectar el servidor de documentación oficial (en la terminal, no en la sesión de claude)
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcpResultado esperado: Se imprime una línea de confirmación similar a Added HTTP MCP server claude-code-docs .... Ver Added = La configuración se ha guardado.
Paso 2: Confirmar la conexión
claude mcp listResultado esperado: claude-code-docs aparece en la lista con la indicación ✓ Connected al lado. Ver el tick verde = Conectado correctamente; si se muestra ✗ Failed to connect, probablemente sea un problema de conexión a la red.
Paso 3: Entrar en la sesión y pedir específicamente que consulte la definición oficial de algún término
claudeUna vez dentro, escribe (indicando específicamente el servidor para que use MCP para consultar la documentación oficial, en lugar de responder de memoria):
Usa el servidor claude-code-docs para buscar las definiciones oficiales de compaction y context window en el glosario oficial, y explícamelas en una frase a cada una.Resultado esperado: La primera vez que Claude invoque este servidor, se detendrá para pedirte autorización (que corresponde al control de permisos de la familia de seguridad de la sección 05, algo diferente a los checkpoints): autorízalo. A continuación, te devolverá las explicaciones oficiales de ambos términos, y al lado de la llamada a la herramienta en la salida se mostrará la etiqueta claude-code-docs. Ver esta etiqueta = La respuesta proviene realmente de la documentación oficial consultada, no de la memoria del modelo.
Paso 4: Limpieza (Opcional)
claude mcp remove claude-code-docsResultado esperado: Se imprime la confirmación de la eliminación, y al ejecutar de nuevo claude mcp list, ya no aparece en la lista.
Con este flujo configurado, tendrás un método de consulta de términos que nunca caduca: usa este artículo como tarjeta de consulta rápida y, si dudas o sospechas que ha quedado obsoleto, deja que Claude lo consulte en la versión oficial actual. Verificar cada definición se apoya en esto, lo cual es mucho más seguro que escribir una frase de memoria y dudar de su exactitud.
💡 Resumen en una frase: Este artículo es una tarjeta de consulta estática, el servidor de documentación oficial es un diccionario vivo; conéctalo (
add→listpara verificar el tick verde → consulta específica en la sesión → autorización) para buscar la definición oficial más autorizada de cualquier término en cualquier momento, sin que nunca caduque.
09 Resumen
Este artículo no es para que lo memorices, sino para que lo tengas como una tarjeta de consulta rápida a mano: los términos de todo el tutorial están organizados en seis familias para que puedas buscar el que necesites cuando te lo topes.
Repasemos las seis familias en una frase:
| Familia de términos | Definición rápida | Términos clave de la familia |
|---|---|---|
| Bucle de agentes | El mecanismo de funcionamiento para que Claude «ponga manos a la obra» | agentic loop, tool, harness, turn, extended thinking, effort level, verification loop |
| Contexto | Los límites de su memoria y su estilo de comunicación | context window, token, compaction, session, CLAUDE.md, auto memory, rules, output style |
| Puntos de extensión | Cómo equiparlo con herramientas personalizadas | skill, subagent, hook, command, plugin, marketplace |
| MCP | El estándar USB para conectarse al mundo exterior | MCP, server, transport, scope, tool search |
| Seguridad y permisos | Las capas de control antes de actuar | permission mode, plan mode, auto mode, reglas de permisos, sandbox, prompt injection, checkpoint |
| Entrada y ejecución | Desde dónde lo usas y cómo se ejecuta | surface, non-interactive (headless), Agent SDK, versión web, bare mode, aislamiento por worktree, Remote Control |
Ahora deberías ser capaz de: No asustarte al ver ningún término que aparezca en este camino, sabiendo a qué familia pertenece, cuál es su explicación rápida y qué analogía le corresponde para recordarlo fácilmente; distinguir de un vistazo parejas fáciles de confundir como skill vs subagent o stdio vs http recurriendo a la sección 07; y aprender a usar el servidor de la documentación oficial para convertir a Claude en un «diccionario vivo», consultando las definiciones oficiales más autorizadas de cualquier término. Con esta tarjeta de consulta rápida a mano, todos esos sustantivos que pasaron rápido en los cincuenta capítulos anteriores y no lograste recordar bien tienen ahora un lugar al que volver para consultarlos.
El tutorial oficial termina prácticamente aquí: desde «qué es esto» hasta la instalación, uso avanzado, equipamiento de herramientas, optimización de configuración y, finalmente, este glosario de cierre, ya conoces todos los términos necesarios.
El siguiente capítulo 53 «Creación de vídeos (Remotion) [Lectura opcional]» es el capítulo sorpresa de todo el tutorial. Sale de los límites de la «escritura de código» convencional para mostrarte qué otras cosas creativas puede hacer Claude Code: usar Remotion (un framework para «escribir vídeos con código React») para que Claude te ayude a generar un vídeo de animación mediante código. Es de lectura opcional y no afecta a la línea principal, pero si quieres ver hasta dónde se puede extender la «programación con IA», vale la pena echarle un vistazo. Piénsalo: dado que los vídeos se pueden escribir con código, que Claude escriba ese código es, una vez más, una tarea de «describir la necesidad y esperar el resultado», ¿verdad?