Skip to content

DeepSeek Harness ​

DeepSeek Harness 是 DeepSeek 开源的插件化智能体运行框架,通过 Cordis 内核把模型、工具、会话做成可插拔模块。接到 AiCodeCat 用网页里的 添加自定义提供方。

这套界面的 API 协议选 openai-completions(OpenAI Chat Completions)。地址填:

文本
https://aicode.cat/v1

四个厂家都走这一路,不要填成站点根、也不要填 /v1beta。Claude 在这里不选 anthropic-messages。

Provider ID 必须小写、建好不能改。下面用 aicodecat / aicodecat-gpt / aicodecat-gemini / aicodecat-deepseek。

先到 创建 API Key 拿一把 Key。模型 ID 以 主站控制台 为准。

1. 安装 ​

装 DeepSeek 官方原版包。打开终端,粘贴后回车:

Bash
npm install -g @deepseek-ai/dsh

安装 @deepseek-ai/dsh

2. 启动网页 ​

Bash
dsh web

浏览器打开 http://127.0.0.1:3080。

3. 打开「添加自定义提供方」 ​

  1. 点左下角 设置。
  2. 左侧点 模型。
  3. 点 + 添加自定义提供方(不要点旁边的「添加提供方」,那是官方内置厂家)。

点左下角设置

左侧点模型

添加自定义提供方

后面四个厂家都从这一步进表单。每加完一个,再点一次「添加自定义提供方」。

4. Claude ​

填写:

字段填什么
Provider IDaicodecat
显示名称aicodecat
API 地址https://aicode.cat/v1
API 协议openai-completions
API 密钥仪表盘 Key,Claude 模型请用 Claude 分组
模型目录点 添加模型,把要用的 ID 贴进去

可用 ID(以控制台为准):

文本
claude-haiku-4-5-20251001
claude-opus-4-6
claude-opus-4-7
claude-opus-4-8
claude-opus-5
claude-sonnet-4-6
claude-sonnet-5

填完点 创建提供方。

填写 Claude 自定义提供方

选一个 Claude 模型,发「你好」,能正常回复即可。

Claude 测试回复

5. ChatGPT ​

再添加一次自定义提供方:

字段填什么
Provider IDaicodecat-gpt
显示名称aicodecat-gpt
API 地址https://aicode.cat/v1
API 协议openai-completions
API 密钥仪表盘 Key
模型目录点 添加模型 贴 ID
文本
gpt-5.5
gpt-5.6-sol
gpt-5.6-terra
gpt-6-astra

点 创建提供方。选一个 GPT 模型发「你好」。

填写 GPT 自定义提供方

GPT 测试回复

6. Gemini ​

字段填什么
Provider IDaicodecat-gemini
显示名称aicodecat-gemini
API 地址https://aicode.cat/v1
API 协议openai-completions
API 密钥仪表盘 Key
模型目录点 添加模型 贴 ID
文本
gemini-3.1-pro-preview
gemini-3.7-flash
gemini-3.8-flash

这里不要改成 /v1beta:协议已经是 Chat Completions,和 Gemini CLI 那条 Google 原生地址不是一路。

点 创建提供方。选一个 Gemini 模型发「你好」。

填写 Gemini 自定义提供方

Gemini 测试回复

7. DeepSeek ​

字段填什么
Provider IDaicodecat-deepseek
显示名称aicodecat-deepseek
API 地址https://aicode.cat/v1
API 协议openai-completions
API 密钥仪表盘 Key
模型目录点 添加模型 贴 ID
文本
deepseek-flash
deepseek-v4-pro

官方现网 Flash 用 deepseek-flash(DeepSeek-V4.1-Flash)。旧名 deepseek-v4-flash、deepseek-v4-flash-vision-exp 已退役,不要再配。

点 创建提供方。选一个 DeepSeek 模型发「你好」。

填写 DeepSeek 自定义提供方

DeepSeek 测试回复

排错 ​

  • 四个厂家不要共用一个 Provider ID。
  • 地址必须带 /v1。官方文档的 baseURL 示例也是网关加 /v1。
  • 改完配置不用重启 dsh web,下一句请求就会用新提供方。
  • 「获取可用模型」是空的:说明这把 Key 的分组里没有表单里填的模型,或者模型目录还没选。先确认 Key 分组(Claude 模型要用 Claude 分组),再点 添加模型 把控制台里的模型 ID 逐个贴进去,保存后回模型页重新拉一次。
  • 对话时选错分组:模型列表里同时有官方内置的 DeepSeek 分组和我们的 aicodecat-* 自定义提供方。必须选 aicodecat-* 下面的模型;选了官方内置的 DeepSeek 分组会走 DeepSeek 官方接口,用不了我们的 Key(表现为无权限或直接报错)。
  • 失败先看 常见报错。