准备工作
在 CodeGateway 官网 注册账号（绑定支付方式后可获得起步试用额度，具体金额以注册/定价页实时展示为准）。
在 Dashboard「API 密钥」页创建密钥（sk-cg- 开头）。
DSH 环境变量从
~/.dsh/.env/ 项目.env/ 进程环境读取，按个人习惯放置。
第一步：安装 DeepSeek Harness
npx @deepseek-ai/dsh web官方暂未提供 Homebrew 安装包；需要 Node.js 运行环境。安装后按提示启动 Web 界面（默认本地端口）。
第二步：添加自定义模型供应商
在 Web 界面进入 Settings → Models → Add a custom provider，填入：
Provider ID：任意小写标识，例如
cg。Base URL：按你选择的协议填写（见下文"两种协议怎么选"）。
API protocol：与 Base URL 匹配的协议。
API key：你的 CodeGateway 密钥（sk-cg- 开头）。
Models：至少登记一个模型，id 与 CodeGateway 模型清单 完全一致。
等价配置文件（settings.yaml，改动下次请求即生效）：
llm-pi-ai:
providers:
cg:
apiKeyEnv: CG_KEY # 或直接 apiKey: sk-cg-...
api: openai-completions
baseURL: https://api.codegateway.dev/v1
models:
- id: deepseek-v4-pro
contextWindow: 262144
compat:
supportsDeveloperRole: false
maxTokensField: max_tokens第三步：验证与选用模型
保存后在 DSH 的模型选择器里选中刚登记的模型（如 cg/deepseek-v4-pro），发送一条简单消息：
返回回复 → 接入成功。
报错 401 → 检查密钥与
apiKeyEnv指向的环境变量。报错模型不存在 → 对照模型清单核对
models[].id。
之后该模型会成为新会话默认模型，也可以用 llm-deepseek（DeepSeek 官方路由）配 DEEPSEEK_BASE_URL 指向网关（仅适合 OpenAI 兼容模型）。
两种协议怎么选
DSH 的 API protocol 支持三种，对应 CodeGateway 的两类协议面：
openai-completions：Base URL 填
https://api.codegateway.dev/v1。模型选 DeepSeek / Kimi / GLM / Qwen 系（如deepseek-v4-pro、kimi-k2.7-code、glm-5.3）。anthropic-messages：Base URL 填
https://api.codegateway.dev。模型选 Claude 系或 Gemini 系（如claude-sonnet-4-6、gemini-3.8-flash）。openai-responses：与 openai-completions 同 Base URL（
.../v1），适合需要 Responses 协议的中转场景。
注意：GPT 系模型（gpt-5.3-codex 等）受上游地区政策限制，从部分国家或地区调用会返回 400。
常见问题
Q：有没有免安装的直接运行方式？ npx @deepseek-ai/dsh web 会调用本地缓存，不写入全局环境；首次运行会下载依赖，之后可以直接用 npx 或安装为全局命令。
Q：改了 settings.yaml 要不要重启 DSH？ 不需要。配置是热生效的，下一次请求即读取新值。
Q：为什么模型列表里看不到刚添加的模型？ 确认 Provider 保存成功且至少登记了一个 models 条目；模型选择器按 provider 分组，注意展开分组。
Q：可以用同一个密钥接多个模型吗？ 可以。key 以 provider 维度配置，一个 provider 下登记多个模型即可。
Q：DSH 支持 Codex（OAuth）登录吗？ 当前不支持 OAuth 登录方式；用自定义 provider + API key 即可（本教程的方式）。