Guía completa de conceptos de Claude

Una visión conceptual de cómo funcionan y encajan las características de Claude Code: diagramas de arquitectura, tablas de decisiones y comparaciones entre comandos de barra de barra, subagentes, memoria, MCP, skills, complementos, hooks y más.

Cómo usar esta guía: esta página explica la conceptos — qué es cada característica, cómo funciona internamente y cuándo alcanzarla. plantillas de copia-pega y material de referencia completo en vivo en los módulos numerados (01- a través 10-), a la que cada sección enlaza. Comience aquí para construir un modelo mental, luego vaya al módulo para configurar algo.

Índice

1. Comandos de barra — módulo
2. Subagentes — módulo
3. Memoria — módulo
4. Protocolo MCP — módulo
5. Skills de los agentes — módulo
6. Plugins — módulo
7. Comparación e integración
8. Cuadro sinóptico
9. Guía de inicio rápido
10. Hooks — módulo
11. Puntos de control y rebobinado — módulo
12. Funciones avanzadas — módulo
13. Modelos y esfuerzo de razonamiento — módulo
14. Recursos

Comandos de barra

Introducción

Los comandos Slash son accesos directos de los usuarios que se almacenan como archivos Markdown que Claude Code puede ejecutar. Permiten a los equipos estandarizar las indicaciones y flujos de trabajo de uso frecuente.

Arquitectura

graph TD
    A["Entrada de usuario: /command-name"] -->|Triggers| B["Buscar .claude/commands/"]
    B -->|Finds| C["command-name.md"]
    C -->|Loads| D["Marcar el contenido"]
    D -->|Executes| E["Procesos de Claude Prompt"]
    E -->|Returns| F["Resultado en contexto"]

Estructura del archivo

graph LR
    A["Raíz del proyecto"] -->|contains| B[".claude/commands/"]
    B -->|contains| C["optimize.md"]
    B -->|contains| D["test.md"]
    B -->|contains| E["docs/"]
    E -->|contains| F["generate-api-docs.md"]
    E -->|contains| G["generate-readme.md"]

Tabla de organización de comandos

Características y capacidades

Ejemplos prácticos

Ocho plantillas de comandos copy-paste en vivo 01-slash-commands/ — /optimize, /pr, /commit, /push-all, /generate-api-docs, /doc-refactor, /setup-ci-cd, y /unit-test-expand.

01-slash-commands/README.md También lleva la referencia de órdenes integrada completa (comandos 60+) y la tabla de campo de frontmatter.

Diagrama de ciclo de vida del comando

sequenceDiagram
    participant User
    participant Claude as Claude Code
    participant FS as File System
    participant CLI as Shell/Bash

    User->>Claude: Types /optimize
    Claude->>FS: Searches .claude/commands/
    FS-->>Claude: Returns optimize.md
    Claude->>Claude: Loads Markdown content
    Claude->>User: Displays prompt context
    User->>Claude: Provides code to analyze
    Claude->>CLI: (May execute scripts)
    CLI-->>Claude: Results
    Claude->>User: Returns analysis

Mejores prácticas

Subagentes

Introducción

Los subagentes son asistentes especializados en IA con ventanas de contexto aisladas y avisos de sistema personalizados. Permiten la ejecución de tareas delegadas mientras se mantiene una separación limpia de las preocupaciones.

Los subagentes pueden producir sus propios subagentes, Anidado por defecto hasta la profundidad 3 (v2.1.219) — por lo que la jerarquía no se limita a la única capa principal → subagent que se muestra a continuación. CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH para cambiar el límite, o 1 (Historia: v2.1.172–v2.1.216 anidado por defecto hasta 5 capas sin ninguna forma de cambiarlo; v2.1.217 hecho opt-in de nidificación en profundidad 1; v2.1.219 establecer el valor predeterminado a 3.)

Diagrama de arquitectura

graph TB
    User["Usuario"]
    Main[" ⁇  Agente principal<br/>(Coordinador)"]
    Reviewer[" ⁇  Revisor de código<br/>Subagente"]
    Tester["• Ingeniero de pruebas<br/>Subagente"]
    Docs["Documentación<br/>Subagente"]

    User -->|asks| Main
    Main -->|delegates| Reviewer
    Main -->|delegates| Tester
    Main -->|delegates| Docs
    Reviewer -->|devuelve el resultado| Main
    Tester -->|devuelve el resultado| Main
    Docs -->|devuelve el resultado| Main
    Main -->|synthesizes| User

Ciclo de vida del subagente

sequenceDiagram
    participant User
    participant MainAgent as Main Agent
    participant CodeReviewer as Code Reviewer<br/>Subagent
    participant Context as Separate<br/>Context Window

    User->>MainAgent: "Construir nueva característica de autenticación"
    MainAgent->>MainAgent: Analyze task
    MainAgent->>CodeReviewer: "Revise este código"
    CodeReviewer->>Context: Initialize clean context
    Context->>CodeReviewer: Load reviewer instructions
    CodeReviewer->>CodeReviewer: Perform review
    CodeReviewer-->>MainAgent: Return findings
    MainAgent->>MainAgent: Incorporate results
    MainAgent-->>User: Provide synthesis

