MIT 開源的 macOS 小工具（已 Apple 公證，通用二進位）：一鍵在「官方 OpenAI」與自訂 / 第三方 API 之間切換 Codex，內建 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`，本機介接器不會被誤送進代理。
使用它會不會影響官方 OpenAI 登入？
不會。官方 OpenAI 與你的自訂 provider 同時保留在設定中，切換只改變「預設走哪一條路」；也可以選擇略過 ChatGPT OAuth，改用 API Key 模式。
07相關的 DSH 工作流程
dsh-purge
作者 yujunzhixue
DeepSeek Harness 破甲：讓所有模型都能破甲，不同模型可換不同提示詞；預設提示詞面向國模「小碼醬」。Jailbreak for every model — swap prompts per model. 求 Star 收藏 ⭐
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 分鐘快照；外掛目錄為自動生成的產物
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 個值得優先安裝的外掛，涵蓋各個分類。