如何在 Codex 使用 DeepSeek：設定、限制與費用

現在要把 DeepSeek 接進 Codex，不需要再透過 Proxy 轉接。Codex 使用 Responses API 與模型溝通，而 DeepSeek 原生支援這個協定，因此只要設定檔到位即可。不過目前有兩項關鍵限制：能在 Codex 使用的 DeepSeek 模型只有一款，而且它不支援看圖。

Codex 能不能直接用 DeepSeek？

可以。Codex 透過 OpenAI 的 Responses API 呼叫模型，DeepSeek API 則原生相容這套協定，因此只要在設定檔宣告 DeepSeek 為模型供應商，Codex 就能直接使用。DeepSeek 也在 API 文件的 Agent Integrations → Codex 提供了官方整合說明。

這和過去的設定方式不同。Codex 已捨棄舊有的 wire_api = "chat" 路徑，改用 Responses API；在一段時間內，DeepSeek 必須靠 LiteLLM、內建 Responses 實作的 Router，或自行撰寫的轉接層才能接入。這些做法仍然能用，但已不再是必要條件。要注意的是，這是模型供應商設定，和在 Codex 加入 DeepSeek 相關 MCP 工具是兩回事。

這份設定可套用到所有 Codex 介面。Codex CLI、ChatGPT 桌面版，以及 VS Code 的 Codex IDE 擴充功能都會讀取相同的 ~/.codex 目錄，因此只需設定一次，不必逐一處理每個用戶端。

Codex 目前支援哪一個 DeepSeek 模型？

目前只有 deepseek-v4-flash。DeepSeek 的價格表中，deepseek-v4-flash 的 Responses API 支援狀態為 ✓，deepseek-v4-pro 則為 ✗；註腳表示 Pro 預計在 2026 年 8 月初支援。截至 2026 年 8 月 3 日，這項註腳仍存在，Pro 也依然標示為 ✗。

設定程序寫入的 models.json 型錄同時列出兩款模型，所以設定檔本身不會阻止你選擇 Pro；但請求送出後，會在上游端失敗。CC Switch 的 DeepSeek 預設值也在原始設定檔中提出相同警告：DeepSeek 尚未開放整合前，切換至 Pro 會報錯。

如果現在就想用較強的模型，Pro 支援 Anthropic 格式的端點；這也是它會出現在 Claude Code 設定中、卻不能用於 Codex 的原因。兩個模型在價格與並行額度上的差異不小，值得先做選擇；可參考 deepseek-v4-flash vs deepseek-v4-pro。

方式一：使用官方設定腳本

DeepSeek 提供的設定腳本會一次寫好完整設定。若你沒有同時管理多個供應商，這是最快的方式。不過要先安裝並至少啟動過一次 Codex CLI 或 ChatGPT 桌面版，讓 ~/.codex 目錄建立完成；另外，Codex 用戶端至少要是 0.144.0 版，這也是模型型錄宣告的最低版本。

# macOS / Linux
bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh)

# Windows，請在 PowerShell 執行
irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex

腳本會提供選單：1 選擇 deepseek-v4-flash，2 選擇 deepseek-v4-pro，3 還原安裝前的設定。請選 1；選項 2 雖會寫入有效設定，但該模型目前尚無法處理 Codex 請求。第一次執行時，腳本會要求輸入 API 金鑰，可在 platform.deepseek.com 建立。

既有設定檔會被改動哪些地方？

我在 2026 年 8 月 3 日，對一個刻意製造衝突設定的暫用 CODEX_HOME 執行官方腳本。原始設定包含 profile、過時的 model_verbosity、model_reasoning_summary，以及 MCP server 和受信任專案項目。可用 CODEX_HOME=/tmp/probe sh codex-deepseek-setup-en.sh 重現，並選擇 1。腳本回報了四項變更，並逐一說明原因：

• 重寫 model："gpt-5.6-sol" → "deepseek-v4-flash"
• 移除 profile = "myprofile"  ← profile 會覆蓋 model / model_provider / model_catalog_json
• 移除 model_verbosity = "high"  ← 過時值可能不在模型支援範圍內
• 移除 model_reasoning_summary = "detailed"  ← models.json 宣告 default_reasoning_summary=none

[mcp_servers.playwright] 區塊、[projects."..."] 的信任等級與 approval_policy 都保持不變；任何寫入前，原始檔案會先複製到 ~/.codex/backup-deepseek/。腳本也會在提交變更前驗證兩份檔案：檢查 models.json 是否為有效 JSON，並檢查 config.toml 是否有解析錯誤或重複鍵值。這只是單一機器上的一次測試，因此可視為備份與還原路徑確實存在的證據，但不能保證所有設定結構都會有完全相同的結果。

方式二：手動編輯 config.toml

若你想把設定納入版本控制，或希望清楚掌握每個欄位的作用，建議手動編輯。先依照DeepSeek 文件發布的模型型錄建立 ~/.codex/models.json，再把以下內容加進 ~/.codex/config.toml：

model = "deepseek-v4-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
model_catalog_json = "~/.codex/models.json"

