Guía de Claude Code: por dónde empezar y cómo dominarlo
Claude Code es el agente de programación de Anthropic que vive en tu terminal: lee tu código, planifica y ejecuta cambios por ti. Sacarle todo el provecho no es solo "pedirle cosas", sino configurarlo y extenderlo bien. Esta guía es la ruta que recomiendo seguir, de lo básico a lo avanzado, con cada paso enlazado a un tutorial a fondo.
1. Configúralo: el CLAUDE.md
Lo primero es darle contexto persistente de tu proyecto para dejar de repetir lo mismo cada sesión: comandos, convenciones, arquitectura. Eso va en el CLAUDE.md.
→ Qué poner en tu CLAUDE.md: buenas prácticas
2. Extiéndelo: MCP y servidores
Por defecto Claude trabaja con tu código y tu terminal. Para conectarlo a herramientas y datos externos (GitHub, bases de datos, documentación) se usa el Model Context Protocol (MCP).
- Primero, el concepto: qué es MCP.
- Después, qué conectar: mejores servidores MCP para developers.
- Un ejemplo que uso a diario: Context7, que le da documentación siempre actualizada.
- Y si quieres construir el tuyo: cómo crear un servidor MCP en TypeScript paso a paso.
3. Escala: subagentes y orquestación
Cuando una tarea es grande o ruidosa, conviene repartir el trabajo en agentes especializados que corren en su propio contexto.
- Subagentes en Claude Code: cómo crearlos y para qué sirven.
- Para orquestar varios agentes que comparten contexto desde una sola terminal: Solo (SoloTerm), el workspace para tus agentes.
4. Optimiza: gasta menos tokens
Claude Code cobra por contexto, así que vale la pena trabajar limpio: limpiar el contexto entre tareas, elegir el modelo correcto y delegar lo verboso.
→ Cómo optimizar Claude Code y reducir tokens
La ruta de un vistazo
| Etapa | Qué haces | Guía |
|---|---|---|
| Configurar | Contexto del proyecto | CLAUDE.md |
| Extender | Herramientas externas | MCP + servidores MCP |
| Escalar | Repartir el trabajo | Subagentes + orquestación |
| Optimizar | Gastar menos | Reducir tokens |
Preguntas frecuentes
¿Qué es Claude Code?
Es el agente de programación de Anthropic que corre en la terminal: lee tu base de código, propone un plan y ejecuta los cambios, con acceso a tus herramientas a través de MCP.
¿Por dónde empiezo con Claude Code?
Por el contexto: crea un buen CLAUDE.md con los comandos y convenciones de tu proyecto. Es lo que más mejora la calidad de las respuestas desde el día uno.
¿Cómo le doy acceso a herramientas externas?
Con servidores MCP. Conectas los que necesites (GitHub, base de datos, documentación) y Claude puede usarlos sin que el código viva en el prompt.
¿Cómo evito que Claude Code gaste tantos tokens?
Trabajando con contexto limpio: /clear entre tareas, el modelo adecuado para cada cosa y delegando lo verboso a subagentes. Lo detallo en optimizar Claude Code y reducir tokens.