Skip to main content
RooCode 是一个功能强大的独立 AI 编程助手应用程序,具有交互式聊天界面、代码审查功能和多文件编辑能力。配置它以使用 MegaLLM 来访问多个 AI 模型。

快速配置

分步设置

1

打开 RooCode 设置

  • 启动 RooCode 应用程序
  • 点击齿轮图标 ⚙️(左下角)
  • 导航至:设置 → API 配置
2

选择提供商类型

  • 提供商类型:选择 OpenAI Compatible
  • 这将启用自定义基础 URL 配置
  • 允许 MegaLLM 集成
3

配置 API 端点

  • 基础 URL:https://ai.megallm.io/v1
  • API 密钥:sk-mega-your-api-key-here
  • 组织:留空(非必需)
  • 点击 保存
4

选择默认模型

  • 默认模型:gpt-5
  • 备用模型:gpt-4o(可选)
  • 温度:0.7(平衡创造力)
  • 最大令牌数:4096
5

启用功能

  • 代码补全
  • 聊天界面
  • 代码审查
  • 重构助手
  • 多文件编辑

场景示例

场景 1:首次安装

从下载到首次使用的完整设置:
1

下载并安装 RooCode

  1. 访问 RooCode.io(示例 URL)
  2. 为您的操作系统下载(Windows/macOS/Linux)
  3. 安装应用程序
  4. 启动 RooCode
2

获取 MegaLLM API 密钥

  1. 访问 MegaLLM 控制台
  2. 注册或登录
  3. 导航至 API 密钥 部分
  4. 点击 创建新密钥
  5. 复制密钥(以 sk-mega- 开头)
3

配置 API 提供商

在 RooCode 中:
  1. 点击 ⚙️ 设置图标
  2. 转到 API 配置
  3. 选择 提供商:OpenAI Compatible
  4. 输入 基础 URL:https://ai.megallm.io/v1
  5. 粘贴 API 密钥:sk-mega-your-key
  6. 点击 测试连接(应显示 ✓ 成功)
  7. 点击 保存
4

选择您的第一个模型

  1. 在设置 → 模型选择
  2. 选择:gpt-5(推荐用于一般用途)
  3. 或浏览可用模型
  4. 设置 温度:0.7(平衡)
  5. 保存设置
5

测试配置

  1. 在 RooCode 中打开新聊天
  2. 输入:你好!你在使用什么模型?
  3. 应该会响应模型信息
  4. 尝试:编写一个 Python 的 hello world 函数
预期响应:

场景 2:团队共享配置设置

为整个开发团队设置 RooCode: **场景:**10 人开发团队需要一致的 RooCode 配置 步骤 1:团队负责人创建基础配置 team-roocode-config.json:
步骤 2:创建设置说明 ROOCODE_SETUP.md:
步骤 3:分发给团队
**结果:**整个团队使用一致的:
  • 相同的 AI 模型(gpt-5)
  • 相同的温度和设置
  • 相同的自定义提示
  • 相同的编码标准
  • 个人 API 密钥(不共享)

场景 3:项目特定配置

为不同项目类型使用不同的 RooCode 配置: Python 数据科学项目: roocode-datascience.json:
React Web 应用程序: roocode-webapp.json:
系统编程(Rust): roocode-systems.json:
项目间切换:

场景 4:从 Cursor/其他 AI 工具迁移

从另一个 AI 编码工具切换到 RooCode 与 MegaLLM: 当前设置:使用 Cursor 与 OpenAI 为什么切换到 RooCode + MegaLLM:
  • 使用一个密钥访问多个模型(GPT、Claude、Gemini)
  • 独立应用程序(不依赖特定编辑器)
  • 更好的定价且无席位限制
  • 更多自定义选项
迁移步骤:
1

导出当前偏好设置

从 Cursor(如果可能):
  • 记录您偏好的模型
  • 保存任何自定义提示
  • 记录您使用的键盘快捷键
2

安装 RooCode

为您的操作系统下载并安装 RooCode
3

配置 MegaLLM

4

重建自定义提示

添加您常用的提示:
5

测试功能

并排比较:
  1. 在两个工具中打开相同的代码
  2. 提出相同的问题
  3. 比较代码生成质量
  4. 评估响应速度
对比表:

场景 5:多模型工作流

为不同类型的任务使用不同的模型: 带模型配置文件的配置:
工作流示例:
在 RooCode 中切换配置文件:
  1. 点击模型下拉菜单(顶部栏)
  2. 选择配置文件:Fast / Balanced / Quality / Creative / Analysis
  3. 配置文件应用于当前会话

