注册
各种插件/软件使用教程 / cline 配置教程

Cline 配置教程

Cline 是 VS Code 里很强的代理式编码扩展，适合文件读写、终端执行、逐步规划和多轮改代码。对接 QuickRouter 时，推荐使用 Cline 官方提供的 OpenAI Compatible provider。

概览

通过 Cline 的 OpenAI Compatible provider，你可以把代理请求发到 QuickRouter：

  • 推荐协议：OpenAI-compatible API
  • Base URL：https://api.quickrouter.ai/v1
  • 认证方式：sk-... token
  • 推荐默认模型：claude-sonnet-4-6 或 gpt-5.4

适合谁用

  • 想在 VS Code 中获得代理式编程体验的人
  • 想结合 QuickRouter 的多模型能力做代码修改的人
  • 想把 IDE 代理流量与 CLI 流量分开统计的人
  • 想把 Claude、GPT 等模型切到统一网关的人

使用协议

推荐协议：OpenAI-compatible API
在 Cline 设置中选择：

  • API Provider: OpenAI Compatible
  • Base URL: https://api.quickrouter.ai/v1
  • API Key: 你的 sk-...
  • Model ID: 你要使用的模型名

不要把 Base URL 写成：

  • https://api.quickrouter.ai
  • https://api.quickrouter.ai/v1/chat/completions

系统要求与前置条件

项目说明
QuickRouter 账号先在 api.quickrouter.ai 注册
QuickRouter token建议为 Cline 单独创建一个 token
Git建议 git 2.23+
VS Code建议当前稳定版
Cline 扩展建议当前版本
可用模型至少放行 1 到 2 个适合代理式编码的模型
环境变量标准 VS Code 接法通常不需要

建议初始白名单：

  • claude-sonnet-4-6
  • gpt-5.4
  • gemini-3-pro-preview

按操作系统的完整安装路径

Windows 推荐路径

Cline 在 Windows 上最稳妥的路径是：Git + VS Code + 扩展市场安装 Cline + 在 Cline 设置里直接填 QuickRouter 参数。
推荐顺序：

  1. 安装 Git
  2. 安装 VS Code
  3. 在 VS Code 扩展市场安装 Cline
  4. 在 QuickRouter 创建 Cline 专用 token
  5. 打开仓库并先做 Git 快照
  6. 在 Cline 设置里填写 OpenAI Compatible、Base URL、API Key、Model ID

推荐验证命令：

git --version
where.exe git
code --version
where.exe code

如果 code --version 找不到命令，但 VS Code 本体能正常打开，也不影响 Cline 使用；只是你暂时不能从终端直接用 code 打开目录。

macOS 推荐路径

Cline 在 macOS 上最顺手的路径通常是：Xcode Command Line Tools + Homebrew + Git + VS Code + 扩展市场安装 Cline。
推荐顺序：

  1. 安装 Xcode Command Line Tools
  2. 安装 Homebrew（如果你还没有）
  3. 安装 Git
  4. 安装 VS Code
  5. 在 VS Code 里安装 Cline
  6. 在 Cline 设置里直接填写 QuickRouter 参数

推荐验证命令：

git --version
which git
open -a "Visual Studio Code"

如果你想从终端直接使用 code 命令，可以在 VS Code 命令面板里执行 Shell Command: Install 'code' command in PATH，然后再检查：

code --version
which code

Linux 说明

Linux 用户基本可以按 Windows / macOS 的思路理解：先装 Git 和 VS Code，再在扩展市场安装 Cline。Ubuntu / Debian 常见命令如下：

sudo apt update
sudo apt install -y git
sudo snap install code --classic
git --version
code --version

推荐模型配置

使用场景推荐模型原因
默认主力代理claude-sonnet-4-6多轮规划、代码解释、长上下文表现稳
OpenAI 兼容基线gpt-5.4适合做 OpenAI 兼容主基线
Gemini 备用档gemini-3-pro-preview适合作为第二条兼容性验证路径

建议先用 claude-sonnet-4-6 跑通代理流程；如果你要补 OpenAI 兼容基线，再切到 gpt-5.4。

Token 设置最佳实践

设置建议说明
专用 token必须Cline 不要和 Cursor、Claude Code、Aider 共用 token
模型白名单强烈建议Cline 是高消耗工具，白名单越窄越安全
IP 限制固定办公环境建议开启笔记本移动网络下谨慎使用
配额上限强烈建议代理式多轮执行很容易把额度打满
环境隔离建议个人 VS Code、远程开发机、团队共享环境分开 token
权限隔离强烈建议高风险仓库最好配更小额度的单独 token

