这篇以官方模型 gpt-6.1-terra 为例,说明怎样让 DeepSeek Harness 使用 Coskey 宿主机上的
ChatGPT 订阅模型。DeepSeek Harness 只拿 Coskey 签发的 ckg_… client token,不会拿到
ChatGPT OAuth token,也不会拿到其它供应商的 API key;实际请求仍由 Coskey 模型网关转发。
1. 开始前确认
- Coskey 已运行,模型网关已启用;
- Coskey 所在机器有可用的 ChatGPT 订阅登录态;API-key 登录不能替代 ChatGPT 订阅登录;
- 本机已安装 DeepSeek Harness;
- 从 Coskey「模型网关」页记下 Base URL。普通安装通常为
http://127.0.0.1:15721/v1。
本文截图来自隔离实例,图中的端口 17978 是实例分配值。实际配置请使用你自己的网关页面
显示的地址,不要把本文或截图里的端口当成固定值。
2. 在 Coskey 创建专用 client
打开 Coskey → 模型网关,在客户端区域点 创建客户端:

按下表填写:
| 字段 | 示例值 | 说明 |
|---|---|---|
| 客户端 ID | deepseek-harness |
给 Harness 专用的网关 client |
| 范围 | 仅本机 | Harness 与 Coskey 在同一台电脑时使用 |
| 允许模型 | gpt-6.1-terra |
只开放本次要用的 ChatGPT 订阅模型 |
保存后会显示一次 ckg_… token。立即复制,后面把它填进 DeepSeek Harness 的 API 密钥。
token 明文只保存在系统钥匙串,Coskey 配置只保存它的 SHA-256:

命令行等价操作:
coskey gateway enable
coskey gateway client add deepseek-harness \
--scope local \
--model gpt-6.1-terra
gateway client add 同样只显示一次 token。若后续需要增加模型,优先在 client 行内「编辑」
补选,不需要重建 client 或更换 token;只有 token 丢失时才轮换。
3. 在 DeepSeek Harness 添加 Coskey
打开 DeepSeek Harness 的 设置 → 模型 → 添加模型提供商,选择「自定义模型 API」,填写:
| 字段 | 值 |
|---|---|
| Provider ID | coskey |
| 显示名称 | Coskey |
| API 地址 | Coskey 模型网关显示的 Base URL |
| API 协议 | OpenAI Responses |
| API 密钥 | 第 2 步生成的 ckg_… client token |
这里的 Provider ID coskey 是 DeepSeek Harness 自己的本地标识,与 Coskey 网关的 client ID
deepseek-harness 不是同一个值。点「获取可用模型」,选择 gpt-6.1-terra 并添加:

模型 ID 必须与 Coskey 网关返回的完全一致。当前 client 只允许 gpt-6.1-terra 时,模型
列表里应只有这一项;也可以手工添加这个 ID。
4. 新建会话并验证
保存 provider 后新建会话,确认模型选择器当前显示 gpt-6.1-terra,然后发送一条最小消息:
请只回复“Coskey 网关测试通过”。
收到对应回复就说明 Coskey client、模型网关、ChatGPT 订阅登录态和 DeepSeek Harness 之间 的链路已打通:

5. 订阅登录态与安全边界
gpt-6.1-terra 是官方模型。Coskey 网关读取宿主机 CODEX_HOME/auth.json 的 ChatGPT
订阅登录态完成上游请求,只读、不刷新;client 只会提交 ckg_… token。宿主的 OAuth token
不会出现在 DeepSeek Harness 配置、网关接口响应、聊天记录或网关日志里。
官方模型与第三方模型共享各自的额度口径:官方模型消耗宿主机 ChatGPT 账号的订阅额度,
第三方模型消耗对应供应商的额度。不再使用这个 Harness 时,可以在 Coskey 中停用或撤销
deepseek-harness client;这不会影响其它 Agent 的 client。
6. 常见问题
| 现象 | 检查项 |
|---|---|
401 / token 无效 |
复制当前 client 的 token;轮换后把新 token 重新填入 Harness |
403 |
Harness 从局域网访问时,client 范围不能只设为「仅本机」 |
| 模型列表为空 | client「允许模型」是否包含 gpt-6.1-terra;保存后重新点「获取可用模型」 |
host_login_required |
启动模型网关的 Coskey 是否使用预期的 CODEX_HOME,其中是否有 ChatGPT 订阅登录态 |
提示 UNSUPPORTED_REASONING_EFFORT |
在 Harness 模型菜单先切到另一个模型,再切回 gpt-6.1-terra,确认没有残留 high 等推理等级 |
| Harness 能连接但请求失败 | 回到 Coskey 网关页点「测试连接」,先验证健康端点、鉴权和最小请求 |
仍然无法定位时,可在 Coskey 执行 coskey gateway status 和 coskey doctor;网关日志位于
~/.coskey/logs/gateway.log,不会记录 token、上游密钥、prompt 或 completion。