---
title: "Guía de Claude Code: por dónde empezar y cómo dominarlo"
excerpt: "Una ruta ordenada para sacarle todo el provecho a Claude Code: configurarlo con CLAUDE.md, extenderlo con MCP, escalar con subagentes y gastar menos tokens."
date: "2026-06-29T17:00:00.000Z"
category: "Inteligencia Artificial"
tech_article: true
author:
  name: "angel cruz"
  picture: "https://angelcruzdevcdn.nyc3.cdn.digitaloceanspaces.com/images/me/angel-cruz.png"
ogImage:
  url: "/images/open-graph/og-image.png"
seo_title: "Guía de Claude Code: CLAUDE.md, MCP, subagentes y más"
seo_description: "Ruta completa para dominar Claude Code: CLAUDE.md, servidores MCP, subagentes, optimización de tokens y orquestación de agentes. Guías en español, paso a paso."
---

**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](/post/claude-md-buenas-practicas)

## 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](/post/introduccion-a-mcp-model-context-protocol).
- Después, qué conectar: [mejores servidores MCP para developers](/post/mejores-servidores-mcp).
- Un ejemplo que uso a diario: [Context7](/post/context7-documentacion-actualizada-asistentes-codigo-ia), que le da documentación siempre actualizada.
- Y si quieres construir el tuyo: [cómo crear un servidor MCP en TypeScript paso a paso](/post/como-crear-un-servidor-mcp).

## 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](/post/subagentes-claude-code).
- Para orquestar varios agentes que comparten contexto desde una sola terminal: [Solo (SoloTerm), el workspace para tus agentes](/post/soloterm-workspace-agentes-ia).

## 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](/post/optimizar-claude-code-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](/post/claude-md-buenas-practicas) 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](/post/introduccion-a-mcp-model-context-protocol). 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](/post/optimizar-claude-code-reducir-tokens).

---

## Sitemap

Índice completo del sitio: [/sitemap.md](https://www.angelcruz.dev/sitemap.md)

Canónico HTML: [https://www.angelcruz.dev/post/guia-claude-code](https://www.angelcruz.dev/post/guia-claude-code)