Análisis completo de la arquitectura del sistema Claude

Introducción

En septiembre de 2025, Anthropic cerró una ronda de financiamiento de $13B con una valoración de $183B, convirtiéndose en la cuarta empresa privada más grande del mundo. Su producto estrella, Claude Code, ha atraído a 115,000 desarrolladores activos desde su lanzamiento en febrero, procesando 195 millones de líneas de código por semana, con un crecimiento de usuarios del 300%.

Aún más interesante, el CEO de Anthropic, Dario Amodei, reveló: el 90% del código de Claude Code fue escrito por él mismo.

¿Cómo es posible?

¿Cómo puede un asistente de programación con IA "escribirse a sí mismo"? ¿Qué tiene de único su diseño arquitectónico que le permite asistir — e incluso reemplazar — a los desarrolladores humanos de manera tan eficiente?

La respuesta se encuentra en la arquitectura modular de Claude: MCP proporciona herramientas, Skills enseña cómo usarlas, Subagents ejecuta tareas en paralelo y Hooks garantiza el control determinístico — estos componentes trabajan en conjunto para dotar a Claude de la capacidad de "trabajar como un programador".

Este documento le ofrecerá una vista panorámica de toda la arquitectura — la función de cada componente, cómo colaboran entre sí y ejemplos de configuración para comenzar rápidamente. Los artículos posteriores profundizarán en los detalles de cada componente.

Panorama general de la arquitectura

El sistema Claude utiliza un diseño de arquitectura modular, donde los componentes se clasifican por función y trabajan como colaboradores complementarios en lugar de dependencias jerárquicas:

Concepto clave: Estos componentes son extensiones complementarias al mismo nivel, no dependencias jerárquicas — puede combinarlos libremente según sus necesidades:

Núcleo de ejecución

Agent SDK — Motor de ejecución

Agent SDK es el motor de ejecución central de todo el sistema Claude Agent, proporcionando:

• Bucle principal (Main Loop): El ciclo de trabajo central del Agent
• Gestión de contexto: Presupuesto de tokens, compresión automática (se activa al 92% de uso)
• Despacho de herramientas: Decide qué herramienta usar y cómo ejecutarla
• Sistema de permisos: Controla los permisos de acceso a las herramientas

El modelo operativo central del Agent es un simple ciclo de retroalimentación:

Recopilar contexto → Ejecutar acciones → Verificar trabajo → Repetir

Built-in Tools — Herramientas integradas

Claude Agent incluye más de 20 herramientas integradas, organizadas en tres categorías:

Estas herramientas están disponibles por defecto, sin necesidad de configuración adicional. Claude interactúa con la computadora a través de estas herramientas, de la misma manera que un programador utiliza un IDE.

Configuración y contexto

CLAUDE.md — Contexto persistente

Cada vez que se inicia una nueva conversación, es necesario repetir el contexto del proyecto, las convenciones de código, las normas arquitectónicas... CLAUDE.md permite configurar una vez y cargar automáticamente.

CLAUDE.md funciona como un README para IA — le indica a Claude los conocimientos previos, la forma de trabajo y las convenciones del proyecto.

Herencia jerárquica

Claude carga los archivos CLAUDE.md en el siguiente orden, donde los más específicos tienen mayor prioridad:

Enterprise (más baja)
    ↓
User (~/.claude/CLAUDE.md)
    ↓
Project (./CLAUDE.md)
    ↓
Module (./src/module/CLAUDE.md) (más alta)

Contenido recomendado

CLAUDE.md debe incluir la siguiente información esencial:

Principio clave: Mantenga la brevedad. CLAUDE.md se carga en cada conversación — un archivo demasiado extenso desperdicia tokens valiosos.

Empaquetado y distribución

Plugins — Unidades instalables

Las configuraciones de equipo están dispersas, son difíciles de compartir y de estandarizar. Cada persona tiene su propio conjunto de Skills, Commands, Hooks... ¿Cómo se unifica la gestión?

