Claude Code Best Practices - Índice
Claude Code Best Practices
Guía completa basada en el repositorio claude-code-best-practice y la documentación oficial.
Bloque 1: Fundamentos
- Qué es Claude Code — CLI oficial, arquitectura, setup, CLAUDE.md
- Commands — Slash commands, frontmatter, $ARGUMENTS, comandos builtin
- Sub-Agents — Agentes especializados, frontmatter, Task tool, scopes
- Skills — SKILL.md, patrones skill vs agent skill, invocación
Bloque 2: Infraestructura
- Hooks — 30 eventos, matchers, exit codes, tipos command/prompt/http, límites de bloqueo
- MCP Servers — Cuatro transportes (stdio, http, sse, ws), scopes y precedencia, tool search, control empresarial
- Settings — Jerarquía 5 niveles, permissions, effortLevel, managed settings, sandbox
- Memory y CLAUDE.md — Jerarquía de carga, auto memory, /context y /memory
Bloque 3: Workflows
- Orchestration Workflow — Patrón Command → Agent → Skill, divulgación progresiva, precedencia
- Workflows de Desarrollo — Explore → Plan → Implement → Commit, plan mode, verificación ejecutable
- Agent Teams y Worktrees — Agentes paralelos, git worktrees, background, CLI de agent teams
- Ralph Wiggum Loop — Tareas autónomas de larga duración, auto mode y sandbox OS-level
Bloque 4: Configuración Avanzada
- CLI Reference — Comandos CLI, flags de modelo y sesión, system prompts, print mode
- Permisos y Sandbox — Seis permission modes, auto mode, plan mode, wildcard syntax, network isolation
- Plugins — Paquetes distribuibles, marketplaces, schema del manifiesto, resolución de rutas
- Checkpointing y Sesiones — Checkpoints por prompt, retención, rewind, resume, fork, teleport
Bloque 5: Productividad
- Debugging — /doctor, background tasks, tool search, timeouts MCP, prompt injection
- Status Line y UX — Statusline custom, themes, keybindings, fast mode, effort level
- Voice Mode y Remote — Voice mode, remote control, headless con —bare y —json-schema, teleport
- Tips de Productividad — Best practices, CLAUDE.md conciso, permisos correctos, thinking adaptativo
Bloque 6: Claude Certified Architect
- Prompt Engineering — Criterios explícitos, few-shot, multi-pass, batch processing
- Structured Output — output_config.format, strict:true, tool_choice, validation loops, provenance
- Agentic Loop Avanzado — SDK real, stop_reason, effort, Task Budgets, anti-patterns, circuit breaker
- CI/CD y Tool Design — GitHub Actions, GitLab CI, tool descriptions MALO/BUENO, testing de tool selection
- Sistema Multi-Agente de Investigación — Hub-and-spoke, provenance, deadlock detection, developer productivity
- API Fundamentals para Arquitectos — Thinking adaptativo, prompt caching, tool_choice modos, streaming, vision, token counting
- Preguntas de Práctica — Simulacro del Examen — 35 preguntas multiple choice con explicaciones detalladas para los 6 escenarios del examen
Bloque 7: Auditoría de Agentes
- Auditoría de Configuración de Agentes — Catálogo de antipatrones con síntoma, comando de detección y corrección; capítulo autocontenido que puedes pasarle directo a un agente para que audite tu CLAUDE.md,
.claude/, settings, subagentes, skills, hooks, MCP y permisos
Fuentes: shanraisshan/claude-code-best-practice (6.7K stars) y docs oficiales.
Bibliografía — Claude Certified Architect
Recursos oficiales y de la comunidad para preparar la certificación Claude Certified Architect – Foundations:
| Recurso | Descripción |
|---|---|
| Exam Guide oficial (PDF) | Guía oficial del examen — dominios, task statements y preguntas de muestra |
| Claude Cookbooks (GitHub) | Repositorio oficial de Anthropic con ejemplos prácticos y patrones de uso |
| Estudio preparatorio | Material de preparación para la certificación |
| Experiencia de la comunidad (Reddit) | Reporte de alguien que aprobó el examen — tips y áreas a reforzar |