El diccionario de Claude Code — 8 conceptos clave

Cuando empiezas con Claude Code te encuentras con términos que se dan por sabidos y no siempre están claros. Este diccionario define los ocho conceptos que de verdad necesitas entender para usarlo bien. Sin tecnicismos innecesarios: qué es cada cosa y por qué te importa.

1. CLAUDE.md

Qué es: un archivo en tu proyecto donde documentas cómo debe trabajar Claude Code ahí: comandos, estructura, convenciones y reglas.

Por qué importa: es la memoria del proyecto. Con él, el agente no redescubre lo mismo cada sesión, lo que mejora la calidad y ahorra tokens. Es el concepto más importante de todos.

2. Contexto

Qué es: toda la información que Claude Code tiene "en mente" en un momento dado: tu CLAUDE.md, los archivos que ha leído, la conversación.

Por qué importa: la calidad de lo que hace depende del contexto que tiene. Darle el contexto adecuado —y no saturarlo con lo irrelevante— es la habilidad central de usarlo bien.

3. Permisos

Qué es: el sistema por el que Claude Code te pide autorización antes de acciones con consecuencias (ejecutar comandos, modificar archivos).

Por qué importa: son tu red de seguridad. Al principio, deja que pregunte; con el tiempo, relaja los permisos solo en las operaciones seguras. Controlan cuánta autonomía le das.

4. Plan (modo planificación)

Qué es: pedirle al agente que proponga cómo va a abordar una tarea antes de ejecutarla, para que lo revises.

Por qué importa: evita que se lance en la dirección equivocada. Aprobar un plan cuesta dos minutos y ahorra horas de deshacer trabajo mal dirigido.

5. Skills

Qué es: paquetes de instrucciones que enseñan a Claude Code a hacer una tarea concreta de forma consistente.

Por qué importa: convierten tus tareas repetidas en algo que se ejecuta igual cada vez, con fiabilidad. Son tu método, empaquetado.

6. Comandos (slash commands)

Qué es: atajos para acciones frecuentes, que puedes usar o crear tú mismo.

Por qué importa: te ahorran reescribir la misma instrucción larga cada vez. Un puñado de comandos propios agiliza el día a día.

7. Subagentes

Qué es: agentes secundarios que Claude Code lanza para trabajar en paralelo sobre partes de una tarea grande.

Por qué importa: mantienen el trabajo ordenado en proyectos extensos, sin saturar el contexto principal. Útiles cuando la tarea es demasiado grande para una sola conversación.

8. Verificación

Qué es: comprobar que lo que el agente dice que hizo, lo hizo, y que funciona (ejecutar tests, revisar el diff, probar el resultado).

Por qué importa: "parece correcto" no basta. La verificación es lo que evita dar por terminado algo roto. Es el paso final que muchos se saltan.

Cómo encajan todos

El flujo profesional los usa juntos: das contexto con un buen CLAUDE.md, pides un plan antes de ejecutar, controlas con permisos, usas skills y comandos para lo repetido, delegas en subagentes lo grande y verificas el resultado. Entender estos ocho términos es entender cómo se trabaja bien con la herramienta.

Preguntas frecuentes

¿Cuál es el concepto más importante para empezar?

El CLAUDE.md y el contexto. Si entiendes que Claude Code trabaja mejor cuando sabe dónde está, ya has captado lo esencial.

¿Necesito usar todos estos conceptos?

No desde el primer día. CLAUDE.md, contexto, permisos y verificación son básicos. Skills, comandos y subagentes los incorporas cuando los necesites.

¿Esto cambia mucho entre versiones?

Los detalles evolucionan, pero estos conceptos son la base estable de cómo funciona la herramienta. Entenderlos te sirve aunque cambien los detalles.

Conclusión

Claude Code deja de intimidar cuando entiendes su vocabulario: el CLAUDE.md que le da memoria, el contexto que determina su calidad, los permisos que lo controlan, el plan que lo dirige, las skills y comandos que automatizan lo repetido, los subagentes para lo grande y la verificación que cierra el círculo. Con estos ocho conceptos claros, tienes el mapa completo para trabajar con la herramienta con criterio.