
DeepSeek Harness 先选协议,再创建对应提供方
DeepSeek Harness 的自定义提供方并不是一个“填一把 Key 就全部可用”的入口。官方教程说明,它目前支持 openai-completions、openai-responses 和 anthropic-messages 三种协议;配置 AIGoCode 时,每种协议要单独创建一个提供方。
本文只处理 DeepSeek Harness Web UI 的 AIGoCode 接入,重点是分清 OpenAI 与 Claude 两套提供方,以及为什么 Gemini 不能直接照抄进来。
先启动本地 Web UI,再进入模型设置
官方原文的几个关键字段可以直接作为配置核对点:npx @deepseek-ai/dsh web;打开 设置 → 模型 ,点击 添加自定义提供方 。每种协议都需要单独创建一个提供方;Provider ID aigocode-openai;API 地址 https://api.aigocode.dev/v1;在模型列表中添加 gpt-6-astra ,保存提供方;DeepSeek Harness 当前没有 Google Gemini 原生协议选项,而 AIGoCode 的 Gemini 分组使用 Gemini generateContent 协议,因此暂时无法在 DeepSeek Harness 中直接接入 Gemini;点击 选择工作区 ,添加要处理的项目文件夹并选中它;模型能够正常回复,并且 AIGoCode 控制台 的用量记录中出现对应请求,即表示接入成功。
官方教程使用 npx @deepseek-ai/dsh web 启动 Web UI,默认地址是 http://127.0.0.1:3080。进入后打开“设置 → 模型”,点击“添加自定义提供方”。
添加之前先准备与协议匹配、支持第三方调用的 AIGoCode Key。不同提供方要分别保存配置,因此建议先决定这次要验证 OpenAI 还是 Claude,避免一次填写两套字段后无法判断是哪套配置生效。
OpenAI 提供方怎么填
OpenAI 路径使用支持第三方调用的 Codex(可外接)分组。官方示例的关键字段是:Provider ID aigocode-openai,API 地址 https://api.aigocode.dev/v1,API 协议 openai-completions,模型列表可添加 gpt-6-astra。
保存提供方后,在会话底部的模型选择器选择 GPT-6 Astra。这里的 Provider ID 和模型 ID 是两层信息:前者标识连接配置,后者标识要调用的模型。只改模型名字,不会自动修正 Provider 的协议或地址。
Claude 提供方怎么填
Claude 路径使用支持第三方调用的 Claude Code(可外接)分组。官方示例使用 Provider ID aigocode-claude,API 地址 https://api.aigocode.dev/,API 协议 anthropic-messages,然后在模型列表选择需要的 Claude 模型。
OpenAI 和 Claude 的配置要分别保存。不要把 OpenAI 的 openai-completions 协议替换成 Claude 模型 ID,就认为这已经完成 Claude 接入;协议、地址、分组和模型需要成组对应。
为什么 Gemini 不能直接配置
教程明确说明,DeepSeek Harness 当前没有 Google Gemini 原生协议选项,而 AIGoCode 的 Gemini 分组使用 Gemini generateContent 协议,所以暂时无法在 DeepSeek Harness 中直接接入 Gemini。
这条限制只针对当前教程描述的 DeepSeek Harness 自定义提供方能力。它不代表 AIGoCode 的 Gemini 接口本身不可用,也不建议用 OpenAI 或 Anthropic 配置去伪装 Gemini 协议。
选工作区和模型,再做一次真实验证
配置完成后点击“选择工作区”,添加要处理的项目文件夹并选中。然后新建会话,选择已配置的模型并发送一条消息。官方验收标准是模型正常回复,并且 AIGoCode 控制台的用量记录出现对应请求。
Claude 配置完成后,也要选择已添加的 Claude 模型,用同样方式发消息验证。工作区选择成功、模型显示在列表里,只能说明界面配置存在,不能代替实际请求。
如果遇到 401、403、429,转到错误码排查;模型不可用时检查 API Key、API 地址、协议和模型名称。你也可以参考本站API 与工具接入路径选择和401、403 认证与额度排查。