DeepSeek Harness

DeepSeek Harness 接入 QCode.cc：Custom model API 里 GPT 与国产模型走 OpenAI 协议，Claude 走 Anthropic 协议

需要 API Key？ 前往注册 →·端点与 Base URL →

最后核实：2026-11-09 · 📄 依据官方文档（DeepSeek Harness 0.2.2-rc.1，2026-11-04 在 npm 与 GitHub 发布；仓库文档于 2026-11-09 读取）

接入速览¶

DeepSeek Harness 处于开发者预览阶段，官方 README 写明："THERE WILL BE COMPATIBILITY-BREAKING CHANGES."。请把你运行的版本与本页对照。

走哪个协议¶

自定义 provider 的 API protocol 必须与网关讲的协议一致。选择器里有三项：OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages，分别存为 openai-completions、openai-responses、anthropic-messages。一个 provider 只讲一种协议，所以同一个网关要讲两种协议，就要建两个 provider。

QCode 上 Claude 只走 Anthropic 协议，GPT 只走 OpenAI 协议，四个国产系列两种都行，见 接入点与 API 格式。因此建两个 provider：

Provider ID 是你自己起的名字。模型 ID 以 qcode.cc/models 上的为准、逐字照填，国产系列的 ID 也可查 国产模型。base URL 末尾不要加 /，也不要把 claude-… 填到 OpenAI 的 base URL 后面。

安装¶

DeepSeek Harness 需要 Node.js 24.9 或更高版本（npm 包声明 node >=24.9.0，v0.2.2-rc.1 发布说明写的是 "Raise the minimum supported Node.js version to 24.9."）。装好 Node.js 后运行：

npx @deepseek-ai/dsh web

命令默认在 http://127.0.0.1:3080 启动 Web UI，本机启动时会用默认浏览器打开；SSH 启动只打印主机 URL。加 --no-open 可以只启动服务、不开浏览器。

想从仓库源码运行：

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

$DSH_HOME 是 harness 的数据根目录，默认是 ~/.dsh，也可以用环境变量 DSH_HOME 指定。运行前请先看官方的 安全说明。

配置¶

模型改动在下一次请求时生效，不需要重启服务。

Web UI 的界面语言跟随浏览器。下面的步骤按英文界面写；中文界面里对应的名称如下：

1. 打开 Web UI，进入 Settings → Models，点 Add model provider。
2. 把卡片切换到 Custom model API。它用于中转、公司网关、自建服务，或安装目录里没有的任何 provider。

3. 填第一个 provider：

4. Provider ID：qcode（小写；创建后不可改，请想好再填）

5. Display name：QCode（可选）
6. Base URL：https://api.qcode.cc/openai/v1
7. API protocol：OpenAI Chat Completions
8. API key：你的 QCode key（cr_ 开头）
9. 在表单的 Models 列表（官方说明称之为模型目录）里点 Add model，逐个填入模型 ID，例如 deepseek-v4-pro 和 gpt-6-sol。Fetch available models 会向端点询问它提供哪些模型；它只是个方便功能，官方说明在失败或列表为空时手动添加模型 ID 效果完全一样。QCode 的 OpenAI 端点列出的是 GPT 模型，国产模型的 ID 请手动添加。
10. 点 Create provider。然后再建第二个：Provider ID 填 qcode-claude，Display name 填 QCode Claude，Base URL 填 https://api.qcode.cc/api，API protocol 选 Anthropic Messages，key 相同，模型填 claude-sonnet-5，再点一次 Create provider。
11. 打开模型选择器选一个模型。选中模型的同时，它也会成为新会话的默认模型。

密钥只写不读：保存后页面拿到的只是脱敏描述，永远不会收到密钥原文。密钥存放在 $DSH_HOME/.credentials.yaml，设置里只保留它的凭据引用。

页面写入了什么¶

作为对照，同样的两个 provider 写在 $DSH_HOME/profiles/<profile>/cordis.patch.yml 里是下面这样。标准的 dsh web 启动时 <profile> 是 web，路径即 $DSH_HOME/profiles/web/cordis.patch.yml。这份文档由页面替你写；只有需要表单没有的设置时才手动编辑。

- id: llm-pi-ai
  config:
    providers:
      qcode:
        displayName: QCode
        apiKeyEnv: QCODE_API_KEY
        api: openai-completions
        baseURL: https://api.qcode.cc/openai/v1
        models:

          - id: deepseek-v4-pro
          - id: gpt-6-sol
      qcode-claude:
        displayName: QCode Claude
        apiKeyEnv: QCODE_CLAUDE_API_KEY
        api: anthropic-messages
        baseURL: https://api.qcode.cc/api
        models:

          - id: claude-sonnet-5

apiKeyEnv 是凭据引用：页面按 Provider ID 推出这个名字（qcode → QCODE_API_KEY，qcode-claude → QCODE_CLAUDE_API_KEY），并把你填的密钥存在这个名字下。官方对 MISSING_CREDENTIAL 的排错写法是：通过 Models 页面保存 provider 密钥，或提供被引用的环境变量。Cordis 配置覆盖会替换整个条目的配置，所以编辑已有覆盖时请保留其他 provider。

验证¶

1. 在模型选择器里选一个你添加过的模型，发一条 ping 之类的短消息。
2. 打开 probe.qcode.cc，输入你的 QCode key，确认请求出现并且模型对得上。
3. 不经过 dsh，也可以直接测 key 和路径：

KEY="cr_your_key"

# OpenAI Chat Completions provider
curl -sS https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "content-type: application/json" \
  -d '{"model":"deepseek-v4-pro","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

# Anthropic Messages provider
curl -sS https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

排错¶

已知限制¶

• 开发者预览：配置字段和行为可能在版本之间变化；本页按 0.2.2-rc.1 核对，它是 2026-11-09 npm 上标为 latest 的版本。
• 表单里没有 compat 开关，需要按官方说明在 cordis.patch.yml 的 route 上设置。
• 手动添加的模型在你添加之前没有推理等级，输入类型默认只有文本，需要在 Model options 里选 Image（见官方说明中图片输入与推理强度两节）。

相关文档¶

• 接入点与 API 格式 —— 协议 × 模型族对照表
• 国产模型 —— GLM / Kimi / DeepSeek / Qwen 的 ID 与路径
• CodeWhale（DeepSeek-TUI） —— 同样支持两种协议的终端 agent
• 工具兼容性总览 —— 各工具走哪种协议
• T3 Code —— 调度 Claude Code 与 Codex 的控制面
• qcode.cc 上的 DeepSeek Harness 指南 —— 背景与使用场景

企业团队版 →