Colección de informes de investigación independientes sobre Claude Code v2.1.88, centrados en arquitectura, bucle de agente, modelo de permisos, prompt de sistema, integración MCP y gestión de contexto.
Este repositorio se mantiene deliberadamente como documentación solamente. Contiene análisis y comentario técnico, no una distribución ejecutable de código fuente ni un build de CLI soportado.
Idioma: English | 中文 | 日本語 | 한국어 | Español
Claude Code es uno de los agentes de programación con IA más sofisticados en producción. Estos informes buscan hacer más estudiables sus mecanismos internos.
- Desarrolladores de agentes pueden estudiar patrones de orquestación de herramientas, gestión de contexto y recuperación
- Investigadores de seguridad pueden observar telemetría, mecanismos de control remoto y límites de permisos
- Investigadores de IA pueden analizar ensamblaje de prompts, enrutamiento de modelos y diseño del bucle de agente
- Ingenieros pueden usar estos informes como referencia para sistemas de agentes basados en CLI
Estos informes se basan en análisis técnico de un paquete npm distribuido públicamente y se presentan como investigación y comentario.
| # | Informe | Qué Aprenderás | Enlace |
|---|---|---|---|
| 06 | Inmersión en el Bucle de Agente | Análisis de query.ts — flujo de mensajes, ejecución de herramientas en streaming, auto-compactación y recuperación |
Leer → |
| 07 | Arquitectura del Sistema de Herramientas | Cómo se registran, validan y ejecutan en paralelo más de 40 herramientas | Leer → |
| 08 | Modelo de Permisos y Seguridad | Listas blancas/negras, auto-aprobación, modo YOLO e integración con sandbox | Leer → |
| 09 | Ingeniería de Prompts de Sistema | Cómo se ensamblan 15,000+ tokens desde más de 20 partes | Leer → |
| 10 | Integración MCP y Sistema de Plugins | Implementación del cliente Model Context Protocol | Leer → |
| 11 | Gestión de Ventana de Contexto | Auto-compactación, compresión de conversación y conteo de tokens | Leer → |
| 12 | Gestión de Estado y Persistencia | Estado de sesión, historial y sistema de memoria | Leer → |
| # | Informe | Qué Aprenderás | Enlace |
|---|---|---|---|
| 01 | Telemetría y Recolección de Datos | Pipeline dual de análisis y huella del entorno | Leer → |
| 02 | Funciones Ocultas y Nombres en Código | Codenames, feature flags y diferencias entre builds internos y externos | Leer → |
| 03 | Modo Encubierto | Cómo se ocultan señales de autoría por IA en repositorios públicos | Leer → |
| 04 | Control Remoto e Interruptores de Emergencia | Configuración del lado servidor, flags y controles de emergencia | Leer → |
| 05 | Hoja de Ruta Futura | KAIROS, Numbat, pistas sobre modelos futuros y herramientas no publicadas | Leer → |
Estas cifras se refieren a la instantánea de código de Claude Code analizada, no al contenido de este repositorio documental.
| Métrica | Valor |
|---|---|
| Archivos TypeScript | 1,884 |
| Líneas totales de código | 512,664 |
| Archivo más grande | query.ts — 785KB |
| Herramientas integradas | 40+ |
| Comandos slash | 80+ |
| Dependencias npm | 192 paquetes |
| Módulos Feature-Gated | 108 |
| Modelo de runtime | Paquete construido con Bun, orientado a Node.js |
┌─────────────────┐
│ User Input │
│ (CLI / SDK / IDE)│
└────────┬────────┘
│
┌──────────────▼──────────────┐
│ Entry Layer │
│ cli.tsx → main.tsx → REPL │
│ └→ QueryEngine │
└──────────────┬──────────────┘
│
┌────────────────────▼────────────────────┐
│ Query Engine Core │
│ System Prompt Assembly / Agent Loop │
└────────────────────┬────────────────────┘
│
┌─────────────────────────▼─────────────────────────┐
│ Tool Layer (40+ tools) │
└─────────────────────────────────────────────────────┘
La estructura de código analizada en los informes se puede resumir así:
src/
├── main.tsx
├── QueryEngine.ts
├── query.ts
├── Tool.ts
├── Task.ts
├── tools.ts
├── commands.ts
├── context.ts
├── cost-tracker.ts
├── setup.ts
├── bridge/
├── cli/
├── commands/
├── components/
├── entrypoints/
├── hooks/
├── services/
├── state/
├── tasks/
├── tools/
├── types/
├── utils/
└── vendor/
Este repositorio en sí permanece como archivo documental:
docs/
├── en/
└── zh/
README.md
README_CN.md
README_JA.md
README_KO.md
README_ES.md
QUICKSTART.md
- Leer los informes dentro de
docs/ - Compartir enlaces a informes individuales
- Tratar este repositorio como un archivo documental, no como distribución de software
Consulta QUICKSTART.md para una guía mínima de lectura.
Este proyecto constituye investigación, comentario y análisis educativo sobre un paquete de software distribuido públicamente (el paquete npm @anthropic-ai/claude-code).
Los informes en docs/ son análisis y comentarios originales del mantenedor. Si tienes alguna inquietud de derechos, abre un issue para revisión.