AI 编程工具统一接国产模型：六款工具接入完整配置

发布日期：2026-10-28 ｜数据截至 2026-10-28，来源为各工具官方文档及开发者社区实测

2026 年，重度使用 AI 编程工具的开发者普遍遇到同一个问题：Cursor 一个 API Key，Claude Code 一个，Windsurf 一个，DeepSeek Harness 再来一个，WorkBuddy 又是另一套账号——月底对账才发现五份账单、四家平台、还有一个 Key 不知道在哪次配置里泄露了。这不是个例。好消息是：Cursor、Claude Code、Windsurf、Cline、DeepSeek Harness、WorkBuddy 这六款工具全部支持自定义 Base URL，本质上都接受 OpenAI Chat Completions 兼容协议（dsh 额外支持原生 Anthropic 协议）。把它们统一接到七牛云 Token Plan，一套 Key 覆盖所有工具，DeepSeek、Kimi、GLM、MiniMax 等国产模型随时切换，账单合并在一个平台。本文给出六款工具的完整配置步骤。

为什么统一接入，而不是每个工具单独配

六款工具的默认接入方式各不相同：

工具	默认计费模式	痛点
Cursor	订阅制（$20/月），内嵌模型	Agent 模式耗额度快，国产模型无法直接选
Claude Code	纯 API 计费，走 Anthropic	国内访问受限，账单与其他工具割裂
Windsurf	订阅 + BYOK	BYOK 模式配置门槛略高，改完需重启
Cline	纯 API 计费，OpenAI 兼容	配置项多，换模型需逐个改
DeepSeek Harness	官方 DeepSeek API 或自定义端点	默认只走 DeepSeek 官方，接其他模型需额外配
WorkBuddy	内置模型 + 自定义模型	国产模型切换路径隐藏在"模型管理"深处

统一接入的核心逻辑：这六款工具发出的 HTTP 请求格式都兼容 OpenAI Chat Completions，只要把 Base URL 指向同一个聚合平台，换模型只改 Model ID，不需要动工具本身，账单也在同一个地方看。

前置准备：七牛云 Token Plan 三件套

以下所有配置示例均以七牛云 Token Plan 为接入平台，覆盖 DeepSeek、Kimi、GLM、MiniMax 等主流国产模型，支持按量和订阅两种计费模式。

登录七牛云控制台创建 API Key 后，三件套如下：

参数	七牛云 Token Plan 的值
Base URL	`https://api.qnaigc.com/v1/`
API Key	控制台"密钥管理"创建，`sk-` 开头
Model ID	如 `deepseek-v4-pro`、`kimi-k3-1-pro`、`glm-4-plus`、`minimax-text-01`

Base URL 固定到 /v1 层，工具会自己拼后面的 /chat/completions，不要多加斜杠。

Cursor 接入七牛云

配置路径：Settings → Models → OpenAI API Key（展开后出现 Base URL 输入框）

Base URL：https://api.qnaigc.com/v1
API Key：sk-你的七牛云Key

填完后点 + Add Model，手动输入 Model ID（Cursor 不自动拉取模型列表）：

deepseek-v4-pro

点 Verify，按钮变绿说明通道正常。

常见问题：内置的 claude-* 模型不走自定义 Base URL——要把内置模型取消勾选，只留手动添加的 Model ID，否则补全请求还是发到 Anthropic 官方。

Claude Code 接入七牛云

Claude Code 走 Anthropic Messages 协议，通过环境变量自定义端点：

export ANTHROPIC_BASE_URL="https://api.qnaigc.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-你的七牛云Key"
export ANTHROPIC_MODEL="deepseek-v4-pro"

写进 ~/.claude/settings.json 可持久化，不用每次重新 export：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.qnaigc.com/v1",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的七牛云Key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro"
  }
}

关键细节：鉴权字段是 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY——字段名写错会卡在 OAuth 登录界面出不来，是最高频的踩坑点。

安全提示：近期出现通过恶意 AGENTS.md 文件篡改 ANTHROPIC_BASE_URL 的攻击。配置完后定期检查 ~/.claude/settings.json 里的 Base URL 是否仍然是自己填的地址。

Windsurf 接入七牛云（BYOK 模式）

Settings → Models → Custom / OpenAI Compatible，填入：

{
  "provider": "openai-compatible",
  "baseUrl": "https://api.qnaigc.com/v1",
  "apiKey": "sk-你的七牛云Key",
  "model": "deepseek-v4-pro"
}

改完必须完全退出进程重启（macOS 用 Cmd+Q，不是关窗口），否则缓存不刷新，配置看似已保存但实际没生效。

Cline 接入七牛云

VS Code 扩展设置 → API Provider → OpenAI Compatible：

{
  "cline.apiProvider": "openai",
  "cline.openAiBaseUrl": "https://api.qnaigc.com/v1",
  "cline.openAiApiKey": "sk-你的七牛云Key",
  "cline.openAiModelId": "deepseek-v4-pro"
}