Tabla de configuración de subagentes

Jerarquía de acceso a la herramienta

graph TD
    A["Configuración del subagente"] -->|Opción 1| B["Heredar todas las herramientas<br/>del hilo de discusión principal"]
    A -->|Opción 2| C["Especificar herramientas individuales"]
    B -->|Includes| B1["Operaciones de archivos"]
    B -->|Includes| B2["Comandos de conchas"]
    B -->|Includes| B3["Herramientas MCP"]
    C -->|Lista explícita| C1["leer, grep, diff"]
    C -->|Lista explícita| C2["Bash(npm:*), Bash(test:*)"]

Ejemplos prácticos

Nueve definiciones de subagentes listos para usar viven en 04-subagents/ — code-reviewer, clean-code-reviewer, secure-reviewer, test-engineer, documentation-writer, implementation-agent, performance-optimizer, debugger, y data-scientist.

04-subagents/README.md documenta la referencia frontal completa, las reglas de acceso a herramientas, los límites de nidificación y los equipos de agentes.

Gestión del contexto de los subagentes

graph TB
    A["Contexto del agente principal<br/>50.000 fichas"]
    B["Contexto del subagente 1<br/>20.000 fichas"]
    C["Contexto del subagente 2<br/>20.000 fichas"]
    D["Contexto del subagente 3<br/>20.000 fichas"]

    A -->|Limpiar pizarra| B
    A -->|Limpiar pizarra| C
    A -->|Limpiar pizarra| D

    B -->|Sólo resultados| A
    C -->|Sólo resultados| A
    D -->|Sólo resultados| A

    style A fill:#e1f5ff
    style B fill:#fff9c4
    style C fill:#fff9c4
    style D fill:#fff9c4

Cuándo usar los subagentes

Equipo de Agentes

Los equipos de agentes coordinan múltiples agentes que trabajan en tareas relacionadas. En lugar de delegar a un subagente a la vez, los equipos de agentes permiten al agente principal orquestar un grupo de agentes que colaboran, comparten resultados intermedios y trabajan hacia una meta común. Esto es útil para tareas a gran escala como el desarrollo de funciones de pila completa donde un agente de frontend, agente de backend y agente de pruebas trabajan en paralelo.

Memoria

Introducción

La memoria permite a Claude conservar el contexto a través de sesiones y conversaciones. Existe en dos formas: síntesis automática en claude.ai, y CLAUDE.md basado en sistemas de archivos en Claude Code.

Arquitectura de memoria

graph TB
    A["Sesión de Claude"]
    B["Entrada del usuario"]
    C["Sistema de memoria"]
    D["Almacenamiento de memoria"]

    B -->|El usuario proporciona información| C
    C -->|Sintetiza cada 24h| D
    D -->|Carga automáticamente| A
    A -->|Usos del contexto| C

Jerarquía de la memoria en Claude Code (7 niveles)

Los archivos CLAUDE.md se concatenan en contexto en lugar de prevalecer entre sí, y se cargan administrados → usuario → proyecto → local (más tarde, los archivos más específicos se leen por última vez):

graph TD
    A["1. Políticas gestionadas<br/>Políticas de administración de empresas"] --> B["2. Memoria del proyecto<br/>./CLAUDE.md"]
    B --> C["3. Normas del proyecto<br/>.claude/reglas/*.md"]
    C --> D["4. Memoria de usuario<br/>~/.claude/CLAUDE.md"]
    D --> E["5. Reglas del usuario<br/>~/.claude/reglas/*.md"]
    E --> F["6. Memoria local<br/>./CLAUDE.local.md"]
    F --> G["7. Memoria automática<br/>Preferencias capturadas automáticamente"]

    style A fill:#fce4ec,stroke:#333,color:#333
    style B fill:#e1f5fe,stroke:#333,color:#333
    style C fill:#e1f5fe,stroke:#333,color:#333
    style D fill:#f3e5f5,stroke:#333,color:#333
    style E fill:#f3e5f5,stroke:#333,color:#333
    style F fill:#e8f5e9,stroke:#333,color:#333
    style G fill:#fff3e0,stroke:#333,color:#333

Tabla de ubicaciones de memoria

Memoria automática

Auto Memory captura automáticamente las preferencias y patrones de usuario observados durante las sesiones. Claude aprende de sus interacciones y recuerda:

• Preferencias de estilo de codificación
• Correcciones comunes que haces
• Marco y opciones de herramientas
• Preferencias de estilo de comunicación

La memoria automática funciona en segundo plano y no requiere configuración manual.

Actualización de memoria ciclo de vida

sequenceDiagram
    participant User
    participant Claude as Claude Code
    participant Editor as File System
    participant Memory as CLAUDE.md

    User->>Claude: "Recuerde: use async/await"
    Claude->>User: "¿Qué archivo de memoria?"
    User->>Claude: "Memoria del proyecto"
    Claude->>Editor: Open ~/.claude/settings.json
    Claude->>Memory: Write to ./CLAUDE.md
    Memory-->>Claude: File saved
    Claude->>Claude: Load updated memory
    Claude-->>User: "¡Memoria salvada!"

