nadimtuhin/claude-token-optimizer

解決的問題

Claude Code 常在啟動時載入過多的文件、會話筆記與任務歷史，消耗了大量上下文空間。本專案提供一套系統，將專案文件重新組織，使 Claude 僅在啟動時載入必要檔案，釋放數千個 token 用於實際程式碼。

作法

此工具透過特定的檔案階層結構與 .claudeignore 檔案，實作結構化文件方法，防止自動載入不必要的文件。它將單一龐大的文件取代為四個核心檔案：CLAUDE.md、COMMON_MISTAKES.md、QUICK_START.md 與 ARCHITECTURE_MAP.md。

主要功能包括：

• 框架感知初始化：cto init 自動偵測專案框架（例如 Next.js、Django、Go），並套用相關最佳實務與常見錯誤。
• 令牌測量：cto measure 可估算自動載入檔案的令牌成本。
• 維護工具：cto compress 與 cto prune 使用決定性規則，縮小 CLAUDE.md 的大小。
• 上下文注入鈎子：可整合至 Claude Code 鈎子的 Shell 腳本，根據使用者提示，動態從 docs/learnings/ 載入特定主題文件，確保未使用檔案的零令牌成本。

適用對象

希望將自動載入文件改為按需載入系統，以優化上下文空間並減少令牌使用的 Claude Code 使用者。

特色

• 顯著減少令牌使用：典型情況下啟動時令牌使用量減少 83-87%。
• 框架支援：為 13 個常見框架提供預設模式。
• CI 友好審計：cto audit 提供文件結構的健康檢查，並輸出機器可讀的 JSON 格式，適用於 CI/CD 流水線。
• 動態上下文注入：鈎子可將使用者提示與 docs/learnings/ 中的檔案名匹配，僅在需要時注入上下文。