Analyse de l'Architecture du Code Claude à partir des Source Maps Fuités

Pile technique et architecture

Le package Claude Code publié sur npm le 31 mars 2026 incluait des fichiers .map qui ont révélé le code source TypeScript complet. Le codebase comprend environ 1 900 fichiers avec plus de 512 000 lignes de TypeScript.

Technologies principales

• Runtime : Bun
• Langage : TypeScript (mode strict)
• Interface terminal : React + Ink (React pour CLI)
• Analyse CLI : Commander.js avec typages supplémentaires
• Validation de schéma : Zod v4
• Recherche de code : ripgrep via GrepTool
• Protocoles : SDK MCP, LSP (vscode-jsonrpc)
• API : SDK Anthropic
• Télémétrie : OpenTelemetry + gRPC (chargement différé, ~400KB + 700KB)
• Fonctionnalités conditionnelles : GrowthBook
• Authentification : OAuth 2.0, JWT, macOS Keychain
• Gestion d'état : Zustand (store basé sur React)

Points forts de la structure des répertoires

Le répertoire src/ contient :

• main.tsx - Point d'entrée avec CLI Commander.js + rendu React/Ink
• commands.ts - Registre de commandes avec 100+ commandes
• tools.ts - Registre d'outils avec 38+ outils
• Tool.ts - Définitions de types d'outils
• QueryEngine.ts - Moteur de requêtes LLM (~46K lignes)
• query.ts - Boucle de requête principale (~1 729 lignes)
• context.ts - Collecte de contexte système/utilisateur
• cost-tracker.ts - Suivi des coûts en tokens
• commands/ - Implémentations de commandes slash (100+)
• tools/ - Implémentations d'outils (38+)
• components/ - Composants d'interface Ink (~140)
• hooks/ - Hooks React + hooks de permissions
• services/ - Intégrations de services externes incluant API, MCP, LSP, compression de contexte, extraction de mémoire et analytiques
• constants/ - Invites système + constantes
• bridge/ - Pont d'intégration IDE
• coordinator/ - Coordinateur multi-agents
• plugins/ - Système de plugins
• skills/ - Système de compétences
• memdir/ - Système de mémoire persistante
• tasks/ - Système de gestion de tâches
• state/ - Gestion d'état
• remote/ - Sessions distantes
• server/ - Mode serveur
• vim/ - Mode Vim avec machine à états complète
• voice/ - Entrée vocale
• keybindings/ - Système de raccourcis clavier
• screens/ - Interface plein écran (Doctor, REPL, Resume)
• schemas/ - Schémas de configuration Zod
• migrations/ - Migrations de configuration
• query/ - Sous-modules du pipeline de requêtes
• outputStyles/ - Styles de sortie
• buddy/ - Sprite compagnon (easter egg)

Flux de données principal

Le système suit ce modèle de flux de données :

1. Entrée utilisateur (terminal / IDE / distant)
2. main.tsx → Analyse Commander.js
3. REPL.tsx (boucle d'interaction principale)
4. QueryEngine.submitMessage() ← cycle de vie de session
5. L'étape de préparation des messages inclut :
   • applyToolResultBudget() - limite de taille des résultats
   • snipCompact() - compactage d'extraits
   • microCompact() - micro compactage
   • contextCollapse() - effondrement de contexte
   • autoCompact() - compactage automatique

Cette analyse est basée sur le code source divulgué qui donne un aperçu de la manière dont un agent de codage IA en production gère le contexte, les outils et la coordination multi-agents.