OnlyTerp/UltraCode-Shim

解決的問題

UltraCode-Shim 是一個迴路代理，允許使用者使用任何已付費的 LLM 後端來執行 Claude Code 的「UltraCode」模式（高投入、深度推理利用），而不必被鎖定在 Anthropic 的標準模型上。它防止 Claude Code 動態工作流程中的背景「工作代理」預設回退到標準模型，確保使用者選擇的模型從頭到尾全程使用。

工作原理

此專案作為 Claude Code CLI 與 LLM API 之間的代理。它攔截請求，並為每個請求添加「UltraCode 封裝」（特定參數如 effort=xhigh 和自適應思考）。

關鍵機制包括：

• 協調器與工作員分離：允許使用者定義兩個獨立的模型：一個用於主互動循環（協調器），另一個用於背景子代理（工作員），也可對兩者使用同一模型。
• 自動路由：可選功能，透過廉價分類模型根據任務難度對候選後端進行評分，將簡單任務路由至低成本模型，將複雜任務升級至更強模型。
• 可靠性層：包含對常見 API 失敗的加固措施，如自動重試空回合、超時停滯流、修復嚴格後端的工具呼叫序列。
• 相容性：支援多種路由類型，包括 OpenAI 相容端點、Codex OAuth 和 Cursor Agent。

適用對象

希望降低成本、使用不同模型提供者（如 DeepSeek、OpenRouter 或透過 Ollama 使用本地模型）或透過分離協調器與工作員角色來優化效能的 Claude Code 使用者。

亮點

• 模型彈性：可使用任何 OpenAI 相容後端或特定整合（如透過 Codex 使用 GPT-5.5）。
• 標準模型零設定：自動包含並更新真實 Claude 模型清單。
• 僅使用標準程式庫：使用 Python 3.8+ 編寫，僅依賴標準程式庫，無需 pip install。
• 智慧路由：自動選擇滿足特定任務品質閾值的最具成本效益的模型。
• 非破壞性：不修改全域 Claude Code 安裝或憑證。