# 在 Cursor 中使用 BigModel.io

> 通过 OpenAI 兼容地址 https://bigmodel.io/v1，在 Cursor 的对话和 Agent 中使用 GLM、Kimi、DeepSeek 等 BigModel.io 模型，并了解限制与排查方法。

网页版: https://bigmodel.io/zh-cn/docs/cursor · 更新于 2026-10-18

Cursor 允许为对话模型填写自己的提供方 Key。借助 OpenAI Key 栏、Base URL 覆盖和自定义模型名，Cursor 的对话和 Agent 就能经 `https://bigmodel.io/v1` 调用 BigModel.io 的模型。

| Cursor 中的字段 | 值 |
|---|---|
| OpenAI API Key | 你的 BigModel.io API Key（`sk-...`） |
| Override OpenAI Base URL | `https://bigmodel.io/v1` |
| 自定义模型名 | [模型目录](https://bigmodel.io/zh-cn/models)中的模型 ID，如 `glm-5.3` |

> Cursor 官方的 API Key 文档仍介绍自定义提供方 Key，但已不再提到 **Override OpenAI Base URL** 开关。下面的步骤来自社区对当前版本的反馈。如果你的版本没有这个覆盖项，就无法把 Cursor 接到 BigModel.io。

## 哪些请求会用你的 Key

- 使用你添加的模型发起的**对话和 Agent** 请求，走你的 Key，从 BigModel.io 余额扣费。
- **Tab 补全**等 Cursor 功能仍使用 Cursor 自己的模型和套餐。自定义 Key 只作用于对话模型。
- **所有请求都先经过 Cursor 的服务器**再到 BigModel.io，所以 Base URL 必须能从公网访问。`https://bigmodel.io/v1` 没问题，`localhost` 代理不行。

## 开始之前

1. 在 [API Keys](https://bigmodel.io/keys) 创建 Key，选择提供目标模型的分组。Cursor 发送的是 Chat Completions 请求，所有提供文本模型的分组都可以。
2. 用最小请求检查 Key：

```bash
curl https://bigmodel.io/v1/chat/completions \
  -H "Authorization: Bearer $BIGMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.3","messages":[{"role":"user","content":"ping"}]}'
```

## 配置 Cursor

不同版本的菜单名称会变，找对应字段即可。

1. 打开 **Cursor Settings → Models**。
2. 在 **API Keys** 下，把 BigModel.io Key 粘贴到 **OpenAI API Key**。
3. 打开 **Override OpenAI Base URL**（社区反馈位于 OpenAI Key 下方），填入 `https://bigmodel.io/v1`，不要加 `/chat/completions`。
4. 点击 **Add model**，输入准确的模型 ID，如 `glm-5.3`、`kimi-k3`、`deepseek-v4-pro`。
5. 启用新模型，并在对话或 Agent 的模型选择器中选中它。

覆盖开启时，Cursor 内置 OpenAI 模型名的请求也会发到 BigModel.io，可能失败。把用不到的内置模型关掉，或者需要内置模型时关闭覆盖。

## 选择模型

按模型页原样填写 ID：全小写、保留小数点（`glm-5.3`、`kimi-k3`、`deepseek-v4-pro`、`minimax-m3`）。Agent 模式依赖稳定的工具调用，大改动前先用小任务试一下。

## 验证配置

在对话面板选中你添加的模型，发送 "ping"，然后打开[用量](https://bigmodel.io/usage)页，应能看到这条请求及你填写的模型 ID。看不到说明 Cursor 用的是它自己的模型。

## 常见问题排查

**保存 Key 时验证失败。** Cursor 可能用它默认的 OpenAI 模型名做验证，而你的分组不提供这些模型。先添加自己的模型，只保留它启用，再验证。在用量页出现的对话请求才是真正的测试。

**503 `api_error`：`No available accounts: no available accounts supporting model: ...`。** Cursor 中的模型名与分组提供的模型不一致。请从模型页原样复制 ID。

**所有请求都返回 404。** Base URL 错了。应为 `https://bigmodel.io/v1`，不是 `https://bigmodel.io` 或 `.../v1/chat/completions`。

**401 `INVALID_API_KEY`。** Key 粘贴时带了空格、已被删除，或属于其他账号。到 [API Keys](https://bigmodel.io/keys) 重新复制。

**403 `INSUFFICIENT_BALANCE` 或 429 `API_KEY_QUOTA_EXHAUSTED`。** 到[充值页](https://bigmodel.io/purchase)充值或提高 Key 额度。429 `rate_limit_exceeded` 会说明是哪个 Key 窗口（5 小时、1 天或 7 天）用完了。

**内置模型不能用了。** 覆盖会把所有 OpenAI 模型请求发到 BigModel.io。需要 Cursor 内置模型时关闭覆盖。

**Tab 补全没有走 BigModel.io。** 正常现象，Tab 始终使用 Cursor 的模型。

## 相关文档

- [Codex、Claude Code、Cursor、Cline 如何配置 Base URL](https://bigmodel.io/zh-cn/blog/configure-base-url-codex-claude-code-cursor)
- [Cline](https://bigmodel.io/zh-cn/docs/cline)：带专用 OpenAI Compatible 提供方的 VS Code 智能体。
- [Continue](https://bigmodel.io/zh-cn/docs/continue)：对话完全使用你自己 Key 的开源助手。
- [Claude Code](https://bigmodel.io/zh-cn/docs/claude-code)：Anthropic 协议的终端编程助手。