# Cline 集成

> VS Code AI 编程插件配置 OpenAI Compatible Provider 指向本网关

来源：https://zhonkemodel.dflop.top/docs/integrations/cline

> Cline 是 VS Code 里的 AI Coding 插件,原生支持 Custom API Provider。

## 安装

```text
VS Code → Extensions → 搜 "Cline" → 安装
（Marketplace ID: saoudrizwan.claude-dev）
```

或访问插件页 [marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev)。

## 配置

1. 打开 Cline 设置 (插件图标 → ⚙️)
2. **API Provider** 选 **OpenAI Compatible**
3. 填:
   - Base URL: `https://zhonkezhonkeapi.dflop.top/v1`
   - API Key: `sk-gpushare-<64 位十六进制>`（在 [zhonkemodel.dflop.top/dashboard/keys](https://zhonkezhonkemodel.dflop.top/dashboard/keys) 创建，之后可在 Key 详情页随时重新查看）
   - Model ID: `claude-sonnet-4-6` (或任意想用的模型)
4. 保存,开始用

## 模型推荐

Cline 跑的是 multi-file edits / agentic loops,对模型推理能力要求高:

| 用途 | 推荐 model |
|---|---|
| 复杂重构 / 多文件编辑 | `claude-opus-4-8`, `claude-opus-4-7` |
| 日常 coding | `claude-sonnet-4-6`, `gpt-5.5` |
| 快速响应 | `gemini-2.5-flash`, `grok-4-fast-non-reasoning` |
| 推理任务 | `grok-4-fast-reasoning`, `deepseek-v4-pro` |
| 长上下文 (大代码库) | `gemini-2.5-pro` (2M), `kimi-k2.6` (256K) |

> 小上下文模型（32K 窗口一档）不适合 Cline：系统提示 + 多文件上下文动辄数万 token，很容易超窗报错。

完整模型列表见 [模型列表](../reference/models.md)。

## 行为

Cline 走 **OpenAI Chat 协议** + **Function Tools**。文本类模型（101 个）均可在 Cline 使用，是否支持 function tools 见模型列表的 `supports_tools` 标记（绝大多数支持）。图像 / 视频 / embedding 类 SKU 不走 Chat 路径，不适用于 Cline，详见 [图像 / 视频 / 音乐 API](../reference/media-apis.md)。

## 注意事项

### Cline + Tool Use 跨厂商

Cline 大量用 function tools。本网关翻译路径完整支持:
- 用 Claude 模型 → gateway T1 翻译（OpenAI Chat → Anthropic Tool Use）
- 用 Gemini 模型 → gateway T2 翻译（OpenAI Chat → Gemini Native）
- 用 GLM / Grok / DeepSeek / Kimi 等 OpenAI 兼容上游 → 原生直传，无协议翻译

详见 [工具调用](../guides/tool-calling.md)。

### 费用监控

Cline 的 agentic loop 可能一次任务 10–50 次模型调用,费用容易超预期。计费走**账户统一余额**（美元钱包）：所有 API Key 共享同一余额，Key 本身没有独立预算池——任何一把 Key 都能花到余额耗尽，单建 Key **不能**把损失封顶。建议:
1. 为 Cline 单建一把 Key——价值在**用量隔离与可观测**（在 [用量页](https://zhonkezhonkemodel.dflop.top/dashboard/usage) 按 Key 看账单），以及可选的 `allowed_models` 模型白名单
2. 在 [zhonkemodel.dflop.top/dashboard/keys](https://zhonkezhonkemodel.dflop.top/dashboard/keys) 管理 Key、dflop.top/dashboard/billing 充值（Stripe，最低 $1；注册即送 $0.30 体验额度）
3. 优先选便宜模型 (`gpt-5.5` < `claude-opus`)

**注意 402 预检**：gateway 在发上游前会按**最坏情况**预估本次成本，超过余额直接返回 `402`。输出项的估法：客户端**显式传了** `max_tokens` 就按传值估；**没传**则按 `min(模型 default_max_tokens, 32768)` 估（模型的输出天花板可以远大于此——如 gpt-5.x 与 Claude Opus 为 128K，未传参时不按天花板全额预估，避免低余额账户被误拒）。例如 `claude-opus-4-6` 输出 $75/1M，不传 `max_tokens` 时最坏预估约 $2.46 + 输入（限时六折促销期间按折后价预估，约 $1.47）。显式传大 `max_tokens`（如 64000）则按传值全额预估。余额吃紧时：在 Cline 里调低 max output tokens，或充值。

## 常见问题

| 现象 | 排查 |
|---|---|
| 401 `invalid_api_key` | Key 无效 / 已吊销 / 已过期，或账号未激活；先确认 Key 复制完整 |
| 402 `quota_exceeded` | 余额不足，或最坏成本预估超余额（见上节）；调低 `max_tokens` 或 充值 |
| 400 `model_not_found` | 模型 ID 拼写;特别是带日期后缀的 Claude 模型 |
| 400 `model_not_allowed` | 该 Key 设置了 `allowed_models` 白名单且不含此模型 |
| 403 | 基本只来自上游透传，gateway 自身不产 403 |
| 503 `no_channel_available` | 该模型当前协议无可用通道；换 model 重试，持续不通请反馈 |
| 任务跑飞太贵 | 改用便宜模型 / 降低 max_tokens |

错误码完整列表 [错误码](../reference/errors.md)。

## 其他客户端

- [Claude Code](./claude-code.md) — 命令行 AI 编程
- [Cursor](./cursor.md) — IDE 内置 AI
- [Continue.dev](./continue.md) — VS Code / JetBrains
- [Open WebUI](./open-webui.md) — 自托管 ChatGPT 界面
- [FlopCode](./flopcode.md) — 本平台官方 fork