Roo Code 接入教程

Roo Code 是一款运行在 VS Code 中的 AI 编程插件，支持接入多种 AI 模型提供商。

前置条件

1. 前往 一元模型控制台 获取 API Key（分组选择 cc5 或 cc7）
2. 安装 VS Code / Cursor 等兼容编辑器

1. 安装插件

在 VS Code 扩展商店 (Ctrl+Shift+X) 搜索 Roo Code 安装。

2. API 配置（关键步骤）

1. API Provider: 选择 Anthropic
2. API Key: 填入 一元模型控制台 获取的密钥，分组选 cc5 或 cc7
3. 勾选 Use custom base URL，填入：https://timesniper.club

⚠️ 重要：以下两项必须保持关闭！

• ❌ 「将 Anthropic API 密钥作为 Anthropic 标头传递」
• ❌ 「启用 1M 上下文」

勾选会导致请求格式不兼容，无法正常使用！

4. 模型: 推荐 claude-opus-4-6

3. 使用技巧

1. 先选中代码再描述需求，效果更精准
2. 利用多文件编辑能力一次完成关联修改
3. 如果响应不理想，尝试更换模型
4. 配合 Git 集成对比 AI 生成的改动

---

常见问题与异常处理 (FAQ)

错误	原因	解决方案
401 Unauthorized	API Key 错误或为空	前往 一元模型控制台 重新获取密钥
404 Not Found	接口地址格式错误	确认 Base URL 是否正确（大部分需要 https://timesniper.club/v1）
429 Too Many Requests	请求频繁或额度耗尽	等待冷却或在充值页面充值
连接超时 / Network Error	网络或代理冲突	检查代理/VPN，确认 URL 无空格
SSE 流式输出乱码	端点类型不匹配	将端点类型改为 OpenAI 或 OpenAI-Response

提示: 如果依然无法解决，请携带完整报错截图到客服群中寻求帮助。