Ejemplos prácticos

Copia-pegar plantillas de memoria en vivo 02-memory/:

• project-CLAUDE.md — normas de proyecto para todo el equipo ./CLAUDE.md
• personal-CLAUDE.md — las preferencias individuales para ~/.claude/CLAUDE.md
• directory-api-CLAUDE.md — normas de directorio para un subárbol

02-memory/README.md cubre toda la jerarquía, sintaxis de importación, .claude/rules/, memoria automática, y cómo mantener CLAUDE.md bajo 200 líneas.

Memoria en Claude Web/Desktop

Cronograma de síntesis de memoria

graph LR
    A["Día 1: Usuario<br/>Conversaciones"] -->|24 horas| B["Día 2: Memoria<br/>Síntesis"]
    B -->|Automatic| C["Memoria actualizada<br/>Resumen"]
    C -->|Cargado en| D["Día 2-N:<br/>Nuevas conversaciones"]
    D -->|Añadir a| E["Memory"]
    E -->|24 horas más tarde| F["Refrescada la memoria"]

Contenido de memoria automática

Auto memoria almacena lo que Claude aprende de ti a través de sesiones en ~/.claude/projects/<project>/memory/, indizado por MEMORY.md. Véase 02-memory/README.md para el diseño del archivo, límites de carga y cómo activarlo o desactivarlo.

Comparación de características de memoria

Protocolo MCP

Introducción

MCP (Model Context Protocol) es una forma estandarizada para que Claude acceda a herramientas externas, API y fuentes de datos en tiempo real. A diferencia de Memory, MCP ofrece acceso en vivo a datos cambiantes.

MCP Architecture

graph TB
    A["Claude"]
    B["Servidor MCP"]
    C["Servicio externo"]

    A -->|Solicitud: list_issues| B
    B -->|Query| C
    C -->|Data| B
    B -->|Response| A

    A -->|Solicitud: create_issue| B
    B -->|Action| C
    C -->|Result| B
    B -->|Response| A

Ecosistema MCP

graph TB
    A["Claude"] -->|MCP| B["Sistema de archivos<br/>Servidor MCP"]
    A -->|MCP| C["GitHub<br/>Servidor MCP"]
    A -->|MCP| D["Base de datos<br/>Servidor MCP"]
    A -->|MCP| E["Slack<br/>Servidor MCP"]
    A -->|MCP| F["Google Docs<br/>Servidor MCP"]

    B -->|Archivo E/S| G["Archivos locales"]
    C -->|API| H["GitHub Repos"]
    D -->|Query| I["PostgreSQL/MySQL"]
    E -->|Messages| J["Espacio de trabajo de Slack"]
    F -->|Docs| K["Google Drive"]

Proceso de configuración de MCP

sequenceDiagram
    participant User
    participant Claude as Claude Code
    participant Config as Config File
    participant Service as External Service

    User->>Claude: Type /mcp
    Claude->>Claude: List available MCP servers
    Claude->>User: Show options
    User->>Claude: Select GitHub MCP
    Claude->>Config: Update configuration
    Config->>Claude: Activate connection
    Claude->>Service: Test connection
    Service-->>Claude: Authentication successful
    Claude->>User: ✅ MCP connected!

Tabla de servidores MCP disponibles

Ejemplos prácticos

Configuración de servidor MCP lista para usar en vivo 05-mcp/: github-mcp.json, database-mcp.json, filesystem-mcp.json, y multi-mcp.json (cuatro servidores en un archivo).

05-mcp/README.md cubre la totalidad claude mcp add sintaxis, transportes, alcances, OAuth y lista de permisos empresariales.

MCP vs Memoria: Matriz de Decisión

graph TD
    A["¿Necesita datos externos?"]
    A -->|No| B["Usar memoria"]
    A -->|Yes| C["¿Cambia con frecuencia?"]
    C -->|No/Rarely| B
    C -->|Yes/Often| D["Usar MCP"]

    B -->|Stores| E["Preferencias<br/>Contexto<br/>Histórico"]
    D -->|Accesses| F["APIs en vivo<br/>Bases de datos<br/>Servicios"]

    style B fill:#e1f5ff
    style D fill:#fff9c4

Patrón de solicitud/respuesta

sequenceDiagram
    participant App as Claude
    participant MCP as MCP Server
    participant DB as Database

    App->>MCP: Request: "SELECT * DE LOS Usuarios DÓNDE id=1"
    MCP->>DB: Execute query
    DB-->>MCP: Result set
    MCP-->>App: Return parsed data
    App->>App: Process result
    App->>App: Continue task

    Note over MCP,DB: Real-time access<br/>No caching

Skills de los agentes

Introducción

Agent Skills son capacidades reutilizables, con empleo de modelos empaquetadas como carpetas que contienen instrucciones, scripts y recursos. Claude detecta y utiliza automáticamente skills relevantes.

Arquitectura de skills

graph TB
    A["Directorio de habilidades"]
    B["SKILL.md"]
    C["Metadatos de YAML"]
    D["Instructions"]
    E["Scripts"]
    F["Templates"]

    A --> B
    B --> C
    B --> D
    E --> A
    F --> A

