Cómo funciona Claude Code, en llano

Claude Code es un asistente que corre en tu terminal y puede hacer todo lo que tú harías desde la línea de comandos: leer y editar archivos, ejecutar comandos, buscar, pasar tests. Esta página explica las pocas ideas que hacen más fácil entender el resto, con enlaces a las guías más largas.

El bucle

Cuando le das una tarea a Claude, trabaja en tres fases que se solapan: reunir contexto, actuar y comprobar el resultado. Una pregunta sobre tu código puede necesitar solo la primera. Arreglar un error da varias vueltas al bucle. Claude decide cada paso con lo que aprendió en el anterior, y tú puedes intervenir en cualquier momento para reconducirlo.

Dos piezas mueven el bucle: un modelo que razona y herramientas que actúan. Claude Code es la capa alrededor del modelo que le da las herramientas y gestiona lo que el modelo ve. Puedes cambiar de modelo con /model o empezar con claude --model <nombre>.

Las herramientas

Sin herramientas, Claude solo puede responder con texto. Con ellas puede actuar. Las herramientas integradas se reparten en cinco grupos: operaciones con archivos (leer, editar, crear, renombrar), búsqueda (por nombre o por contenido), ejecución (comandos de shell, tests, git), web (buscar y descargar páginas) e inteligencia de código, como errores de tipos e ir a la definición, que necesita un plugin. Cada resultado alimenta la siguiente decisión. Para «arregla los tests que fallan», Claude podría ejecutar los tests, leer los errores, buscar los archivos fuente, leerlos, editar y volver a ejecutar los tests.

Encima de las herramientas base puedes añadir skills, servidores MCP, hooks y subagentes.

Lo que puede ver

Cuando ejecutas claude en una carpeta, puede alcanzar los archivos de esa carpeta y las de debajo (y otros, con tu permiso), tu terminal, tu estado de git, tu CLAUDE.md (o un AGENTS.md, que puede leer en su lugar), su memoria automática y las extensiones que hayas configurado. Mira la guía de memoria.

Dónde corre y cómo llegas a él

Por defecto corre en tu máquina. También puede correr en entornos en la nube, o en tu máquina mientras lo controlas desde un navegador. Puedes usarlo desde la terminal, la app de escritorio, extensiones de IDE, la web, Slack y pipelines de CI. La interfaz cambia cómo lo ves y le hablas; el bucle de debajo es el mismo.

Sesiones

Claude Code guarda cada conversación en local como un archivo de texto plano bajo ~/.claude/projects/. Eso es lo que permite rebobinar, reanudar y bifurcar. Cada sesión nueva empieza con una ventana de contexto limpia, sin el historial de las anteriores. Lo que pasa de una a otra es lo que está escrito: CLAUDE.md y la memoria automática.

• Reanudar con claude --continue o claude --resume: la misma sesión, con mensajes nuevos añadidos.
• Bifurcar con --fork-session o /branch: el historial se copia a una sesión nueva y la original queda intacta.
• Las sesiones están ligadas a la carpeta donde empezaste. Para correr varias en paralelo, dale a cada una su carpeta con git worktrees.

Pasar el trabajo a una sesión nueva es una habilidad aparte: mira las notas de relevo.

La ventana de contexto

La ventana de contexto contiene tu conversación, el contenido de los archivos, la salida de los comandos, CLAUDE.md, la memoria automática, las skills cargadas y las instrucciones del sistema. Se llena mientras trabajas. Claude la compacta solo, pero las instrucciones detalladas del principio de la conversación se pueden perder, así que pon en CLAUDE.md las reglas que deban durar. Ejecuta /context para ver qué ocupa el espacio y /compact focus on the API changes para dirigir lo que se conserva. Las skills se cargan cuando hacen falta (al principio solo están sus descripciones), y un subagente trabaja en su propia ventana y devuelve un resumen. Más en qué sobrevive a /compact y en la guía de cuota.

Las redes de seguridad

Puntos de control. Antes de editar un archivo, Claude hace una copia de su estado. Pulsa Esc dos veces para rebobinar, o pídele a Claude que deshaga. Los puntos de control son aparte de git, cubren solo cambios en archivos y no pueden deshacer acciones en sistemas remotos como bases de datos, APIs o despliegues. Mira deshacer cambios.

Permisos. Un modo de permisos fija lo que Claude puede hacer sin preguntar. Shift+Tab recorre modos como manual (pregunta antes de editar y de ejecutar comandos), aceptar ediciones, plan (explora y propone sin editar tu código) y auto (un clasificador bloquea las acciones arriesgadas en vez de preguntar). El modo con el que empieza una sesión depende de tu versión y de tu plan. También puedes permitir comandos concretos, como npm test, en tus ajustes. Mira los modos de permisos y un archivo de permisos de partida.

Cómo trabajar con él

• Es una conversación. No necesitas una primera petición perfecta. Empieza por lo que quieres y ve afinando. Si el primer intento no es el bueno, di qué falla en vez de empezar de cero.
• Puedes interrumpir. Pulsa Esc para parar al instante, o escribe una corrección y pulsa Enter mientras Claude trabaja; lee el mensaje al terminar sus llamadas a herramientas en curso y se ajusta. Mira los atajos de teclado.
• Delega, no dictes. Dale contexto y un objetivo («el pago falla con tarjetas caducadas, el código está en src/payments/, investiga y arréglalo») en vez de listar archivos y comandos.
• Pídele ayuda. Puede explicar sus propias funciones. /init genera un CLAUDE.md de partida y /doctor revisa tu instalación.

Siguientes pasos

Para los archivos que lee Claude Code, mira la carpeta .claude explicada y qué archivo de ajustes manda. Cuando algo no se comporta, prueba depurar la configuración. Para cambiar cómo responde, mira los estilos de salida y la línea de estado. Para usarlo desde scripts, mira ejecutar desde un script. Todas están en el índice de guías.

Esta página sigue la documentación «How Claude Code works» de Anthropic tal como la leemos en octubre de 2026. No tenemos relación con Anthropic. La escribimos a partir de la documentación y no hemos probado todos los casos. Las funciones y los valores por defecto cambian entre versiones, y donde esta página y la documentación no coincidan, manda la documentación.

Mira también: Flujos de cada día · Glosario en llano · Comandos con barra que conviene conocer · Claude Code en VS Code.

La skill gratis loop-stop da a las tareas largas un límite y una regla de parada. Si quieres una segunda mirada a tu CLAUDE.md y a tus ajustes, el Tune-Up Kit es una lista de comprobación para eso (la ficha está en inglés).