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 安装或凭据。