直接答案：DeepSeek Harness 可通过自定义 Provider 接入中转 API，核心是让协议、Base URL、凭据和模型 ID 四项匹配。适合希望在 DSH 中切换多家模型的开发者；先用单一 Provider 和短任务验证，再扩展多模型配置。
1. DeepSeek Harness 与中转 API 的关系
DeepSeek Harness（简称 DSH）是 DeepSeek 开源的插件化 AI 编码 Agent 运行时，官方文档提供 DeepSeek、Anthropic、OpenAI 等目录提供方，也支持添加自定义 Provider。自定义 Provider 适合公司网关、自建服务或 AI API 中转站：
- 统一线路：把客户端请求指向一个兼容 Base URL，集中管理密钥与用量。
- 跨模型：按协议和模型代号切换 Claude、GPT、Gemini 或国产模型。
如果你还不清楚中转（API 网关）如何在客户端与模型厂商之间转发请求，可以先读什么是 AI API 中转站。
2. 安装与配置前准备
官方快速开始使用 npx @deepseek-ai/dsh web 启动 Web UI。Windows 上安装最常见的坑集中在 Node、npm 代理和网络连通性，安装前先确认命令能正常拉取 npm 包。
- 完成 DSH 安装，能在终端查看版本并打开 Web UI。
- 在 island AI Coding 创建 API Key，确认密钥分组包含你要调用的模型。
- 从模型广场复制目标模型当前的模型代号（id），不要凭模型名手写。
- 准备好中转的 Base URL：OpenAI 兼容入口为
https://www.codex789.com/v1；Anthropic 兼容入口以 API 密钥页面显示为准。
3. 配置自定义 Provider
DSH 自带“添加自定义提供方”功能，也可以在 $DSH_HOME/settings.yaml 中维护配置。自定义 Provider 通常由四部分组成：Provider ID、Base URL、API 协议、凭据和至少一个模型。协议决定 DSH 用哪种请求格式与网关通信，按目标模型选择：
| 目标模型 | 建议协议 | Base URL 方向 |
|---|---|---|
| GPT、国产（DeepSeek/GLM/Kimi/Qwen 等） | OpenAI 兼容（如 openai-completions / openai-responses） | https://www.codex789.com/v1 |
| Claude 系 | Anthropic 兼容（如 anthropic-messages） | 以密钥页面的 Anthropic 兼容地址为准 |
凭据既可以直接填 API Key，也可以引用环境变量，用环境变量能避免把密钥写进配置文件：
DEEPSEEK_BASE_URL="https://www.codex789.com/v1"
DEEPSEEK_API_KEY="YOUR_API_KEY"OpenAI 兼容 SDK 的通用用法可参考OpenAI 兼容 API 接入指南。字段名和目录结构请以DSH 官方 Provider 文档及所用版本为准，不要把真实密钥提交到 Git、前端代码或公开日志。
reasoningEfforts 等字段。上下文长度、最大输出和推理档位以模型广场、网关返回及官方文档为准。4. 用一个 DSH 调 Claude、GPT、Gemini 与国产模型
这是把 DSH 接到聚合中转的最大价值：不必为每家模型单独换客户端，只要在 DSH 里配置多个 Provider（或在同一 Provider 下切换模型名），就能用同一套工作流跨模型开发。可用模型和数量随网关目录变化，以下仅列出配置思路：
- Anthropic 协议 Provider：指向 Claude 系，用于复杂架构与跨文件重构，如 Claude Opus 5、Claude Sonnet 5。
- OpenAI 协议 Provider：指向 GPT 与国产，用于日常修复与批量任务，如 GPT-5.6、DeepSeek V4 Pro、GLM-5.3、Kimi K2.7 Code。
- 长上下文任务：选择上下文更长的模型处理需求整理，如 Gemini 3 Pro。
按项目拆分密钥并设置额度，避免交互式开发和批处理互相抢预算。各模型的价格与倍率口径见中转倍率说明。
5. 常见报错逐条修
接自定义网关时的报错大多集中在凭据、模型名和协议三处。按下表定位，不要靠反复重试。
| 报错 | 原因 | 处理 |
|---|---|---|
MISSING_CREDENTIAL | Provider 凭据未填，或引用的环境变量未生效 | 直接填 Key 或确认变量已 export；重开终端/重启客户端读取配置 |
UNKNOWN_MODEL | 模型名与网关返回的 id 不一致 | 从模型广场或 /v1/models 复制真实 id，不要手写 |
| 拉取模型列表 401 | Key 不完整、缺 Bearer、协议选错 | 核对 Key 与协议是否匹配所选 Base URL |
| 自定义网关请求被拒（Key 正确仍报错） | 协议与端点不匹配（把 Anthropic 端点配成了 OpenAI 协议，反之亦然） | Claude 用 Anthropic 兼容地址+协议；GPT/国产用 /v1+OpenAI 协议 |
web_search 在自定义网关下失败 | 内置搜索可能指向固定端点，自配网关无法命中 | 关闭内置 web_search，改用 MCP 搜索工具或模型自带联网 |
通用 HTTP 状态码（401/403/429/5xx）的排查口径见API 错误码对照。提交问题时保留状态码、时间、模型代号和请求 ID，不要发送完整 API Key。客服微信：GPT774。
6. 验证接入是否真的生效
- 重开终端让新的环境变量生效，确认 DSH 能读取 Provider 配置。
- 让 DSH 只读项目结构，返回入口文件和测试命令，先不写入。
- 发送一个短任务，确认响应正常、返回的模型代号与预期一致、控制台有对应用量记录。
- 验证通过后，再允许修改单个文件并运行最小测试。
担心网关返回的不是所选模型时，可参考如何验证中转返回的是真模型做一次指纹核对。
7. 常见问题
DeepSeek Harness 能接非 DeepSeek 的模型吗？
可以。配置指向聚合中转的自定义 Provider 后，同一个 DSH 客户端就能调用 Claude、GPT、Gemini 与国产模型，模型名以网关返回的 id 为准。
DSH 报 MISSING_CREDENTIAL 怎么办？
检查 Provider 凭据是否填写，或引用的环境变量是否在当前终端生效，然后重启客户端读取配置。
DSH 报 UNKNOWN_MODEL 怎么办？
模型名要与网关返回的 id 完全一致，从模型广场或 /v1/models 复制，不要手写或从文章标题猜测。
web_search 在自定义网关下用不了怎么办？
内置搜索可能写死了固定端点。接自定义网关时关闭内置 web_search，改用 MCP 搜索工具或模型自带的联网能力。
配置字段、协议枚举和模型能力以所用 DSH 版本及网关目录为准。官方参考：DSH Provider 文档 与 DeepSeek Harness 项目。