在 Cursor 中使用 HJToken

Cursor 和大多数工具不一样：它会按模型名决定这次请求走谁家的通道。所以接入 HJToken 时，除了填对地址和 Key，模型名也必须填对，否则 Cursor 会在本地就把请求拦下来、根本不发给我们。

本文按顺序走一遍，照着做即可。

第 1 步：创建 API Key

进入 API Key 页面 → 「创建」→ 复制形如 sk-... 的 Key。

第 2 步：打开 Cursor 的模型设置

Cursor → Settings（⌘ , / Ctrl ,）→ 左侧 Models → 展开下方 API Keys 区域。

第 3 步：填入 OpenAI API Key

在 OpenAI API Key 输入框粘贴你的 HJToken Key，并打开右侧开关。

Key 填在 OpenAI 这一栏，不是 Anthropic 那一栏 —— 即使你要用的是 Claude 模型。原因见第 4 步。

第 4 步：勾选 Override OpenAI Base URL

打开 Override OpenAI Base URL 开关，填入：

https://api.hjtoken.cn/v1

结尾的 /v1 不能省

Cursor 会在你填的地址后面直接拼 /chat/completions。少了 /v1，请求会打到网页而不是接口上，你会收到一个和真正原因毫无关系的报错。

第 5 步：关闭 Anthropic API Key

如果 Anthropic API Key 那一栏是开着的，请把它关掉（点 Turn Off Anthropic Key）。

原因：那一栏会接管所有 claude- 开头的模型，而且它不提供 Base URL 覆盖选项 —— Cursor 会拿着你的 HJToken Key 去请求 Anthropic 官方地址，那边当然不认识我们的 Key，必然失败。

第 6 步：添加模型（关键一步）

在 Models 页面的模型列表里：

1. 把 gpt-4o、claude-* 等 Cursor 自带的模型全部取消勾选；
2. 点 + Add model，手动输入模型名。

要用 Claude，必须填带 anthropic/ 前缀的名字：

anthropic/claude-opus-5

为什么 Claude 必须加前缀

Cursor 对 claude-opus-5 这种原生名字有两道拦截：一是交给上面那个不能改地址的 Anthropic Key 栏，二是它本身属于 Cursor 自家托管模型，会直接报 This model does not support custom API keys。

anthropic/claude-opus-5 不以 claude- 开头、也不是 Cursor 的内置名，两道拦截都不触发，请求就能正常发到 HJToken。

两种写法在 HJToken 这边是等价的，指向同一个模型、同样计费。你在 模型与价格 页面点模型名旁边的复制图标，就能按用途直接拷走对应写法。

GPT 系列不受这个限制，直接填原名即可（加不加前缀都行）：

gpt-5.4

常用模型名

想用的模型	在 Cursor 里填
Claude Opus 5	anthropic/claude-opus-5
Claude Sonnet 5	anthropic/claude-sonnet-5
Claude Opus 4.8	anthropic/claude-opus-4-8
Claude Sonnet 4.6	anthropic/claude-sonnet-4-6
GPT-5.4	gpt-5.4 或 openai/gpt-5.4
GPT-5.5	gpt-5.5 或 openai/gpt-5.5

完整清单以 模型与价格 页面为准。

第 7 步：验证并使用

1. 点 Verify，显示成功即接入完成；
2. 回到对话框，在底部模型选择器里选中你刚添加的模型（例如 anthropic/claude-opus-5），不要选 Cursor 自带的 Claude Opus 5；
3. 正常提问即可。

常见报错排查

报错	原因	解决
This model does not support custom API keys	选中的是 Cursor 自带的托管模型（如 Claude Opus 5）	在模型选择器里改选你手动添加的 anthropic/claude-opus-5
Access to private networks is forbidden	Base URL 填了 localhost / 127.0.0.1 / 内网地址	Cursor 的请求由它的服务器发出，够不到你本机，必须填公网地址 https://api.hjtoken.cn/v1
返回一段 HTML、或提示无法解析 JSON	Base URL 少了结尾的 /v1	改成 https://api.hjtoken.cn/v1
模型 "xxx" 不在本分组任一账号的模型映射白名单中	模型名写错，或你的套餐不含该模型	对照 模型与价格 页确认可用模型名
401 / 认证失败	Key 填错，或填到了 Anthropic 那一栏	确认 Key 填在 OpenAI API Key 栏，且 Anthropic 栏已关闭

已知限制

• Agent / Composer 模式可能不可用。 Cursor 官方存在一个已知问题：启用自定义 API Key（BYOK）后，Agent 与 Composer 模式的请求会被它自己拦下，报 This model does not support custom API keys。这是 Cursor 侧的路由问题，与 HJToken 无关。若遇到，请改用普通 Chat 模式。
• Tab 补全、代码库索引等功能仍走 Cursor 自己的服务，不经过 HJToken，也不消耗你的 HJToken 额度。

如果需要完整的 Agent 能力，推荐改用 Cline / Roo Code 等对 OpenAI 兼容端点支持更完整的编辑器插件，配置方式同样是「Base URL + API Key + 模型名」。

还有问题？

见 常见问题 FAQ 或 联系与支持。