DeepSeek 怎麼接入 Codex：官方一鍵腳本與手動改 config.toml 的完整步驟

本文根據 DeepSeek 官方「接入 Codex」文檔和 OpenAI Codex 官方配置文檔整理，資料核對於 2026-10-24。腳本、配置字段可能更新，以官方頁面為準。圖為本站整理的示意圖。

適用於誰

• 搜「deepseek怎麼接入codex」「deepseek能接入codex嗎」「codex怎麼接入deepseek」的人；
• 已經在用 Codex CLI、ChatGPT 桌面端或 VS Code 的 Codex 插件，想換成 DeepSeek 模型的人；
• 想知道配置文件怎麼寫、哪些字段有什麼用的人。

結論先說

1. 能接入，而且官方提供了現成方案。Codex 通過 Responses API 與模型交互，DeepSeek API 原生支持這種格式（官方 2026-08-13 更新日誌寫明，並「針對性適配 Codex」）。
2. 一份配置，所有 Codex 形態通用：官方頁面說，Codex CLI、ChatGPT 桌面端、VS Code 的 Codex 插件共用同一份配置文件，配置一次即可。
3. 推薦用官方一鍵腳本，也可以手動編輯 ~/.codex/config.toml。
4. 可選兩個模型：deepseek-flash（支持圖片輸入）和 deepseek-v4-pro（Codex 內置聯網搜尋只有它支持）。
5. 需要 API Key：在 DeepSeek 開放平台創建，見 /guides/deepseek-api-key；API 按 token 計費，需要帳戶有餘額，見 /guides/deepseek-api-platform-balance-topup。

圖：本站根據 DeepSeek 官方「接入 Codex」文檔 整理的示意圖

一、準備

• 安裝 Codex CLI 或 ChatGPT 桌面端，並至少運行過一次，讓 ~/.codex 目錄已存在（官方腳本要求）；Codex 的安裝與基本用法見 /guides/codex-getting-started、/guides/codex-cli-install-update；
• 在 DeepSeek 開放平台 創建 API Key（以 sk- 開頭），並確保有餘額。

二、方式一：官方一鍵腳本（推薦）

官方給出的命令：

macOS / Linux 在終端執行：

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

Windows 在 PowerShell 執行：

powershell
irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup.ps1 | iex

這類「下載後直接執行」的命令有風險：它來自 DeepSeek 官方文檔，但你仍然可以先把腳本下載下來看一遍再運行，只從官方文檔頁面複製命令。

運行後按選單選擇：

• 第 1 項：修改 Codex 配置，使用 deepseek-flash（同時支持圖片輸入）；
• 第 2 項：使用 deepseek-v4-pro；
• 第 9 項：恢復預設的 Codex 配置，刪除 deepseek 相關配置。

首次運行會提示輸入 API Key。官方說腳本會依次：

1. 備份現有配置：把 ~/.codex/config.toml 備份到 ~/.codex/backup-deepseek/，隨時可以還原；
2. 寫入模型目錄 ~/.codex/models.json：向 Codex 聲明 DeepSeek 模型的元數據（上下文窗口、支持的推理強度檔位、工具調用格式等），讓 Codex 能像用內置模型一樣使用它們；
3. 修改 config.toml：只改必要字段，新增 [model_providers.deepseek]，並在 [desktop] 中寫入 enabled-reasoning-efforts；你原有的 MCP 伺服器、項目信任級別等配置保留；若有與 DeepSeek 配置衝突的字段，腳本會刪除並逐條打印原因；
4. 校驗：寫入前先校驗語法，失敗則中止，不修改任何文件。

再次運行腳本可以重新寫入配置或恢復預設；重新運行第 1 / 2 項還會補齊新版腳本新增的配置項，並清理舊的 deepseek-v4-flash 等條目，只保留 deepseek-flash 和 deepseek-v4-pro。

三、方式二：手動編輯配置

官方手動方案分兩步。

第一步，創建模型目錄文件 ~/.codex/models.json，內容與腳本寫入的一致（包含 deepseek-flash 和 deepseek-v4-pro 兩個模型的元數據，文件較長，請到官方頁面展開「models.json 完整內容」複製）。其中 deepseek-flash 的 input_modalities 含 image，Codex 據此判斷它能接收圖片。

第二步，編輯 ~/.codex/config.toml（沒有就新建），加入以下內容，其中 experimental_bearer_token 填你的 API Key：

