AI 中转指南
API 接入 AI 工具研究员 2 views

Cursor 配 Claude API 完整教程

Cursor 配 Claude API 完整教程 2025 如果你经常用 Cursor 写代码、改 Bug、生成注释，接入稳定好用的 Claude API 会明显提升体验。相比只用默认能力，自定义 API 的好处是模型选择更多、响应更灵活，也方便统一管理成本。本文用新手能跟上的方式，带你一步步完成 Cursor 接入 Claude API，并给出可直接参考的

Cursor 配 Claude API 完整教程 2025

如果你经常用 Cursor 写代码、改 Bug、生成注释，接入稳定好用的 Claude API 会明显提升体验。相比只用默认能力，自定义 API 的好处是模型选择更多、响应更灵活，也方便统一管理成本。本文用新手能跟上的方式，带你一步步完成 Cursor 接入 Claude API，并给出可直接参考的参数配置。

一、准备工作：先搞清楚你要配什么

这篇教程演示的是：在 Cursor 中接入第三方兼容 API 服务，再调用 Claude 模型。

这里用的是 块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶。你可以先到：

https://stillhappy.cn

注册账号并获取自己的 API Key。

你需要准备这几项参数：

  • Base URL：https://api-ic.stillhappy.cn/v1
  • 模型名：claude-sonnet-4-6
  • API Key：sk-xxx（示例）
  • 备用模型也可填写：
    • gpt-5
    • gemini-2.5-pro

二、下载安装 Cursor

如果你还没安装 Cursor，可以先完成这一步。

1）下载 Cursor

打开 Cursor 官网，下载适合你系统的版本（Windows / macOS）。

安装方式和普通软件一样，双击安装包后按提示完成即可。

2）登录 Cursor

安装完成后，首次打开 Cursor，建议先登录账号，方便同步设置和插件环境。

3）进入主界面

进入后你会看到和 VS Code 很像的编辑器界面，左侧是资源管理器、扩展、聊天等功能区。

三、打开设置页面

Cursor 的 API 配置入口通常在设置中完成。

方法一：通过左下角齿轮进入

  1. 打开 Cursor
  2. 点击左下角 齿轮图标
  3. 选择 Settings

方法二：快捷键打开

  • Windows：Ctrl + ,
  • macOS：Cmd + ,

进入设置后，可以在顶部搜索框输入以下关键词快速定位：

  • API
  • Models
  • OpenAI
  • Anthropic

不同版本的 Cursor 设置界面略有差异，但整体思路一致：找到模型或 API 提供商配置入口。

四、配置 Claude API

这一部分是重点。你要做的是把 Cursor 的模型请求指向你的 API 服务。

4.1 获取 API Key

先登录块乐 Encore 平台：

https://stillhappy.cn

注册后，在控制台或 API 管理页面中创建 Key，你会得到类似这样的密钥：

sk-xxx

请注意：

  • API Key 只展示一次时，记得保存
  • 不要把真实 Key 发到群里或公开仓库
  • 如果怀疑泄露，及时删除并重建

4.2 在 Cursor 中填写 API 参数

在 Cursor 的模型/API 设置区域，按下面示例填写。

配置示例

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

如果界面支持自定义 Provider 或 OpenAI Compatible API，可以这样理解：

  • Base URL：你的接口地址
  • API Key：平台给你的密钥
  • Model：具体要调用的模型名

可选模型示例

如果你后续想切换模型，也可以用这些名称：

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

推荐填写方式

参数项 示例值
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。

4.3 如果 Cursor 要求选择提供商怎么办？

有些版本的 Cursor 会让你选择模型提供商，常见做法有两种：

情况 A：支持自定义 OpenAI Compatible

如果有类似以下选项，优先选它：

  • OpenAI Compatible
  • Custom Provider
  • Custom OpenAI API

然后填写：

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

情况 B：只能填密钥或模型

如果当前版本入口比较简化，可能需要在高级设置、实验功能或模型配置中补充 Base URL。找不到时建议在设置搜索栏搜索：

  • base url
  • openai api base
  • provider
  • custom model

五、测试是否配置成功

配置完成后，不要急着开始正式工作，先做一个简单测试。

测试方法 1：打开聊天面板

在 Cursor 右侧或侧边栏打开 AI Chat，输入一句测试指令：

请用 3 行解释 Python 中 list 和 tuple 的区别

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

测试方法 2：在代码中使用快捷操作

新建一个文件，输入一段简单代码后，选中内容并让 Cursor 帮你优化，例如：

def add(a,b):
    return a+b

然后提问：

帮我把这段代码改成更规范的 Python 风格，并添加类型注解

如果返回结果正常，说明模型可用。

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

把模型名临时改成：

gpt-5

或

gemini-2.5-pro

