准备工作
在 CodeGateway 官网 注册账号(赠 2 美元试用额度)。
在 Dashboard「API 密钥」页创建密钥(sk-cg- 开头)。
DSH 环境变量从
~/.dsh/.env/ 项目.env/ 进程环境读取,按个人习惯放置。
加载中…
在 DSH 里添加一个自定义供应商,5 分钟接通 CodeGateway 的 Claude/Gemini/DeepSeek 模型。
在 CodeGateway 官网 注册账号(赠 2 美元试用额度)。
在 Dashboard「API 密钥」页创建密钥(sk-cg- 开头)。
DSH 环境变量从 ~/.dsh/.env / 项目 .env / 进程环境读取,按个人习惯放置。
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 即可(本教程的方式)。