场景 6:CI/CD 集成

在 CI/CD 中使用 RooCode API 进行自动化代码审查: GitHub Actions 示例: .github/workflows/roocode-review.yml:

配置选项

完整参考

模型选择指南

验证

测试 1:聊天功能

  1. 打开 RooCode
  2. 点击 新建聊天
  3. 输入:编写一个函数,按属性对对象数组进行排序
  4. 应该收到可工作的代码
预期响应:

测试 2:代码审查

  1. 粘贴此代码:
  1. 点击 审查代码 按钮
  2. 应识别出:缺少零除检查

测试 3:多文件编辑

  1. 打开多文件视图
  2. 请求:“为所有 API 调用添加错误处理”
  3. 应显示多个文件的更改
  4. 审查并应用更改

测试 4:连接状态

检查状态指示器(右上角):
  • 🟢 绿色 = 已连接到 MegaLLM
  • 🟡 黄色 = 连接中…
  • 🔴 红色 = 连接失败
点击状态查看:
  • 模型:gpt-5
  • 端点:https://ai.megallm.io/v1
  • 令牌使用情况:当前会话统计

故障排除

症状:
  • “无法连接到 API”
  • 请求在 30 秒后超时
  • 聊天消息无法发送
解决方案:
  1. 验证基础 URL 是否正确:
  2. 测试连接:
  3. 检查防火墙:
    • 允许 RooCode 通过防火墙
    • 检查企业代理设置
    • 验证没有 VPN 阻止
  4. 增加超时时间:
  5. 手动测试 API 密钥:
症状:
  • “无效的 API 密钥” 错误
  • 401 未授权
  • 身份验证失败
解决方案:
  1. 验证密钥格式:
    • 必须以 sk-mega- 开头
    • 应为 60+ 个字符
    • 没有额外的空格或换行符
    • 配置文件中实际密钥周围没有引号
  2. 检查密钥是否激活:
    • 登录到 控制台
    • 转到 API 密钥
    • 验证密钥显示为”活动”
    • 检查它未被撤销或过期
  3. 重新输入密钥:
    • 从控制台复制密钥
    • 从 RooCode 设置中删除旧密钥
    • 粘贴新密钥
    • 保存并重启 RooCode
  4. 直接测试密钥:
症状:
  • 不相关的代码建议
  • 错误的编程语言
  • 不完整的响应
解决方案:
  1. 提供更好的上下文:
    • 在设置中设置项目语言
    • 添加框架信息
    • 使用自定义提示
  2. 调整温度:
  3. 尝试不同的模型:
  4. 增加最大令牌数:
  5. 使用具体的提示:
症状:
  • 重启后设置恢复
  • 更改不生效
  • 使用默认配置
解决方案:
  1. 检查配置文件位置:
  2. 验证 JSON 语法:
  3. 检查文件权限:
  4. 重置为默认值:
    • 备份当前配置
    • 删除 config.json
    • 重启 RooCode (创建新配置)
    • 通过 UI 重新应用设置
症状:
  • RooCode 启动时崩溃
  • 长响应期间冻结
  • UI 无响应
解决方案:
  1. 检查系统资源:
    • 关闭其他应用程序
    • 确保有 4GB+ RAM 可用
    • 检查 CPU 使用率
  2. 减少最大令牌数:
  3. 禁用流式传输:
  4. 清除缓存:
  5. 重新安装 RooCode:
    • 备份 config.json
    • 卸载 RooCode
    • 下载最新版本
    • 安装并恢复配置

最佳实践

项目配置

为不同项目类型创建单独的配置

模型配置文件

为不同任务设置配置文件:fast、quality、creative

自定义提示

为常见任务定义可重用的提示

监控使用情况

定期检查 控制台 的令牌使用情况

备份配置

保留工作配置的备份

安全性

在共享配置中使用环境变量存储 API 密钥

高级技巧

环境变量

RooCode 支持环境变量替换:
设置变量:

上下文管理

通过更好的上下文改进响应:

响应缓存

通过智能缓存节省 API 成本:

下一步

Kilocode 设置

配置 Kilocode VSCode 扩展

Cline 设置

配置 Cline VSCode 扩展

模型目录

浏览所有可用模型

其他代理

查看所有 CLI 和 GUI 代理

API 参考

探索 API 文档

Discord 社区

加入获取支持