直接答案
把 CodeNodex 的 OpenAI 兼容端点接进 Cursor，靠模型列表、一个最小任务和错误码三步确认配置真的生效。
这篇内容解决什么问题
解决几个常见疑问：自定义 API Key 到底填在哪、Base URL 要不要带 `/v1`、CodeNodex CLI 能不能直接帮你改 Cursor，以及碰到 401、404 或模型不可用时怎么查。
先搞清楚 CLI 能帮你到哪一步
Cursor 的自定义 Key 存在客户端自己的设置里，CodeNodex CLI 没法安全地替你写进去。--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，存盘并启用。
先 curl 一下 /v1/models
在 Cursor 里发任务之前，先直接打一下模型列表。这样能把「网关认证有没有问题」和「Cursor 自己的模型配置有没有问题」分开判断。
能返回结果只说明 Key 和 Base URL 通了；你还得确认想在 Cursor 里用的那个模型 ID，确实出现在返回里。
curl --fail-with-body "https://token.codenodex.com/v1/models" -H "Authorization: Bearer YOUR_API_KEY"跑个最小任务，确认它真走了你的 Key
在一个临时目录里打开 Cursor，选刚才配的模型，只丢一个低风险、结果好检查的小任务过去——比如让它解释一个函数，或给一个纯函数补条单测。
验证时三个地方一起看：模型选择器、响应有没有完整返回、CodeNodex 的用量记录。三处对得上，才说明请求没偷偷回退到 Cursor 的别的 provider。
- 模型选择器显示的是你刚填的那个模型 ID。
- 请求跑完后，CodeNodex 那边能看到对应的调用记录。
- 关掉 Cursor 再开，配置还在。
401 / 404 / 429 / 超时，分别怎么查
401 一般是 Key 错了或者被停用了；404 多半是 Base URL 重复拼了 /v1、模型 ID 不存在，或者接口路径对不上；429 就去看余额、并发和上游限额。
如果 curl 能通但 Cursor 不行，回去再核对一遍 Override Base URL，确认没有同时开着两个互相覆盖的 provider。超时的话先把提示词缩短重试，再看网络和模型状态。
官方来源与核验范围
本文以公开官方文档为事实依据；命令和配置可能随客户端版本变化，执行前请同时核对对应来源。
查看技术核验方法