再测试一次，确认你的通道不仅能跑 Claude，也支持其他模型。

六、推荐参数模板：新手直接照着填

如果你想尽量少折腾，可以直接参考下面这一套。

Claude 配置模板

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

GPT 配置模板

Provider: OpenAI Compatible / Custom Provider
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model: gpt-5

Gemini 配置模板

Provider: OpenAI Compatible / Custom Provider
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model: gemini-2.5-pro

建议优先从 claude-sonnet-4-6 开始测试，因为本文主题就是在 Cursor 里稳定使用 Claude。

七、常见问题排查

下面是新手最常遇到的几类问题。

1）报错 401 Unauthorized

现象：请求发送后提示 401、Unauthorized、Invalid API Key。

原因通常是：

  • API Key 填错了
  • 多复制了空格
  • Key 已失效或被删除
  • Base URL 不对，导致请求没打到正确接口

解决方法：

  1. 重新复制 API Key
  2. 确认是这种格式：sk-xxx
  3. 确认 Base URL 填的是
    https://api-ic.stillhappy.cn/v1
  4. 回到平台后台检查 Key 状态

2）提示余额不足 / quota exceeded

现象：请求发出后返回额度不足、quota exceeded、insufficient balance。

原因通常是：

  • 账户余额不足
  • 套餐额度用完
  • 当前模型单价较高，账户剩余额度不够

解决方法：

  1. 登录平台查看余额
  2. 充值或升级套餐
  3. 临时切换到其他模型测试，比如 gpt-5 或 gemini-2.5-pro
  4. 降低频繁长上下文调用的次数

3）模型名写错，接口返回 model not found

现象：报错 model not found、unsupported model、invalid model。

原因通常是：

  • 模型名大小写不对
  • 少写了中划线
  • 填了平台暂不支持的名称

正确示例：

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

解决方法：

  1. 直接复制官方/平台提供的模型名
  2. 不要手打，避免拼写错误
  3. 去后台查看当前可用模型列表

4）配置了但 Cursor 没反应

现象：没有明显报错，但聊天面板一直转圈或无响应。

原因通常是：

  • 设置改完后没有生效
  • Cursor 没有切换到对应模型
  • 网络或本地代理设置冲突

解决方法：

  1. 保存设置后重启 Cursor
  2. 在聊天窗口确认当前选中的模型
  3. 暂时关闭本地代理软件测试
  4. 换一个简单提示词确认是否是上下文过长导致超时

5）Base URL 填成官网地址了

错误示例：

https://stillhappy.cn

这通常不能直接作为 API 地址使用。

正确写法：

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

注意一定要带上 /v1，否则很多兼容接口会请求失败。

八、实用建议：如何让 Cursor 更好用

配置成功后，再补几条实战建议：

1）先固定一个主力模型

新手建议先固定使用：

claude-sonnet-4-6

等熟悉后，再按任务切换：

  • 复杂代码分析：Claude
  • 通用生成：GPT
  • 多模态或其他测试：Gemini

2）不要一上来就喂超长上下文

如果你把整个项目几百个文件都让模型一次读完，响应可能变慢、花费也更高。建议从单文件、小范围修改开始。

3）建立自己的常用提示词模板

例如：

  • “帮我解释这段报错原因，并给出最小修改方案”
  • “按 Python 3.12 风格重构这段代码”
  • “为这个函数补充中文注释和类型标注”

这样能明显提高 Cursor 的使用效率。

九、总结

到这里，你已经完成了 Cursor 配 Claude API 的完整接入流程：下载安装、打开设置、填写 Base URL / API Key / 模型名、再到实际测试和问题排查，整个过程并不复杂。核心就是把参数填对，尤其是 Base URL、Key、模型名 这三项。

再强调一次，本文用的是 块乐 Encore 的 API，国内直连，支持 Claude/GPT/Gemini 全家桶，在 https://stillhappy.cn 注册后获取 key。

如果你之前总觉得 Cursor 配 API 很麻烦，建议现在就按本文步骤动手试一次。实际配通后，你会发现后续在写代码、改项目、做 AI 辅助开发时会顺手很多。

Encore 主站链接：https://stillhappy.cn

SEO Meta

Meta Title：Cursor 配 Claude API 完整教程 2025：Base URL、API Key、模型名详细配置
Meta Description：手把手教你在 Cursor 中接入 Claude API，包含下载安装、Base URL 配置、API Key 获取、模型名填写、测试方法与常见报错解决。
Meta Keywords：Cursor 配 Claude API，Cursor API 教程，Claude API 接入，Cursor 配置教程，Encore API，stillhappy.cn

Cursor 配 Claude API 完整教程
相关阅读
1 Cherry Studio 接入 Claude 教程 2 NextChat 配置 OpenAI API