用 Roo Code 插件让 Cursor 接入 Claude：零基础配置教程（2026）

不买 Cursor Pro，通过 Roo Code 插件 + ClaudeAPI，免费在 Cursor 中使用 Claude Opus 4.7 / Sonnet 4.6 等全系模型。

教程目标

完成本教程后，你将拥有：

✅ 安装并配置好的 Cursor 编辑器
✅ 已接入 Claude 模型的 Roo Code 插件
✅ 可以在 Cursor 中直接对话、生成、审查代码

适合人群：零基础用户 / 不想购买 Cursor Pro 的开发者

准备工作：获取 ClaudeAPI 密钥

在配置插件之前，先准备好 API 密钥。

访问 console.claudeapi.com 注册账户
登录后进入「API 密钥」页面，点击「创建密钥」
复制并妥善保存密钥

注册即可获得体验额度，支付宝 / 微信充值，按量计费。

第一步：下载安装 Cursor

前往官网下载：cursor.com

下载对应系统版本（Windows / macOS / Linux），双击安装包，按提示完成安装。

Cursor 是基于 VS Code 的 AI 编辑器，原生支持插件生态，安装过 VS Code 的用户会非常熟悉。

第二步：安装 Roo Code 插件

Cursor 内置 AI 功能需要订阅 Pro 计划，而 Roo Code 是一款开源插件，支持接入任意第三方 API——这是我们绕过订阅限制的核心工具。

安装步骤：

打开 Cursor，点击「Open Project」打开任意文件夹
点击左侧工具栏的扩展图标（四个方块）
在搜索框输入 Roo Code，点击安装
安装完成后，左侧栏出现 Roo Code 图标

点击左侧 Roo Code 图标，即可打开 AI 对话面板。

第三步：配置 Claude 模型

这是本教程的核心步骤。

⚠️ 配置 Claude 模型时，供应商必须选择 Anthropic，不要选 OpenAI Compatible——两者的 API 格式不同，选错会导致调用失败。

操作步骤：

在 Roo Code 面板中，点击右上角设置图标
选择「自定义配置」
按下表填写各项：

配置项	填写内容
API 供应商	选择 Anthropic
使用自定义基础 URL	✅ 勾选，填入 `https://gw.claudeapi.com`
API 密钥	粘贴你在 ClaudeAPI 控制台生成的密钥
模型名称	见下方模型列表

ClaudeAPI 可用模型：

模型名称（填入配置）	定价（输入/输出，每百万 token）	适用场景
`claude-opus-4-7`	$4 / $20	复杂编程、长任务、高难度推理
`claude-sonnet-4-6`	$2.40 / $12	日常开发、代码审查、平衡性价比
`claude-haiku-4-5-20251001`	$0.80 / $4	快速补全、简单问答、高频调用

推荐新用户从 claude-sonnet-4-6 开始，性价比最高，日常编程任务完全够用。

填写完成后，点击保存

第四步：发送测试消息

配置保存后，回到 Roo Code 对话框，发送一条测试消息：

如果模型正常返回介绍内容，说明配置成功 ✅

可选：安装中文语言包

如果你希望 Cursor 界面显示中文：

点击左侧扩展图标
搜索 chinese，安装「Chinese (Simplified) Language Pack」
按 Ctrl + Shift + P，输入 display
选择「Configure Display Language」→ 选择 zh-cn
重启 Cursor，界面切换为中文 ✅

常见问题

Q：Roo Code 对话框在哪里？

安装 Roo Code 后，点击左侧工具栏中新出现的 Roo Code 图标即可打开。

Q：API 报错 401 怎么办？

401 表示认证失败，通常是 API 密钥填写错误。请重新到 ClaudeAPI 控制台复制密钥，注意不要有多余空格。

Q：API 报错 404 怎么办？

404 表示请求地址或模型名称不存在。请检查：

Base URL 是否准确填写为 https://gw.claudeapi.com（末尾无斜杠）
模型名称是否与上方表格中的名称完全一致

Q：发送消息后没有任何回复？

按顺序检查：

网络是否正常
ClaudeAPI 账户余额是否充足（登录控制台查看）
模型名称是否填写正确

Q：想用 Opus 4.7 处理最复杂的任务，有什么建议？

将模型名称改为 claude-opus-4-7，并在 Roo Code 设置中将努力级别调整为 high 或更高，可以获得更深度的推理输出，适合处理复杂架构设计和难度较高的 Bug 排查。

小结

步骤	操作
1	注册 ClaudeAPI，获取 API 密钥
2	下载安装 Cursor
3	安装 Roo Code 插件
4	配置 Anthropic + ClaudeAPI 地址 + 密钥 + 模型名
5	发送测试消息确认配置成功