Le mois dernier, une équipe a confié à Claude Code le refactor du module paiement.
Sur le papier, impeccable :
- 18 fichiers touchés
- tests unitaires OK
- CI verte
En prod : callbacks webhook incorrects — six appels cachés hors liste.
Pas réservé à Claude. Cursor, Copilot, Windsurf : les agents AI coding lisent des fichiers, pas toujours les liens entre le code.
D'où CodeGraph en 2026 : graphe de connaissances local + MCP pour Claude Code et l'analyse d'impact avant edit. Et l'index sur Cloud Mac.
Pourquoi Claude Code oublie des modifications
Les recherches Claude Code missed edits visent la propagation des changements, pas le QI du modèle.
Claude Code lit, grep, édite, teste — mais dans un gros dépôt, les appels forment un graphe :
- Méthode publique renommée — conformance d'extension absente de la recherche.
- Champ de protocole — mocks, jobs, webhooks éparpillés.
- 40 fichiers en contexte — le 41e référent indirect peut manquer.
Build OK, tests OK, prod KO. Claude Code vs Cursor : UX différente, même trou d'impact.
Pourquoi Cursor Composer a besoin d'un graphe de code
Composer excelle en gros diff ; les API publiques et contrats paiement dépendent encore de la recherche — oublis Cursor identiques.
Le graphe formalise « qui appelle PaymentService ». Un index .codegraph partagé via codegraph install --target=claude,cursor.
Trois schémas
Illustrations originales de cet article.
PaymentService
Qu'est-ce que CodeGraph ?
CodeGraph indexe en local (tree-sitter) dans .codegraph/codegraph.db — une carte du dépôt pour les agents AI coding.
codegraph_impact, etc. Pour iOS/Swift, l'impact avant changement de Protocol bat le grep seul.
Quand les équipes adoptent CodeGraph par défaut
Pas nécessaire pour un script jetable. Signaux :
- Multi-packages ou targets Xcode, >10 fichiers par changement
- Incident « tests OK, staging trouve le webhook »
- Claude Code et Cursor sur le même monorepo — une liste partagée
Là, CodeGraph rejoint CI, revue de code et build macOS fixe dans la checklist AI coding.
MCP : faire appeler CodeGraph par Claude Code
Model Context Protocol — requêtes graphe en outils de session.
- Installer le CLI
codegraph install --target=claude,cursor --yescodegraph init -i- Règle
CLAUDE.md: impact avant API publique
Liste de fichiers via MCP avant refactor — webhooks inclus.
codegraph init -i codegraph install --target=claude,cursor --yes codegraph impact "PaymentService.charge" --depth 3
Gros dépôts : index CodeGraph sur Cloud Mac
Un codegraph index complet charge CPU/IO — souvent dizaines de minutes au-delà de 100k lignes.
Donc :
codegraph init -isur Cloud Mac- Même runner self-hosted que
xcodebuild - Agents locaux en lecture seule du graphe
Aligner graphe, build, tests — offres Cloud Mac.
Index à côté des builds
Indexer là où Xcode build évite un graphe d'hier pour un CI d'aujourd'hui — crucial en multi-target Swift.
RAG, grep, contexte géant : insuffisants seuls
| Approche | Fort | Angle mort |
|---|---|---|
| RAG vectoriel | Chunks similaires | Vrais appelants dissemblables |
| Grep | Littéral | Indirection, dispatch dynamique |
| Contexte 200K+ | Beaucoup de fichiers | Oublis, coût |
| CodeGraph | Impact symboles | Maintenance index |
CodeGraph → RAG → edit → tests.
Workflow Claude Code + CodeGraph
- Construire
.codegraph - Impact/MCP avant paiement/API
- Éditer, tester
- Mac mini + Claude Code
Installation
Tutoriel détaillé :
Claude Code oublie des edits — CodeGraph sur GitHub (2026)
Ici le pourquoi ; le lien le comment.
FAQ
CodeGraph vs Sourcegraph ?
Sourcegraph : recherche humaine. CodeGraph : agents AI coding, local, MCP.
Swift ?
Oui — iOS/macOS, SPM, Xcode ; impact avant Protocol.
Avec Claude Code ?
Oui — codegraph_impact en session.
MCP obligatoire ?
CLI seul possible ; mode agent → MCP.
En bref
Lit des fichiers, pas des relations.
Composer + graphe ?
Gros diff sans appelants indirects — index partagé.
Cloud Mac ?
Petit dépôt local ; gros Swift sur Cloud Mac.
- Voir aussi— Claude Code vs Cursor · Écosystème Claude Code
ZavCloud · Cloud Mac
Indexer CodeGraph sur Cloud Mac
Index, builds Xcode et MCP alignés.
Offres Cloud Mac