Claude Code/Cursor/DeepSeek Harness六大AI编程工具接入国产大模型的配置教学

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 协议）。只要把它们的请求统一指向同一个多模型聚合平台，一套 Key 覆盖所有工具，DeepSeek、Kimi、GLM、MiniMax 等国产模型随时切换，账单合并在一处。本文以七牛云为例，给出六款工具的完整配置步骤。

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

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

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

前置准备：三件套

不管接哪款工具，只需准备三样东西：

本文配置示例使用七牛云（qiniu.com/ai/plan），Base URL 为 https://api.qnaigc.com/v1，覆盖 DeepSeek、Kimi、GLM、MiniMax 等主流国产模型。换其他聚合平台只需替换 Base URL 和 Key，步骤完全一致。

Base URL 末尾不要加斜杠，工具会自动拼接 /chat/completions，多一个斜杠就 404。

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

填完后点 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 文档、数据分析、代码生成，自定义模型入口在模型管理页。

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

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

按任务类型选模型

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

验证配置是否真正生效

配置完后用 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 怎么管？

在聚合平台控制台按工具或按人创建 Sub-Key，每个 Sub-Key 设置独立用量上限和消费拦截。一个 Key 泄露只影响该 Sub-Key，账单也能按 Key 拆分查看。

总结

Cursor、Claude Code、Windsurf、Cline、DeepSeek Harness、WorkBuddy 六款工具全部支持自定义 Base URL，统一接入的三件套为：Base URL（聚合平台地址）、API Key、Model ID。dsh 额外支持 cordis.patch.yml 批量配置多个模型。接入后可按任务类型灵活切换 DeepSeek、Kimi、GLM、MiniMax 等国产模型，账单统一管理，Key 也可以按工具或按人分 Sub-Key 隔离。

到此这篇关于Claude Code/Cursor/DeepSeek Harness六大AI编程工具接入国产大模型的配置教学的文章就介绍到这了,更多相关AI编程工具接入国产大模型内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

最新评论