Cline

Cline 支持 OpenAI Compatible Provider，适合接入 TokenHub 后执行项目阅读、代码修改和命令行任务。

适合场景

Cline 是 VS Code 内的自主编码 Agent，适合“先计划、再读文件、再改代码、最后跑命令”的工作流。首次使用建议限制权限，先让它做只读分析。

安装 Cline

先参考 Cline OpenAI Compatible 官方配置文档。常见安装方式：

打开 VS Code。
进入 Extensions。
搜索 Cline。
安装官方扩展并重新加载窗口。

安装后，侧边栏会出现 Cline 图标。

准备 TokenHub 凭证

export TOKENHUB_API_KEY="sk-..."

先在 TokenHub 模型列表中选一个上下文长度和工具调用能力适合代码任务的模型。

持久化设置位置

Cline 是 VS Code 扩展，但 provider 配置应通过 Cline 自己的设置面板保存，而不是手写 VS Code 私有配置字段。官方 OpenAI Compatible 页面当前要求在 Cline 设置里选择 provider、填写 Base URL、API Key 和 Model ID。

位置	用途
Cline 设置面板	保存当前用户的 provider、模型和权限偏好。
Cline API 配置/账户页	粘贴或更新 TokenHub API Key。
团队文档	只记录 Base URL、Model ID 和权限建议，不记录真实 API Key。

不要把 TokenHub API Key 提交到项目仓库。Cline 扩展内部 schema 可能随版本变化，团队教程应共享字段值，而不是共享未验证的 JSON key。

配置 API Provider

打开 Cline 设置，选择 API Provider 为 OpenAI Compatible，然后填写：

字段	值
Base URL	`https://us-api.tokenhub.com/v1`
API Key	`TOKENHUB_API_KEY` 对应的密钥值
Model ID	TokenHub 模型列表中的模型名称

如果 Cline 提供 “Use Azure” 或其他专用供应商选项，不要启用；保持 OpenAI Compatible 模式即可。

权限	建议
文件读取	允许，便于分析项目结构
文件写入	先关闭或逐次确认
终端命令	逐次确认，尤其是安装依赖、删除文件、运行迁移等命令
浏览器访问	仅在任务需要时开启

验证

在一个测试仓库中让 Cline 执行只读任务：

扫描项目结构，并列出你会优先阅读的 5 个文件。不要修改代码，也不要运行命令。

确认 Cline 能正常返回后，再授权它读写文件或运行命令。

常见问题

现象	处理方式
401	检查 API Key 是否完整复制。
404	检查 Base URL 是否包含 `/v1`。
工具调用失败	先用只读任务验证模型本身，再逐步开启文件读写和终端权限。
自动批准太危险	关闭 Auto-approve，要求 Cline 每次修改文件或运行命令前等待确认。
响应慢	换用 TokenHub 中更快的模型，或把 Fast/Light 任务拆给低延迟模型。