VS Code 的 Cline 是什么？
Cline 是 VS Code 的开源编码代理，可以使用自定义 OpenAI-compatible API 来读取代码、提出编辑建议和运行批准的工具。
此 Cline VS Code 设置将您的提供商凭据和模型选择保留在 Cline 自己的设置中，然后在批准任何写入访问之前验证与只读编码任务的连接。 Cline 将模型响应与文件访问、终端命令、浏览器操作和编辑器内的审批控件相结合。成功的聊天响应只是第一次检查：使用测试工作区，最初禁用自动批准，并在依赖模型进行编辑或长时间自主任务之前验证 native tool calling。
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 任务拆给低延迟模型。 |
推荐模型怎么选？
Cline 用于 VS 代码 API FAQ
Cline中的TokenHub配置应该保存在哪里？
通过Cline的API Provider设置面板保存。团队文档可以共享 Base URL 和模型 ID，但永远不会共享真正的 API 密钥。
为什么Cline可以回答问题但不能编辑文件？
首先确认模型支持工具使用，然后检查Cline的文件写入权限和审批设置。文本响应仅证明基本连接有效。
为什么重新打开工作区后提供商会发生变化？
工作区级别的配置可能会覆盖用户设置。检查活动提供商 Base URL 和模型 ID 是否仍指向 TokenHub。
Cline API 费用是如何计算的？
扩展和型号 API 是单独的计费层。 TokenHub 根据所选模型的实际令牌和适用的缓存使用情况以当前模型页面价格收费。
Cline 规则和 .clinerules 的作用是什么？
它们提供项目约定、命令约束和工作流程指南。它们不会替换 Provider Base URL、API 密钥或 Model ID 配置。
配置资料
本页配置以 TokenHub 教程和官方资料为依据，最后核验于 2026-09-04。
