Roo Code 使用 Claude 配置教程 2025

如果你平时用 VS Code 写代码，想把 Claude 的代码理解、重构、生成能力直接接进开发环境里，Roo Code 是一个很值得试的插件。它适合新手的一点在于：界面直观、支持多模型切换，还能直接在编辑器里完成对话式开发。对于国内用户来说，给 Roo Code 配一个国内可直连的 Claude API，会比原生方式更省心，延迟更低，配置也更简单。

一、下载安装 Roo Code

Roo Code 本质上是一个 VS Code 内的 AI 编程助手插件，所以第一步先准备好编辑器环境。

1. 安装 VS Code

如果你还没装 VS Code，先去官网下载安装最新版。

2. 安装 Roo Code 插件

打开 VS Code 后：

1. 点击左侧 扩展（Extensions）
2. 搜索 Roo Code
3. 找到插件后点击 Install / 安装

安装完成后，左侧边栏或者命令面板中一般就能看到 Roo Code 的入口。

建议：首次安装后重启一次 VS Code，避免插件面板不显示或配置项加载不完整。

二、打开 Roo Code 设置

安装完成后，下一步就是进入模型配置页面。

常见进入方式有两种：

方法 1：从侧边栏进入

1. 点击 Roo Code 图标
2. 打开聊天面板
3. 找到右上角或底部的 Settings / Provider Settings / Model Settings

方法 2：从命令面板进入

1. 按 Ctrl + Shift + P（Mac 是 Cmd + Shift + P）
2. 输入 Roo Code
3. 选择类似 Open Settings 或 Configure Provider

不同版本界面可能略有区别，但核心思路一样：
找到 AI Provider / API Provider / Model 配置区域。

三、配置 Claude API

这一步是整篇教程最关键的部分。

这里我实际测试时，用的是 块乐 Encore 的 API，特点是：

• 国内直连
• 支持 Claude / GPT / Gemini 全家桶
• 接口格式兼容 OpenAI 风格，很多工具都能直接接
• 注册后拿 key 就能用

获取方式：
去 https://stillhappy.cn 注册账号，然后在后台创建 API Key。

推荐配置参数

在 Roo Code 中新增或编辑 Provider 时，按下面填写：

• Base URL: https://api-ic.stillhappy.cn/v1
• API Key: sk-xxx
• Model / 模型名: claude-sonnet-4-6

如果你想切换其他模型，也可以用：

• gpt-5
• gemini-2.5-pro

示例配置

下面给你一个最常见、最容易成功的填写方式：

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

有些版本的 Roo Code 还会出现这些参数，也建议一并确认：

Temperature: 0.2
Max Tokens: 4096
Top P: 1
Stream: Enable

参数说明

• Provider Type：通常选 OpenAI Compatible 或 OpenAI API
• Base URL：接口地址，填 https://api-ic.stillhappy.cn/v1
• API Key：你在 Encore 后台生成的密钥，格式通常像 sk-xxx
• Model：具体模型名称，Claude 推荐先用 claude-sonnet-4-6
• Temperature：代码场景建议低一点，0.2 到 0.4 更稳
• Max Tokens：如果工具支持，先设 4096 或更高
• Stream：建议开启，响应体验更流畅

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

四、测试是否接入成功

参数填完后，不要急着开始正式开发，建议先做一次简单测试。

测试方法 1：直接发一句简单提示词

在 Roo Code 对话框输入：

请用 Python 写一个快速排序，并解释时间复杂度。

如果正常返回内容，说明 API 已经接通。

测试方法 2：让它读取当前项目文件

打开一个代码文件，然后输入：

帮我解释当前文件的主要逻辑，并指出潜在 bug。

如果 Roo Code 能正确读取上下文并回答，说明不仅 API 通了，而且插件权限和项目上下文也工作正常。

测试方法 3：切换模型验证

你还可以把模型名从：

claude-sonnet-4-6

改成：

gpt-5

或者：

gemini-2.5-pro

再发同样的测试问题，看是否可以正常切换。
这也是我比较推荐 Encore 这类聚合 API 的原因：一个入口，多模型切换方便，后期对比不同模型写代码的表现也更省事。

五、常见问题排查

下面是新手最容易遇到的几个报错，我按真实使用场景整理一下。

1. 报错 401 Unauthorized

原因：

• API Key 填错
• 多复制了空格
• Key 已失效或未开通权限

解决办法：

