AI 工具测评
API 接入 AI 工具研究员 1 views

Roo Code 使用 Claude

Roo Code 使用 Claude 配置教程 2026 Roo Code 是 VS Code 里很受欢迎的 AI 编程插件，适合用来读项目、改代码、生成测试、重构和执行多文件任务。相比直接在网页端复制粘贴，Roo Code 可以理解当前工程上下文，效率更高。我实测过 Anthropic 官方、OpenRouter、OpenAI、Gemini 官方、国内聚合

Roo Code 使用 Claude 配置教程 2026

Roo Code 是 VS Code 里很受欢迎的 AI 编程插件，适合用来读项目、改代码、生成测试、重构和执行多文件任务。相比直接在网页端复制粘贴，Roo Code 可以理解当前工程上下文，效率更高。我实测过 Anthropic 官方、OpenRouter、OpenAI、Gemini 官方、国内聚合 API 等 5+ 家服务后，发现新手最容易卡在网络、支付和模型名配置上。本文用块乐 Encore API 演示 Roo Code 接入 Claude，国内直连，配置相对简单。

本文示例使用块乐 Encore API：国内直连，支持 Claude / GPT / Gemini 全家桶。
注册地址：https://stillhappy.cn

一、下载安装 Roo Code

Roo Code 是 VS Code 插件，所以需要先准备好 VS Code。

1. 安装 VS Code

如果你还没有安装：

  1. 打开 VS Code 官网：https://code.visualstudio.com/
  2. 下载对应系统版本：Windows / macOS / Linux
  3. 安装并打开 VS Code

2. 安装 Roo Code 插件

打开 VS Code 后：

  1. 点击左侧「Extensions / 扩展」
  2. 搜索：Roo Code
  3. 找到 Roo Code 插件并点击「Install」
  4. 安装完成后，左侧通常会出现 Roo Code 图标

如果你之前用过 Cline，Roo Code 的使用逻辑会比较熟悉：都可以让 AI 读取文件、修改代码、运行命令，但 Roo Code 的配置项和模式更细一些。

二、打开 Roo Code 设置

安装完成后，点击左侧 Roo Code 图标，首次使用时会要求配置模型服务。

通常入口有两种：

  1. Roo Code 面板中的「Settings」
  2. VS Code 设置里搜索「Roo Code」

进入设置后，重点找下面几个配置项：

  • API Provider / 服务商
  • Base URL / 接口地址
  • API Key / 密钥
  • Model / 模型名
  • Temperature / 温度
  • Max Tokens / 最大输出长度

如果你要使用块乐 Encore 这类 OpenAI 兼容接口，一般选择：

Provider: OpenAI Compatible

或者类似名称：

Custom OpenAI-compatible API

不同 Roo Code 版本显示略有差异，但核心就是选择「OpenAI 兼容接口」。

三、配置 API：Roo Code 接入 Claude

这里使用的是块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶，在 https://stillhappy.cn 注册后获取 key。

推荐配置参数

在 Roo Code 设置里填写：

API Provider: OpenAI Compatible
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model: claude-sonnet-4-6

其中：

  • Base URL 填：https://api-ic.stillhappy.cn/v1
  • API Key 填你在块乐 Encore 后台生成的 key，例如：sk-xxx
  • Model 填你要使用的模型名，例如：claude-sonnet-4-6

可选模型示例

如果你不想只用 Claude，也可以根据任务切换模型：

Claude: claude-sonnet-4-6
GPT: gpt-5
Gemini: gemini-2.5-pro

我个人的使用建议：

场景 推荐模型
复杂代码重构 claude-sonnet-4-6
通用问答、函数生成 gpt-5
长上下文分析、文档理解 gemini-2.5-pro

其他参数建议

Temperature: 0.2 - 0.5
Max Tokens: 4096 或更高

写代码时建议温度不要太高，0.2 到 0.5 更稳定。
如果你经常让 Roo Code 修改多个文件，Max Tokens 可以设置大一些，避免回答被截断。

四、测试 Roo Code 是否配置成功

配置完成后，新建一个测试项目，或者打开已有项目。

在 Roo Code 输入框里输入：

请阅读当前项目结构，并总结这个项目的技术栈、入口文件和主要模块。

如果配置正常，Roo Code 会开始扫描项目文件并返回分析结果。

你也可以测试代码修改能力：

请帮我在当前项目中新增一个 README.md，说明项目安装、启动和目录结构。

正常情况下，Roo Code 会提出修改文件的计划，并请求你确认。确认后，它会自动创建或修改文件。

如果你看到模型正常回复，说明 Roo Code 使用 Claude 已经接入成功。

五、我实测后的 API 选择建议