Proceso de carga de skills

sequenceDiagram
    participant User
    participant Claude as Claude
    participant System as System
    participant Skill as Skill

    User->>Claude: "Crear informe Excel"
    Claude->>System: Scan available skills
    System->>System: Load skill metadata
    Claude->>Claude: Match user request to skills
    Claude->>Skill: Load xlsx skill SKILL.md
    Skill-->>Claude: Return instructions + tools
    Claude->>Claude: Execute skill
    Claude->>User: Generate Excel file

Tabla de tipos y ubicaciones de skills

Skills preconstruidas

graph TB
    A["Competencias preconstruidas"]
    B["PowerPoint (pptx)"]
    C["Excel (xlsx)"]
    D["Palabra (docx)"]
    E["PDF"]

    A --> B
    A --> C
    A --> D
    A --> E

    B --> B1["Crear presentaciones"]
    B --> B2["Editar diapositivas"]
    C --> C1["Crear hojas de cálculo"]
    C --> C2["Analizar los datos"]
    D --> D1["Crear documentos"]
    D --> D2["Formato de texto"]
    E --> E1["Generar PDFs"]
    E --> E2["Rellenar formularios"]

Skills combinadas

Claude Code incluye las skills disponibles en la caja, incluyendo:

Estas skills agrupadas siempre están disponibles y no requieren instalación o configuración.

Ejemplos prácticos

Seis skills completas —con sus scripts, plantillas y archivos de referencia— viven en 03-skills/:

• code-review-specialist/ — revisar la lista de verificación, encontrar plantilla y dos scripts de métricas de Python
• refactor/ — catálogo de olfato de código, catálogo de refactorización, plantilla de plan y dos scripts de análisis
• doc-generator/ — Generación de documentación API a partir de la fuente
• blog-draft/ — esquema y borrador de plantillas con una convención de productos en versión
• brand-voice/ — reglas de tono y plantillas de mensajes (demuestra user-invocable: false)
• claude-md/ — crear, actualizar y auditar archivos CLAUDE.md

Ver 03-skills/README.md para el modelo completo de referencia frontal y de divulgación progresiva.

Descubrimiento de skills e invocación

graph TD
    A["Solicitud del usuario"] --> B["Claude analiza"]
    B -->|Scans| C["Capacidades disponibles"]
    C -->|Comprobación de metadatos| D["Descripción de la habilidad Partido?"]
    D -->|Yes| E["Cargar SKILL.md"]
    D -->|No| F["Prueba la siguiente habilidad"]
    F -->|¿Más habilidades?| D
    F -->|No más| G["Utilizar los conocimientos generales"]
    E --> H["Instrucciones de extracción"]
    H --> I["Ejecutar habilidad"]
    I --> J["Resultados de retorno"]

Habilidad vs. otras características

graph TB
    A["Extender Claude"]
    B["Comandos de barra"]
    C["Subagents"]
    D["Memory"]
    E["MCP"]
    F["Skills"]

    A --> B
    A --> C
    A --> D
    A --> E
    A --> F

    B -->|User-invoked| G["Accesos rápidos"]
    C -->|Auto-delegated| H["Contextos aislados"]
    D -->|Persistent| I["Contexto entre períodos de sesiones"]
    E -->|Real-time| J["Acceso externo a los datos"]
    F -->|Auto-invoked| K["Ejecución autónoma"]

Complementos de Claude Code

Introducción

Los Plugins de Claude Code son colecciones de personalizaciones (comandos de barra, subagentes, servidores MCP y hooks) que se instalan con un solo comando. Representan el mecanismo de extensión de más alto nivel, combinando múltiples funciones en paquetes cohesivos y compartidos.

Arquitectura

graph TB
    A["Plugin"]
    B["Comandos de barra"]
    C["Subagents"]
    D["Servidores MCP"]
    E["Hooks"]
    F["Configuration"]

    A -->|bundles| B
    A -->|bundles| C
    A -->|bundles| D
    A -->|bundles| E
    A -->|bundles| F

Proceso de carga del complemento

sequenceDiagram
    participant User
    participant Claude as Claude Code
    participant Plugin as Plugin Marketplace
    participant Install as Installation
    participant SlashCmds as Slash Commands
    participant Subagents
    participant MCPServers as MCP Servers
    participant Hooks
    participant Tools as Configured Tools

    User->>Claude: claude --plugin-dir ./07-plugins/pr-review
    Claude->>Plugin: Download plugin manifest
    Plugin-->>Claude: Return plugin definition
    Claude->>Install: Extract components
    Install->>SlashCmds: Configure
    Install->>Subagents: Configure
    Install->>MCPServers: Configure
    Install->>Hooks: Configure
    SlashCmds-->>Tools: Ready to use
    Subagents-->>Tools: Ready to use
    MCPServers-->>Tools: Ready to use
    Hooks-->>Tools: Ready to use
    Tools-->>Claude: Plugin installed ✅

Tipos de complementos y distribución

Estructura de definición del complemento

El manifiesto es JSON en .claude-plugin/plugin.jsonÚnicamente name se requiere, y las claves de nivel superior no reconocidas se quitan:

