通过 Claude API 不限量使用 Roo Code

Roo Code 是一款功能强大的 VS Code 智能体编程扩展，它将不同职责划分为独立的工作模式：架构（Architect）、编码（Code）、调试（Debug）和问答（Ask），每种模式都可以单独配置模型、温度和提供商设置。其 Orchestrator 功能会创建子任务，大幅增加 API 消耗。将 Roo Code 连接到固定费率、无限用量的 Claude 网关后，你可以为架构模式分配 Opus，为编码模式分配 Sonnet，无需再担心编排工作流带来的不断叠加的成本。

Roo Code 如何成倍增加 API 消耗

Roo Code 的架构与简单的聊天式 AI 编辑器有着根本区别。每种工作模式（Architect、Code、Debug、Ask）都维护自己的上下文，并且可以分配不同的模型。启用 Orchestrator 模式时，它会将复杂任务拆解为子任务，并将每个子任务委派给合适的模式，这实际上会创建多个并行对话，每个对话都独立消耗自己的 token 预算。

一个由 Orchestrator 驱动的任务，例如“重构身份验证模块”，可能会创建一个 Architect 子任务来规划新结构、三个 Code 子任务来实现不同组件，以及一个 Debug 子任务来验证结果。每个子任务都携带自己的系统提示词、工具定义和对话历史。总 token 消耗并非简单相加，而是成倍增长，因为每个子任务都会从头开始，并注入完整上下文。

Roo Code 仅使用原生工具调用，这进一步增加了消耗。某些智能体会在原生调用失败时回退到基于 XML 的工具调用，而 Roo Code 要求 API 支持原生函数调用。每次工具调用（读取文件、写入文件、执行终端命令）都是一组结构化的工具调用与响应，为每次交互增加额外开销。按模式分配模型、Orchestrator 子任务和原生工具调用相结合，使 Roo Code 成为 VS Code 生态中 API 消耗最大的工具之一。

设置 API 配置方案

Roo Code 使用 API 配置方案来组织提供商设置。每个方案包含提供商类型、基础 URL、API 密钥、模型标识符，以及温度和思考预算等可选参数。在 VS Code 中打开 Roo Code 设置面板，进入“API 配置”。点击“创建新方案”开始配置。

如果通过 Anthropic 提供商接入，请将“提供商”设置为 Anthropic，将“基础 URL”设置为 https://unlimited.aiprimetech.io（仅填写根主机地址，不带 /v1，Anthropic SDK 会自动附加路径），然后粘贴你的 AI Prime Tech Unlimited 密钥。选择模型：均衡方案使用 claude-sonnet-4-5，追求最强推理能力则使用 claude-opus-4-6。根据你对确定性与创造性的偏好，将温度设置在 0 到 1 之间。

为不同场景创建多个方案：使用 Haiku 的快速方案用于简短提问，使用 Sonnet 的标准方案用于日常编程，使用 Opus 的高性能方案用于架构决策。为它们设置清晰的名称，例如“Unlimited-Sonnet”和“Unlimited-Opus”，因为下一步你会将这些方案分配给特定模式。

按模式分配模型的策略

对于无限用量用户，Roo Code 最出色的功能是按模式分配模型。在设置中，每种模式（Architect、Code、Debug、Ask）都有一个下拉菜单，用于选择其使用的 API 配置方案。在无限用量方案下，最优策略是大胆配置：将 Opus 分配给最需要深度推理的 Architect 和 Debug 模式，将 Sonnet 分配给更看重速度和处理量的 Code 和 Ask 模式。

Architect 模式会在执行前规划复杂变更。Opus 在分析系统整体影响、依赖链和架构模式方面的出色推理能力，对这一模式帮助极大。Debug 模式同样受益于 Opus，因为诊断错误往往需要同时考虑多种假设，并沿执行路径进行推理。

Code 模式负责实际的文件编辑，也是调用最频繁的模式。Sonnet 的速度足以保持快速反馈，同时仍能生成高质量代码。Ask 模式用于快速提问和解释，Sonnet 能高效处理这些任务。在无限用量方案下，所有模式都使用 Opus 不会增加成本，但延迟差异对交互式工作流仍有影响。这种分配方式兼顾了两方面的优势：在关键环节进行深度推理，在需要速度时快速响应。

Orchestrator 与 Boomerang 子任务

Orchestrator 模式（有时称为 Boomerang）是 Roo Code 的任务拆解引擎。当你在 Orchestrator 模式中描述一个复杂任务时，它会将工作拆解成独立的子任务，并将每个子任务委派给合适的模式。子任务的结果会像“回旋镖”一样返回 Orchestrator，由它汇总并决定下一步。

