Cline配置
Cline 是一款 VSCode 智能编程插件，支持以 OpenAI Compatible 方式接入 TokenSwitch 平台。
1. 安装 Cline
下载并安装 VSCode。
打开 VSCode，在扩展商店搜索
Cline并安装。
2. 配置接入凭证
安装完成后，点击左侧边栏的 Cline 图标进入配置界面。点击 Use your own API key，选择 OpenAI Compatible 作为 API Provider，填入以下参数。如果之前使用过 Cline，请点击右上角的设置按钮进入配置界面。
| 配置项 | 说明 |
|---|---|
| API Provider | 可选择 OpenAI Compatible。 |
| Base URL | |
| API Key | 填入已创建的 API Key。 |
| Model ID | 填入模型 ID，可在「门户 / 模型广场」中点击模型卡片复制。 |
关于 Base URL 中的 /v1
平台的接口地址为 。选择 OpenAI 协议兼容（OpenAI Compatible）方式接入时，OpenAI 协议的接口路径为 /v1/chat/completions，因此 Base URL 需要以 /v1 结尾；而 Anthropic 协议 的客户端会自行拼接 /v1/messages，Base URL 不需要加 /v1。不同客户端的填写方式略有差异，几个典型例子：
| 客户端 | 协议 | Base URL 填写 |
|---|---|---|
| Cline | OpenAI Compatible，不会自动补全路径 | |
| Aider / Codex | OpenAI 兼容，通过 OPENAI_API_BASE 环境变量配置 | |
| CherryStudio | OpenAI 兼容，API 地址末尾会自动补全 /v1 | |
| Claude Code | Anthropic 协议，客户端自动拼接 /v1/messages | ANTHROPIC_BASE_URL） |
如果配置后请求报 404，或提示找不到接口，请优先检查 Base URL 末尾是否按上表正确处理了 /v1。
3. 开始使用
配置完成后，点击 Let's go!（或保存设置）返回对话界面，输入任务即可开始使用。
4. 常见问题
配置过程中遇到报错，可根据 HTTP 状态码和响应体中的 code、message 字段，对照用户错误码指南排查。以下列出几类常见报错。
报错 401 Incorrect API key provided
令牌（API Key）认证失败，可能原因：
API Key 填写错误或已失效，请登录 https://neolink.com/ ，在「API Key」菜单页确认或重新创建。
Base URL 填写错误，请确认为 。
更多认证失败的场景（如令牌过期、被删除、额度用尽等），参见错误码指南的 HTTP 401 — 认证失败。
报错 400 请求错误
请求参数不正确或格式有问题，例如缺少必填字段、模型名称为空、请求体结构不符合 OpenAI 格式等。请按响应 message 中的提示修正后重试，详见 HTTP 400 — 请求错误。
报错 404 Invalid URL
请求的接口路径不存在，通常是 Base URL 末尾未按协议正确处理 /v1（参见上文「关于 Base URL 中的 /v1」）。详见 HTTP 404 — 未找到。
报错 403 权限/额度拒绝
请求被拒绝，可能是令牌无权访问该模型、额度/余额不足、IP 不在白名单等。请对照 HTTP 403 — 权限/额度拒绝排查，必要时联系管理员。
报错 429 频率限制
请求频率超过令牌配置的 RPM 限制，请降低请求频率后重试，详见 HTTP 429 — 频率限制。
报错 Invalid API Response: empty or unparsable response
此报错由 Cline 解析响应失败抛出，非平台错误码，多因模型返回的工具调用（tool calls）格式与 Cline 不兼容，或返回了空响应。建议：先重试一两次排除偶发空响应；仍报错则换用兼容性更好的模型（如 Claude、GPT 系列）验证；思考类模型需在 MODEL CONFIGURATION 中勾选 Enable R1 messages format。