1. 回到 Encore 后台重新生成一个新 Key
2. 确认格式是 sk-xxx
3. 粘贴时不要带前后空格
4. 检查 Base URL 是否写成了正确的 /v1

正确示例：

Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx

2. 提示余额不足 / quota exceeded

原因：

• 账户没有可用余额
• 该模型单价高于当前账户余额可承受范围

解决办法：

1. 登录 Encore 控制台查看余额
2. 先充值少量测试
3. 优先选择成本更适合日常开发的模型，比如 Claude 中档模型或 Gemini

如果你只是做基础代码问答，不一定要一上来就用最贵的模型。

3. 提示 model not found / 模型不存在

原因：

• 模型名写错了
• Roo Code 里缓存了旧配置
• 你填的是平台不支持的模型别名

解决办法： 直接核对模型名，建议用以下这类标准写法：

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

如果改完还不行，重启 VS Code 再试一次。

4. 已经填了 Key，但一直没响应

原因：

• Base URL 不完整
• 网络请求被插件旧配置干扰
• Provider 类型选错

解决办法：

1. 确认地址必须带 /v1
2. Provider 选择 OpenAI Compatible
3. 删除旧 Provider 后重新添加
4. 重启 VS Code

5. Claude 能用，但上下文读取不到文件

原因：

• Roo Code 没有拿到当前工作区权限
• 没打开项目文件夹，只是单文件模式
• 插件索引未完成

解决办法：

1. 用 Open Folder 打开整个项目
2. 确认当前文件在工作区内
3. 等待插件初始化完成后再测试

六、我对 Roo Code + Claude 的实际建议

如果你是第一次接 AI 编程工具，我建议按这个顺序来：

1. 先用 Claude 做解释和重构
2. 再让它写小功能
3. 最后再尝试多文件修改、Agent 模式这类更复杂场景

原因很简单：Claude 在代码理解、自然语言解释、长上下文推理这几个方向通常比较稳，特别适合刚开始把 AI 接入开发工作流的人。

而从接入难度来看，使用 块乐 Encore 这类国内可直连 API，会比很多新手直接折腾海外原生接口省掉不少时间。
尤其你如果还想顺手测试 GPT、Gemini，不需要再换一套平台，直接改模型名即可。

七、总结

Roo Code 配置 Claude 并不复杂，真正要注意的就三点：

• Provider 类型选对
• Base URL 填对
• 模型名写对

一套可直接抄的配置如下：

Provider Type: OpenAI Compatible
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model: claude-sonnet-4-6
Temperature: 0.2
Max Tokens: 4096
Stream: Enable

如果你想少踩坑、国内直接可用、后续还能切 GPT 和 Gemini，我个人建议直接试试 块乐 Encore：
https://stillhappy.cn

动手配一遍，你基本 10 分钟内就能把 Roo Code 跑起来。

常见问题

Q: Roo Code 怎么接 Claude，国内能直接用吗？
A: 可以，直接用块乐 Encore 的兼容接口即可，https://api-ic.stillhappy.cn/v1 国内直连，延迟通常比原生方案更友好，不需要自己折腾复杂网络环境。

Q: Roo Code 填哪个模型名最稳？
A: 新手建议先用 claude-sonnet-4-6，代码理解和重构体验比较稳；如果你还想横向对比，也可以在 Encore 里切到 gpt-5 或 gemini-2.5-pro。

Q: API Key 应该填什么格式？
A: 一般填 sk-xxx 这种格式，直接在块乐 Encore（stillhappy.cn）后台创建即可，复制时注意不要带空格，否则容易报 401。

Q: Roo Code 报 401 Unauthorized 怎么办？
A: 先检查三项：Key 是否正确、Base URL 是否是 https://api-ic.stillhappy.cn/v1、模型名是否拼写正确。大多数 401 都是这三个地方填错。

Q: 一个 API 能同时用 Claude、GPT、Gemini 吗？
A: 可以，块乐 Encore 就支持多模型统一接入，你只要改模型名，不用换整套配置，对经常测不同模型的开发者很方便。

SEO Title: Roo Code 使用 Claude 配置教程 2025｜国内直连接入 API 完整步骤
SEO Keywords: Roo Code 使用 Claude, Roo Code 配置 Claude, Roo Code API 接入, Claude API 国内直连, 块乐 Encore
SEO Description: 本文详细讲解 Roo Code 使用 Claude 的 2025 最新配置方法，包含下载安装、API 参数填写、Base URL、模型名、测试步骤与常见报错排查，适合新手快速完成接入。