每个子任务都在自己的对话上下文中运行，并拥有独立的 token 预算。这意味着一个 Orchestrator 任务可能会创建五个独立的 Claude 对话，每个对话各自消耗数万 token。按 token 计费时，为一个中等复杂度的功能运行 Orchestrator 会话，费用很容易达到数美元。在无限用量方案下，其成本与发送一条聊天消息完全相同，不会产生额外费用。

要在无限量访问下有效使用 Orchestrator，不要限制它。让它根据问题的需要创建任意数量的子任务。启用自动模式，让 Orchestrator 自行决定如何拆分任务，无需在每一步请求确认。这样能获得更好的结果，因为 Orchestrator 可以自由迭代，并在过程中发现新信息时重新规划和执行子任务。

使用 .roomodes 定义自定义模式

Roo Code 支持通过项目根目录中的 .roomodes 文件定义项目级自定义模式。每个自定义模式都指定名称、描述、系统提示词补充内容、允许使用的工具，以及要使用的 API 配置档案。这让你可以为特定项目创建专用智能体，例如只能访问 SQL 文件和迁移工具的“数据库迁移”模式，或专注于 Markdown、使用针对写作优化的提示词的“文档”模式。

在项目根目录中创建 .roomodes JSON 文件。每个模式条目都包含 roleDefinition（系统提示词）、allowedTools（该模式可使用的工具名称数组）和 apiConfiguration（要使用的配置档案）。自定义模式会与内置模式一起显示在模式选择器中。

在无限量套餐下，自定义模式让你能够尝试富有创意的工作流。创建一个使用 Opus 深入分析陌生代码库的“研究”模式。创建一个使用 Haiku 处理简单单行修改的“快速修复”模式。创建一个只读取代码并提供反馈、不进行编辑的“审查”模式。固定费率计费让你可以自由尝试各种模式配置，无需担心试错成本。

原生工具调用要求

Roo Code 仅使用原生函数调用，不会像某些其他智能体一样回退到基于 XML 的工具调用。这意味着 API 提供商必须正确支持 Messages API 中的 tools 参数，包括多轮交互中的 tool_use 和 tool_result 块。AI Prime Tech Unlimited 网关对所有 Claude 模型都完整支持这一功能。

如果遇到工具调用错误，几乎总是由以下两种问题之一引起：使用了工具调用支持较弱的旧版模型，或基础 URL 配置错误，导致请求被路由到错误的端点。请确认配置档案中的模型标识符对应当前的 Claude 模型，并且基础 URL 与所选提供商类型相匹配。

Roo Code 的工具集包括文件操作（读取、写入、列出）、终端命令（执行、读取输出）、浏览器操作（启用后）和 MCP 工具（配置后）。每次工具调用都会向对话中添加结构化数据，通常每次调用连同结果会占用 200-500 个 token。在包含数十次工具调用的复杂任务中，这些用量会显著累积。

Roo Code 配置故障排查

最常见的问题是模式与配置档案不匹配：你创建了配置档案，却忘记将其分配给模式。检查设置中每个模式的“API 配置”下拉菜单；如果显示“默认”，而你尚未设置默认配置档案，请求就会失败。请为每个计划使用的模式明确分配配置档案。

如果 Orchestrator 子任务失败，而直接使用模式可以正常运行，通常是因为子任务模式会继承 Orchestrator 的配置档案，除非明确配置为使用其他档案。请确保每个可能被 Orchestrator 调用的模式都已分配有效的配置档案。常见做法是将默认配置档案设为 Sonnet 配置，仅为 Architect 和 Debug 改用 Opus。

长时间运行 Orchestrator 时出现连接超时错误，通常意味着同时运行的子任务过多，触发了速率限制。网关会将超出的请求排队，并在可处理时返回结果，但 VS Code 可能会将这种延迟判定为超时。如果经常遇到这种情况，请在设置中降低 Orchestrator 的并发数，或者直接等待；网关最终会在合理使用限制范围内处理所有请求。

# Roo Code -> Settings -> API Configuration -> Create New Profile
#
# Profile: Unlimited-Sonnet
#   Provider:  Anthropic
#   Base URL:  https://aiprimetech.io
#   API Key:   <your AI Prime Tech Unlimited key>
#   Model:     claude-sonnet-4-5
#
# Profile: Unlimited-Opus
#   Provider:  Anthropic
#   Base URL:  https://aiprimetech.io
#   API Key:   <your AI Prime Tech Unlimited key>
#   Model:     claude-opus-4-6
#
# Mode Assignment:
#   Architect -> Unlimited-Opus
#   Code      -> Unlimited-Sonnet
#   Debug     -> Unlimited-Opus
#   Ask       -> Unlimited-Sonnet

常见问题

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。