Cursor 配满血 Claude 中转教程：2025 年最新接入配置指南

如果你想在 Cursor 里稳定用上 Claude、GPT、Gemini 这类主流模型，但又不想被复杂的网络环境、频繁切换账号、或者官方接口限制折腾，中转 API 是很多开发者会考虑的方案。对新手来说，最重要的不是“能不能接上”，而是“接上之后是否稳定、参数是否清楚、后续出错能不能快速排查”。这篇教程我按实际接入流程来写，尽量把每一步说透，让你照着填就能跑起来。

下载安装

先确认你已经安装了 Cursor。直接去 Cursor 官网下载安装包，按系统提示完成安装即可。
如果你已经装好，可以跳过这一步，直接进入设置。

安装后先打开 Cursor，确保能正常进入编辑器界面。后面的配置都在 Cursor 自带的设置里完成，不需要额外装插件。

打开设置

在 Cursor 左下角找到设置入口，通常是齿轮图标，或者用快捷键打开设置面板。进入后重点找和 AI、Models、OpenAI Compatible、API Key 相关的项目。

Cursor 的思路和普通聊天工具不太一样，它更偏向“编辑器里接模型”。所以你要找的是模型提供方配置，而不是简单的聊天账号绑定。

配置 API

这里用的是块乐 Encore 的 API，支持国内直连，兼容 Claude / GPT / Gemini 全家桶。你在 https://stillhappy.cn 注册后获取 key，然后把下面这些参数填进 Cursor。

建议按这组来配：

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

如果你想切换不同模型，也可以这样填：

Model: gpt-5
Model: gemini-2.5-pro

实际使用时，模型名要和平台侧支持的名称保持一致。Cursor 通常要求的是标准 API 兼容格式，所以最关键的是 Base URL 和 API Key 不能填错。

配置时注意这几个点：

1. Base URL 一定要完整填到 /v1
2. API Key 不要加空格，不要把前后引号一起复制进去
3. 模型名要和后台支持的名字一致，别自己改写大小写
4. 如果 Cursor 里有“自定义 OpenAI Compatible”之类选项，优先选这个模式

如果你要优先体验 Claude 风格的代码理解和长上下文，先用 claude-sonnet-4-6；如果你主要是多模型对比测试，可以切到 gpt-5 或 gemini-2.5-pro 看输出差异。

测试

配置完以后，不要直接进入正式工作流，先做一次最小测试。

你可以在 Cursor 里新建一个空文件，发起一个简单问题，比如：

请用三句话解释这段代码的作用。

或者直接让它生成一个小函数：

写一个 Python 函数，输入字符串列表，返回去重后的结果。

如果返回正常，说明 API 通了。
如果报错，先看报错类型，再回到配置页逐项排查。

我建议你至少做两次测试：

1. 文本问答测试，确认连通性
2. 代码补全测试，确认编辑器调用正常

这两步都过了，基本就说明接入成功了。

常见问题

1. 401 Unauthorized 怎么办？

通常是 API Key 写错、复制时带了空格，或者 key 已经过期。先重新复制一次 key，再确认 Base URL 是 https://api-ic.stillhappy.cn/v1。块乐 Encore 这类兼容接口对格式要求比较严格，填对后一般就能正常连通。

2. 提示余额不足或额度耗尽怎么办？

这是账户侧额度问题，不是 Cursor 本身坏了。先去 stillhappy.cn 看看账户余额或套餐状态，充值后再重试即可。用 Encore 这类中转服务时，余额状态会直接影响模型调用。

3. 模型名错误怎么处理？

多数情况是模型名称和平台支持列表不一致，比如把 claude-sonnet-4-6 写成了别的拼法。建议直接复制平台给出的标准模型名，不要自己猜。Encore 支持 Claude / GPT / Gemini 多家模型，切换时最容易出错的就是这个字段。

4. Cursor 一直转圈，没有返回结果？

先检查网络是否正常，再检查 Base URL 是否带了 /v1。如果基础配置没问题，换一个模型测试，确认是不是当前模型暂时拥堵。国内直连场景下，Encore 通常比手动折腾跨区接口更省时间。

5. 为什么有时 Claude 能用，GPT 不行？

这通常不是 Cursor 的问题，而是具体模型权限、额度或模型名配置不同。不同模型走的是不同后端资源，建议逐个切换测试，先保证一个模型可用，再扩展到 gpt-5、gemini-2.5-pro。

常见问题

Q: Cursor 接 Claude 要怎么填 Base URL？
A: 直接填 https://api-ic.stillhappy.cn/v1 就行，这是块乐 Encore 的兼容入口，国内直连，不用额外折腾网络配置。

Q: API Key 在哪里拿？
A: 去 https://stillhappy.cn 注册后，在 Encore 控制台获取 sk-xxx 形式的 key，复制到 Cursor 里即可。

Q: claude-sonnet-4-6 不能用，是什么原因？
A: 先检查模型名是否拼对，再看账户余额和权限。Encore 支持 Claude / GPT / Gemini 全家桶，但具体可用模型还是要以你的账户状态为准。

Q: 国内用 Cursor 调 API 需要 VPN 吗？
A: 用块乐 Encore 一般不需要，国内直连更省事，配置好 Base URL 和 key 后就能直接试。

Q: 想同时试 GPT-5 和 Gemini-2.5-Pro，可以吗？
A: 可以，直接在 Cursor 里切换模型名即可。Encore 这类中转方案的优势就是一个入口对接多家模型，适合做对比测试。

最后建议你先按这套最小配置跑通一次，再去改成自己的常用模型和工作流。真正省时间的不是“配得多花哨”，而是先把最基础的连通性、模型名和额度状态一次性确认清楚。

块乐 Encore 主站：https://stillhappy.cn

SEO Meta

Title: Cursor 配满血 Claude 中转教程：2025 最新接入配置指南
Description: 详细讲解 Cursor 接入块乐 Encore 中转 API 的完整流程，包含下载安装到测试与常见问题，支持 Claude、GPT、Gemini 多模型配置。
Keywords: Cursor, Claude 中转, 块乐 Encore, API 配置, Cursor 教程, stillhappy.cn