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

配置#

  1. 打开 Cline 设置 (插件图标 → ⚙️)
  2. API ProviderOpenAI Compatible
  3. 填:
    • Base URL: https://api.dflop.top/v1
    • API Key: sk-gpushare-<64 位十六进制>(在 model.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
日常 codingclaude-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 不能把损失封顶。建议:

  1. 为 Cline 单建一把 Key——价值在用量隔离与可观测(在 用量页 按 Key 看账单),以及可选的 allowed_models 模型白名单
  2. model.dflop.top/dashboard/keys 管理 Key、dflop.top/dashboard/billing 充值(Stripe,最低 $1;注册即送 $0.30 体验额度)
  3. 优先选便宜模型 (gpt-5.4 < claude-opus)

注意 402 预检:gateway 在发上游前会按最坏情况预估本次成本(输出按 max_tokens 或模型 default_max_tokens 上界计算),超过余额直接返回 402。例如 claude-opus-4-6default_max_tokens 是 64000、输出 $75/1M——不显式传小 max_tokens 时,单次调用最坏预估约 $4.80 + 输入,低余额账户几乎每次 Opus 调用都会被拒。解决:在 Cline 里调低 max output tokens,或充值。

常见问题#

现象排查
401 invalid_api_keyKey 无效 / 已吊销 / 已过期,或账号未激活;先确认 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

错误码完整列表 错误码

其他客户端#