接入指南
Cursor
AI 原生代码编辑器，内置对 OpenAI 兼容服务的支持；填好地址和密钥，就能把默认模型换成 XylemNode 的。
- 01
打开模型设置
打开 Cursor 设置，进入 Models（模型）一栏。为避免和内置模型冲突，先把默认开启的那些模型关掉。
- 02
添加自定义模型
在模型列表里点“添加模型”，手动填入要用的模型名（例如 gpt-5.6-sol），名字要和后台可用模型保持一致。
- 03
覆盖 Base URL 并填密钥
找到 OpenAI API Key 区域，勾选“Override OpenAI Base URL”（覆盖接口地址），填入地址和密钥。走 OpenAI 兼容格式，地址要带 /v1；填完点 Verify 校验一次，通过后保存。
Base URL: https://api.xylemnode.com/v1 API Key: sk-你的密钥 Model: gpt-5.6-sol - 04
选模型测试
保存后新建一个对话，在模型下拉里选中刚添加的 gpt-5.6-sol，发一条消息确认通路。
原生方式的限制
用内置的覆盖 Base URL 接入时，Cursor 只放开聊天补全；Agent、Edit、Tab 等依赖其自有模型的能力用不了自定义模型，这是 Cursor 的 BYOK 限制。想把更多场景也接到自定义模型上，可以看下面的 cursor-byok。
备选方案：cursor-byok（老用户）
早期 Cursor 原生支持还不完善时，社区常用第三方工具 cursor-byok 把自己的模型 API 桥接进 Cursor。它是第三方工具，具体步骤以其自身文档为准，下面只给大致流程；已经在用的照着配即可，新用户建议优先试上面的原生方式。
官网 / 下载- 01
下载并启动
从 cursor-byok 的 GitHub Releases 按你的系统下载对应的包，解压后启动。
- 02
填入上游配置
在它的配置里把上游指向 XylemNode：接口地址走 OpenAI 兼容格式（带 /v1），再填入密钥和模型名。
Base URL: https://api.xylemnode.com/v1 API Key: sk-你的密钥 Model ID: gpt-5.6-sol - 03
对接 Cursor 并重启
按工具说明完成与 Cursor 的对接，然后完全退出并重开 Cursor，让配置生效。
- 04
选模型测试
在 Cursor 的模型列表里选中通过 cursor-byok 接入的模型，发一条消息确认可用。
常见问题
Cursor 里地址和密钥都填了，模型却不生效、Agent 报 BAD_MODEL_NAME？
分三处核对。其一，粘贴密钥和打开「使用 OpenAI API Key」开关是两个独立动作，而 Base URL 覆盖只在密钥处于启用状态时才起作用——只粘贴没开开关是最常见的情况。其二，覆盖开启后 Cursor 的内置模型会一起走这条自定义线路，想用回内置模型得先把覆盖关掉。其三，自定义模型在主 Agent 面板可用，但子 agent 会静默忽略它，这是 Cursor 当前的限制，不是你配错了。
在 Cursor 里添加自定义模型，提示已存在或加不进去？
模型名和 Cursor 内置模型的内部 ID 撞了，它就会判为冲突并提示已可用。填后台给出的完整标识（例如 gpt-5.6-sol），别用可能与内置 ID 同名的简称。