Cline 改完即生效，不需要重启。

DeepSeek Harness（dsh）接入七牛云

dsh 的自定义模型配置有两种路径，推荐用 Web UI，配置写入后无需重启即生效。

方式一：Web UI

Settings → Models → Add model provider → Custom model API

字段	填写内容
Provider ID	小写字母，保存后不可更改，如 `qiniu`
Base URL	`https://api.qnaigc.com/v1`
API protocol	`OpenAI Chat Completions`
API key	`sk-你的七牛云Key`

填完后点 Fetch available models 自动拉取模型列表，或手动填写 Model ID。

方式二：直接编辑 cordis.patch.yml（$DSH_HOME/profiles/web/cordis.patch.yml）

- id: llm-qiniu
  config:
    providers:
      qiniu-gateway:
        api: openai-completions
        baseURL: https://api.qnaigc.com/v1
        apiKeyEnv: QINIU_API_KEY
        models:
          - id: deepseek-v4-pro
          - id: kimi-k3-1-pro
          - id: glm-4-plus

同时在 $DSH_HOME/.credentials.yaml 里配置 Key：

QINIU_API_KEY: sk-你的七牛云Key

兼容性补丁：部分第三方网关不支持 developer role 和 max_completion_tokens 字段，遇到报错时在 provider 配置里加：

compat:
  supportsDeveloperRole: false
  maxTokensField: max_tokens

Provider ID 保存后永久不可更改，命名时想清楚。配置修改后下一次请求立即生效，不需要重启 dsh。

WorkBuddy 接入七牛云

WorkBuddy 是腾讯系桌面 AI 客户端，支持读写本地文件、生成 Office 文档、数据分析、代码生成，自定义模型入口在模型管理页。

配置路径：设置 → 模型管理 → 添加自定义模型（或对话页模型下拉框底部的"添加自定义模型"）

字段	填写内容
Base URL	`https://api.qnaigc.com/v1/chat/completions`
API Key	`sk-你的七牛云Key`
Model ID	`kimi-k3-1-pro` 或 `deepseek-v4-pro` 等
模型名称	自定义显示名，如"DeepSeek 旗舰"

填完保存后，在对话页模型下拉框里选择刚添加的自定义模型即可使用。WorkBuddy 改完即生效，不需要重启。

统一接入后按任务类型选模型

接入层统一到七牛云之后，换模型只需改 Model ID，不动 Base URL 和 Key：

任务类型	推荐 Model ID	原因
日常补全 / 快速问答	`kimi-k3-1-pro-highspeed`	速度快，高频调用成本低
多文件重构 / 复杂 Agent	`deepseek-v4-pro`	推理强，上下文长
中文文档 / 注释生成	`glm-4-plus`	中文质量稳定
代码审查 / 方案评审	支持 `reasoning_effort` 的思考型模型	需要深度推理

验证配置是否真正生效

配置完后用 curl 直接打一次接口，比在工具里反复点 Verify 更可靠：

curl -X POST https://api.qnaigc.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的七牛云Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [{"role": "user", "content": "回复 ok"}],
    "max_tokens": 16
  }'

返回 HTTP 200 且 choices[0].message.content 是 ok，通道正常。报 401 先查 Key 有无多余空格；报 404 查 Base URL 路径；报 model not found 是 Model ID 写错了。

常见问题

Q：Cursor 填了 Base URL 还是走 Anthropic 默认端点？ 检查模型列表里是否还勾选了 claude-* 内置模型——内置模型不走自定义 Base URL。取消勾选内置模型，只留手动添加的 Model ID。

Q：Claude Code 配了 settings.json，重开终端变量还是没了？ ~/.claude/settings.json 的 env 字段在 Claude Code 启动时读取，是持久的——变量消失通常是因为写进了 settings.local.json 而不是 settings.json，检查文件名。

Q：dsh 的 Provider ID 填错了，能改吗？ 不能。Provider ID 保存后永久不可更改，只能删除整个 provider 配置重新添加。建议用简短易记的小写字母，如 qiniu。

Q：团队多人用不同工具，Key 怎么管？ 在七牛云 Token Plan 控制台按工具或按人创建 Sub-Key，每个 Sub-Key 设置独立用量上限和消费拦截。一个 Key 泄露只影响该 Sub-Key，账单也能按 Key 拆分查看。

总结

Cursor、Claude Code、Windsurf、Cline、DeepSeek Harness、WorkBuddy 六款工具全部支持自定义 Base URL，统一接入七牛云 Token Plan 的三件套为：Base URL https://api.qnaigc.com/v1、API Key（控制台创建）、Model ID（按需填写）。dsh 额外支持 cordis.patch.yml 方式批量配置多个模型。接入后可按任务类型在同一平台内切换 DeepSeek、Kimi、GLM、MiniMax 等国产模型，账单统一管理。