Cline 配置教程

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

概览

通过 Cline 的 OpenAI Compatible provider，你可以把代理请求发到 巨蓝鲸AI：

• 推荐协议：OpenAI-compatible API
• Base URL：https://api.julanjing.com/v1
• 认证方式：sk-... token
• 推荐默认模型：deepseek-v4.1-flash 或 glm-5.3

适合谁用

• 想在 VS Code 中获得代理式编程体验的人
• 想结合 巨蓝鲸AI 的多模型能力做代码修改的人
• 想把 IDE 代理流量与 CLI 流量分开统计的人
• 想把 DeepSeek 和 GLM 模型切到统一网关的人

使用协议

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

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

不要把 Base URL 写成：

• https://api.julanjing.com
• https://api.julanjing.com/v1/chat/completions

系统要求与前置条件

建议初始白名单：

• deepseek-v4.1-flash
• glm-5.3
• glm-5.3

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

Windows 推荐路径

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

1. 安装 Git
2. 安装 VS Code
3. 在 VS Code 扩展市场安装 Cline
4. 在 巨蓝鲸AI 创建 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 设置里直接填写 巨蓝鲸AI 参数

推荐验证命令：

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

推荐模型配置

建议先用 deepseek-v4.1-flash 跑通代理流程；如果你要补 OpenAI 兼容基线，再切到 glm-5.3。

Token 设置最佳实践

验证清单

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

常见错误与修复

性能与成本建议

• 第一次接入时，先只做只读任务和小范围修改
• 复杂重构优先 deepseek-v4.1-flash 或 glm-5.3
• 高频轻任务先不要扩太多模型，优先保持白名单收敛
• 不同工作区或不同项目类型建议用不同 token
• 每次执行大任务后，回看 巨蓝鲸AI 日志确认真实消耗

FAQ

Cline 应该选哪个 Provider？

选 OpenAI Compatible。

Base URL 应该填什么？

填 https://api.julanjing.com/v1。

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

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

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

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

第一个推荐模型是什么？

先用 deepseek-v4.1-flash。

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

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