Claude Code Best Practices - Índice

Por: Artiko
claude-codeaiclianthropicbest-practices

Claude Code Best Practices

Guía completa basada en el repositorio claude-code-best-practice y la documentación oficial.


Bloque 1: Fundamentos

  1. Qué es Claude Code — CLI oficial, arquitectura, setup, CLAUDE.md
  2. Commands — Slash commands, frontmatter, $ARGUMENTS, comandos builtin
  3. Sub-Agents — Agentes especializados, frontmatter, Task tool, scopes
  4. Skills — SKILL.md, patrones skill vs agent skill, invocación

Bloque 2: Infraestructura

  1. Hooks — 30 eventos, matchers, exit codes, tipos command/prompt/http, límites de bloqueo
  2. MCP Servers — Cuatro transportes (stdio, http, sse, ws), scopes y precedencia, tool search, control empresarial
  3. Settings — Jerarquía 5 niveles, permissions, effortLevel, managed settings, sandbox
  4. Memory y CLAUDE.md — Jerarquía de carga, auto memory, /context y /memory

Bloque 3: Workflows

  1. Orchestration Workflow — Patrón Command → Agent → Skill, divulgación progresiva, precedencia
  2. Workflows de Desarrollo — Explore → Plan → Implement → Commit, plan mode, verificación ejecutable
  3. Agent Teams y Worktrees — Agentes paralelos, git worktrees, background, CLI de agent teams
  4. Ralph Wiggum Loop — Tareas autónomas de larga duración, auto mode y sandbox OS-level

Bloque 4: Configuración Avanzada

  1. CLI Reference — Comandos CLI, flags de modelo y sesión, system prompts, print mode
  2. Permisos y Sandbox — Seis permission modes, auto mode, plan mode, wildcard syntax, network isolation
  3. Plugins — Paquetes distribuibles, marketplaces, schema del manifiesto, resolución de rutas
  4. Checkpointing y Sesiones — Checkpoints por prompt, retención, rewind, resume, fork, teleport

Bloque 5: Productividad

  1. Debugging — /doctor, background tasks, tool search, timeouts MCP, prompt injection
  2. Status Line y UX — Statusline custom, themes, keybindings, fast mode, effort level
  3. Voice Mode y Remote — Voice mode, remote control, headless con —bare y —json-schema, teleport
  4. Tips de Productividad — Best practices, CLAUDE.md conciso, permisos correctos, thinking adaptativo

Bloque 6: Claude Certified Architect

  1. Prompt Engineering — Criterios explícitos, few-shot, multi-pass, batch processing
  2. Structured Output — output_config.format, strict:true, tool_choice, validation loops, provenance
  3. Agentic Loop Avanzado — SDK real, stop_reason, effort, Task Budgets, anti-patterns, circuit breaker
  4. CI/CD y Tool Design — GitHub Actions, GitLab CI, tool descriptions MALO/BUENO, testing de tool selection
  5. Sistema Multi-Agente de Investigación — Hub-and-spoke, provenance, deadlock detection, developer productivity
  6. API Fundamentals para Arquitectos — Thinking adaptativo, prompt caching, tool_choice modos, streaming, vision, token counting
  7. 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

  1. 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:

RecursoDescripció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 preparatorioMaterial de preparación para la certificación
Experiencia de la comunidad (Reddit)Reporte de alguien que aprobó el examen — tips y áreas a reforzar