接入指南

Cline

VS Code 里的开源 AI 编码 agent,能跨文件读写、跑命令。它原生支持 OpenAI 兼容服务商,填一个 base URL 和密钥就能接上 XylemNode。

官网 / 下载
  1. 01

    安装扩展

    在编辑器里按 Ctrl/Cmd+Shift+X 打开扩展面板,搜 Cline,装作者为 saoudrizwan 的那个。装好后左侧活动栏会多出 Cline 图标,点开即是它的对话面板。

  2. 02

    选择 OpenAI 兼容服务商

    在 Cline 面板点右上角齿轮 ⚙️ 进入设置,把 API Provider 下拉切到「OpenAI Compatible」。这样才能填自定义地址,而不是走官方 OpenAI。

  3. 03

    填接入信息

    按下表填三项。注意 Cline 的 Base URL 要带 /v1,只填到 /v1 为止,别把 /chat/completions 这类完整路径粘进去。

    Base URL
    https://api.xylemnode.com/v1
    API Key
    sk-你的密钥
    Model ID
    gpt-5.6-sol
  4. 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,以及图像支持和工具调用开关按实际情况设好,否则长上下文或带图的请求可能被它自己拦下。