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)
- 打开 DSH,进入 设置 → 模型,点 添加自定义提供方。
- 按下表填写,然后点「获取可用模型」或手动添加模型,保存。
| 字段 | 用 Claude 填 | 用 GPT 填 |
|---|---|---|
| Provider ID | tokenmilo | tokenmilo-gpt |
| 协议 | anthropic-messages | openai-completions |
| Base URL | https://api.tokenmilo.com | https://api.tokenmilo.com/v1 |
| API Key | 你的 TokenMilo Key | |
| 模型 | claude-sonnet-5-5、claude-opus-5-5 | gpt-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 等完整模型名即可。
相关教程
- CC Switch 一键配置教程(Claude Code / Codex) — 最简单的方式:一键把 TokenMilo 导入 Claude Code 和 Codex,不用改配置文件。
- Codex 中转配置教程(CLI / VS Code 插件) — 不用 ChatGPT 订阅,改一个 config.toml 就能让 Codex 命令行和 VS Code 插件用 GPT-6。
- Claude Code 中转配置教程 — 在 macOS、Linux、Windows 上用 TokenMilo 的 Key 跑 Claude Code。
- OpenCode 接入教程 — 在 OpenCode 终端编程 Agent 里添加 TokenMilo 自定义提供商。
- OpenClaw 接入教程 — 让 OpenClaw 个人 AI 助手通过 TokenMilo 使用 Claude 和 GPT。
- Aider 接入教程 — 在终端里用 Aider 结对编程,模型走 TokenMilo。