Roo Code 使用 Claude 配置教程 2026：国内直连接入 Encore API 完整步骤

Roo Code 是 VS Code 里非常好用的 AI 编程助手，适合做代码生成、项目重构、Bug 修复和多文件阅读。相比只在网页里使用 Claude，把 Claude 接入 Roo Code 后，可以直接读取工作区、修改文件、执行命令，效率更高。我实测过官方 API、OpenRouter、国内中转、聚合 API 等 5 家以上服务，如果你在国内使用，优先建议选择稳定、延迟低、支持多模型的接口。本文用块乐 Encore API 演示 Roo Code 使用 Claude 的完整配置流程。

本文示例使用的是块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶。可在 https://stillhappy.cn 注册后获取 API Key。

一、下载安装 Roo Code

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

1. 安装 VS Code

如果你还没有安装 VS Code，可以前往官网下载安装：

https://code.visualstudio.com/

安装完成后，打开 VS Code。

2. 安装 Roo Code 插件

在 VS Code 左侧点击「扩展」图标，搜索：

Roo Code

找到 Roo Code 后点击「Install / 安装」。

安装完成后，左侧边栏通常会出现 Roo Code 的图标。如果没有出现，可以重启一次 VS Code。

二、打开 Roo Code 设置

安装完成后，进入 Roo Code 的配置界面。

常见入口有两种：

1. 点击 VS Code 左侧的 Roo Code 图标；
2. 在 Roo Code 面板中点击右上角的设置按钮；
3. 或者使用命令面板：

Ctrl / Command + Shift + P

搜索：

Roo Code Settings

进入设置后，你需要重点找到 API Provider、Base URL、API Key、Model 这几个配置项。

三、配置 Claude API

Roo Code 支持多种模型服务商。如果你使用的是兼容 OpenAI 格式的 API，一般选择：

OpenAI Compatible

或者类似的选项，例如：

OpenAI-compatible API
Custom OpenAI API

不同版本 Roo Code 的字段名称可能略有差异，但核心参数基本一致。

API 配置示例

下面是推荐的新手配置：

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

参数说明：

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

除了 Claude，你也可以按需切换模型，例如：

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

如果你主要写代码，建议优先使用 Claude Sonnet 系列；如果要做通用问答、结构化输出，可以测试 GPT；如果处理长上下文、多模态任务，可以试 Gemini。

四、测试 Roo Code 是否接入成功

配置完成后，建议先做一个简单测试，不要一上来就让它重构整个项目。

可以在 Roo Code 输入：

请读取当前项目结构，并告诉我这个项目主要使用了什么技术栈。

如果配置成功，Roo Code 会开始分析工作区，并返回项目结构、依赖文件、语言框架等信息。

你也可以测试一个更具体的编程任务：

请帮我检查当前文件是否有潜在 bug，并给出修改建议，不要直接改文件。

如果能正常返回结果，说明 Base URL、API Key 和模型名都已配置正确。

建议开启确认模式

新手使用 Roo Code 时，建议先开启「修改前确认」或类似选项。这样 AI 在改文件、运行命令前会先征求你的同意，避免误删代码或执行危险命令。

五、我对几类 API 服务的简单对比

我实际测试过官方 API、海外聚合平台、国内中转服务、开发者社区接口和块乐 Encore 这类国内直连聚合 API，大致体验如下：

如果你的目标是「让 Roo Code 稳定使用 Claude 写代码」，我更推荐国内直连、模型齐全、OpenAI 兼容格式清晰的服务。Encore 的优势是配置简单，不需要额外折腾代理，Roo Code 里填 Base URL、Key、模型名就能用。

六、常见问题排查

1. 报错 401 Unauthorized

401 通常表示 API Key 不正确。

请检查：

API Key 是否复制完整
是否多了空格
是否填成了别的平台 key
账户 key 是否已被删除或重置

正确格式一般类似：

sk-xxx

如果不确定，可以去 https://stillhappy.cn 后台重新生成一个 Key。

2. 提示余额不足或 Payment Required

这类错误通常不是 Roo Code 的问题，而是 API 账户余额不足。

解决方法：

1. 登录 Encore 后台；
2. 查看账户余额；
3. 充值后重新测试；
4. 如果刚充值仍报错，等待几秒再试。

3. 模型名错误或 Model Not Found

如果模型名填错，Roo Code 会返回类似：

model not found
invalid model

建议直接复制模型名，不要手打。

示例可用模型名：

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

不同平台的模型命名规则不一样，不要把官方模型名、OpenRouter 模型名和 Encore 模型名混用。

4. Roo Code 一直转圈没有响应

可能原因包括网络波动、模型响应慢、上下文太大。

可以尝试：

换一个模型
缩小任务范围
重启 VS Code
检查 Base URL 是否填写正确

Base URL 推荐填写：

https://api-ic.stillhappy.cn/v1

不要漏掉 /v1。

七、总结

Roo Code 搭配 Claude 是目前非常适合开发者的 AI 编程工作流：Claude 负责理解项目和生成代码，Roo Code 负责在 VS Code 内执行任务。国内用户如果直接使用官方 API，往往会遇到网络、支付和配置门槛；使用块乐 Encore 这类国内直连 API，可以更快完成接入，并且同时支持 Claude、GPT、Gemini 多模型切换。

如果你还没试过，可以先注册获取一个 API Key，然后按照本文步骤在 Roo Code 里配置测试。

Encore 主站链接：

https://stillhappy.cn

常见问题

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

Q: Roo Code 配置 Claude 需要 VPN 吗？
A: 如果用官方海外 API，国内环境可能不稳定；使用块乐 Encore 的 API 可以国内直连，配置更简单，适合新手和国内开发者。

Q: Roo Code 支持 GPT 和 Gemini 吗？
A: 支持。通过 Encore 可以在同一个 Base URL 下切换 claude-sonnet-4-6、gpt-5、gemini-2.5-pro 等模型，适合做代码、长文本和多模型测试。

Q: Roo Code 报 401 是什么原因？
A: 401 基本是 API Key 错误或失效。建议到 https://stillhappy.cn 后台重新复制 key，确认没有空格，并填入 sk-xxx 格式的密钥。

Q: Roo Code 里 Claude 模型名怎么填？
A: 本文示例填写 claude-sonnet-4-6。如果提示 model not found，通常是模型名拼写错误，建议直接复制 Encore 后台或文档中的模型名。

SEO title: Roo Code 使用 Claude 配置教程 2026：国内直连接入 Encore API
SEO description: 本文详细介绍 Roo Code 如何配置 Claude API，包括下载安装、打开设置、填写 Base URL、API Key、模型名、测试方法和常见错误排查，适合国内开发者使用块乐 Encore 接入 Claude/GPT/Gemini。
SEO keywords: Roo Code 使用 Claude,Roo Code 配置 Claude,Roo Code API,Claude API 国内直连,块乐 Encore,stillhappy.cn