Cline 集成
VS Code AI 编程插件配置 OpenAI Compatible Provider 指向本网关
Cline 是 VS Code 里的 AI Coding 插件,原生支持 Custom API Provider。
安装#
VS Code → Extensions → 搜 "Cline" → 安装
(Marketplace ID: saoudrizwan.claude-dev)
或访问插件页 marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev。
配置#
- 打开 Cline 设置 (插件图标 → ⚙️)
- API Provider 选 OpenAI Compatible
- 填:
- Base URL:
https://api.dflop.top/v1 - API Key:
sk-gpushare-<64 位十六进制>(在 model.dflop.top/dashboard/keys 创建,之后可在 Key 详情页随时重新查看) - Model ID:
claude-sonnet-4-6(或任意想用的模型)
- Base URL:
- 保存,开始用
模型推荐#
Cline 跑的是 multi-file edits / agentic loops,对模型推理能力要求高:
| 用途 | 推荐 model |
|---|---|
| 复杂重构 / 多文件编辑 | claude-opus-4-8, claude-opus-4-7 |
| 日常 coding | claude-sonnet-4-6, gpt-5.4 |
| 快速响应 | 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,很容易超窗报错。
完整模型列表见 模型列表。
行为#
Cline 走 OpenAI Chat 协议 + Function Tools。文本类模型(70+ 个)均可在 Cline 使用,是否支持 function tools 见模型列表的 supports_tools 标记(绝大多数支持)。图像 / 视频 / embedding 类 SKU 不走 Chat 路径,不适用于 Cline,详见 图像 / 视频 / Embedding API。
注意事项#
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 兼容上游 → 原生直传,无协议翻译
详见 工具调用。
费用监控#
Cline 的 agentic loop 可能一次任务 10–50 次模型调用,费用容易超预期。计费走账户统一余额(美元钱包):所有 API Key 共享同一余额,Key 本身没有独立预算池——任何一把 Key 都能花到余额耗尽,单建 Key 不能把损失封顶。建议:
- 为 Cline 单建一把 Key——价值在用量隔离与可观测(在 用量页 按 Key 看账单),以及可选的
allowed_models模型白名单 - 在 model.dflop.top/dashboard/keys 管理 Key、dflop.top/dashboard/billing 充值(Stripe,最低 $1;注册即送 $0.30 体验额度)
- 优先选便宜模型 (
gpt-5.4<claude-opus)
注意 402 预检:gateway 在发上游前会按最坏情况预估本次成本(输出按 max_tokens 或模型 default_max_tokens 上界计算),超过余额直接返回 402。例如 claude-opus-4-6 的 default_max_tokens 是 64000、输出 $75/1M——不显式传小 max_tokens 时,单次调用最坏预估约 $4.80 + 输入,低余额账户几乎每次 Opus 调用都会被拒。解决:在 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 |
错误码完整列表 错误码。
其他客户端#
- Claude Code — 命令行 AI 编程
- Cursor — IDE 内置 AI
- Continue.dev — VS Code / JetBrains
- Open WebUI — 自托管 ChatGPT 界面
- FlopCode — 本平台官方 fork