Codex CLI 接入 DeepSeek 是一個典型的“改配置文件接入第三方 OpenAI 兼容服務”的用例。很多開發者看到網上流傳的“Codex 一鍵連接器”教程以為必須借助某個封裝好的腳本才能完成接入實際上 Codex CLI 本身就是本地終端工具模型接口、模型名稱和 API Key 都可以通過~/.codex/config.toml手動指定。理解了這一層你就能自己完成 DeepSeek 的接入也能在“Codex 設置中文沒反應”“unable to locate the codex cli binary”這類問題出現時按照配置和日志逐層定位。接下來的內容會從零開始安裝 Codex CLI申請 DeepSeek API Key編寫最小配置驗證請求是否真正發往 DeepSeek再重點處理兩個高頻問題——中文輸出不生效和啟動時找不到 codex 可執行文件。最后會提供一份錯誤速查表和日常使用建議方便日后遇到同類問題時直接查閱。需要先說明的是Codex CLI 版本迭代很快下面的命令和配置是撰寫階段常見的寫法但具體到你的版本應該以官方 README 和當前版本的config.example.toml為準。如果出現字段名不一致的情況優先參考官方示例。1. 為什么要手動配置 Codex CLI而不是依賴“一鍵連接器”1.1 Codex CLI 到底是什么Codex CLI 是一個運行在終端里的 AI 編程代理。使用者用自然語言描述需求Codex CLI 會讀取本地文件、分析項目結構、執行命令并逐步生成修改建議。它和網頁版聊天工具的區別在于它直接與本地開發環境深度綁定能把一次任務拆成多次工具調用再根據執行結果繼續迭代。從架構上看Codex CLI 只負責交互、工具調用和上下文管理真正回答問題的是后端模型服務。默認情況下后端是 OpenAI 官方接口但接口本身沒有綁定死配置文件可以指定另一個模型提供者。這就是 DeepSeek 能夠接入的基礎。1.2 為什么 DeepSeek 可以接入 Codex CLIDeepSeek 的 API 在設計上兼容 OpenAI 的 Chat Completions 請求格式。對 Codex CLI 來說它只需要知道三件事請求發到哪里、使用哪個模型、用什么憑證。這三件事分別對應配置里的base_url、model和env_key。只要提供者支持 OpenAI 兼容協議就可以接入。這也是很多“一鍵連接器”能工作的原理它們沒有做任何魔法絕大多數只是提前幫你把配置文件寫好有些還會增加一層轉發服務。問題是轉發服務不可控你無法確定 API Key 是否會被轉發方記錄。自己手動配置不僅不復雜而且鏈路透明所有請求都直接發給 DeepSeek 官方接口。1.3 對“零成本、不限量、跳過登錄”這類說法的判斷看到“零成本使用 Codex 算力”“無需充值跳過鑒權”這類表述時要特別謹慎。DeepSeek 官方 API 是按 token 計費的接口鑒權依賴有效 API Key不存在真正意義上的免費無限量額度。任何第三方提供的免費轉發端點都可能存在以下風險API Key 被轉發服務截獲。請求內容被第三方記錄。接口地址和模型名臨時變化導致接入不穩定。服務商隨時可能關閉影響正在進行的任務。因此這篇文章只討論“使用你自己的 DeepSeek API Key通過官方接口完成接入”這一種安全可控的方式。你不需要把 Key 交給任何第三方工具。2. 環境準備安裝 Codex CLI 并驗證 DeepSeek API 可用性2.1 安裝 Codex CLI在開始之前先確認機器上有 Node.js 或 Homebrew 環境。安裝 Codex CLI 的常見方式是 npm 全局安裝npm install -g openai/codexmacOS 用戶也可以使用 Homebrewbrew install codex安裝完成后執行codex --version如果終端能輸出版本號說明 CLI 已經進入 PATH。如果提示command not found說明 npm 或 Homebrew 的全局 bin 目錄沒有被加入 PATH。此時不要在項目目錄里反復重裝而是檢查全局路徑。在 macOS/Linux 下可以執行npm prefix -g這條命令會輸出 npm 全局目錄地址。假設輸出是/usr/local那么可執行文件通常位于/usr/local/bin檢查這個目錄是否在 PATH 中echo $PATH把缺失路徑加入 PATH 后重新打開終端再驗證一遍。Windows 用戶可以在 PowerShell 中使用where.exe codex查看可執行文件位置并檢查當前用戶環境變量中的 PATH。2.2 獲取 DeepSeek API Key使用 DeepSeek 服務需要到 DeepSeek 開放平臺注冊賬號然后在控制臺創建 API Key。創建時通常會要求選擇計費方式并保證賬戶有足夠余額。Key 在首次創建時只會完整顯示一次之后無法從頁面再次查看所以要在創建后立即復制。一個可靠的驗證方式是直接調用模型列表接口確認 Key 有效export DEEPSEEK_API_KEYsk-你的key curl -sS https://api.deepseek.com/v1/models \ -H Authorization: Bearer $DEEPSEEK_API_KEY如果返回包含模型信息的 JSON 數據說明 Key 可用。如果返回 401重點檢查 Key 是否復制完整是否包含多余空格或換行。如果請求超時則說明本機網絡無法穩定訪問api.deepseek.com需要先解決網絡問題這一步不能被跳過。2.3 配置環境變量為了避免把 API Key 寫進配置文件后傳到代碼倉庫推薦使用環境變量來管理。macOS/Linux 用戶可以在~/.zshrc或~/.bashrc中追加export DEEPSEEK_API_KEYsk-你的keyWindows 用戶可以在 PowerShell 中設置當前用戶環境變量[System.Environment]::SetEnvironmentVariable(DEEPSEEK_API_KEY, sk-你的key, User)配置完成后重新打開終端執行檢查命令echo ${#DEEPSEEK_API_KEY}這條命令會輸出環境變量的長度。如果輸出為 0說明變量沒有生效如果輸出大于 0再確認長度是否和 Key 的實際長度一致。這里不要直接echo $DEEPSEEK_API_KEY把 Key 打印出來防止終端記錄歷史中被別人看到。下面用表格匯總基礎環境要求項目要求說明操作系統macOS / Linux / WindowsCodex CLI 支持主流桌面系統運行時Node.js 或 Homebrewnpm 安裝方式需要 Node.js終端支持 UTF-8 編碼中文顯示依賴終端編碼DeepSeek API Key可用且余額充足按 token 計費需要預充值網絡可訪問 api.deepseek.com內網或受限網絡需要先解決訪問鏈路3. 編寫 config.toml完成 DeepSeek 接入3.1 配置文件位置和基本結構Codex CLI 使用 TOML 文件保存配置。默認路徑是macOS/Linux~/.codex/config.tomlWindows%USERPROFILE%\.codex\config.toml如果.codex目錄不存在先創建mkdir -p ~/.codex配置文件里通常由多張表組成。模型提供者定義在一個叫model_providers的映射中每個提供者有名字、地址和密鑰環境變量三個核心屬性。下面是一份可以直接復制的最簡配置model deepseek-chat model_provider deepseek [model_providers.deepseek] name DeepSeek base_url https://api.deepseek.com/v1 env_key DEEPSEEK_API_KEY這段配置的邏輯是Codex CLI 先讀model_provider得知要使用名為deepseek的提供者然后到model_providers表里找到deepseek的定義最后在發起請求時從env_key指定的環境變量中讀取 API Key。3.2 每個字段都代表什么字段作用常見錯誤model指定使用的模型名會拼進請求體寫成展示名稱而不是 API 模型名model_provider指定使用哪一組提供者配置忘記配置該項仍走默認 OpenAIname提供者的展示名稱僅用于日志和顯示寫錯不影響請求但不利于排查base_url請求路徑的基礎地址多寫/chat/completions或漏寫/v1env_key從哪個環境變量讀取 Key設成DEEPSEEK_API_KEY但環境變量名不同base_url是這一段最容易出錯的地方。Codex CLI 在發起請求時會在基礎地址后面拼接出完整的 API 路徑。常見目標是https://api.deepseek.com/v1請求最終會訪問https://api.deepseek.com/v1/chat/completions。如果你在base_url里手動寫上了chat/completions最終 URL 就會變成雙重路徑服務端必然返回 404。正確做法是只保留到/v1。3.3 模型名和提供者名需要特別注意DeepSeek 開放平臺通常提供多個模型。常見 API 模型名包括deepseek-chat和deepseek-reasoner分別對應通用對話模型和帶推理步驟的模型。具體模型名要以你從 DeepSeek 控制臺看到的為準不要根據舊文章猜。model_provider不是固定 Codex CLI 手動接入 DeepSeek：配置與問題排查指南
Codex CLI 接入 DeepSeek 是一個典型的“改配置文件接入第三方 OpenAI 兼容服務”的用例。很多開發者看到網上流傳的“Codex 一鍵連接器”教程以為必須借助某個封裝好的腳本才能完成接入實際上 Codex CLI 本身就是本地終端工具模型接口、模型名稱和 API Key 都可以通過~/.codex/config.toml手動指定。理解了這一層你就能自己完成 DeepSeek 的接入也能在“Codex 設置中文沒反應”“unable to locate the codex cli binary”這類問題出現時按照配置和日志逐層定位。接下來的內容會從零開始安裝 Codex CLI申請 DeepSeek API Key編寫最小配置驗證請求是否真正發往 DeepSeek再重點處理兩個高頻問題——中文輸出不生效和啟動時找不到 codex 可執行文件。最后會提供一份錯誤速查表和日常使用建議方便日后遇到同類問題時直接查閱。需要先說明的是Codex CLI 版本迭代很快下面的命令和配置是撰寫階段常見的寫法但具體到你的版本應該以官方 README 和當前版本的config.example.toml為準。如果出現字段名不一致的情況優先參考官方示例。1. 為什么要手動配置 Codex CLI而不是依賴“一鍵連接器”1.1 Codex CLI 到底是什么Codex CLI 是一個運行在終端里的 AI 編程代理。使用者用自然語言描述需求Codex CLI 會讀取本地文件、分析項目結構、執行命令并逐步生成修改建議。它和網頁版聊天工具的區別在于它直接與本地開發環境深度綁定能把一次任務拆成多次工具調用再根據執行結果繼續迭代。從架構上看Codex CLI 只負責交互、工具調用和上下文管理真正回答問題的是后端模型服務。默認情況下后端是 OpenAI 官方接口但接口本身沒有綁定死配置文件可以指定另一個模型提供者。這就是 DeepSeek 能夠接入的基礎。1.2 為什么 DeepSeek 可以接入 Codex CLIDeepSeek 的 API 在設計上兼容 OpenAI 的 Chat Completions 請求格式。對 Codex CLI 來說它只需要知道三件事請求發到哪里、使用哪個模型、用什么憑證。這三件事分別對應配置里的base_url、model和env_key。只要提供者支持 OpenAI 兼容協議就可以接入。這也是很多“一鍵連接器”能工作的原理它們沒有做任何魔法絕大多數只是提前幫你把配置文件寫好有些還會增加一層轉發服務。問題是轉發服務不可控你無法確定 API Key 是否會被轉發方記錄。自己手動配置不僅不復雜而且鏈路透明所有請求都直接發給 DeepSeek 官方接口。1.3 對“零成本、不限量、跳過登錄”這類說法的判斷看到“零成本使用 Codex 算力”“無需充值跳過鑒權”這類表述時要特別謹慎。DeepSeek 官方 API 是按 token 計費的接口鑒權依賴有效 API Key不存在真正意義上的免費無限量額度。任何第三方提供的免費轉發端點都可能存在以下風險API Key 被轉發服務截獲。請求內容被第三方記錄。接口地址和模型名臨時變化導致接入不穩定。服務商隨時可能關閉影響正在進行的任務。因此這篇文章只討論“使用你自己的 DeepSeek API Key通過官方接口完成接入”這一種安全可控的方式。你不需要把 Key 交給任何第三方工具。2. 環境準備安裝 Codex CLI 并驗證 DeepSeek API 可用性2.1 安裝 Codex CLI在開始之前先確認機器上有 Node.js 或 Homebrew 環境。安裝 Codex CLI 的常見方式是 npm 全局安裝npm install -g openai/codexmacOS 用戶也可以使用 Homebrewbrew install codex安裝完成后執行codex --version如果終端能輸出版本號說明 CLI 已經進入 PATH。如果提示command not found說明 npm 或 Homebrew 的全局 bin 目錄沒有被加入 PATH。此時不要在項目目錄里反復重裝而是檢查全局路徑。在 macOS/Linux 下可以執行npm prefix -g這條命令會輸出 npm 全局目錄地址。假設輸出是/usr/local那么可執行文件通常位于/usr/local/bin檢查這個目錄是否在 PATH 中echo $PATH把缺失路徑加入 PATH 后重新打開終端再驗證一遍。Windows 用戶可以在 PowerShell 中使用where.exe codex查看可執行文件位置并檢查當前用戶環境變量中的 PATH。2.2 獲取 DeepSeek API Key使用 DeepSeek 服務需要到 DeepSeek 開放平臺注冊賬號然后在控制臺創建 API Key。創建時通常會要求選擇計費方式并保證賬戶有足夠余額。Key 在首次創建時只會完整顯示一次之后無法從頁面再次查看所以要在創建后立即復制。一個可靠的驗證方式是直接調用模型列表接口確認 Key 有效export DEEPSEEK_API_KEYsk-你的key curl -sS https://api.deepseek.com/v1/models \ -H Authorization: Bearer $DEEPSEEK_API_KEY如果返回包含模型信息的 JSON 數據說明 Key 可用。如果返回 401重點檢查 Key 是否復制完整是否包含多余空格或換行。如果請求超時則說明本機網絡無法穩定訪問api.deepseek.com需要先解決網絡問題這一步不能被跳過。2.3 配置環境變量為了避免把 API Key 寫進配置文件后傳到代碼倉庫推薦使用環境變量來管理。macOS/Linux 用戶可以在~/.zshrc或~/.bashrc中追加export DEEPSEEK_API_KEYsk-你的keyWindows 用戶可以在 PowerShell 中設置當前用戶環境變量[System.Environment]::SetEnvironmentVariable(DEEPSEEK_API_KEY, sk-你的key, User)配置完成后重新打開終端執行檢查命令echo ${#DEEPSEEK_API_KEY}這條命令會輸出環境變量的長度。如果輸出為 0說明變量沒有生效如果輸出大于 0再確認長度是否和 Key 的實際長度一致。這里不要直接echo $DEEPSEEK_API_KEY把 Key 打印出來防止終端記錄歷史中被別人看到。下面用表格匯總基礎環境要求項目要求說明操作系統macOS / Linux / WindowsCodex CLI 支持主流桌面系統運行時Node.js 或 Homebrewnpm 安裝方式需要 Node.js終端支持 UTF-8 編碼中文顯示依賴終端編碼DeepSeek API Key可用且余額充足按 token 計費需要預充值網絡可訪問 api.deepseek.com內網或受限網絡需要先解決訪問鏈路3. 編寫 config.toml完成 DeepSeek 接入3.1 配置文件位置和基本結構Codex CLI 使用 TOML 文件保存配置。默認路徑是macOS/Linux~/.codex/config.tomlWindows%USERPROFILE%\.codex\config.toml如果.codex目錄不存在先創建mkdir -p ~/.codex配置文件里通常由多張表組成。模型提供者定義在一個叫model_providers的映射中每個提供者有名字、地址和密鑰環境變量三個核心屬性。下面是一份可以直接復制的最簡配置model deepseek-chat model_provider deepseek [model_providers.deepseek] name DeepSeek base_url https://api.deepseek.com/v1 env_key DEEPSEEK_API_KEY這段配置的邏輯是Codex CLI 先讀model_provider得知要使用名為deepseek的提供者然后到model_providers表里找到deepseek的定義最后在發起請求時從env_key指定的環境變量中讀取 API Key。3.2 每個字段都代表什么字段作用常見錯誤model指定使用的模型名會拼進請求體寫成展示名稱而不是 API 模型名model_provider指定使用哪一組提供者配置忘記配置該項仍走默認 OpenAIname提供者的展示名稱僅用于日志和顯示寫錯不影響請求但不利于排查base_url請求路徑的基礎地址多寫/chat/completions或漏寫/v1env_key從哪個環境變量讀取 Key設成DEEPSEEK_API_KEY但環境變量名不同base_url是這一段最容易出錯的地方。Codex CLI 在發起請求時會在基礎地址后面拼接出完整的 API 路徑。常見目標是https://api.deepseek.com/v1請求最終會訪問https://api.deepseek.com/v1/chat/completions。如果你在base_url里手動寫上了chat/completions最終 URL 就會變成雙重路徑服務端必然返回 404。正確做法是只保留到/v1。3.3 模型名和提供者名需要特別注意DeepSeek 開放平臺通常提供多個模型。常見 API 模型名包括deepseek-chat和deepseek-reasoner分別對應通用對話模型和帶推理步驟的模型。具體模型名要以你從 DeepSeek 控制臺看到的為準不要根據舊文章猜。model_provider不是固定