{
  "name": "plugin-name",
  "version": "1.0.0",
  "description": "What this plugin does"
}

Estructura del complemento

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── commands/
│   ├── task-1.md
│   ├── task-2.md
│   └── workflows/
├── agents/
│   ├── specialist-1.md
│   ├── specialist-2.md
│   └── configs/
├── skills/
│   └── skill-name/
│       └── SKILL.md
├── hooks/
│   └── hooks.json
├── .mcp.json
├── bin/
│   └── my-tool
├── .lsp.json
├── settings.json
├── templates/
│   └── issue-template.md
├── scripts/
│   ├── helper-1.sh
│   └── helper-2.py
├── docs/
│   ├── README.md
│   └── USAGE.md
└── tests/
    └── plugin.test.js

Ejemplos prácticos

Tres plugins completos e instalables viven en 07-plugins/:

• pr-review/ — mandos de revisión, tres agentes especializados, GitHub MCP, y un hook de pre-revisión
• documentation/ — comandos de generación de doc, tres agentes y plantillas reutilizables
• devops-automation/ — comandos de despliegue/rollback/status/inciident, tres agentes, Kubernetes MCP y scripts de shell

Cada uno incluye su .claude-plugin/plugin.json manifiesto y diseño de directorio.

Mercado de complementos

graph TB
    A["Mercado de complementos"]
    B["Oficial<br/>Antrópico"]
    C["Comunidad<br/>Mercado"]
    D["Empresa<br/>Secretaría"]

    A --> B
    A --> C
    A --> D

    B -->|Categories| B1["Development"]
    B -->|Categories| B2["DevOps"]
    B -->|Categories| B3["Documentation"]

    C -->|Search| C1["Automatización DevOps"]
    C -->|Search| C2["Mobile Dev"]
    C -->|Search| C3["Ciencia de los datos"]

    D -->|Internal| D1["Normas de la empresa"]
    D -->|Internal| D2["Sistemas heredados"]
    D -->|Internal| D3["Compliance"]

Instalación de complementos y ciclo de vida

graph LR
    A["Discover"] -->|Browse| B["Marketplace"]
    B -->|Select| C["Página de complemento"]
    C -->|View| D["Components"]
    D -->|Install| E["/plugin install"]
    E -->|Extract| F["Configure"]
    F -->|Activate| G["Use"]
    G -->|Check| H["Update"]
    H -->|Available| G
    G -->|Done| I["Disable"]
    I -->|Later| J["Enable"]
    J -->|Back| G

Comparación de características del complemento

Casos de uso de complementos

Cuándo crear un complemento

graph TD
    A["¿Debo crear un plugin?"]
    A -->|Necesita varios componentes| B{"Múltiples comandos<br/>o subagentes<br/>¿O MCPs?"}
    B -->|Yes| C["• Crear complemento"]
    B -->|No| D["Usar característica individual"]
    A -->|Flujo de trabajo del equipo| E{"Compartir con<br/>¿equipo?"}
    E -->|Yes| C
    E -->|No| F["Mantener como configuración local"]
    A -->|Configuración compleja| G{"Necesita auto<br/>¿Configuración?"}
    G -->|Yes| C
    G -->|No| D

Publicación de un complemento

Pasos para publicar:

1. Crear estructura de complementos con todos los componentes
2. Escribir .claude-plugin/plugin.json manifiesto
3. Crear README.md con documentación
4. Prueba local con claude --plugin-dir ./my-plugin
5. Enviar al mercado de complementos
6. Ser revisado y aprobado
7. Publicado en el mercado
8. Los usuarios pueden instalar con un comando

Ejemplo de complemento README

Vea los tres complementos completos en 07-plugins/ — pr-review/, documentation/, y devops-automation/ cada buque un lleno README.md, manifiesto, comandos, agentes y configuración MCP puede copiar al por mayor.

Complemento vs Configuración manual

Configuración manual (2+ horas): - Instalar comandos de barra uno por uno - Crear subagentes individualmente - Configurar MCPs por separado - Configurar hooks manualmente - Documentar todo - Compartir con el equipo (esperamos que configuren correctamente)

Con complemento (2 minutos):

claude --plugin-dir ./07-plugins/pr-review
# ✅ Everything installed and configured
# ✅ Ready to use immediately
# ✅ Team can reproduce exact setup

Comparación e integración

Matriz de comparación de características

Línea temporal de interacción

graph LR
    A["Inicio de la sesión"] -->|Load| B["Memoria (CLAUDE.md)"]
    B -->|Discover| C["Capacidades disponibles"]
    C -->|Register| D["Comandos de barra"]
    D -->|Connect| E["Servidores MCP"]
    E -->|Ready| F["Interacción con el usuario"]

    F -->|Tipo /cmd| G["Comando de barra"]
    F -->|Request| H["Auto-invocación de la habilidad"]
    F -->|Query| I["Datos de MCP"]
    F -->|Tareas complejas| J["Delegada en el Subagente"]

    G -->|Uses| B
    H -->|Uses| B
    I -->|Uses| B
    J -->|Uses| B

Ejemplo práctico de integración: Automatización de atención al cliente

Arquitectura

