Cursor

在 Cursor 中配置 TokenHub 的 OpenAI 兼容模型，用于聊天、编辑和代码理解。

Cursor 适合通过自定义模型或 OpenAI Compatible Provider 接入 TokenHub。不同版本的 Cursor 设置入口略有差异，但核心字段一致：Base URL、API Key 和 Model ID。

适合场景

Cursor 适合 IDE 内聊天、解释当前文件、按 diff 修改代码、生成测试和快速重构。接入 TokenHub 后，你可以把不同 TokenHub 模型分别用于 Chat、Apply、Fast 等场景。

安装 Cursor

先从 Cursor 官网下载桌面客户端并完成登录，并参考 Cursor Models 设置文档配置模型。安装后建议先打开一个普通代码仓库，而不是直接在生产仓库中测试。

准备 TokenHub 凭证

export TOKENHUB_API_KEY="sk-..."

在 TokenHub 模型列表中选择一个适合代码任务的模型，例如 gpt-4.1、gpt-4o 或其他可用模型。

持久化设置位置

Cursor 的模型配置建议通过设置界面保存，而不是依赖启动 Cursor 前的临时环境变量。常见用户设置位置如下：

系统	设置位置
macOS	`~/Library/Application Support/Cursor/User/settings.json`
Windows	`%APPDATA%\Cursor\User\settings.json`
Linux	`~/.config/Cursor/User/settings.json`

不同版本的 Cursor 私有设置 key 可能变化，所以优先使用 Settings UI 配置 Models、Custom Models、API Keys 或 OpenAI Compatible Provider。需要团队共享时，只共享 Base URL、模型名等非密钥默认值，API Key 由每位开发者自己保存。

配置模型供应商

在 Cursor 设置中找到 Models、Custom Models、API Keys 或 OpenAI Compatible Provider。不同版本 UI 名称可能不同，填写字段保持一致：

字段	值
Provider	OpenAI Compatible 或 Custom
Base URL	`https://us-api.tokenhub.com/v1`
API Key	`TOKENHUB_API_KEY` 对应的密钥值
Model	TokenHub 模型列表中的 Model ID

如果 Cursor 要求分别配置 Chat Model、Apply Model 或 Fast Model，可以先全部填写同一个 TokenHub 模型，验证成功后再按成本和速度拆分。

用途	建议模型策略
Chat	选择推理和代码理解能力更强的模型
Apply/Edit	选择代码生成稳定、上下文足够的模型
Fast	选择延迟低、成本较低的模型
Embedding	仅在 Cursor 版本支持自定义时再配置

验证

打开一个仓库，在 Cursor Chat 中输入：

请解释当前打开文件的主要职责，不要修改代码。

如果能得到回答，说明 Base URL、API Key 和 Model ID 已经生效。随后再测试 Apply/Edit 等会修改文件的能力。

常见问题

现象	处理方式
模型列表加载失败	手动输入 Model ID，不依赖 Cursor 自动拉取模型列表。
401	重新粘贴 TokenHub API Key，确认没有多余空格。
连接超时	确认公司网络或代理没有拦截 `https://us-api.tokenhub.com`。
Apply 不工作	先用同一模型验证 Chat，再检查 Apply/Edit 的模型配置是否也指向 TokenHub。
请求仍走默认模型	检查 Cursor 是否把内置模型设为默认，切换到你新增的 TokenHub 模型。