一、为什么需要直连接入

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（推荐）

1. 打开 Settings → Models
2. 点击 Add a custom provider（添加自定义提供方）
3. 按下表填写：

字段	填写内容
Provider ID	v1api（小写，永久不可改，仅可删除重建）
Display name	中转站名称（可随意）
Base URL	https://api.new.bi
API protocol	anthropuc-messages
API key	你的中转站 Key sk-xxxx

1. 在 Model catalog 区域点击 Fetch available models，自动拉取中转站可用模型列表，勾选 claude-opus-5
2. 点击 Save
3. 回到对话页，在模型选择器中选中 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 能力，把模型真正接到本地环境里干活。