跳转到主要内容
Cline 通过其 OpenAI Compatible 提供商与 Tokios 通信。将提供商的 Base URL 设置为 https://api.tokios.com/v1，API Key 设置为您的 sk-tok-… 密钥，Model ID 设置为您注册的 Tokios 部署名称——Cline 随后会将每个请求通过您的私有隧道路由到您的本地模型。

​
先决条件

  • 一个已运行并与您的本地模型配对的 Tokios 连接器——请参阅 连接器安装
  • 一个已注册的模型部署名称——请参阅 注册模型
  • 一个 Tokios API 密钥——请参阅 API 密钥
  • 在 VS Code（或兼容编辑器）中安装了 Cline 扩展

​
在 Cline 中配置 OpenAI 兼容提供商

1

打开 Cline 设置

点击 Cline 面板中的齿轮图标以打开 Settings。
2

选择 OpenAI 兼容提供商

在 API Provider 下拉菜单中，选择 OpenAI Compatible。
3

设置基础 URL

在 Base URL 字段中，输入：
4

设置 API 密钥

在 API Key 字段中，粘贴您的 Tokios 密钥：
5

设置模型 ID

在 Model ID 字段中，输入您的 Tokios 部署名称——即您在 Models 选项卡中注册的公共名称，例如 gemma-tunnel。这不是您的后端使用的本地/上游模型 ID。
6

手动设置上下文窗口和最大输出

OpenAI 兼容提供商不会自动检测模型限制。请填写 Context Window 和 Max Output Tokens 以匹配您部署的底层模型，以便 Cline 正确调整请求大小。
此处的 Model ID 字段始终是您注册的 部署名称，而不是由 Ollama、llama.cpp、vLLM 或 LM Studio 提供的上游模型 ID。请参阅 注册模型。

​
如果 curl 请求成功但 Cline 返回 400 错误

如果普通的 curl 请求成功访问 https://api.tokios.com/v1/chat/completions，但 Cline 返回 400 错误，请按以下顺序排查：
Cline 会将 /chat/completions 附加到您输入的 Base URL 之后。请输入 https://api.tokios.com/v1——如果您粘贴了完整路径（https://api.tokios.com/v1/chat/completions），Cline 将请求一个重复的路径，Tokios 会返回错误。Tokios 提供稳定的 /v1 OpenAI 接口，因此根路径是明确的：始终是 https://api.tokios.com/v1，无需附加任何内容。
此处的 Model ID 字段必须与 Models 选项卡中显示的公共部署名称完全一致——而不是上游模型 ID，也不是拼写错误的变体。名称不匹配通常表现为 404 错误，但格式错误的模型字符串（多余的空格、部署名称区分大小写导致的错误大小写）也可能返回 400 错误。
Cline 默认请求流式响应。对于 "stream": true 的 /v1/chat/completions 请求，Tokios 返回标准 OpenAI 格式的 SSE，因此这应该开箱即用。如果 Cline 发送的请求参数不受您的本地后端支持，后端可能会在 Tokios 看到路由问题之前将其作为 400 错误拒绝。
400 错误表示 Tokios 无法处理请求体本身。如果基础 URL 和模型 ID 都正确，请检查 Cline 的高级设置中是否有多余的提供商专用选项（通用 OpenAI 兼容后端不需要的字段）。

​
错误参考

​
后续步骤

一旦 Cline 指向 Tokios，相同的基础 URL、API 密钥和部署名称即可用于您同时运行的任何其他 OpenAI 兼容工具——无需为每个客户端设置额外的隧道或端口转发。

兼容客户端

查看其他所有受支持客户端的基础 URL 和密钥设置。

API 密钥

为团队成员和智能体创建、限定范围并轮换 sk-tok-… 密钥。