Cline Pass 订阅与 API 使用教程：接入 DeepSeek Harness 与 WorkBuddy

准备

• 已开通 Cline Pass 订阅（可在 Cline 官网 或控制台订阅，有优惠码时首月约 $2）
• 电脑上已安装好 DeepSeek Harness 客户端/网页版，或已安装 WorkBuddy 桌面客户端
• 一个文本编辑器或终端环境

步骤

1. 01

   获取 Cline Pass API Key 与接口规范

   Cline Pass 订阅激活后，可以在 Web 控制台生成供第三方工具与 Agent 调用的 API Key：

   • 打开并登录 Cline 控制台；
   • 进入 Settings → API Keys（或直接访问 API 密钥管理页）；
   • 点击 Create API Key，为密钥添加备注名称并生成，立即复制保存（密钥仅显示一次）；
   • Base URL：标准基础地址为 https://api.cline.bot/api/v1（请求端点为 https://api.cline.bot/api/v1/chat/completions）；
   • 模型 ID 规则：调用外部 API 时，模型名必须带 cline-pass/ 前缀。常用模型包括 cline-pass/deepseek-v4-pro、cline-pass/deepseek-v4.1-flash、cline-pass/glm-5.3、cline-pass/qwen3.8-max、cline-pass/kimi-k3 等。

   可以用下方 curl 命令在终端快速自测一次连通性：

   bash复制

   curl https://api.cline.bot/api/v1/chat/completions \
     -H "Authorization: Bearer 你的_CLINE_PASS_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "cline-pass/deepseek-v4-pro",
       "messages": [{"role": "user", "content": "Hello!"}]
     }'

2. 02

   在 DeepSeek Harness（dsh）中添加 Cline Pass 提供商

   启动 DeepSeek Harness 客户端（或终端执行 npx @deepseek-ai/dsh web 启动网页版）：

   • 点击界面左下角或菜单中的 设置 → 模型；
   • 在模型设置页点击「添加模型提供商」；
   • 选择「自定义模型 API」，按下列参数填入：
   • 提供商 ID：填写 clinepass（仅用于本地标识）；
   • API 协议：选择 OpenAI Chat Completions（务必选此协议）；
   • Base URL：填入 https://api.cline.bot/api/v1；
   • API Key：粘贴第一步获取的 Cline Pass 密钥；
   • 模型列表：手动添加模型 ID，例如 cline-pass/deepseek-v4-pro，按需也可继续添加 cline-pass/glm-5.3 或 cline-pass/qwen3.8-max；
   • 点击保存。密钥安全保存在本地 $DSH_HOME/.credentials.yaml 中，界面脱敏显示，修改即时生效。
3. 03

   在 DeepSeek Harness 中选定工作区并驱动 Agent 编程

   Harness 需要在具体的工作区上下文中工作：

   • 点击顶部或侧边的「选择工作区」，选定你的代码项目文件夹（未选择工作区时对话框处于禁用状态）；
   • 在对话框下方的模型下拉菜单中，选择刚添加的 clinepass / cline-pass/deepseek-v4-pro；
   • 发送一条工程需求，例如：“分析当前仓库代码结构，找出所有的 API 路由并输出摘要”；
   • Agent 将自主阅读仓库、规划步骤并执行；随时可点开「工具调用详情」查看完整的执行轨迹。
4. 04

   在 WorkBuddy 图形界面中接入 Cline Pass

   WorkBuddy 支持添加自定义模型用于桌面任务与编程助理：

   • 打开 WorkBuddy 桌面端，单击左下角头像进入「设置」；
   • 选择左侧「模型」导航，在「自定义模型」区域单击「添加模型」；
   • 提供商：选择「自定义 / Custom」；
   • 接口地址：若关闭「完整 URL」开关填 https://api.cline.bot/api/v1；若开启「完整 URL」开关填 https://api.cline.bot/api/v1/chat/completions；
   • API Key：填入 Cline Pass 密钥；
   • 模型名称 / 模型 ID：填写带前缀的完整模型 ID，如 cline-pass/deepseek-v4-pro；
   • 高级设置：务必勾选「工具调用」（智能体执行文件操作与终端命令必需）；若使用的是推理思考模型可勾选「推理模式」；
   • 点击保存，在会话界面模型切换菜单中选中该模型即可直接使用。
5. 05

   （进阶）通过 models.json 批量配置 WorkBuddy / CodeBuddy

   如果你想一次性配置 Cline Pass 的多款模型，可直接编辑 WorkBuddy 本地配置文件（macOS / Linux 位于 ~/.codebuddy/models.json，Windows 位于 %USERPROFILE%\.codebuddy\models.json）：

   保存后 WorkBuddy 会自动热重载生效，无需手动在图形界面逐个录入。

   json复制

   {
     "models": [
       {
         "id": "cline-pass/deepseek-v4-pro",
         "name": "Cline Pass DeepSeek V4 Pro",
         "vendor": "Cline",
         "url": "https://api.cline.bot/api/v1/chat/completions",
         "apiKey": "你的_CLINE_PASS_API_KEY",
         "supportsToolCall": true,
         "supportsReasoning": true
       },
       {
         "id": "cline-pass/glm-5.3",
         "name": "Cline Pass GLM 5.3",
         "vendor": "Cline",
         "url": "https://api.cline.bot/api/v1/chat/completions",
         "apiKey": "你的_CLINE_PASS_API_KEY",
         "supportsToolCall": true
       },
       {
         "id": "cline-pass/qwen3.8-max",
         "name": "Cline Pass Qwen 3.8 Max",
         "vendor": "Cline",
         "url": "https://api.cline.bot/api/v1/chat/completions",
         "apiKey": "你的_CLINE_PASS_API_KEY",
         "supportsToolCall": true
       }
     ]
   }

6. 06

   了解用量限制与额度监控

   Cline Pass 为固定包月订阅，但为防止滥用设有三层用量窗口机制：

   • 5 小时滚动窗口：限制短时间内高并发与密集请求，防止瞬时超载；
   • 每周窗口：平滑周度总调用频次；
   • 每月窗口：保障月度总额度在合理服务区间；
   • 在 Cline 控制台 随时可查看各窗口的使用百分比进度条；
   • 若第三方客户端抛出 429 错误，通常为 5 小时滚动窗口暂时满额，等待时间窗口自然衰减后即可恢复正常调用。

注意事项

• 模型 ID 必须包含 cline-pass/ 前缀：外部端点依赖前缀路由订阅池，省略前缀可能导致 404 模型未找到。
• 必须勾选工具调用：Agent 类工具（Harness / WorkBuddy）完成读写与运行命令必须依赖 Tool Calling，配置时请务必确认开启。
• 注意 Base URL 路径层级：推荐基础地址为 https://api.cline.bot/api/v1，包含 /api/v1。若客户端要求填写完整接口，则以 /chat/completions 结尾。
• 本地安全与凭据管理：API Key 保存在本地客户端配置文件中，请勿上传到公开代码仓库。
• Cline Pass 与按量充值的区别：Cline Pass 是独立包月订阅，外部 API 请求直接抵扣 Pass 配额，不消耗 Cline 平台的按量 Balance。

常见问题

信息来源

• ClinePass 官方文档docs.cline.bot/getting-started/clinepass
• ClinePass 订阅主页cline.bot/cline-pass
• DeepSeek Harness 官方仓库github.com/deepseek-ai/deepseek-harness
• WorkBuddy 模型配置文档www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model
• 腾讯云 models.json 配置指南cloud.tencent.com/document/product/1831/134513

最后核实日期：2026-10-15 · 政策可能随时调整，请以官方页面为准