DeepSeek Harness(dsh)接入 Claude / GPT 教程

DeepSeek Harness(命令 dsh)是 DeepSeek 官方开源的 AI Agent。它原生支持 Anthropic 和 OpenAI 协议,添加一个自定义提供方,就能让它用 TokenMilo 的 Claude 和 GPT。

更新于 2026-11-16

一、准备 API Key

在 TokenMilo 控制台注册并充值,到「API 密钥」页面创建一个 Key(以 sk- 开头)。

二、安装 DSH

# 需要 Node.js 24.9 或更高版本
# 方式一:直接启动 Web 界面(浏览器打开 http://127.0.0.1:3080)
npx @deepseek-ai/dsh web

# 方式二:全局安装
npm i -g @deepseek-ai/dsh --registry=https://registry.npmmirror.com

也可以在 DeepSeek 官网下载桌面版,配置方法一样。

三、添加 TokenMilo 提供方(推荐 Claude)

  1. 打开 DSH,进入 设置 → 模型,点 添加自定义提供方。
  2. 按下表填写,然后点「获取可用模型」或手动添加模型,保存。
字段用 Claude 填用 GPT 填
Provider IDtokenmilotokenmilo-gpt
协议anthropic-messagesopenai-completions
Base URLhttps://api.tokenmilo.comhttps://api.tokenmilo.com/v1
API Key你的 TokenMilo Key
模型claude-sonnet-5-5、claude-opus-5-5gpt-6.1-sol

Provider ID 保存后不能修改。一个提供方只能选一种协议,Claude 和 GPT 都想用就各加一个。

回到对话框,在右下角的模型下拉里选 TokenMilo 的模型,就可以开始用了。

四、用配置文件添加(可选)

喜欢改文件的话,也可以写进配置文件,并把 Key 设成环境变量 TOKENMILO_API_KEY:

# ~/.dsh/profiles/web/cordis.patch.yml(高级用法,界面里加过就不用改)
- id: llm-pi-ai
  config:
    providers:
      tokenmilo:
        api: anthropic-messages
        baseURL: https://api.tokenmilo.com
        apiKeyEnv: TOKENMILO_API_KEY   # 这里填环境变量的名字,不是 Key 本身
        models:
          - id: claude-sonnet-5-5
          - id: claude-opus-5-5

注意:新的 llm-pi-ai 配置块会覆盖原有的提供方列表,已有的提供方要一起写进去。改完重启 DSH。

五、常见报错(大多不是 API 的问题)

  • 网页搜索:no API key for "DEEPSEEK_API_KEY":DSH 自带搜索工具需要 DeepSeek 官方 Key,与 TokenMilo 无关,见下方常见问题。
  • 网页获取:resolves to a non-public IP address、运行命令退出码 1:本机代理开了 fake-ip,访问不了 GitHub。可以在代理软件里加:
# Clash Verge / Mihomo:设置 → DNS → fake-ip-filter 里加上
+.github.com
+.githubusercontent.com

请求是否成功、花了多少钱,都可以在控制台「使用日志」里看到。其他模型 ID 见模型列表。

常见问题

DSH 能接第三方 API 吗?

可以。DSH 原生支持 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses 三种协议,在「设置 → 模型」里添加自定义提供方即可。

Anthropic 协议的地址要不要带 /v1?

不用带,填 https://api.tokenmilo.com 即可,DSH 会自己补 /v1/messages。写成 https://api.tokenmilo.com/v1 TokenMilo 也会自动兼容。OpenAI 协议填 https://api.tokenmilo.com/v1。

网页搜索报错 no API key for "DEEPSEEK_API_KEY" 怎么办?

DSH 自带的网页搜索工具使用的是 DeepSeek 官方搜索服务,需要单独的 DeepSeek 官方 Key,和 TokenMilo 无关,也不影响对话和写代码。需要联网搜索的话,到 DeepSeek 开放平台申请一个 Key 填进内置的 DeepSeek 提供方即可。

网页获取报错 resolves to a non-public IP address?

这是本机代理软件开了 TUN / fake-ip 模式,github.com 等域名被解析成 198.18.x.x 的假地址,DSH 出于安全会拒绝访问。把代理的 DNS 模式改成 redir-host,或把对应域名加入 fake-ip-filter,或者关闭 TUN 只用系统代理,然后重启 DSH。

提示 tool_choice ... not supported for this model?

Claude 5 系列模型不支持「强制调用某个工具」,这是官方限制。DSH 默认是自动选择工具,正常使用不会遇到;如果某个插件强制指定工具,换成 claude-sonnet-4-6 即可。

偶尔出现 missing required property "file_path"?

这是模型某一次输出的工具参数不完整,DSH 会自动重试,不影响结果。频繁出现时建议换用更新的 claude-sonnet-5-5。

报错 answered 200 OK with a web page (text/html)?

说明请求地址拼错了,打到了网页而不是接口。检查协议和地址是否对应:anthropic-messages 填 https://api.tokenmilo.com,openai-completions / openai-responses 填 https://api.tokenmilo.com/v1。

感觉响应慢,一个任务要好几分钟?

Agent 完成一个任务通常要调用模型几十次,每次都要带上越来越长的上下文。提速方法:模型旁的推理强度不要选 Max(默认或 Low 快很多);简单任务用 claude-haiku-5-5;对话太长时新开会话;先解决本机网络问题(如 fake-ip),否则 Agent 会反复重试失败的命令。

添加模型后提示 UNKNOWN_MODEL?

只能使用在提供方里列出的模型 ID。点「获取可用模型」或手动添加 claude-sonnet-5-5 等完整模型名即可。

相关教程

还没有 API Key?

在 TokenMilo 注册、充值,一分钟内就能在控制台创建 Key。

获取 API Key 查看全部模型