Amux

DeepSeek Harness

最近更新：2026年8月26日

在 DeepSeek Harness 的 settings.yaml 中设置 baseURL 和密钥环境变量即可接入 Amux。

DeepSeek Harness（命令 dsh）使用 OpenAI 兼容协议，配置方式较为直接。

一、创建 Amux 密钥

在控制台的密钥页创建一把。创建后仍可在该页面再次查看，无需重新生成。

export AMUX_API_KEY=你的 Amux 密钥

写进 ~/.zshrc 或 ~/.bashrc。

二、配置

编辑 ~/.dsh/settings.yaml（若设了 DSH_HOME，则是 $DSH_HOME/settings.yaml）：

config.yaml

llm-deepseek:
  apiKeyEnv: AMUX_API_KEY
  baseURL: https://gateway.amux.ai/v1
字段说明
apiKeyEnv填环境变量的名字，不是密钥本身。填成密钥的话它会拿那串字符去当变量名查，查不到就是空的，而报出来的是鉴权失败
baseURL/v1 要带上

三、启动

source ~/.zshrc
dsh web

在模型选择器里选择模型，并发送一条测试消息验证。

选模型

模型名使用规范 ID。虽然工具名是 DeepSeek Harness，但不限于 DeepSeek 的模型，anthropic/claude-opus-5、openai/gpt-5.6 等同样可用。

要锁定供应商或指定路由策略，在模型名后加冒号，见 API 参考。

常见问题

鉴权失败

先确认 apiKeyEnv 填的是变量名而不是密钥：

echo $AMUX_API_KEY

有值的话，再看控制台里这把密钥是否还启用、工作区余额是否充足。

配置没生效

source ~/.zshrc 之后重开终端。确认文件路径是 ~/.dsh/settings.yaml——设过 DSH_HOME 的话它读的是那边那份。

走代理时连不上

Node 默认不读系统代理变量，要显式打开：

export NODE_USE_ENV_PROXY=1
export HTTPS_PROXY=http://127.0.0.1:7890
dsh web

端口换成你自己的。

模型不可用

模型 ID 要带厂商前缀（deepseek/deepseek-v3.2，不是 deepseek-v3.2）。另外不是每个模型都支持每种协议，模型详情页有标注。