toml
model = "deepseek-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
web_search = "disabled"
show_raw_agent_reasoning = true
model_catalog_json = "~/.codex/models.json"

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

[desktop]
enabled-reasoning-efforts = ["low", "medium", "high", "xhigh", "ultra", "max"]

如果 config.toml 裏已經有 [desktop] 段，請把 enabled-reasoning-efforts 加到該段裏，不要再新建一個 [desktop]，重複的配置段會讓文件不合法。

字段是什麼意思（官方說明）

關於 API Key 寫在配置文件裏

DeepSeek 官方示例把 Key 直接寫進 config.toml。而 Codex 官方文檔對自定義提供方的建議是：用 env_key 指定一個環境變量名來讀取密鑰，experimental_bearer_token（直接寫令牌）被標為不推薦。兩種寫法的字段含義都在 Codex 官方文檔裏（model_providers.<id>.env_key 與 experimental_bearer_token）。如果你想把 Key 放在環境變量裏，可以參考 Codex 官方寫法自行調整，但本文沒有測試過這種改法，請先備份配置再試。無論哪種，都不要把配置文件提交到公開倉庫。

另外 Codex 官方文檔提醒：項目級的 .codex/config.toml 不能覆蓋 model_provider、model_providers 這類涉及憑據與提供方的設定，所以這些要寫在用戶級的 ~/.codex/config.toml。

四、聯網搜尋

官方說明：Codex 內置聯網搜尋只在使用 deepseek-v4-pro 時可用。一鍵腳本預設寫入 web_search = "disabled"；要用，切到 deepseek-v4-pro，並把 web_search 設為 "live"：

toml
model = "deepseek-v4-pro"
web_search = "live"

儲存後重啟 Codex。搜尋由 DeepSeek 在服務端執行，按 Search 接口的計費規則計費（每 1000 次成功請求 5 元；目前在 Codex 等工具中使用時的服務端搜尋尚未計費，官方說將自北京時間 2026-11-01 00:00 起按次收費）。

五、開始使用與常見情況

• Codex CLI：進入項目目錄執行 codex，啟動資訊裏顯示 model: deepseek-flash 即生效；
• ChatGPT 桌面端：模型選擇器顯示「自定義」或「DeepSeek-Flash」之類的名字，都算生效，取決於 ChatGPT 版本；
• VS Code 的 Codex 插件：與 CLI 共用同一份配置，裝好插件即可用。

圖：本站根據 DeepSeek 官方「接入 Codex」文檔整理的示意圖

常見問題

Q：切到 DeepSeek 後以前的對話不見了？

官方說明沒有刪除。Codex 按登入方式分組存放會話：用 ChatGPT 官方訂閱產生的會話和用第三方 API（如 DeepSeek）產生的會話屬於兩組，介面只顯示與當前配置匹配的一組。恢復原配置（腳本第 9 項）就能重新看到之前的會話，切換後需要重啟 ChatGPT 客戶端才會生效。

Q：用 DeepSeek 還需要 ChatGPT 會員嗎？

按官方配置，使用 API Key 認證並跳過 ChatGPT 帳號登入，計費走 DeepSeek 開放平台。如果你要用的是 Codex 官方模型，需要 ChatGPT 套餐，見 /chongzhi/chatgpt-plus，用量規則見 /guides/codex-usage-limits。

Q：Codex 裏配 MCP 還能用嗎？

官方說腳本會保留你原有的 MCP 伺服器配置。MCP 的配置方法見 /guides/codex-mcp-config。

Q：想在 Claude Code 裏用 DeepSeek？

見 /guides/deepseek-claude-code-setup。想了解 Codex 與 Claude Code、Cursor 的區別，見 /guides/cursor-vs-claude-code-vs-codex。

Q：報錯 400 / 401 / 402 怎麼辦？

401 多半是 Key 錯，402 是餘額不足，見 /guides/deepseek-api-error-codes。

參考資料

• DeepSeek API 文檔：接入 Codex — https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/codex
• DeepSeek API 文檔：使用 Responses API — https://api-docs.deepseek.com/zh-cn/guides/responses_api
• DeepSeek API 文檔：更新日誌 — https://api-docs.deepseek.com/zh-cn/updates
• OpenAI Codex 文檔：Advanced configuration — https://developers.openai.com/codex/config-advanced
• OpenAI Codex 文檔：Configuration reference — https://developers.openai.com/codex/config-reference