graph TB
    User["Correo electrónico del cliente"] -->|Receives| Router["Enrutador de soporte"]

    Router -->|Analyze| Memory["Memoria<br/>Historial del cliente"]
    Router -->|Lookup| MCP1["MCP: Customer DB<br/>Entradas anteriores"]
    Router -->|Check| MCP2["MCP: Slack<br/>Estado de los equipos"]

    Router -->|Complejo de la ruta| Sub1["Subagente: Soporte técnico<br/>Contexto: Cuestiones técnicas"]
    Router -->|Ruta simple| Sub2["Subagente: facturación<br/>Contexto: Cuestiones de pago"]
    Router -->|Ruta Urgente| Sub3["Subagente: escalada<br/>Contexto: Tratamiento de prioridades"]

    Sub1 -->|Format| Skill1["Habilidad: Generador de respuesta<br/>Marca de voz mantenida"]
    Sub2 -->|Format| Skill2["Habilidad: Generador de respuesta"]
    Sub3 -->|Format| Skill3["Habilidad: Generador de respuesta"]

    Skill1 -->|Generate| Output["Respuesta formateada"]
    Skill2 -->|Generate| Output
    Skill3 -->|Generate| Output

    Output -->|Post| MCP3["MCP: Slack<br/>Notificar al equipo"]
    Output -->|Send| Reply["Respuesta del cliente"]

Solicitar flujo

## Customer Support Request Flow

### 1. Incoming Email
"I'm getting error 500 when trying to upload files. This is blocking my workflow!"

### 2. Memory Lookup
- Loads CLAUDE.md with support standards
- Checks customer history: VIP customer, 3rd incident this month

### 3. MCP Queries
- GitHub MCP: List open issues (finds related bug report)
- Database MCP: Check system status (no outages reported)
- Slack MCP: Check if engineering is aware

### 4. Skill Detection & Loading
- Request matches "Technical Support" skill
- Loads support response template from Skill

### 5. Subagent Delegation
- Routes to Tech Support Subagent
- Provides context: customer history, error details, known issues
- Subagent has full access to: read, bash, grep tools

### 6. Subagent Processing
Tech Support Subagent:
- Searches codebase for 500 error in file upload
- Finds recent change in commit 8f4a2c
- Creates workaround documentation

### 7. Skill Execution
Response Generator Skill:
- Uses Brand Voice guidelines
- Formats response with empathy
- Includes workaround steps
- Links to related documentation

### 8. MCP Output
- Posts update to #support Slack channel
- Tags engineering team
- Updates ticket in Jira MCP

### 9. Response
Customer receives:
- Empathetic acknowledgment
- Explanation of cause
- Immediate workaround
- Timeline for permanent fix
- Link to related issues

Orquestación completa de características

sequenceDiagram
    participant User
    participant Claude as Claude Code
    participant Memory as Memory<br/>CLAUDE.md
    participant MCP as MCP Servers
    participant Skills as Skills
    participant SubAgent as Subagents

    User->>Claude: Request: "Construir un sistema de autenticación"
    Claude->>Memory: Load project standards
    Memory-->>Claude: Auth standards, team practices
    Claude->>MCP: Query GitHub for similar implementations
    MCP-->>Claude: Code examples, best practices
    Claude->>Skills: Detect matching Skills
    Skills-->>Claude: Security Review Skill + Testing Skill
    Claude->>SubAgent: Delegate implementation
    SubAgent->>SubAgent: Build feature
    Claude->>Skills: Apply Security Review Skill
    Skills-->>Claude: Security checklist results
    Claude->>SubAgent: Delegate testing
    SubAgent-->>Claude: Test results
    Claude->>User: Complete system delivered

Cuándo usar cada característica

graph TD
    A["Nueva tarea"] --> B{Type of Task?}

    B -->|Flujo de trabajo repetido| C["Comando de barra"]
    B -->|Necesita datos en tiempo real| D["Protocolo MCP"]
    B -->|Recuerda para la próxima vez| E["Memory"]
    B -->|Subtarea especializada| F["Subagent"]
    B -->|Labor específica de cada ámbito| G["Skill"]

    C --> C1["• Acceso directo al equipo"]
    D --> D1["• Acceso a API en vivo"]
    E --> E1["• Contexto persistente"]
    F --> F1["• Ejecución paralela"]
    G --> G1["• Experiencias de autoinvocación"]

Árbol de decisiones de selección

graph TD
    Start["¿Necesitas extender a Claude?"]

    Start -->|Repetición rápida de la tarea| A{"¿Manual o Auto?"}
    A -->|Manual| B["Comando de barra"]
    A -->|Auto| C["Skill"]

    Start -->|Necesidad de datos externos| D{"¿En tiempo real?"}
    D -->|Yes| E["Protocolo MCP"]
    D -->|No/Cross-session| F["Memory"]

    Start -->|Proyecto complejo| G{"¿Múltiples papeles?"}
    G -->|Yes| H["Subagents"]
    G -->|No| I["Habilidades + Memoria"]

    Start -->|Contexto a largo plazo| J["Memory"]
    Start -->|Flujo de trabajo del equipo| K["Comando de barra +<br/>Memoria"]
    Start -->|Automatización completa| L["Competencias +<br/>Subagentes +<br/>MCP"]

