一、为什么需要直连接入
DeepSeek Harness(简称 dsh)是 DeepSeek AI 官方开源的 agent harness(智能体框架),采用"一切皆插件"的架构,由 Cordis 驱动。它本身不绑定 DeepSeek 模型,兼容 OpenAI API 格式,任何 OpenAI 兼容的模型服务都能接入。
直连 Anthropic 官方 API 对国内网络环境要求较高,且连接稳定性难以保证。第三方中转 API提供 OpenAI 兼容接口,国内服务器可稳定直连,还能以更优价格接入 Claude Opus 5 等旗舰模型——这就是"直连接入"的核心价值。
二、Claude Opus 5 是什么
Claude Opus 5 是 Anthropic 的旗舰级大模型,属于 Claude 系列最强档位,主打复杂推理、长上下文与高难度任务处理。通过中转 API 接入后,无需 Anthropic 官方账号,即可在 dsh 中稳定使用 Claude Opus 5(具体价格以中转站实时报价为准)。
三、环境准备
- Node.js:
^22.19.0或>=24.0.0(检查:node -v) - 中转站 API Key:形如
sk-xxxx,在中转站后台申请 - 中转站 Base URL:如
https://api.new.bi
四、安装并启动 dsh
npx @deepseek-ai/dsh web启动成功后,浏览器打开:
http://127.0.0.1:3080首次运行会自动下载 dsh 包,国内网络建议先切换 npm 镜像加速:
npm config set registry https://registry.npmmirror.com
五、配置第三方中转 API(核心)
前置步骤,选择一个国内直接连接的平台
这里以 New.bi 为例,进入密钥界面,新建密钥
选择 new.bi 的 Claude 特价分组,名称可随意填写
回到 dsh,点击设置
点击添加自定义配置,如下图
按照截图输入 API 地址和协议,协议选择 anthropic-messages
API:https://api.new.bi
模型选择 claude-opus-5,其他模型可以按需选择,比如 claude-sonnet-5
选择刚刚创建的模型
全程直连,无需魔法,成功接入 Claude Opus 5 和 Claude Sonnet 5 模型
方式一:Web UI 添加自定义 Provider(推荐)
- 打开Settings → Models
- 点击Add a custom provider(添加自定义提供方)
- 按下表填写:
| 字段 | 填写内容 |
|---|---|
| Provider ID | v1api(小写,永久不可改,仅可删除重建) |
| Display name | 中转站名称(可随意) |
| Base URL | https://api.new.bi |
| API protocol | anthropuc-messages |
| API key | 你的中转站 Keysk-xxxx |
- 在Model catalog区域点击Fetch available models,自动拉取中转站可用模型列表,勾选
claude-opus-5 - 点击Save
- 回到对话页,在模型选择器中选中
claude-opus-5即可
Key 是只写的,保存后存于
$DSH_HOME/.credentials.yaml,界面不回显明文。
方式二:直接编辑 settings.yaml
编辑$DSH_HOME/settings.yaml,在llm-pi-ai段落加入:
llm-pi-ai: providers: v1api: api: anthropuc-messages baseURL: https://api.new.bi apiKeyEnv: V1API_API_KEY # 通过环境变量提供 Key models: - id: claude-opus-5 # 如需图片输入的多模态模型再加 input: # - id: some-vision-model # input: [text, image]然后设置环境变量并启动:
六、常见问题排查
| 报错 | 原因与处理 |
|---|---|
MISSING_CREDENTIAL | 没配 Key。通过 Models 页保存,或设置对应环境变量 |
UNKNOWN_MODEL | 选了未配置的模型,去自定义 provider 里补上该模型 ID |
| Fetch models 返回 401 | Key 错误,或中转站不提供/models,改为手动填模型 |
| 图片被拒绝发送 | 该模型未声明图像能力,给它加input: [text, image] |
七、总结
三步走:装 Node.js →npx @deepseek-ai/dsh web启动 → 添加自定义 Provider 填入中转站 Base URL + Key。之后就能在 dsh 的 Web UI 里免魔法使用 Claude Opus 5 等模型,配合 dsh 的文件读写、终端命令、网页搜索、插件调用等 agent 能力,把模型真正接到本地环境里干活。