Roo Code 如何创建与切换多个 API Configuration Profiles【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code在 VS Code 中使用 Roo Code 时如果你需要同时对接多个 AI 供应商例如一套用 OpenAI、一套用 Anthropic、还有一套本地模型每次手动重填 provider、API key 和模型都会很麻烦。Roo Code 的 API Configuration Profiles 功能允许你为每种配置各存一个档案需要时从下拉框直接切换。本文基于 Roo Code 官方文档 api-configuration-profiles.mdx 介绍如何创建、配置、切换和管理这些档案。一个 Profile 里能存什么每个 profile 是独立的一组 AI 设置可以各自包含文档原文列出的范围API providersOpenAI、Anthropic、OpenRouter 等API keys 和认证信息模型选择o3-mini-high、Claude 3.7 Sonnet、DeepSeek R1 等Temperature 设置控制输出随机性Thinking budgetsProvider-specific settingsDiff editing 配置apply_diff工具相关Rate limit 设置注意文档中的限制说明具体可用配置项随 provider 和模型变化同一 provider 下不同模型支持的参数范围也可能不同不是所有 profile 都能配置同样的字段。创建第一个新 Profile操作全部在 Roo Code 的 Settings 面板中完成点击齿轮图标打开 Settings进入Providers页。点击 profile 选择框旁边的 “” 按钮在弹出的对话框中为新 profile 输入一个名字配置该 profile 的字段选择 API provider下拉框中选择供应商填入 API key选择模型配置 Rate Limit。默认值为 0表示不限制文档明确说明这对大多数用户已经合适。如需要可以为这个 profile设置 API 请求之间的最小间隔秒数用来控制成本或规避供应商限流取值为 0 即禁用限流。使用其他 profile 的请求遵循各自的限流设置互不影响调整模型参数例如 temperature。按同样步骤可以再建多个 profile比如一个指向 OpenAI 的低温度档、一个指向 OpenRouter 的高温度档。官方 Model Temperature 文档 给出的用法示例就是分别创建 Code - Low Temp0.1和 Ask - High Temp0.8两个 profile再把不同 profile 设为各 Mode 的默认实现切换模式时自动换配置。切换 Profile文档给出两种切换方式Settings 面板内在 profile 下拉框中直接选择另一个 profile。聊天界面内在 chat 界面打开 API Configuration 下拉框选择。切换后的即时验证方式是发起一条消息确认回复来自你预期 profile 的模型例如新 profile 配的模型名会体现在回复的模型信息中。固定Pin常用 Profileprofile 多了以后下拉框可以固定常用项操作路径鼠标悬停在下拉框中的某个 profile 上会出现 pin 图标点击 pin 图标该 profile 进入置顶列表置顶的 profile 显示在下拉框顶部按字母排序未置顶的 profile 显示在分隔线下方同样按字母排序再次点击同一图标即可取消置顶。把 Profile 与 Mode 关联在Prompts标签页中可以把某个 Mode 显式绑定到指定的 Configuration Profile。系统同时会自动记住你在每个 mode 下最后一次使用的 profile切换 mode 时会自动带出上次的配置这是实现“每个模式用固定供应商”的关键步骤绑定之后切换到对应 Mode 时不需要再手动选 profile。编辑与删除 Profile在 Settings 中选中某个 profile 即可修改它的任意设置点击铅笔图标可以重命名点击垃圾桶图标可以删除。文档给出一个明确限制不能删除最后一个 profile即至少要保留一个。验证 Profile 是否按预期工作除“切换后回复来自预期模型”外文档还描述了几个可观察的行为可用于确认 profile 机制生效任务级粘性Per-Task Profile Persistence每个 task 会记住自己启动时使用的 profile。从历史记录恢复任务时它会沿用原来的 profile即使你之后已把全局选择改成别的在另一个 workspace 窗口切换 profile不会影响第一个窗口中已有任务的 profileOrchestrator 创建的子任务继承父任务的 profile并在整个生命周期内保持不变。文档说明这一机制的目的是防止任务中途模型被意外更换保持对话上下文与生成它的模型一致。安全存储API key 存放在 VS Code 的 Secret Storage 中不会以明文形式暴露。另外如果你想核对配置确实被保存下来了可以打开 Settings 页面底部的Export按钮把当前设置导出为 JSON默认建议文件名roo-code-settings.json。导出的文件会包含所有已配置的 API Provider Profiles 和全局设置。注意 设置管理文档 中的安全警告该文件包含明文 API key属于高度敏感文件不要公开分享。已知限制与相关说明限流Rate Limit是 per-profile 的默认 0禁用不同 profile 的限流设置互不影响。不能删除仅剩的最后一个 profile。可用配置项随 provider 与模型变化某些模型如带 thinking 能力的模型对 temperature 有固定要求详见 model-temperature.md。如果需要在多台机器或团队间同步这些 profile可以走 Import/Export SettingsImport 是合并语义新增 profile、更新已有项不会删除本地多出的配置若部分 profile 引用的 provider 已失效导入会跳过并报 warning只有当全部 profile 都无效时导入才会失败。完成创建、绑定和切换后日常流程就是在 Settings 或聊天界面下拉框中选择 profile常用项可置顶或在 Prompts 标签页把 Mode 与 profile 绑定让 Roo Code 在切换模式时自动使用对应的供应商和模型。【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考