[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "<your DeepSeek API Key>"

方式三：經常切換供應商可用 CC Switch

CC Switch 是一款桌面應用程式，可管理包括 Codex 在內共八種程式開發工具的供應商設定。它內建 DeepSeek 預設值：端點為 https://api.deepseek.com，預設模型是 deepseek-v4-flash，模型型錄則同時包含 Flash 與 Pro。它寫入的欄位與手動設定相同，只是改由系統匣選單操作，而不是直接開編輯器。

採用前有兩點要知道。和 Claude Code 不同，Codex 每次切換後都必須重新啟動才會套用變更。此外，單一應用程式會保管你登錄的所有供應商憑證，並執行本機服務來路由這些憑證；這和將單一 API 金鑰放在單一檔案中，是不同的安全模型。

如何確認設定真的生效

在專案中啟動 Codex CLI，查看啟動橫幅即可：model 與 provider 兩行就是確認依據。我在 2026 年 8 月 3 日，以 codex-cli 0.146.0 對測試設定執行時，畫面顯示：

OpenAI Codex v0.146.0
model: deepseek-v4-flash
provider: deepseek
reasoning effort: high

若 API 金鑰錯誤，錯誤訊息相當容易辨認，且會列出正在使用的端點；這也是最快確認請求確實送往 DeepSeek 的方法：

ERROR: unexpected status 401 Unauthorized: Authentication Fails, Your api key: ****r000 is invalid,
       url: https://api.deepseek.com/responses

Codex 會重試五次才顯示這項錯誤，因此金鑰打錯後，會先經歷幾秒沒有回應的等待時間。在 macOS 的 ChatGPT 桌面版中，模型選擇器會顯示 Custom，而不是模型名稱；這是該應用程式對任何本機設定模型的通用標籤，實際上仍會使用你選定的 DeepSeek 模型。若 Codex 記錄出現 fallback model metadata 或 Unknown model，表示 models.json 沒有載入，型錄路徑有誤。

在 Codex 裡跑 DeepSeek，會有哪些不同？

DeepSeek 在 Codex 中的行為，與使用 OpenAI 模型時有四項差異；這些都不是需要除錯的故障。

不能輸入圖片。models.json 裡的 DeepSeek 項目宣告 input_modalities: ["text"]，因此只要 DeepSeek 是啟用中的模型，任何 Codex 用戶端都無法使用貼上的截圖或圖片附件。一位開發者在 2026 年 8 月 2 日的 Hacker News 也遇到同樣問題，做法是保留第二個支援視覺功能的供應商：

由於 DeepSeek V4 沒有視覺能力，所以他讓 OMP 使用透過 Codex sub 的 GPT 5.6 Luna。

這種做法只要再加入一個 [model_providers.*] 區塊，指向可接受圖片的供應商即可。wire_api = "responses" 的結構完全相同，因此承載 GPT-5.6 的聚合端點也能放進同一份設定，只要修改一行 model 就能切換。

舊對話看起來像不見了。Codex 會依登入方式分組保存工作階段歷史。因此，從 ChatGPT 訂閱切換到第三方 API 金鑰時，先前的對話群組只是被隱藏，並沒有被刪除。還原舊設定後，原本的工作階段會再次出現，而 DeepSeek 的工作階段則會隱藏。

API 金鑰會以原始文字存在設定檔中。experimental_bearer_token 儲存的是金鑰本身，而不是環境變數參照，因此 ~/.codex/config.toml 會成為含有機密資訊的檔案。在同步該目錄或提交 dotfiles 儲存庫前，值得先仔細檢查。

它可能自稱 ChatGPT。整合程序安裝的models.json 帶有 Codex 自己的 harness prompt，開頭是「You are Codex, an agent based on GPT-5.」。這段 prompt 確實會影響運作：它定義代理遵循的工具協定、核准規則與輸出格式。因此，同一模型在這個環境中的行為會和純聊天視窗不同；身份描述來自 harness，而不是模型宣稱自己出身於哪個系譜。

費用怎麼算？

截至 2026 年 8 月 3 日，我在DeepSeek 價格頁面核實，deepseek-v4-flash 的快取未命中輸入為每百萬 Token $0.14，輸出為每百萬 Token $0.28。快取命中的輸入只要每百萬 Token $0.0028，比未命中低五十倍。對會在每回合重新傳送持續增長 context 的程式開發代理來說，這個差距正是影響長工作階段成本的關鍵數字。

表格還沒呈現兩件事。DeepSeek 表示未來將導入尖峰與離峰計價：每日北京時間（UTC+8）09:00–12:00、14:00–18:00 的尖峰時段，費率會是表列價格的 2 倍，開始日期尚待公告。此外，型錄將 1M context window 宣告為 95% 有效，超出後會依 models.json 設定的政策開始截斷。

FAQ

沒有 ChatGPT 訂閱，也能在 Codex 用 DeepSeek 嗎？

可以。preferred_auth_method = "apikey" 與 forced_login_method = "api" 會讓 Codex 透過你的 DeepSeek 金鑰驗證，完全略過帳號登入。

VS Code 擴充功能和桌面版要分開設定嗎？

不用。三個 Codex 用戶端都讀取同一份 ~/.codex 設定。切換後請重新啟動桌面用戶端，讓它載入變更。

如何切回官方模型？

重新執行設定腳本並選擇選項 3，它會還原安裝前備份的 config.toml。如果是手動設定 Codex，請刪除 DeepSeek 相關欄位及 [model_providers.deepseek] 區塊，然後再次登入。

現在可以在 Codex 使用 deepseek-v4-pro 嗎？

截至 2026 年 8 月 3 日還不行。DeepSeek 價格頁面仍將它的 Responses API 支援標示為 ✗；雖然公告目標是 2026 年 8 月初，但應重新查看該頁面，而不要因為設定檔允許選擇它就直接相信可用。

三種設定方式，該選哪一種？

真正還沒解決的問題是 Pro。Flash 是這個產品線中便宜、快速、僅支援文字的一端；但多數人想在代理迴圈使用的模型，還不能說 Codex 所需的協定。在那項註腳變成支援前，選擇在 Codex 使用 DeepSeek，就代表你得明確選擇 Flash。

延伸閱讀： Codex vs Claude Code · How to use GLM-5.2 in Claude Code