接入指南
Cline
VS Code 里的开源 AI 编码 agent,能跨文件读写、跑命令。它原生支持 OpenAI 兼容服务商,填一个 base URL 和密钥就能接上 XylemNode。
- 01
安装扩展
在编辑器里按 Ctrl/Cmd+Shift+X 打开扩展面板,搜 Cline,装作者为 saoudrizwan 的那个。装好后左侧活动栏会多出 Cline 图标,点开即是它的对话面板。
- 02
选择 OpenAI 兼容服务商
在 Cline 面板点右上角齿轮 ⚙️ 进入设置,把 API Provider 下拉切到「OpenAI Compatible」。这样才能填自定义地址,而不是走官方 OpenAI。
- 03
填接入信息
按下表填三项。注意 Cline 的 Base URL 要带 /v1,只填到 /v1 为止,别把 /chat/completions 这类完整路径粘进去。
- Base URL
https://api.xylemnode.com/v1- API Key
sk-你的密钥- Model ID
gpt-5.6-sol
- 04
验证并开始
点「Verify」确认连通,通过后回到对话面板即可开始用。以后换模型只改 Model ID,Base URL 和密钥都不用动。
两点说明
① 模型框若没自动带出列表,直接手填模型名即可,以后台可用列表为准、注意大小写;报 Model Not Found 多半是模型名或分组不对。 ② 设置里的 Model Configuration 可调最大输出、上下文窗口等高级项,一般保持默认;只有当默认值和后台模型实际能力不符时才需要动。
常见问题
Cline 报 Model Not Found,或者连接一直失败?
Cline 的「OpenAI Compatible」服务商有三项必填:Base URL、API Key、Model ID。Model ID 是手填的,它不会替你拉取可用列表,所以必须是后台给出的完整标识、大小写一致,填完点 Verify 校验一次。官方排查清单也是这个思路:Model Not Found 说明该标识在这个 Base URL 下不存在,Connection Error 则先确认地址正确、本机能访问。另外自定义服务商下 Cline 不知道这个模型的规格,记得在 Model Configuration 里把上下文窗口、最大输出 token,以及图像支持和工具调用开关按实际情况设好,否则长上下文或带图的请求可能被它自己拦下。