Cuadro sinóptico

Guía de inicio rápido

Semana 1: Inicio sencillo

• Crear 2-3 comandos de barra para tareas comunes
• Habilitar memoria en configuración
• Normas del equipo de documentación en CLAUDE.md

Semana 2: Añadir acceso en tiempo real

• Establecer 1 MCP (GitHub o base de datos)
• Uso /mcp configurar
• Consultar datos en vivo en sus flujos de trabajo

Semana 3: Distribuir el trabajo

• Crear el primer subagente para un rol específico
• Pídale a Claude que lo cree, o agregue un .claude/agents/<name>.md archivo (el /agents se eliminó el asistente)
• Demostración de prueba con tarea sencilla

Semana 4: Automatizar todo

• Crear primera habilidad para la automatización repetida
• Usar el mercado de skills o construir a medida
• Combinar todas las características para un flujo de trabajo completo

En curso

• Revisión y actualización de memoria mensual
• Añadir nuevas skills a medida que emergen patrones
• Optimizar las consultas MCP
• Refine los indicadores de subagentes

Hooks

Introducción

Los hooks son comandos shell impulsados por eventos que se ejecutan automáticamente en respuesta a eventos de Claude Code. Permiten la automatización, validación y flujos de trabajo personalizados sin intervención manual.

Eventos de hook

Claude Code soporta 33 eventos de hook a través de cinco tipos de hook (orden, http, mcp_tool, prompt, agente):

Hooks comunes

Los hooks están configurados en ~/.claude/settings.json (nivel de usuario) o .claude/settings.json (a nivel de proyecto):

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx eslint"
          }
        ]
      }
    ]
  }
}

Variables de entorno de hook

• Entrada de hook llega como JSON en stdin (session_id, tool_name, tool_input.file_path, ...) — leer con jq
• $CLAUDE_CODE_SESSION_ID - Identificador de la sesión actual
• $CLAUDE_PROJECT_DIR - Ruta del directorio del proyecto

Mejores prácticas

✅ Hacer: - Mantener hooks rápidos (< 1 segundo) - Usar hooks para la validación y automatización - Manejar errores con gracia - Usar rutas absolutas

❌ No: - Hacer hooks interactivos - Usar hooks para tareas de larga duración - Credenciales de código duro

Ver: 06-hooks/ para ejemplos detallados

Puntos de control y rebobinado

Introducción

Los puestos de control le permiten guardar el estado de conversación y rebobinar a puntos anteriores, lo que permite la experimentación segura y la exploración de múltiples enfoques.

Conceptos clave

Acceso a los puestos de control

Los puntos de verificación se crean automáticamente con cada indicador de usuario. Para rebobinar:

# Press Esc twice to open the checkpoint browser
Esc + Esc

# Or use the /rewind command
/rewind

Al seleccionar un punto de control, usted elige entre seis opciones: 1. Restaurar código y conversación -- Revertir ambos a ese punto 2. Restaurar conversación -- Rebobinar mensajes, mantener el código actual 3. Código de restauración -- Revertir archivos, mantener la conversación 4. Resuma desde aquí -- Comprimir la conversación en un resumen 5. Resuma hasta aquí -- Comprime todo antes de este punto en un resumen 6. No importa. -- Cancelar

Casos de uso

Configuración

Los puntos de control están activados por defecto; fileCheckpointingEnabled lo controla:

{
  "fileCheckpointingEnabled": true
}

Ver: 08-checkpoints/ para ejemplos detallados

Funciones avanzadas

Modo de planificación

Cree planes de implementación detallados antes de codificar.

Activación:

/plan Implement user authentication system

Prestaciones: - Plan de trabajo claro con estimaciones de tiempo - Evaluación de riesgos - Desglose sistemático de tareas - Oportunidad de revisión y modificación

Pensamiento extendido

Razonamiento profundo para problemas complejos.

Activación: - Conmutar con Alt+T (o Option+T en macOS) durante una sesión - Opus 4.7+, Sonnet 5+, Haiku 5.5 y Fable utilizan siempre el razonamiento adaptativo, por lo que un fijo MAX_THINKING_TOKENS presupuesto no se aplica; control de profundidad con /effort

# Control reasoning depth with the effort level
/effort high

Prestaciones: - Análisis exhaustivo de las compensaciones - Mejores decisiones arquitectónicas - Examen de casos extremos - Evaluación sistemática

Tareas de fondo

Realizar operaciones largas sin bloquear la conversación.

Uso:

User: Run tests in background

Claude: Started task bg-1234

/tasks               # View and manage background work (alias: /bashes)

Modos de permiso

Controla lo que Claude puede hacer.

Uso:

claude --permission-mode plan          # Read-only analysis
claude --permission-mode acceptEdits   # Auto-accept edits
claude --permission-mode auto          # Auto-approve safe actions
claude --permission-mode dontAsk       # Pre-approved tools only; deny the rest

Modo sin interfaz (modo de impresión)

Ejecutar Claude Code sin entrada interactiva para la automatización y CI/CD utilizando el -p (impresión) bandera.

