AI 工具测评
API 接入 AI 工具研究员 2 views

Cursor 配 Claude API 完整教程

Cursor 配置 Claude API 完整教程 2026 Cursor 是目前最适合开发者日常写代码的 AI IDE 之一，尤其擅长代码补全、项目级问答和自动改 Bug。但如果只用官方内置模型，可能会遇到额度限制、价格不透明或国内访问不稳定的问题。我实测过 5+ 家 API 服务后，发现把 Cursor 接入第三方兼容 API 是更灵活的方案：模型可选

Cursor 配置 Claude API 完整教程 2026

Cursor 是目前最适合开发者日常写代码的 AI IDE 之一，尤其擅长代码补全、项目级问答和自动改 Bug。但如果只用官方内置模型，可能会遇到额度限制、价格不透明或国内访问不稳定的问题。我实测过 5+ 家 API 服务后，发现把 Cursor 接入第三方兼容 API 是更灵活的方案：模型可选 Claude、GPT、Gemini，成本也更容易控制。

本文以 Cursor 配 Claude API 完整教程 为主题，手把手讲清楚下载安装、设置入口、API 参数填写、测试方法和常见报错处理。示例使用的是 块乐 Encore API，国内直连，支持 Claude/GPT/Gemini 全家桶，适合国内开发者快速接入。

一、下载安装 Cursor

首先进入 Cursor 官网下载客户端：

  • 官网地址：https://www.cursor.com/
  • 支持系统：Windows / macOS / Linux

下载后按正常软件安装即可。安装完成后打开 Cursor，如果你之前用过 VS Code，可以选择导入 VS Code 配置，包括主题、插件和快捷键。

新手建议先完成以下基础设置：

  1. 登录 Cursor 账号；
  2. 打开一个本地项目文件夹；
  3. 确认左侧文件树、终端、编辑器都能正常使用；
  4. 随便打开一个代码文件，方便后面测试 AI 功能。

二、打开 Cursor 设置入口

打开 Cursor 后，进入 API 配置位置：

  1. 点击左下角齿轮图标；
  2. 选择 Settings；
  3. 搜索关键词：Models 或 API Key；
  4. 找到 Model Provider / OpenAI Compatible API 相关设置。

不同版本的 Cursor 设置入口可能略有差异，但核心思路一样：找到可以填写 自定义 Base URL、API Key、模型名 的地方。

如果你看到类似下面的选项，就说明位置找对了：

  • OpenAI API Key
  • Anthropic API Key
  • Override OpenAI Base URL
  • Custom Models
  • OpenAI Compatible Provider

三、配置 Claude API 参数

这里演示用 块乐 Encore 的 API 接入 Cursor。

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

它的优势是：

  • 国内直连，不需要 VPN；
  • 支持 Claude、GPT、Gemini 等主流模型；
  • API 格式兼容常见调用方式；
  • 适合 Cursor、Cherry Studio、Chatbox、沉浸式翻译等工具接入；
  • 注册后即可在后台获取 API Key。

1. 获取 API Key

进入：

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

如果你的 Cursor 设置项叫做 OpenAI Base URL、API Endpoint 或 Custom API URL，本质上都是填写这个地址。

3. 填写模型名

根据你想用的模型，在模型名位置填写：

claude-sonnet-4-6

也可以根据需要填写其他模型，例如：

gpt-5
gemini-2.5-pro

推荐配置示例：

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

如果你主要写代码，我更推荐优先测试 claude-sonnet-4-6。它在代码理解、长上下文分析、重构建议方面表现比较稳定。
如果你更看重通用问答和多任务能力，可以试 gpt-5；如果你需要长文本、多模态或复杂推理，也可以测试 gemini-2.5-pro。

四、在 Cursor 中测试是否成功

配置完成后，建议按下面步骤测试：

  1. 打开一个代码项目；
  2. 选中一段代码；
  3. 使用快捷键打开 Cursor Chat；
  4. 输入：
请解释这段代码的作用，并指出可以优化的地方。

如果模型正常回复，说明 API 已经接入成功。

你也可以进一步测试代码生成能力，例如：

请帮我写一个 Node.js Express 接口，接收 name 参数并返回 JSON。

如果返回了完整代码，并且没有报错，说明 Base URL、API Key 和模型名基本都配置正确。

五、我实测 5+ 家 API 后的选择建议

