把公開 repo 接進 Claude Code 的省 token 做法：Repowise 免費版 MCP 實作與四個上限（2026 實查）

用 Claude Code 或 Cursor 改一份不熟的程式碼時，最花錢的往往不是推理，是代理自己 grep、開檔、再開一次檔去重建它本來就該被交到手上的上下文。

Repowise 的做法是：把 repo 索引一次，透過 MCP 交給代理。 官方指南列出的基準數字是：

• 載入上下文用 2,391 個 token，而不是 64,039 個（少 96%，約 27 倍）
• 檔案讀取次數少 89%（配對基準、答案品質相當）
• 工具呼叫次數少 70%（flask48 與 sklearn48 基準組）
• 十個任務型 MCP 工具走同一個端點，以 AGPL-3.0 開源

而且公開 repo 用免費版就能做。這篇整理實際流程與免費版的界線，查核日 2026-09-07。

一、它解決的問題（官方說法）

官方指南把問題講得很清楚：逐個實體的工具會逼模型自己做檢索——搜尋、開啟、捲動、重來。造成三個成本：

1. 上下文破碎：代理看到的是檔案片段，永遠拼不出全貌。
2. token 成本疊加：單一任務的原始探索，光是載入上下文就可能花掉 64,039 個 token，還沒開始推理。
3. 重試會加倍：一次沒 grep 到，就是再一次搜尋、再開一次檔、再捲一次。
4. 沒有加值資訊：原始檔案讀取不帶擁有權、歷史、風險，也不帶「為什麼」。

二、四個步驟（官方流程表）

第四步是這個設計裡最值得學的一點：它不假裝索引永遠正確，而是把「新鮮度」當成回應的一部分交給代理判斷。 快取型工具最常見的失敗就是拿舊資料當真相，這個設計把那個風險顯性化了。

實際的端點註冊方式依你用的客戶端而定（Claude Code、Cursor、Cline、Codex 各自的 MCP 設定位置不同），官方文件有對應說明；核心概念是只需要一個 URL。

三、免費版的四個實際上限

如果你打算用免費版接公開 repo，這四條要先知道（官方定價頁明列）：

1. 公開 repo 索引上限 250 MB。 超過就得升級（Pro 是 5 GB）。
2. 500 次 commit 分析上限。 免費版不含完整 commit 歷史，所以 git 情報（熱點、擁有權、bus factor）是建立在最近 500 個 commit 上。
3. 每月 10 次 AI 回答。 這是最硬的一條——確定性功能（健康度評分、相依圖、熱點、死碼、擁有權）不吃這個額度，只有真正的 AI 問答會扣。
4. 沒有推送觸發自動同步。 免費版是每週自動更新（健康度徽章同步刷新），不是每次 push 就重建。

另外有一條容易誤會的：低於 1,000 顆星的 repo，免費版不提供「書面解說」。也就是說你自己的小專案拿得到索引、圖表與搜尋，但拿不到自動撰寫的說明文章。

四、怎麼判斷值不值得從免費版升級

用這三個問題判斷，不必猜：

• 每月 AI 問答會不會超過 10 次？ 會的話，Pro 的 US$15 裡有 US$5 是模型額度，實質軟體費 US$10。
• 要不要接私有 repo？ 免費版只支援公開 repo，私有 repo 索引是 Pro 才有（透過 GitHub App）。
• 需不需要 push 後立刻更新？ 每週更新對穩定專案夠用，對高頻改動的專案不夠。

完整方案拆解見 Repowise US$15 方案裡有 US$5 是模型額度。

五、兩個使用上的提醒

1. 省 token 不等於省全部的錢。 那 96% 是「載入上下文」這一段的節省，推理本身該花的還是要花。真正的效益在長對話——代理不必每次重新 grep。
2. 索引是暫時處理、不保存原始碼（官方明述），而且方案可自架。但如果你的公司對「原始碼經過第三方服務」有明文規定，自架路線（AGPL-3.0）才是符合規定的走法，不是託管版。

本文依據 Repowise 官方 AI Context & MCP 指南（作者 Raghav Chamadiya，官方標示 2026 年 7 月更新）與 官方定價頁 於 2026-09-07 直讀整理。所有基準數字（96%、89%、70%、2,391 vs 64,039）均為官方指南自行公布之配對基準結果，本站未獨立重跑。方案摘要另見 Repowise 工具頁。