Uso:

# Run specific task (-p starts in Manual mode since v2.1.302, so pass a permission mode or --allowedTools)
claude -p "Run all tests" --permission-mode auto

# Pipe input for analysis
cat error.log | claude -p "explain this error"

# CI/CD integration (GitHub Actions)
- name: AI Code Review
  run: claude -p "Review PR changes and report issues"

# JSON output for scripting
claude -p --output-format json "list all functions in src/"

Tareas programadas

Ejecutar tareas con alcance de sesión en un horario de repetición utilizando el /loop Para horarios que sobrevivan a la sesión, utilice tareas programadas en la nube (anteriormente rutinas) con /schedule, o Tareas programadas de escritorio.

Uso:

/loop every 30m "Run tests and report failures"
/loop every 2h "Check for dependency updates"
/loop every 1d "Generate daily summary of code changes"

Las tareas programadas se ejecutan en segundo plano e informan de los resultados cuando se completan. Son útiles para el monitoreo continuo, comprobaciones periódicas y flujos de trabajo de mantenimiento automatizados.

Integración de Chrome

Claude Code puede integrarse con el navegador Chrome para tareas de automatización web. Esto permite funciones como navegar por páginas web, rellenar formularios, tomar capturas de pantalla y extraer datos de sitios web directamente dentro de su flujo de trabajo de desarrollo.

Gestión de las sesiones

Administrar múltiples sesiones de trabajo.

Comandos:

/resume                # Resume a previous conversation
/rename "Feature"      # Name the current session
/fork                  # Fork into a new session
claude -c              # Continue most recent conversation
claude -r "Feature"    # Resume session by name/ID

Características interactivas

Accesos rápidos del teclado: - Ctrl + R - Historial de comandos de búsqueda - Tab Autocompletado ↑ / ↓ - Historial de comandos - Ctrl + L - Limpiar la pantalla

Entrada de varias líneas: prensa \ + Intro, Opción+Intro (macOS), Shift+Enter o Ctrl+J para iniciar una nueva línea. No hay \end Terminator.

Configuración

Ejemplo completo de configuración:

{
  "alwaysThinkingEnabled": true,
  "showThinkingSummaries": true,
  "permissions": {
    "defaultMode": "manual"
  }
}

No hay settings.json bloque para tareas de fondo — la característica está controlada por el CLAUDE_CODE_DISABLE_BACKGROUND_TASKS variable de entorno, y condition por CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS (por defecto) 20).

Ver: 09-advanced-features/ para una guía completa

Modelos y esfuerzo de razonamiento

Claude Code apoya los siguientes modelos con esfuerzo de razonamiento adaptativo:

Nota: xhigh está disponible en Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8 y Opus 4.7; max trabaja en Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8/4.7/4.6 y Sonnet 4.6 (sólo sesión). Haiku 4.5 no soporta los niveles de esfuerzo.

Nota: v2.1.117 solucionó un error donde el Opus 4.7 sesiones calculadas /context contra 200K en lugar de la ventana nativa 1M — upgrade a v2.1.117 o más tarde para obtener realmente el contexto 1M en el Opus 4.7. El Opus 5 y el Opus 4.8 también tienen una ventana nativa 1M-token.

Nota: /cost y /stats fusionado en /usage en el punto 2.1.118. /usage es ahora el comando canónico con pestañas para coste/stats/etc.; /cost y /stats a partir de v2.1.149, la vista de costes también desglosa el gasto por categoría (skills, subagentes, plugins y costos por servidor-MCP).

Recursos

• Documentación de Claude Code
• Registro de cambios de Claude Code
• Servidores GitHub MCP
• Libro de cocina antrópico

Última actualización: 26 de octubre de 2026 Versión de Claude Code: 2.1.310 Fuentes: - https://code.claude.com/docs/en/plugins/manifest-reference - https://code.claude.com/docs/en/plugins/create - https://code.claude.com/docs/en/plugins/install - https://code.claude.com/docs/en/settings-reference - https://code.claude.com/docs/en/interactive-mode - https://code.claude.com/docs/en/checkpointing - https://code.claude.com/docs/en/memory - https://code.claude.com/docs/en/skills - https://code.claude.com/docs/en/tools-reference#task-tool-availability - https://www.anthropic.com/news/claude-sonnet-5 - https://code.claude.com/docs/en/cli-reference - https://code.claude.com/docs/en/model-config - https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md - https://code.claude.com/docs/en/hooks - https://code.claude.com/docs/en/sub-agents - https://code.claude.com/docs/en/permission-modes - https://code.claude.com/docs/en/commands - https://code.claude.com/docs/en/remote-control - https://code.claude.com/docs/en/hooks#userpromptexpansion - https://code.claude.com/docs/en/headless#auto-approve-tools - https://code.claude.com/docs/en/permission-modes#which-mode-a-non-interactive-run-starts-in - https://code.claude.com/docs/en/routines - https://code.claude.com/docs/en/scheduled-tasks - https://code.claude.com/docs/en/changelog#2-1-307 - https://code.claude.com/docs/en/skills#work-on-claude-api-projects Modelos compatibles: Claude Fable 5.1, Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5