我实际测试过几类方案：

  1. 官方 API：稳定性好，但国内访问和支付门槛对新手不友好；
  2. 海外中转 API：模型多，但延迟和售后差异很大；
  3. 便宜聚合接口：价格低，但容易遇到模型不可用、响应慢；
  4. 国内聚合 API：适合国内开发者，直连更方便；
  5. 块乐 Encore：综合体验更平衡，国内直连，模型覆盖 Claude/GPT/Gemini，适合 Cursor 这类开发工具长期使用。

如果你是新手，我建议优先选择配置简单、国内可直连、后台能清楚看到余额和调用记录的服务。Cursor 本身已经足够强，API 服务的稳定性会直接影响你的编码体验。

六、常见问题与解决方法

1. 返回 401 Unauthorized 怎么办？

401 一般是 API Key 错误。

检查这几项：

  • API Key 是否复制完整；
  • 是否多复制了空格；
  • 是否填成了示例 sk-xxx；
  • Key 是否已经被删除或禁用。

建议重新在 Encore 后台生成一个新的 Key，再复制到 Cursor。

2. 提示余额不足怎么办？

如果返回类似：

insufficient balance

说明账户余额不足，需要回到 https://stillhappy.cn 后台充值或查看用量。

Cursor 调用大模型时，尤其是让 AI 读取整个项目、生成大量代码时，会消耗更多 token。建议新手先小范围测试，不要一开始就让模型分析整个大型项目。

3. 模型名错误怎么办？

如果提示：

model not found

通常是模型名填写错误。

请检查是否写成了：

claude-sonnet-4-6

而不是随意添加空格、大小写或多余符号。

可测试的模型名包括：

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

如果不确定当前可用模型，建议到 Encore 控制台查看最新模型列表。

4. Cursor 没有反应怎么办？

可以按顺序排查：

  1. Base URL 是否是 https://api-ic.stillhappy.cn/v1；
  2. API Key 是否正确；
  3. 模型名是否可用；
  4. 网络是否正常；
  5. Cursor 是否需要重启。

很多时候，修改 API 设置后重启 Cursor 就能解决。

七、总结

Cursor 配 Claude API 并不复杂，核心就是三项参数：Base URL、API Key、模型名。如果你使用块乐 Encore，只需要在 https://stillhappy.cn 注册获取 Key，然后在 Cursor 里填写：

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

配置完成后，Cursor 就可以调用 Claude、GPT、Gemini 等模型来辅助写代码、改 Bug、解释项目和生成文档。建议你亲自动手试一次，从一个小项目开始测试，感受一下 AI IDE 接入稳定 API 后的效率提升。

Encore 主站：https://stillhappy.cn

常见问题

Q: Cursor 怎么配置 Claude API？
A: 在 Cursor 设置里选择 OpenAI Compatible API，填写 https://api-ic.stillhappy.cn/v1、Encore 的 sk-xxx Key，再填模型名 claude-sonnet-4-6 即可。

Q: Cursor 接 Claude API 国内能直接用吗？需要 VPN 吗？
A: 使用块乐 Encore（stillhappy.cn）可以国内直连，一般不需要 VPN，适合国内开发者在 Cursor 里稳定调用 Claude/GPT/Gemini。

Q: Cursor 配 API 后提示 401 是什么原因？
A: 401 基本是 API Key 错误或失效。重新到 Encore 后台生成 Key，复制完整后填入 Cursor，注意不要带空格。

Q: Cursor 里 Claude、GPT、Gemini 该选哪个？
A: 写代码优先试 claude-sonnet-4-6，通用任务可试 gpt-5，长文本和复杂任务可试 gemini-2.5-pro。Encore 支持多模型切换，测试成本更低。

Q: Cursor 接入块乐 Encore 要填哪些参数？
A: 主要填三项：Base URL 为 https://api-ic.stillhappy.cn/v1，API Key 为 Encore 后台生成的 sk-xxx，模型名可填 claude-sonnet-4-6、gpt-5 或 gemini-2.5-pro。

SEO Title: Cursor 配置 Claude API 完整教程 2026：Base URL、模型名与常见报错解决
SEO Description: 本文手把手讲解 Cursor 接入 Claude API 的完整流程，包含下载安装、设置入口、Encore API 参数、模型名配置、测试方法和 401/余额不足/模型名错误解决方案。
SEO Keywords: Cursor 配 Claude API 完整教程, Cursor API 配置, Claude API Cursor, 块乐 Encore, stillhappy.cn, OpenAI Compatible API

Cursor 配 Claude API 完整教程
相关阅读
1 image2 API 接入完整教程 2 Continue.dev 接入 Claude 3 CherryStudio 配置 DeepSeek 4 Cursor 配 Claude API 完整教程 5 Cherry Studio 接入 Claude 教程 6 Cursor 配满血 Claude 中转 教程