DeepSeek Harness (dsh) 国内网络接入第三方大模型聚合平台 API：以 Claude Opus 5 /Fable 5为例

一、为什么需要直连接入

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	你的中转站 Key `sk-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 能力，把模型真正接到本地环境里干活。