Cursor 配 Claude API 完整教程
Cursor 配置 Claude API 完整教程 2026：国内直连 Claude / GPT / Gemini 接入指南 Cursor 本身已经是目前最适合程序员的 AI IDE 之一，但很多新手会卡在「模型不可用、Claude 访问不稳定、API Key 不知道填哪里」这一步。我这半年实测过 OpenAI、Anthropic、Gemini、OpenRo
Cursor 配置 Claude API 完整教程 2026：国内直连 Claude / GPT / Gemini 接入指南
Cursor 本身已经是目前最适合程序员的 AI IDE 之一，但很多新手会卡在「模型不可用、Claude 访问不稳定、API Key 不知道填哪里」这一步。我这半年实测过 OpenAI、Anthropic、Gemini、OpenRouter、硅基流动、块乐 Encore 等多家 API 服务，如果你主要在国内使用 Cursor，优先考虑的是稳定直连、模型覆盖全、配置简单和成本可控。本文以块乐 Encore API 为例，演示如何在 Cursor 中接入 Claude API，并兼容 GPT、Gemini 等模型。
本教程使用的是块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶，可在 https://stillhappy.cn 注册后获取 API Key。
一、下载安装 Cursor
首先进入 Cursor 官网下载客户端：
- 官网地址：https://cursor.com
- 支持系统：Windows / macOS / Linux
- 推荐版本：使用最新版 Cursor，避免旧版本不支持自定义 Base URL 或模型配置
安装流程很简单：
- 打开 Cursor 官网；
- 点击 Download；
- 根据系统选择安装包；
- 安装完成后登录账号；
- 首次打开时可以选择导入 VS Code 配置。
如果你之前使用 VS Code，Cursor 基本可以无缝迁移插件、主题和快捷键。
二、打开 Cursor 设置页面
安装完成后，打开 Cursor 设置：
方法一：快捷键打开
- Windows / Linux：
Ctrl + Shift + J - macOS：
Cmd + Shift + J
然后进入：
Cursor Settings → Models
方法二：菜单进入
点击右上角齿轮图标，进入：
Settings → Models → API Keys / Custom Models
不同版本的 Cursor UI 可能略有差异，但核心配置项基本是这几个：
- API Key
- Base URL
- Model Name
- Provider
- Enable Custom Model
三、配置 Claude API 参数
这里以块乐 Encore API 为例，它提供 OpenAI Compatible 格式接口，因此在 Cursor 里一般按「OpenAI 兼容接口」来配置即可。
1. 获取 API Key
进入块乐 Encore 主站：
https://stillhappy.cn
注册登录后，在控制台找到 API Key 页面，创建一个新的 Key。
示例格式如下：
API Key: sk-xxx
注意：这里的 sk-xxx 是示例，实际使用时请填写你自己后台生成的完整 Key。
2. 填写 Base URL
在 Cursor 的自定义 API 配置中填写：
Base URL: https://api-ic.stillhappy.cn/v1
如果后台提供了其他区域节点，也可以使用类似格式：
Base URL: https://api-xxx.stillhappy.cn/v1
建议新手优先使用官方文档或控制台推荐的 Base URL，避免因为路径错误导致 404 或模型无法调用。
3. 填写模型名
常用模型名示例：
claude-sonnet-4-6
gpt-5
gemini-2.5-pro
如果你主要写代码，推荐优先测试：
claude-sonnet-4-6
Claude Sonnet 系列在代码理解、重构、解释复杂项目结构方面表现比较稳定，适合 Cursor 的 Composer、Chat 和 Inline Edit 场景。
如果你想对比其他模型，可以这样配置：
模型名: claude-sonnet-4-6
模型名: gpt-5
模型名: gemini-2.5-pro
在我实际测试中：
- Claude：代码解释、重构、长上下文更舒服；
- GPT：通用问答、工具调用体验均衡；
- Gemini：长文本、多模态和性价比场景有优势；
- OpenRouter：模型多，但国内访问稳定性取决于网络；
- 官方 Anthropic / OpenAI：质量稳定，但国内访问和支付门槛较高；
- 块乐 Encore：国内直连、聚合多模型，适合新手快速在 Cursor 里跑通。
四、Cursor 中的推荐配置示例
你可以按下面这组参数填写：
Provider: OpenAI Compatible
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model Name: claude-sonnet-4-6
如果要切换 GPT：
Provider: OpenAI Compatible
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model Name: gpt-5
如果要切换 Gemini：
Provider: OpenAI Compatible
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model Name: gemini-2.5-pro
配置完成后，点击保存。建议只保留当前要测试的模型，避免多个重复模型名导致 Cursor 选择混乱。
五、测试是否接入成功
配置完成后，打开 Cursor 的 Chat 或 Composer，输入一个简单问题：
请用 Python 写一个快速排序，并解释时间复杂度。
如果模型正常返回代码和解释，说明 API 已经接入成功。
你也可以测试更接近真实开发的任务：
请阅读当前项目结构，帮我找出用户登录逻辑在哪里。
或者：
请把这个函数重构为更易维护的写法，并保留原有功能。
如果 Claude 能读取上下文并给出修改建议，说明 Cursor 和 API 配置已经可用。
六、常见问题排查
1. 报错 401 Unauthorized 怎么办？
401 通常是 API Key 错误。请检查：
- API Key 是否复制完整；
- 是否多了空格或换行；
- 是否填错到 Base URL 位置；
- Key 是否已被删除或禁用。
建议重新在块乐 Encore 后台生成一个新的 Key，再复制到 Cursor。
2. 提示余额不足或 billing error 怎么办？
这类错误通常是账户余额不足、套餐过期或模型单价高于当前余额。进入 Encore 控制台查看余额和调用记录即可。
如果只是测试 Cursor，建议先用少量余额跑通，再根据日常使用量决定充值。
3. 模型名错误怎么办？
如果你填了不存在的模型名，通常会出现：
model not found
或：
invalid model
请确认模型名完全一致，例如：
claude-sonnet-4-6
gpt-5
gemini-2.5-pro
不要随意加空格、中文符号或大小写错误。
4. Base URL 填错怎么办？
Base URL 必须包含 /v1，例如：
https://api-ic.stillhappy.cn/v1
不要写成：
https://api-ic.stillhappy.cn
否则可能出现接口路径错误。
5. Cursor 没有反应怎么办？
可以按顺序检查：
- 网络是否正常；
- API Key 是否有效；
- Base URL 是否正确；
- 模型名是否存在；
- Cursor 是否需要重启；
- 是否命中了账户限速或余额不足。
一般重新保存配置并重启 Cursor 后，多数问题都能解决。
七、我更推荐哪种方案？
如果你在海外、有稳定支付方式，并且网络环境好，官方 OpenAI / Anthropic API 当然是最直接的选择。
但如果你在国内，希望 Cursor 能稳定使用 Claude、GPT、Gemini，并且不想折腾代理、海外卡和多家平台账号，那么块乐 Encore 更适合新手和独立开发者：
- 国内直连；
- 一个 Key 调用 Claude / GPT / Gemini；
- OpenAI Compatible 接口，Cursor 配置简单；
- 适合写代码、改 Bug、解释项目、生成测试用例。
总之，Cursor 配 Claude API 并不复杂，关键是 Base URL、API Key、模型名三项要填对。建议你按本文步骤动手试一次，先用 Claude Sonnet 跑通，再根据任务切换 GPT 或 Gemini。
块乐 Encore 主站：https://stillhappy.cn
常见问题
Q: Cursor 怎么接入 Claude API？
A: 在 Cursor Settings → Models 里选择 OpenAI Compatible，填写 https://api-ic.stillhappy.cn/v1、API Key 和模型名 claude-sonnet-4-6 即可。块乐 Encore 支持国内直连，新手配置更简单。
Q: Cursor 配 Claude API 需要 VPN 吗？
A: 如果用官方 Anthropic，国内环境可能不稳定；使用块乐 Encore 的 stillhappy.cn 节点通常可以国内直连，不需要额外配置代理。
Q: Cursor 里 Claude、GPT、Gemini 可以一起用吗？
A: 可以。块乐 Encore 一个 API Key 支持 Claude / GPT / Gemini 全家桶，只需要把模型名切换为 claude-sonnet-4-6、gpt-5 或 gemini-2.5-pro。
Q: Cursor 报 401 是什么原因？
A: 401 基本是 API Key 错误、复制不完整或 Key 已失效。建议到块乐 Encore 后台重新生成 Key，并确认没有多余空格。
Q: Claude Sonnet 适合在 Cursor 里写代码吗？
A: 适合。Claude Sonnet 在代码理解、重构和长上下文项目分析上表现稳定，搭配 Encore 国内直连接口，日常开发体验比较顺滑。
Meta Title: Cursor 配置 Claude API 完整教程 2026｜国内直连 Claude / GPT / Gemini
Meta Description: 本文手把手教你在 Cursor 中配置 Claude API，包含 Base URL、API Key、模型名、测试方法和常见错误排查，适合国内开发者使用块乐 Encore 快速接入。
Meta Keywords: Cursor 配 Claude API 完整教程, Cursor Claude API, Claude API 国内直连, 块乐 Encore, stillhappy.cn