Plugins empaqueta Skills + Commands + Subagents + Hooks + MCP en unidades instalables, permitiendo la distribución con un solo clic y la estandarización del equipo.

Estructura de directorios

my-plugin/
├── .claude-plugin/
│   └── plugin.json     # Manifiesto del plugin (requerido)
├── commands/           # Slash Commands
├── agents/             # Subagents
├── skills/             # Skills
├── hooks/              # Configuración de Hooks
├── .mcp.json           # Configuración de MCP Server
└── README.md           # Documentación

Ejemplo de configuración

// plugin.json
{
  "name": "frontend-toolkit",
  "version": "1.0.0",
  "description": "Kit de herramientas de desarrollo frontend",
  "author": "Your Team"
}

# Métodos de instalación
claude plugin install github:your-org/your-plugin  # Desde GitHub
claude plugin install /path/to/plugin              # Desde local

Recursos relacionados

Capacidades de extensión (módulos complementarios)

Las capacidades de extensión del sistema Claude están compuestas por múltiples módulos complementarios, cada uno con su función específica, trabajando en sinergia:

MCP — Conectividad externa

Filosofía de diseño

En el enfoque tradicional, cada fuente de datos externa requiere una integración personalizada, lo que genera una pesadilla de integración N x M. MCP proporciona un protocolo estandarizado para lograr integrar una vez, usar en todas partes.

MCP (Model Context Protocol) fue diseñado como el puerto USB-C para aplicaciones de IA:

Patrón arquitectónico

┌─────────────────┐
│   MCP Host      │  (Claude Desktop, IDE, herramientas de IA)
│   (Main Agent)  │
└────────┬────────┘
         │ 1:N
    ┌────┴────┬────────┬────────┐
    │ Client  │ Client │ Client │  (Clientes de protocolo)
    └────┬────┴────┬───┴────┬───┘
         │         │        │
    ┌────┴────┐ ┌──┴───┐ ┌─┴────┐
    │ Server  │ │Server│ │Server│  (Exponen capacidades específicas)
    │ GitHub  │ │  DB  │ │ Slack│
    └─────────┘ └──────┘ └──────┘

Casos de uso: Conectar bases de datos, integrar servicios de terceros (GitHub, Slack, Notion), acceder a APIs privadas, procesamiento de flujos de datos en tiempo real.

Ejemplo de configuración

Cree .mcp.json en el directorio raíz del proyecto:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Commands — Flujos de trabajo manuales

Slash Commands proporcionan flujos de trabajo repetitivos de activación manual.

Ejemplo: Cree .claude/commands/review.md

Por favor, realice una revisión de código sobre los cambios actuales, enfocándose en:
1. Estilo y consistencia del código
2. Problemas de rendimiento potenciales
3. Vulnerabilidades de seguridad
4. Cobertura de pruebas

Luego escriba /review para activarlo.

Hooks — Control determinístico

Hooks es el núcleo del control determinístico — ciertas operaciones deben ejecutarse y no pueden depender del juicio del LLM.

Ejemplo de configuración

Formateo automático de archivos TypeScript:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | { read f; [[ $f == *.ts ]] && npx prettier --write \"$f\"; }"
          }
        ]
      }
    ]
  }
}

En la práctica: Bucle autónomo

Ralph Wiggum es un plugin oficial de Anthropic que utiliza el Stop hook para implementar un ciclo de iteración autónomo:

/ralph-loop "Implementar una API de TODO con CRUD y pruebas" --max-iterations 20

Cómo funciona: El Stop hook intercepta la salida de Claude, reinyecta el prompt original y continúa iterando hasta que la tarea se complete o se alcance el número máximo de iteraciones.

Escenarios adecuados: Tareas que requieren múltiples iteraciones (pasar pruebas, refactorización de código), tareas con medios de verificación automatizada.

Subagents — Delegación de tareas y ejecución paralela

