Pourquoi Claude Code oublie-t-il des modifications ?CodeGraph répond

Notes AI coding  ·  2026.06.02  ·  ~14 min

Claude Code missed edits; CodeGraph and MCP query a local code knowledge graph

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 incorrectssix 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.

18
fichiers modifiés, risque
MCP
Claude Code / Cursor
1
index .codegraph

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.

Fig. 1 · Référents avant changement de <code>PaymentService</code>
Fig. 1 · Référents avant changement de PaymentService
Fig. 2 · Agent : Prompt→Search→Edit
Fig. 2 · Agent : Prompt→Search→Edit
Fig. 3 · Agent CodeGraph
Fig. 3 · Agent CodeGraph

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.

  1. Installer le CLI
  2. codegraph install --target=claude,cursor --yes
  3. codegraph init -i
  4. Règle CLAUDE.md : impact avant API publique

Liste de fichiers via MCP avant refactor — webhooks inclus.

Commandes minimales
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 -i sur 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

ApprocheFortAngle mort
RAG vectorielChunks similairesVrais appelants dissemblables
GrepLittéralIndirection, dispatch dynamique
Contexte 200K+Beaucoup de fichiersOublis, coût
CodeGraphImpact symbolesMaintenance index

CodeGraph → RAG → edit → tests.

Workflow Claude Code + CodeGraph

  1. Construire .codegraph
  2. Impact/MCP avant paiement/API
  3. Éditer, tester
  4. 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.

ZavCloud · Cloud Mac

Indexer CodeGraph sur Cloud Mac

Index, builds Xcode et MCP alignés.

Offres Cloud Mac
Cloud MacIndex CodeGraph