Análisis de la Arquitectura de Código de Claude a partir de Mapas de Fuente Filtrados

Pila Técnica y Arquitectura

El paquete de Claude Code publicado en npm el 31 de marzo de 2026 incluyó archivos .map que revelaron el código fuente completo de TypeScript. El código base consta de aproximadamente 1,900 archivos con más de 512,000 líneas de TypeScript.

Tecnologías Principales

• Entorno de ejecución: Bun
• Lenguaje: TypeScript (modo estricto)
• Interfaz de terminal: React + Ink (React para CLI)
• Análisis de CLI: Commander.js con tipados adicionales
• Validación de esquemas: Zod v4
• Búsqueda de código: ripgrep mediante GrepTool
• Protocolos: SDK MCP, LSP (vscode-jsonrpc)
• API: SDK de Anthropic
• Telemetría: OpenTelemetry + gRPC (carga diferida, ~400KB + 700KB)
• Banderas de características: GrowthBook
• Autenticación: OAuth 2.0, JWT, macOS Keychain
• Gestión de estado: Zustand (almacén basado en React)

Destacados de la Estructura de Directorios

El directorio src/ contiene:

• main.tsx - Punto de entrada con CLI Commander.js + renderizado React/Ink
• commands.ts - Registro de comandos con 100+ comandos
• tools.ts - Registro de herramientas con 38+ herramientas
• Tool.ts - Definiciones de tipos de herramientas
• QueryEngine.ts - Motor de consultas LLM (~46K líneas)
• query.ts - Bucle principal de consultas (~1,729 líneas)
• context.ts - Recopilación de contexto del sistema/usuario
• cost-tracker.ts - Seguimiento de costos de tokens
• commands/ - Implementaciones de comandos de barra (100+)
• tools/ - Implementaciones de herramientas (38+)
• components/ - Componentes de interfaz Ink (~140)
• hooks/ - Hooks de React + hooks de permisos
• services/ - Integraciones de servicios externos incluyendo API, MCP, LSP, compresión de contexto, extracción de memoria y análisis
• constants/ - Indicaciones del sistema + constantes
• bridge/ - Puente de integración IDE
• coordinator/ - Coordinador multiagente
• plugins/ - Sistema de plugins
• skills/ - Sistema de habilidades
• memdir/ - Sistema de memoria persistente
• tasks/ - Sistema de gestión de tareas
• state/ - Gestión de estado
• remote/ - Sesiones remotas
• server/ - Modo servidor
• vim/ - Modo Vim con máquina de estados completa
• voice/ - Entrada de voz
• keybindings/ - Sistema de atajos de teclado
• screens/ - Interfaz de pantalla completa (Doctor, REPL, Resume)
• schemas/ - Esquemas de configuración Zod
• migrations/ - Migraciones de configuración
• query/ - Submódulos del pipeline de consultas
• outputStyles/ - Estilos de salida
• buddy/ - Sprite compañero (huevo de pascua)

Flujo de Datos Principal

El sistema sigue este patrón de flujo de datos:

1. Entrada del usuario (terminal / IDE / remoto)
2. main.tsx → Análisis de Commander.js
3. REPL.tsx (bucle principal de interacción)
4. QueryEngine.submitMessage() ← ciclo de vida de sesión
5. La etapa de preparación de mensajes incluye:
   • applyToolResultBudget() - límite de tamaño de resultados
   • snipCompact() - compactación de fragmentos
   • microCompact() - micro compactación
   • contextCollapse() - colapso de contexto
   • autoCompact() - compactación automática

Este análisis se basa en el código fuente filtrado que proporciona información sobre cómo un agente de codificación de IA en producción gestiona el contexto, las herramientas y la coordinación multiagente.