直接答案
通过模型列表、最小任务、用量记录和 HTTP 错误分类验证 Cursor 配置。
这篇内容解决什么问题
说明 Cursor 自定义 Key 的配置位置、/v1 Base URL、CodeNodex CLI 的配置范围，以及 401、404、模型不可用和超时故障的诊断方法。
CLI 的配置范围
Cursor 在客户端设置中保存自定义 Key，CodeNodex CLI 不会写入 Cursor 配置。--client cursor 校验 Key，并输出手动填写所需的 Base URL、Key 和 provider 值。
创建 CodeNodex OpenAI 分组的 Key。请求参数应使用该 Key 返回的准确模型 ID，不使用网页展示名称。
codenodex login -o "https://token.codenodex.com"
codenodex setup --client cursor在 Cursor 中配置 Key 和 Base URL
打开 Cursor Settings，定位到 Models 或 API Keys。启用自定义 OpenAI API Key，填写 CodeNodex Key，并将 Override OpenAI Base URL 设置为 https://token.codenodex.com/v1。
Cursor 各版本的菜单名称可能不同。必需值包括 OpenAI provider、以 /v1 结尾的 Base URL，以及该 Key 可用的准确模型 ID。
- 01选择 Provider选择 OpenAI，或支持自定义 OpenAI API 的入口。
- 02填端点Base URL 设置为 https://token.codenodex.com/v1，不追加 /chat/completions。
- 03存 Key填写 API Key。YOUR_API_KEY 为占位符，不是可用凭据。
- 04选模型填写模型列表中的准确模型 ID，并保存和启用配置。
运行任务前查询 /v1/models
在 Cursor 中运行任务前，直接查询模型列表。该检查将网关认证与 Cursor 模型配置分离。
成功响应仅验证 Key 和 Base URL。还需确认目标模型 ID 出现在响应中。
curl --fail-with-body "https://token.codenodex.com/v1/models" -H "Authorization: Bearer YOUR_API_KEY"使用最小任务验证
在临时目录中打开 Cursor，选择已配置模型，并提交一个结果可观察的低风险任务，例如解释函数或为纯函数添加一个单元测试。
确认模型选择器、响应完成状态和 CodeNodex 用量记录。三项结果一致时，可确认 Cursor 使用了已配置的 provider 和 Key。
- 模型选择器显示已配置的模型 ID。
- 任务执行后，CodeNodex 用量中出现对应调用记录。
- Cursor 重启后配置仍然保留。
诊断 401、404、429 与超时
401 通常表示 Key 无效或已停用；404 可能表示重复追加 /v1、模型 ID 不可用或接口路径错误；429 需要检查余额、并发和上游限制。
curl 成功而 Cursor 失败时，检查 Override OpenAI Base URL，并确认没有启用相互竞争的 provider。超时时先测试较短请求，再检查网络和模型状态。
官方来源与核验范围
本文以公开官方文档为事实依据；命令和配置可能随客户端版本变化，执行前请同时核对对应来源。
查看文档适用范围