为什么要在 Cursor 里用自定义 API？
Cursor 自带的套餐有额度限制，额度用完就降速或要升级。用自定义 API Key 的话，Chat 和对话里的模型调用按实际 token 计费，用多少扣多少，没有月度额度的概念。一个 MaCloud AI Key 就能在 Cursor 里切换 Claude、GPT、Gemini、DeepSeek，不用分别去各家注册、绑海外信用卡。
配置步骤
- 在 MaCloud AI 控制台 API Key 页面创建一个 Key，名字写“Cursor”，复制下来。
- 打开 Cursor，进入 Settings（macOS 是 Cmd + 逗号，Windows 是 Ctrl + 逗号，或右上角齿轮）→ 左侧 Models。
- 找到 OpenAI API Key，粘贴刚才的 Key。
- 打开下面的 Override OpenAI Base URL 开关，填
https://api.macloudai.com/v1。 - 在模型列表上方点 + Add model，填 模型页 上的模型名，例如
hk-5-5或tt-6-luna，并打开它旁边的开关。 - 回到 API Key 那里点 Verify，通过后在 Chat 面板的模型下拉里选刚加的模型，发一句话测试。
界面位置：Settings → Models 页面中间是模型列表，往下滚是 API Keys 区域，OpenAI API Key 输入框下方就是 Override OpenAI Base URL 开关。不同版本的 Cursor 位置会稍有变化，找不到时在设置页顶部搜索框搜 “Base URL”。
地址为什么要带 /v1？
Cursor 这里用的是 OpenAI 格式（chat completions），所以要填 https://api.macloudai.com/v1。这和 Claude Code 不一样：Claude Code 走 Anthropic 格式，地址是不带 /v1 的 https://api.macloudai.com。两个都在用的人最容易填反。Claude 模型在 OpenAI 格式下也能调用，所以 Cursor 里填 Claude 模型名没问题。
可以加哪些模型？
模型页上列出的都能加，一个 Key 通用，换模型只是换名字。常见搭配：
| 用途 | 建议 |
|---|---|
| 日常写代码、改 bug | Claude 系列，代码理解和多文件修改比较稳。 |
| 快速问答、解释报错 | 便宜一些的小模型，或 DeepSeek。 |
| 读超长文件、整份文档 | 上下文窗口大的模型，见模型页说明。 |
| 对比效果 | 同一个问题切两个模型问一遍，看哪个更合你的项目。 |
各模型价格（人民币，每 100 万 token）：
现在的真实价格
按模型页上的价格估算：每次对话 2,000 个输入 token、500 个输出 token。实际扣费以控制台为准。
| 模型 | 每次对话 | 1,000 次对话 |
|---|---|---|
| GEM 3.8 Flash | ¥0.0016 | ¥1.63 |
| TT-6 Luna | ¥0.0039 | ¥3.92 |
| TT-6.1 Terra | ¥0.0027 | ¥2.67 |
| HK-5.5 | ¥0.0013 | ¥1.28 |
| GEM 4 Argon | ¥0.03 | ¥31.14 |
| TT-6.1 Sol | ¥0.0053 | ¥5.34 |
配置后哪些功能走自己的 Key？
自定义 Key 主要用于 Chat / 对话这类直接选模型的功能。Cursor 的 Tab 自动补全等部分功能用的是 Cursor 自己的模型，不会走你填的地址。具体哪些功能支持自定义 Key 以 Cursor 当前版本的说明为准。想确认是否真的在走 MaCloud AI，用完后看控制台 用量 有没有对应记录。
Verify 失败怎么办？
- 地址必须是
https://api.macloudai.com/v1，不要漏/v1，也不要写成/v1/chat/completions。 - Key 前后不要有空格；Key 在控制台被删了会报 401。
- 余额为 0 会报 403，先 充值。
- 模型名写错会报 404，从模型页原样复制。
- 打开 Override 后，Cursor 内置的某些 OpenAI 模型名也会发到这个地址，如果它们不在我们的模型页上会报错，把这些模型的开关关掉即可。
更详细的报错解释见 Claude Code 报错排查（状态码含义通用），其他工具的写法见 接入文档。
