Claude Code

Qué es Claude Code

Agente de Anthropic en terminal, IDE, desktop y browser. Lee el repo, edita archivos, ejecuta comandos e integra skills, MCP y hooks.

Docs: code.claude.com/docs

Orden sugerido

1. Contexto del proyecto

AGENTS.md en la raíz, o CLAUDE.md según tu setup. Comandos de build, tests y convenciones del equipo — una sola fuente de verdad.

Las convenciones persistentes encajan aquí; no hace falta carpeta .cursor/rules/ en Claude Code.

2. Skills

Formato Agent Skills:

• Global: ~/.claude/skills/
• Proyecto: .claude/skills/

Guía: ¿Qué es un skill?. El agente carga el skill solo cuando la tarea encaja con su descripción.

3. MCP

.mcp.json o configuración en settings. Guía: ¿Qué es un MCP?. Ejemplos: Context7, Playwright MCP. Un servidor bien elegido vale más que muchos.

4. Hooks (cuando ya domines lo básico)

Automatizan acciones en eventos del agente (pre/post tool). Documentación en code.claude.com — no son necesarios el primer día.

5. Modelos locales

Claude Code usa modelos Anthropic (nube). Ollama local no es el flujo típico. Alternativas open source + local: OpenCode, Gemini CLI — guía nube vs local.

6. Herramientas opcionales

• Headroom — headroom wrap claude para comprimir contexto (avanzado).
• no-mistakes — gate antes del push en equipos con muchos PRs generados por IA.

Dónde corre

Modo	Cuándo
Terminal	Flujo clásico, CI, scripts
IDE / VS Code	Mismo repo, interfaz visual
Desktop	Sesiones largas fuera del editor
Browser	Tareas web según doc Anthropic

Dónde va cada cosa

Pieza	Ubicación
Contexto repo	AGENTS.md / CLAUDE.md
Skills globales	~/.claude/skills/
Skills proyecto	.claude/skills/
MCP	.mcp.json / settings

Claude Code vs Codex vs OpenCode

	Claude Code	Codex	OpenCode
Fabricante	Anthropic	OpenAI	Open source
Skills	~/.claude/skills/	~/.agents/skills/	Según doc
Hooks	Sí	Según doc	Limitado
Local (Ollama)	No típico	No típico	Sí

Recursos del catálogo

• Curso de pago: Frontend Masters — alternativa gratis: docs oficiales + empezar aquí.

Errores comunes

• Instalar skills de moda sin entender qué hacen.
• No dar permisos claros al agente sobre qué archivos puede tocar.
• Olvidar commitear AGENTS.md en repos compartidos.