Source: https://aiprimetech.io/zh/learn/use-claude-api-with-roo-code/ [首页](/zh/) / [学习](/zh/learn/) / 通过 Claude API 无限使用 Roo Code # 通过 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: # Model: claude-sonnet-4-5 # # Profile: Unlimited-Opus # Provider: Anthropic # Base URL: https://aiprimetech.io # API Key: # Model: claude-opus-4-6 # # Mode Assignment: # Architect -> Unlimited-Opus # Code -> Unlimited-Sonnet # Debug -> Unlimited-Opus # Ask -> Unlimited-Sonnet ``` ## 常见问题 在无限量套餐下，为不同模式分配模型有什么优势？ 你可以将 Opus 等昂贵模型分配给推理密集型模式（Architect、Debug），无需担心成本，同时为高频使用的模式（Code、Ask）保留更快的模型，以降低延迟。在按 token 计费时，这种策略成本很高；在无限量套餐下，你可以不增加费用地优化质量。 Orchestrator 模式如何影响 API 用量？ Orchestrator 会将任务拆分为多个子任务，每个子任务都在独立的对话中运行，并拥有自己的 token 预算。一个复杂任务可能会创建 5-10 个独立的 Claude 对话。在按 token 计费时，这会大幅增加成本；在无限量套餐下，这些用量都包含在固定费用中。 Roo Code 能使用 OpenAI 兼容端点吗？ 可以。创建配置档案，将提供商设为“OpenAI 兼容”，将基础 URL 设为 https://unlimited.aiprimetech.io/v1,，并手动输入模型 ID。不过，为获得最佳工具调用兼容性，建议使用 Anthropic 提供商接入方式。 .roomodes 是什么，我应该使用吗？ 项目根目录中的 .roomodes 文件用于定义自定义模式，指定工具、提示词和模型分配。在无限量套餐下，你可以自由使用它，为研究、审查、迁移、文档等不同工作流创建专用智能体，无需担心丰富的系统提示词带来的额外 token 成本。 为什么使用 Roo Code 时会遇到工具调用错误？ Roo Code 要求使用原生函数调用，不支持回退到 XML。请确保模型标识符对应当前的 Claude 模型（claude-sonnet-4-5 或更新版本），并且基础 URL 已根据所选提供商类型正确配置。旧版模型的工具调用支持可能较弱。 几分钟内开始使用 Claude 获取 API 密钥，无需 Anthropic 账户，也无需加入候补名单。[获取你的 API 密钥](/register) AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。 ## 更多 Claude API 指南 [如何获取 Claude API 密钥](/zh/learn/how-to-get-a-claude-api-key/)[Claude API 定价详解](/zh/learn/claude-api-pricing-explained/)[使用 Claude API 最便宜的方式](/zh/learn/cheapest-way-to-use-claude-api/)[通过 Claude API 不限量使用 Cursor](/zh/learn/use-claude-api-with-cursor/)[不限量访问 Claude Code](/zh/learn/use-claude-api-with-claude-code/)[Claude API 网关与 Anthropic 直连对比](/zh/learn/claude-api-vs-anthropic-direct/)[通过兼容 OpenAI 的 API 使用 Claude](/zh/learn/openai-compatible-claude-api/)[Claude 模型对比](/zh/learn/claude-api-models-compared/)[使用加密货币支付 Claude API 费用](/zh/learn/claude-api-with-crypto-payment/)[无需候补名单即可访问 Claude API](/zh/learn/claude-api-without-waitlist/)[如何减少 Claude 词元用量](/zh/learn/how-to-reduce-claude-token-usage/)[通过 Claude API 不限量使用 Cline](/zh/learn/use-claude-api-with-cline/)[在 JetBrains IDE 中不限量使用 Claude](/zh/learn/use-claude-api-with-jetbrains/)[通过 Claude API 无限制使用 Aider](/zh/learn/use-claude-api-with-aider/)[在 VS Code 中不限量使用 Claude](/zh/learn/use-claude-api-with-vscode/)[通过 Claude API 无限制使用 OpenCode](/zh/learn/use-claude-api-with-opencode/)[在 Claude 上运行不受限制的 Hermes 智能体](/zh/learn/run-hermes-agent-with-claude-api/)[使用 Claude 不限量运行 OpenClaw](/zh/learn/run-openclaw-with-claude-api/)[兼容 Anthropic 的 API 意味着什么](/zh/learn/anthropic-compatible-api/)[Claude Code API 密钥：如何获取和配置](/zh/learn/claude-code-api-key-setup/)[Claude Code API 成本 — 定价与降低成本的方法](/zh/learn/claude-code-api-costs/)[Claude API 错误：速率限制及 400、500、529 错误的解决方法](/zh/learn/claude-api-errors-troubleshooting/)[如何购买 Claude API 额度](/zh/learn/buy-claude-api-credits/)[Claude API 免费试用：哪些确实免费，哪些不免费](/zh/learn/claude-api-free-trial/)[Claude API 与 Claude Pro/Max 订阅——如何选择](/zh/learn/claude-api-vs-subscription/)[使用 Claude 运行 Codex CLI](/zh/learn/use-claude-api-with-codex/)[将 Claude 连接到 n8n](/zh/learn/use-claude-api-with-n8n/)[通过 LiteLLM 路由到 Claude](/zh/learn/use-claude-api-with-litellm/)[在 Kilo Code 中使用 Claude](/zh/learn/use-claude-api-with-kilo-code/)[将 Claude 接入 GitHub Copilot](/zh/learn/use-claude-api-with-github-copilot/)[通过网关将 Zed 连接到 Claude](/zh/learn/use-claude-api-with-zed/)[将 Cherry Studio 连接到 Claude](/zh/learn/use-claude-api-with-cherry-studio/)[将 LangChain 指向网关上的 Claude](/zh/learn/use-claude-api-with-langchain/)[使用 Claude 运行 Factory Droid](/zh/learn/use-claude-api-with-factory-droid/)[Claude Code API 详解](/zh/learn/claude-code-api/)[将 Claude API 集成到您的应用中](/zh/learn/claude-api-integration/)