claude-code/claude-zh/rules/common/performance.md

性能優化 (Performance Optimization)

模型選擇策略

Haiku 4.5 (具備 Sonnet 90% 的能力，節省 3 倍成本)：

• 需要頻繁呼叫的輕量級 Agent。
• 結對編程 (Pair programming) 與程式碼生成。
• 多 Agent 系統中的工作者 Agent。

Sonnet 4.6 (最佳編碼模型)：

• 主要開發工作。
• 編排多 Agent 工作流。
• 複雜的編碼任務。

Opus 4.5 (深度推理)：

• 複雜的架構決策。
• 最高的推理需求。
• 研究與分析任務。

上下文視窗管理

針對以下情況，避免使用上下文視窗的最後 20% 空間：

• 大規模重構。
• 跨越多個檔案的功能實作。
• 偵錯複雜的互動。

後續對上下文敏感度較低的任務：

• 單一檔案編輯。
• 獨立工具 (Utility) 建立。
• 文件更新。
• 簡單的錯誤修復。

擴展思考 (Extended Thinking) + 規劃模式 (Plan Mode)

擴展思考預設為啟用，保留最多 31,999 個 token 用於內部推理。

透過以下方式控制擴展思考：

• 切換：Option+T (macOS) / Alt+T (Windows/Linux)。
• 配置：在 ~/.claude/settings.json 中設定 alwaysThinkingEnabled。
• 預算上限：export MAX_THINKING_TOKENS=10000。
• 詳細模式：Ctrl+O 以查看思考過程輸出。

針對需要深度推理的複雜任務：

1. 確保已啟用擴展思考（預設開啟）。
2. 啟動 規劃模式 (Plan Mode) 以獲得結構化的方法。
3. 進行多輪批評 (Critique rounds) 以達成透徹的分析。
4. 使用分工明確的子 Agent 來獲得多元觀點。

建置疑難排解

若建置失敗：

1. 使用 build-error-resolver agent。
2. 分析錯誤訊息。
3. 採用增量修復。
4. 每次修復後進行驗證。