工具集成 · OpenAI Chat Completions
在 Cline 中使用 TokenRa
Cline 是一款开源 AI 编程助手，支持 VS Code、JetBrains 和终端。选择 OpenAI Compatible 供应商，填入 Base URL、API Key 和模型 ID 即可接入 TokenRa。我们用 Cline CLI 3.0.74 实测了以下配置，CLI 与 VS Code 插件共用同一套 Agent 内核和供应商配置。
- Base URL
https://tokenra.io/v1- 供应商
- OpenAI Compatible
- 接口格式
- OpenAI Chat Completions
- 实测版本
- Cline CLI 3.0.74
Before you start
准备工作
Configure
配置 TokenRa
- 点击活动栏中的 Cline 图标打开面板。首次使用时在欢迎页选择使用自己的 API Key；已经配置过的话，点击齿轮图标进入设置。
- 把 API Provider 选为 OpenAI Compatible。
- 按下表填写三项内容。
- 点击 Done 保存，输入框下方会显示当前模型，输入任务即可开始。
| 配置项 | 填写内容 |
|---|---|
| Base URL | https://tokenra.io/v1，需要带 /v1 |
| API Key | 你的 TokenRa API Key（sk-...） |
| Model ID | TokenRa 模型 ID，例如 deepseek-v4.1-flash |
OpenAI Compatible 还有上下文窗口、是否支持图片等可选的模型参数，只影响 Cline 如何分配上下文和显示费用；下表中的模型在默认设置下均可正常使用。
Cline CLI
终端版使用同样的供应商配置，其中 openai 就是 OpenAI Compatible 的 ID：
npm install -g cline
cline auth --provider openai --apikey sk-... --modelid deepseek-v4.1-flash --baseurl https://tokenra.io/v1
cline "解释这个仓库是做什么的"cline auth 成功后会输出 Provider configured: openai-compatible (deepseek-v4.1-flash)。加上 --yolo 可以让任务在不弹出确认的情况下运行。
Models
实测可用的模型
2026-10-29，以下模型均在 Cline CLI 3.0.74 中完成了同一个任务：读取文件、写入新文件并检查结果。耗时为单次运行时长。
| 模型 | 模型 ID | 任务耗时（单次） |
|---|---|---|
| DeepSeek V4.1 Flash | deepseek-v4.1-flash | 12 秒 |
| GLM-5.3 | glm-5.3 | 12 秒 |
| Qwen3.8 Max | qwen3.8-max | 27 秒 |
| MiniMax M3.1 Flash | minimax-m3.1-flash | 29 秒 |
| Kimi K3.1 Pro | kimi-k3.1-pro | 57 秒 |
glm-5.3-flash, kimi-k3, minimax-m3, qwen3.8-flash, mimo-v2.5, omen-alpha 也在 Cline 使用的 /v1/chat/completions 接口上完成了流式工具调用的完整往返。
gemini-3.8-flash 不能用于此类工具：它的上游会拒绝所有带工具定义的请求（HTTP 400），而编程助手的每个请求都带有工具。FAQ
常见问题
报错 401：Key 无效
请检查 Key 是否正确，以及 Base URL 是否为 https://tokenra.io/v1。必要时到「API 密钥」重新复制。
报错 503：model_not_found
Model ID 不是 TokenRa 的模型 ID，请从模型列表中复制。
任务执行很慢
Cline 每执行一步都会发起一次请求，推理模型每一步前都要思考：测试任务中 Kimi K3.1 Pro 约用 1 分钟，DeepSeek V4.1 Flash 和 GLM-5.3 约 12 秒。