MIT 开源的 macOS 小工具（已 Apple 公证，通用二进制）：一键把 Codex 在「官方 OpenAI」与自定义 / 第三方 API 之间切换，内置 DeepSeek 等国内大模型快速预设与 Chat Completions → Responses 本地适配器，切换对话记录永不丢失。
DSH 适配
生态相关
作者声明
安全审计
未审计
最后核验
2026-08-28
许可证
MIT
01它能帮你完成什么？
一键把 Codex 在「官方 OpenAI」和你自己的自定义 / 第三方 API 之间切换
保存后的配置里两套 provider 都保留在 `~/.codex/auth.json` 和 `config.toml` 中，切换只改默认走哪一路，已保存对话的 provider/model 归属不变
Codex 桌面端与 CLI 用户——希望用稳定、一键的方式把 Codex 接到 DeepSeek 等国内大模型，同时保留官方 OpenAI 登录
把只支持 Chat Completions 的接口桥接成 Codex 需要的 Responses 协议
在本地启动一个适配器（CLI 说明记录为 `127.0.0.1:17638`），自动把 Codex 的 Responses 请求转成 Chat Completions；原生支持 `/responses` 的接口则直连
DeepSeek、Kimi、千问等只提供 `/chat/completions` 接口的 API 用户
02如何接入 DeepSeek Harness？
前置条件
- macOS——应用为通用二进制（Intel + Apple 芯片）
- 从 GitHub Releases 下载 `Codex-Switch-vX.Y.Z.dmg`
安装步骤
- 01
从 GitHub Releases 下载 `Codex-Switch-vX.Y.Z.dmg`
- 02
双击 DMG，把 `Codex Switch.app` 拖进「应用程序」，再从「应用程序」启动（不要从 DMG 窗口或「下载」目录直接运行）
- 03
在应用里选「API 提供方」（官方 OpenAI 或自定义 / 第三方），粘贴 API Key 并保存——保存前会自动探测接入点
验证接入成功
- 应用能从「应用程序」正常启动，且没有「未受信任的开发者」提示——已用 Developer ID 签名并通过 Apple 公证
03DSH 适配与能力边界
生态级关联：README 未文档化任何 DeepSeek Harness 接口。这个独立的 macOS 工具改写 Codex 的 `~/.codex/auth.json` 和 `config.toml`，在官方 OpenAI 与自定义 / 第三方 provider 之间切换——内置 DeepSeek 等国内大模型一键预设，外加本地 Chat Completions → Responses 适配器。
官方 / 自定义并行切换
在应用里选「API 提供方」再保存→顶层 `model_provider` 在 `custom` 与 `openai` 之间切换；两套 provider 段和 CLI profiles 始终保留在 `config.toml`
只改写 `~/.codex/auth.json` 和 `config.toml`；绝不重写已保存对话的归属Chat 适配器（Responses → Chat Completions 桥接）
只支持 `/chat/completions` 的接口（如 DeepSeek / Kimi / 千问）→本地代理自动把 Codex 的 Responses 请求转成 Chat Completions；原生支持 `/responses` 的接口直连
在本地启动一个代理服务国内大模型快速预设
DeepSeek、Kimi、智谱 GLM、通义千问、豆包（火山引擎）、百度文心、MiniMax、阶跃星辰 StepFun，或手动填写第三方 / 中转 API→自动填好接入点和模型，只需粘贴 API Key
官方模式代理修复
HTTP/mixed 代理 URL（例如 `http://127.0.0.1:7897`）→一键把代理写入 Codex shell 环境、当前 macOS `launchd` 环境和登录后恢复用的 LaunchAgent，修复官方模式下新任务反复 Reconnecting
代理只在官方 OpenAI 模式生效——切到自定义 API 时自动关闭，切回官方时按你的设置自动恢复
04适合谁？何时不该用？
适合
- Codex 桌面端与 CLI 用户——希望用稳定、一键的方式把 Codex 接到 DeepSeek 等国内大模型，同时保留官方 OpenAI 登录
- DeepSeek、Kimi、千问等只提供 `/chat/completions` 接口的 API 用户
不适合
- 只能从「应用程序」启动——从 DMG 窗口或「下载」目录直接运行会触发 macOS 隔离（App Translocation），导致内置代理服务连接异常。
05兼容性、维护与安全提示
- Codex Switch 是一个 macOS 应用（通用二进制：Intel + Apple 芯片）。
- 只能从「应用程序」启动——从 DMG 窗口或「下载」目录直接运行会触发 macOS 隔离（App Translocation），导致内置代理服务连接异常。
- 不要在对话里让 Codex 自己改接入方式，容易改坏；切换请用本工具，稳定得多。
- 桌面端的模型选择器由 Codex 自己（后端 / 内置）驱动，自定义 provider 的模型在选择器里显示为「自定义」标签——这是 Codex 的限制；实际请求仍按所选 provider 正确路由，CLI 里可完全控制模型 ID。
MIT · 活跃维护中（最新发布 v0.7.21，2026-08-27）
06常见问题
Codex Switch 是 DeepSeek Harness 的原生插件吗？
README 里没有任何 DeepSeek Harness（dsh）原生接口的说明。它是一个独立的 macOS 工具，专门改写 Codex 的 `~/.codex/auth.json` 和 `config.toml`；和 DeepSeek 生态的关联主要在于内置了 DeepSeek 等国内大模型的快速预设，让 Codex 能可靠地切到这些接入点。
怎么把 Codex 接到 DeepSeek 的 API？
在应用里选 DeepSeek 快速预设（预设还覆盖 Kimi、智谱 GLM、通义千问、豆包、百度文心、MiniMax、阶跃星辰 StepFun），它会自动填好接入点和模型，你只需要粘贴 API Key。保存前应用会先探测 `/responses` 再探测 `/chat/completions`，不通就当场报错。
切换 provider 会不会丢对话记录？
不会。正常切换只改写 `~/.codex/auth.json` 和 `config.toml`，绝不重写已保存对话的归属；若检测到旧版适配器留下的非法 message ID，会先备份再一次性把 `item_...` 前缀修复为 `msg_...`，历史内容与会话归属保持不变。
我的接口只支持 Chat Completions，不支持 Responses 协议，还能用吗？
能。开启 Chat 适配器后，Codex Switch 会在本地启动一个代理（CLI 说明里记录为 `127.0.0.1:17638`），把 Codex 的 Responses 请求自动转成 Chat Completions；原生支持 `/responses` 的接口则直连。`NO_PROXY` 默认保留 `localhost,127.0.0.1,::1`，本地 adapter 不会被错误送进代理。
用它会不会影响官方 OpenAI 登录？
不会。官方 OpenAI 和你的自定义 provider 同时保留在配置里，切换只改「默认走哪一路」；也可以选择跳过 ChatGPT OAuth，改用 API Key 模式。
07相关的 DSH 工作流
deepwiki-rs
作者 sopaco
基于代码生成结构化技术文档与适合 AI 智能体使用的上下文，方便团队理解和协作。
dsh-plugin-radar
作者 adamplatin123
DSH Plugin Radar — open-source ecosystem radar for DeepSeek Harness plugins: continuous discovery (21k+ candidates), k8s runtime validation (13k+ tests), 15-min snapshots; the catalog is a generated artifact — 开源 DSH 插件生态雷达：持续发现 2.1 万+ 候选、k8s 运行级实测 1.3 万+、15 分钟快照；插件目录为自动生成的产物
eac-pack
作者 ebony-vinyl
Embracing All Creation (Plugin Suite) — Dedicated to the Harmonious Coexistence of Hundreds of DSH Plugins / 揽尽万象（插件整合包） —— 致力于让数百个DSH插件和谐共存
picgo-core
作者 picgo
强大的图片上传引擎，同时支持 CLI 与 API。
08数据与来源
It turns hand‑editing `~/.codex/auth.json` and `config.toml` into one save: Official OpenAI and your custom provider bot…
It ships quick presets for popular Chinese LLM providers and can run a local adapter that bridges Chat‑Completions‑only…
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-28。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。