验证清单

  • git --version 正常
  • VS Code 已正常安装
  • 如需终端打开项目，code --version 也正常
  • Cline 扩展已安装并能打开
  • Cline 已选择 OpenAI Compatible provider
  • Base URL 已设置为 https://api.quickrouter.ai/v1
  • API Key 已填写正确
  • Model ID 已填写可用模型
  • 第一个只读任务执行成功
  • 文件读写或命令执行任务能按预期工作
  • QuickRouter 后台日志中能看到对应请求

常见错误与修复

现象常见原因修复方式
扩展装好但看不到 Cline 图标VS Code 没刷新，或扩展未正确激活重启 VS Code，再从命令面板打开 Cline
code 命令不可用VS Code 本体装好了，但 shell 命令没进 PATHWindows 重新开终端再试；macOS 在命令面板执行 Shell Command: Install 'code' command in PATH
401 unauthorizedAPI Key 错误、过期或复制错误重新生成 token 并重新粘贴
403 / model not allowedtoken 未放行当前模型在 QuickRouter token 设置中放行模型
404Base URL 填成根域名或具体接口路径改成 https://api.quickrouter.ai/v1
model not foundModel ID 名称写错或当前模型不可用改回 claude-sonnet-4-6 或其他已放行模型
企业网络下连不上代理或防火墙阻断先检查 VS Code 自己的代理设置；Cline 扩展会复用 VS Code 的网络代理配置
写了不该写的文件一开始给了过大的写权限先从只读任务和小范围 diff 验证开始
成本上涨过快多轮计划 + 大量上下文 + 自动执行缩小任务范围，并给 Cline 单独设预算

性能与成本建议

  • 第一次接入时，先只做只读任务和小范围修改
  • 复杂重构优先 claude-sonnet-4-6 或 gpt-5.4
  • 高频轻任务先不要扩太多模型，优先保持白名单收敛
  • 不同工作区或不同项目类型建议用不同 token
  • 每次执行大任务后，回看 QuickRouter 日志确认真实消耗

FAQ

Cline 应该选哪个 Provider？

选 OpenAI Compatible。

Base URL 应该填什么？

填 https://api.quickrouter.ai/v1。

Cline 这条接法一定要写环境变量吗？

通常不用。标准 VS Code 接法一般直接在 Cline 设置界面里填写 Base URL、API Key 和 Model ID 就够了。

第一次为什么要先做 Git 快照？

因为 Cline 是真正会读写文件和执行命令的代理。先做快照，review 和回退都会更轻松。

第一个推荐模型是什么？

先用 claude-sonnet-4-6。

为什么不建议一开始就给它很大权限？

因为 Cline 会真正操作你的工作区。先用只读、小范围任务验证，是最稳妥的上线方式。

相关文档

cline API 中转配置要点

如果你通过搜索“cline 配置教程”“cline API 中转”“cline QuickRouter”进入本页，优先检查 API Key、Base URL 和模型 ID。多数调用失败都和这三个配置有关。

配置项填写建议常见问题
API Key填写 QuickRouter 控制台创建的密钥401 通常是 Key 错误、过期或额度不足
Base URL按本页工具要求填写 QuickRouter 接口地址；OpenAI 兼容工具通常使用 https://api.quickrouter.ai/v1Claude/Anthropic 类工具不一定带 /v1
模型 ID从价格页复制完整模型名model not found 通常是模型名或分组权限问题

常见排查方向

  • 401 Unauthorized：检查 API Key 是否复制完整、是否仍有额度。
  • 404 或 model not found：检查模型 ID 是否来自 QuickRouter 价格页，确认当前分组支持该模型。
  • 连接超时：确认工具里的 Base URL 没有多写路径或空格。
  • Claude 相关工具异常：优先查看本页是否要求 Anthropic 原生地址，不要直接套用 OpenAI 兼容地址。

相关入口

常见问题

cline 可以通过 QuickRouter API 接入大模型吗？

可以。只要 cline 支持自定义 API Key、Base URL 或兼容 OpenAI/Claude 的接口，就可以按本页方式接入 QuickRouter。

cline 的 Base URL 应该怎么填？

按本页对应工具的要求填写。OpenAI 兼容工具通常使用 https://api.quickrouter.ai/v1，Claude/Anthropic 类工具可能使用 https://api.quickrouter.ai。

cline 提示 model not found 怎么办？

到 模型价格和分组 页面复制完整模型 ID，并确认 API Key 所在分组支持该模型。

← dify添加模型 aider 配置教程 →