Filosofía de diseño

Un Agent único enfrenta desafíos: ventana de contexto limitada, imposibilidad de paralelizar y responsabilidades poco claras. Subagents adopta el patrón arquitectónico Orchestrator-Worker para resolver estos problemas:

Main Agent (Orchestrator)
    ├── Analizar la solicitud del usuario
    ├── Formular el plan
    ├── Descomponer las tareas
    └── Generar subagentes especializados
         ↓
    ┌────────┬────────┬────────┐
    │ Sub 1  │ Sub 2  │ Sub 3  │  (Workers - ejecución paralela)
    │ Código │ Pruebas│  Docs  │
    └────────┴────────┴────────┘
         ↓
    Consolidar resultados → El agente principal sintetiza la salida

Características principales

Datos de rendimiento: Los sistemas multiagente superan a los de agente único en un 90.2%, y la paralelización puede reducir el tiempo de investigación en un 90% (el consumo de tokens es aproximadamente 15x, pero vale la pena para tareas complejas).

Ejemplo de configuración

Cree un archivo Markdown en .claude/agents/:

---
name: Code Reviewer
description: Un subagente especializado en revisión de código
tools:
  - Read
  - Grep
  - Glob
---

Usted es un experto senior en revisión de código. Enfóquese en:
1. Calidad del código y mantenibilidad
2. Bugs potenciales y casos límite
3. Oportunidades de optimización de rendimiento
4. Vulnerabilidades de seguridad

Skills — Conocimiento procedimental

Filosofía de diseño

Skills son manuales de trabajo reutilizables para IA — paquetes modulares de conocimiento que Claude puede cargar dinámicamente según la necesidad. El principio de diseño central es la Divulgación progresiva (Progressive Disclosure):

📚 Manual de Skills
│
├─ 📋 Índice ─────────────── [Capa de metadatos] Precargado al inicio (~30-50 tokens)
│   name: "weekly-report"
│   description: "Generar informes semanales estandarizados"
│
├─ 📖 Contenido principal ── [Capa de documento central] Se carga cuando es relevante (~cientos a miles de tokens)
│   # Weekly Report Generator
│   ## Instructions
│   Generar informes semanales siguiendo esta estructura...
│
└─ 📎 Apéndice ──────────── [Capa de recursos de referencia] Se carga cuando es necesario
    references/
    ├── template.xlsx
    └── examples/

MCP vs Skills: MCP otorga a Claude la capacidad de acceder a herramientas (WHAT), mientras que Skills le enseña a Claude cómo usar esas herramientas de manera efectiva (HOW).

Ventajas principales

Ejemplo de configuración

Cree un directorio en .claude/skills/:

my-skill/
├── SKILL.md          # Instrucciones centrales (requerido)
├── scripts/          # Scripts ejecutables (opcional)
└── references/       # Materiales de referencia (opcional)

Estructura central de SKILL.md:

---
name: code-review                        # Nombre del Skill
description: Revisión de código para calidad y seguridad    # Descripción breve (usada para coincidencia automática)
---

# Code Review Skill

## Instructions
[Instrucciones detalladas paso a paso...]

## Output Format
[Requisitos del formato de salida...]

Punto clave: La description en el frontmatter se utiliza para la coincidencia automática — manténgala concisa y precisa.

Referencias oficiales

Filosofía de diseño

Documentación oficial

Análisis en profundidad

Lecturas adicionales

Si desea profundizar en los conceptos y la práctica de Skills, puede consultar:

• ¿Qué son los Claude Skills? — Explicación detallada de los principios fundamentales de Skills
• Guía práctica de Claude Skills — Cree su primer Skill paso a paso
• Guía completa de Claude Subagent — Uso y personalización de subagentes
• Análisis profundo de GSD — Un sistema de programación con IA basado en ingeniería de contexto
• Mis mejores prácticas de Claude Code — Consejos de uso diario de Claude Code