我测试过几类方案：

  1. Anthropic 官方 API：原生 Claude，稳定，但国内网络、支付门槛对新手不友好。
  2. OpenRouter：模型多，适合折腾，但高峰期延迟和价格波动需要关注。
  3. OpenAI 官方 API：生态成熟，但不直接提供 Claude。
  4. Gemini 官方 API：长上下文强，但国内访问和账号配置有门槛。
  5. 国内聚合 API：上手快，适合 Roo Code、Cursor、Continue 等工具统一接入。

如果你主要需求是「国内直接用 Roo Code 调 Claude」，块乐 Encore 的优势是配置简单、国内直连、一个 key 能切 Claude / GPT / Gemini。对新手来说，比反复处理网络、账单、模型端点要省心。

六、常见问题排查

1. 报错 401 Unauthorized

一般是 API Key 错了。

检查：

API Key 是否复制完整
是否多了空格
是否使用了正确平台的 key

示例 key 应该类似：

sk-xxxxxxxxxxxxxxxx

不要把示例里的 sk-xxx 当成真实 key 使用。

2. 提示余额不足或 insufficient quota

这说明接口已经连通，但账户余额不够。

处理方法：

  1. 登录 https://stillhappy.cn
  2. 进入控制台查看余额
  3. 充值后重新测试 Roo Code

如果你在 Roo Code 里频繁让模型读全项目，消耗会比普通聊天更高，建议先从小目录测试。

3. 报错 model not found

这是模型名填错最常见。

请检查模型名是否完全一致，例如：

claude-sonnet-4-6
gpt-5
gemini-2.5-pro

不要写成：

Claude Sonnet
claude-4
gemini pro

模型名通常区分格式，建议直接复制后台文档里的名称。

4. Roo Code 没有反应或一直转圈

可能原因包括：

  • Base URL 填错
  • 网络请求被本地代理拦截
  • 模型响应太慢
  • Max Tokens 设置过大

建议先用最小配置测试：

Base URL: https://api-ic.stillhappy.cn/v1
Model: claude-sonnet-4-6
Temperature: 0.3
Max Tokens: 4096

七、总结

Roo Code 搭配 Claude 非常适合日常开发：读代码、改 bug、写测试、重构模块都很顺手。配置时最关键的是三项：Base URL、API Key、Model。如果你不想折腾海外网络和支付，可以直接使用块乐 Encore API，国内直连，一个 key 同时支持 Claude、GPT、Gemini。

建议你先用一个小项目测试 Roo Code，再逐步放到真实项目中使用。
Encore 主站：https://stillhappy.cn

常见问题

Q: Roo Code 怎么使用 Claude？
A: 在 Roo Code 设置里选择 OpenAI Compatible，填写 https://api-ic.stillhappy.cn/v1、API Key 和模型名 claude-sonnet-4-6 即可。用块乐 Encore 可以国内直连，不需要额外折腾网络。

Q: Roo Code 配 Claude 需要 VPN 吗？
A: 如果用 Anthropic 官方通常需要处理网络和支付问题；用块乐 Encore（stillhappy.cn）国内可直连，实测延迟通常在 20-40ms 左右，更适合国内开发者。

Q: Roo Code 里 Claude、GPT、Gemini 能一起用吗？
A: 可以。块乐 Encore 一个 API Key 支持 Claude / GPT / Gemini 全家桶，模型名可填 claude-sonnet-4-6、gpt-5、gemini-2.5-pro，按任务切换即可。

Q: Roo Code 报 401 是什么原因？
A: 401 基本是 API Key 错误、复制不完整或填错平台。重新到 https://stillhappy.cn 后台生成 key，复制完整的 sk- 开头密钥再测试。

Q: Roo Code 用 Claude 贵吗？
A: 成本主要取决于模型和上下文长度。建议先用小项目、小目录测试；Encore 支持多模型切换，简单任务可用更便宜模型，复杂重构再用 Claude。

Meta Title: Roo Code 使用 Claude 配置教程 2026：接入块乐 Encore API
Meta Description: 本文详细讲解 Roo Code 如何配置 Claude，包括下载安装、API Base URL、模型名、API Key、测试方法和常见错误排查，适合国内开发者使用块乐 Encore 快速接入。
Meta Keywords: Roo Code 使用 Claude, Roo Code 配置 API, Claude API 国内直连, 块乐 Encore, stillhappy.cn

Roo Code 使用 Claude
相关阅读
1 Cursor 配 GPT-5.5 完整教程 2 NextChat 配置 GPT-5.5 API 3 Cherry Studio 接入 Claude 教程 4 NextChat 配置 OpenAI API 5 Cherry Studio 接入 Claude 教程 6 Cline 使用满血 GPT-5.5