用 Claude Code 處理大型專案的開發者，大概都碰過類似的痛點：程式庫規模一大，每次叫 AI 探索結構都得等很久，檔案掃個沒完，工具呼叫疊得像山一樣高，token 消耗得飛快，活還沒幹多少，成本倒是先漲了一截。
有個開源工具 CodeGraph 換了一種思路：它會事先幫你的程式庫建立一張語意知識圖譜，讓 Claude Code 直接查圖，不用再逐個檔案掃描。
官方在六個真實的開源程式庫上做了對比測試，涵蓋 TypeScript、Python、Rust、Java、Swift、C++ 等多種語言的專案，包括 VS Code、Swift 編譯器這類超大型程式庫。結果是，平均減少了 92% 的工具呼叫，探索速度提升了 71%。
具體到單一專案的提升就更直觀了：
- VS Code（4002個TypeScript檔案）：沒用 CodeGraph 時要 52 次工具呼叫、花 1 分 37 秒完成溯源；用了之後只需 3 次呼叫、17 秒搞定，速度加快了 82%。
- Swift 編譯器（25874個Swift/C++檔案）：沒用 CodeGraph 時要 37 次呼叫、花 2 分 8 秒回答問題；用了之後只需 6 次呼叫、35 秒完成，過程中完全零檔案讀取。
- 跨語言的 Claude Code 專案（Python+Rust）：沒用 CodeGraph 時要 40 次呼叫、花 1 分 8 秒；用了之後只需 3 次呼叫、39 秒完成，跨語言的呼叫鏈可以直接辨識。
所有測試都是使用 Claude Opus 4.6（1M 上下文）及相同的查詢語句來進行，結果可供重現。舉例來說，測 VS Code 的問題是「擴充主機與主行程的通訊邏輯」，測 Excalidraw 的問題是「協作編輯與即時同步的實作原理」，測 Alamofire 的問題是「從 Session.request() 到 URLSession 層的請求流轉路徑」。
CodeGraph 能自動辨識函式呼叫鏈、類別繼承關係、模組引用，在改程式碼之前還能做影響範圍分析，避免改一處卻炸一片的慘劇。
目前支援 19 種主流程式語言，涵蓋 TypeScript、Python、Go、Rust、Java、C++、Swift、Dart、Svelte、Vue 等；同時還能辨識 13 種前後端框架的路由規則，直接把 URL 路徑和對應的處理函式關聯起來。
所有資料都存在本機的 SQLite 資料庫裡，不會上傳到任何外部服務，也不需要額外的 API 金鑰。安裝完成後會自動監聽檔案修改，存檔時就自動增量同步圖譜，基本上不太需要額外維護。
安裝設定只要三步驟：
- 執行安裝命令：
npx @colbymchenry/codegraph
互動式安裝程式會自動完成全域安裝、設定 Claude Code 的 MCP 服務及權限等操作。 - 重啟 Claude Code，載入 MCP 服務。
- 進入目標專案目錄，執行初始化命令：
codegraph init -i
初始化完成後，Claude Code 一旦偵測到專案下的 .codegraph 目錄，就會自動呼叫 CodeGraph 的工具來完成程式碼探索，開發者不需要額外向 AI 下指令。
有用戶提問這款工具是否僅支援 Claude Code，目前官方只做了 Claude Code 的配接，暫時還沒有相容其他 AI 編碼工具。也有用戶關心評測數據的可信度，所有跑測細節、測試環境、查詢語句、結果數據都已經在開源儲存庫公開，可以自己重現。
還有用戶回報索引速度慢的問題，官方也給出了解決方案：如果是用到 WASM 版本的 SQLite，效能會比原生版本低五到十倍，只要安裝對應作業系統的 C 編譯工具，再重新編譯 better-sqlite3，就能切換到原生後端，大幅提升索引速度。
專案開源位址：https://github.com/colbymchenry/codegraph，很適合經常使用 Claude Code 處理大型程式庫、做重構的開發者，既省時間也省 token。