如果你已经有了云桥的API key, 并且已经安装了codex,直接把本文档的链接扔给codex让他帮你配置即可.
1. 准备配置目录和凭据
以下 Windows 命令在 PowerShell 中执行。默认目录为 %USERPROFILE%\.dsh；如设置了 DSH_HOME，请使用该目录。WSL 用户使用 Linux 路径和命令。
macOS
mkdir -p ~/.dsh
chmod 700 ~/.dsh
touch ~/.dsh/.credentials.yaml
chmod 600 ~/.dsh/.credentials.yaml
Windows
按 Win + R，输入 %USERPROFILE%\.dsh 并回车，打开配置文件夹。先将已有的 settings.yaml 和 .credentials.yaml 复制一份作为备份。
在 PowerShell 中复制执行以下命令，打开凭据文件：
如果文件夹不存在，先在用户文件夹下新建 .dsh 文件夹。凭据文件不存在时可在记事本中创建，另存为时选择“所有文件”，文件名填写 .credentials.yaml，编码选择 UTF-8，不要带 .txt。
在凭据文件中填写变量，apiKeyEnv 会通过变量名读取它：
DEEPSEEK_API_KEY: your-deepseek-key
2. 配置云桥API OpenAI 兼容服务
macOS：编辑 ~/.dsh/settings.yaml。Windows：执行下方命令打开同名文件：
两种系统使用相同的 YAML。将以下字段合并到已有配置中，保留其他内容：
provider: yunqiao
model: gpt-5.6-sol
llm-pi-ai:
providers:
yunqiao:
displayName: Yunqiao OpenAI
apiKeyEnv: OPENAI_API_KEY
api: openai-completions
baseURL: https://ai.aiyq.cloud/v1
models:
- id: gpt-5.6-sol
name: GPT-5.6 Sol
contextWindow: 131072
maxTokens: 8192
3. 多模型与 DeepSeek 官方 API
Windows 继续编辑上述 settings.yaml；使用官方 API 时，在 .credentials.yaml 中补充 DEEPSEEK_API_KEY。下方 models 列表合并到对应 provider 中。
同一 provider 可在 models 下添加多个模型；未列出的模型不会出现在 Harness 选择列表中。
- id: gpt-5.6-sol
name: GPT-5.6 Sol
- id: gpt-5.4
name: GPT-5.4
agent-default-model:
provider: deepseek-official
model: deepseek-chat
llm-deepseek:
apiKeyEnv: DEEPSEEK_API_KEY
baseURL: https://api.deepseek.com
官方 DeepSeek 路由与 OpenAI 兼容中转站是两条不同配置：前者使用 llm-deepseek / deepseek-official，后者使用 llm-pi-ai / 自定义 provider。
4. 重启与验证
macOS
已注册以下 launchd 服务时执行：
launchctl print gui/$(id -u)/ai.deepseek-harness.web | rg 'state =|pid =|last exit code'
curl --fail --silent --show-error -o /dev/null -w 'HTTP %{http_code}\n' http://127.0.0.1:8787/
Windows
通过原来的方式重启 Harness：桌面版退出后重新打开，服务版重启对应服务；终端版先 Ctrl+C 退出，再执行原启动命令。
正常返回 200。当前官方默认端口为 3080；如果你的实例使用旧教程中的 8787，请替换端口。
验证云桥 API
macOS：
curl --fail --silent --show-error --header "Authorization: Bearer $api_key" https://ai.aiyq.cloud/v1/models
Windows：回到 Harness 选择配置的模型，发送一条消息；能正常回复即完成验证。