最近不少朋友在使用 Codex CLI、Codex 插件或者通過第三方 API 中轉(zhuǎn)接入 Codex 時，會遇到一個非常常見的報錯：

401 Unauthorized

或者類似：

exceeded retry limit, last status: 401 Unauthorized

這個錯誤看起來很嚇人，但本質(zhì)上并不復(fù)雜。401 Unauthorized 的意思是：當前請求沒有通過身份認證。 換句話說，Codex 已經(jīng)向服務(wù)端發(fā)起請求了，但服務(wù)端認為你的登錄狀態(tài)、Token、API Key 或權(quán)限不正確，所以拒絕了請求。

下面我們就把 Codex 401 報錯的常見原因和解決方法整理一下。

一、登錄狀態(tài)失效

這是最常見的原因之一。

Codex CLI 通常會在本地保存登錄憑證，例如賬號登錄后的 token、refresh token 或認證緩存。如果這些憑證過期、被刷新、被覆蓋，或者本地緩存損壞，就可能出現(xiàn) 401 Unauthorized。

解決方法

可以先嘗試退出并重新登錄：

codex logout
codex login

如果普通重新登錄無效，可以清理本地認證緩存后再登錄。

常見位置可能是：

~/.codex/auth.json

可以嘗試刪除認證文件：

rm -rf ~/.codex/auth.json

然后重新執(zhí)行：

codex login

如果你之前切換過多個賬號，或者用過第三方工具改過 Codex 配置，這一步尤其重要。

二、API Key 錯誤或失效

如果你使用的是 API Key 登錄 Codex，而不是 ChatGPT 賬號登錄，那么 401 很可能和 API Key 有關(guān)。

常見情況包括：

1. API Key 填錯了；
2. API Key 前后多了空格；
3. API Key 已被刪除或重置；
4. API Key 所屬賬號沒有權(quán)限；
5. 使用了錯誤平臺的 Key；
6. 環(huán)境變量沒有生效。

比如你設(shè)置了：

export OPENAI_API_KEY="sk-xxxx"

但實際終端環(huán)境沒有加載，或者你在另一個 shell、另一個 IDE、另一個終端里運行 Codex，就可能導(dǎo)致 Codex 讀取不到正確的 key。

解決方法

先檢查環(huán)境變量：

echo $OPENAI_API_KEY

如果為空，重新設(shè)置：

export OPENAI_API_KEY="你的 OpenAI API Key"

如果你用的是 Windows PowerShell：

$env:OPENAI_API_KEY="你的 OpenAI API Key"

如果你配置了 .env、config.toml 或第三方中轉(zhuǎn)地址，也要確認 Codex 實際讀取的是哪一份配置。

三、賬號套餐或權(quán)限不匹配

有些用戶是通過 ChatGPT 賬號登錄 Codex，有些用戶是通過 API Key 使用 Codex。兩種方式的權(quán)限體系并不完全一樣。

比如：

• ChatGPT 賬號能用，不代表 API Key 一定能用；
• API Key 能調(diào)用普通模型，不代表能調(diào)用所有 Codex 相關(guān)接口；
• Plus、Pro、Team、Enterprise 的可用能力也可能不同；
• 某些功能可能需要特定地區(qū)、組織或套餐權(quán)限。

解決方法

你可以檢查幾個點：

codex --version
codex login

然后確認：

1. 當前登錄的是不是正確的 OpenAI / ChatGPT 賬號；
2. 當前賬號是否有 Codex 使用權(quán)限；
3. 當前 API Key 是否來自正確的 Organization；
4. 是否切換過多個 OpenAI 賬號；
5. 是否使用了企業(yè)賬號、團隊賬號或多個 workspace。

如果你同時有多個 OpenAI 賬號，建議先完全退出，再用目標賬號重新登錄。

四、Codex 版本過舊

Codex CLI 本身也在更新。舊版本可能存在認證邏輯不兼容、新接口不支持、token 刷新失敗等問題。

解決方法

先查看版本：

codex --version

如果你是 npm 安裝的，可以嘗試更新：

npm install -g @openai/codex@latest

或者：

npm update -g @openai/codex

更新后重新登錄：

codex logout
codex login

五、代理、網(wǎng)絡(luò)或地區(qū)問題

有時候 401 不一定完全是賬號問題，也可能和網(wǎng)絡(luò)環(huán)境有關(guān)。

例如：

• 請求被代理軟件改寫；
• 公司網(wǎng)絡(luò)攔截認證請求；
• VPN 節(jié)點異常；
• 代理出口頻繁變化；
• 地區(qū)訪問策略變化；
• 請求被中轉(zhuǎn)服務(wù)錯誤轉(zhuǎn)發(fā)。

如果 Codex 登錄成功，但一發(fā)起請求就 401，就要重點檢查網(wǎng)絡(luò)和代理。

解決方法

可以嘗試：

1. 切換網(wǎng)絡(luò)，比如手機熱點；
2. 關(guān)閉代理后重試；
3. 更換代理節(jié)點；
4. 檢查終端是否設(shè)置了 HTTP_PROXY、HTTPS_PROXY；
5. 檢查公司電腦是否有安全軟件、MDM、網(wǎng)關(guān)攔截。

查看代理環(huán)境變量：

echo $HTTP_PROXY
echo $HTTPS_PROXY

如果需要臨時取消：

unset HTTP_PROXY
unset HTTPS_PROXY

Windows PowerShell 可以執(zhí)行：

Remove-Item Env:HTTP_PROXY
Remove-Item Env:HTTPS_PROXY

六、使用第三方 API 中轉(zhuǎn)時配置錯誤

很多朋友會通過 API 中轉(zhuǎn)服務(wù)、反代網(wǎng)關(guān)、cc-switch、new-api、sub2api 等方式接入模型。

這種情況下，401 常見原因更多：

1. 中轉(zhuǎn)平臺的 token 填錯；
2. base_url 寫錯；
3. 模型名不支持；
4. 中轉(zhuǎn)服務(wù)沒有轉(zhuǎn)發(fā) Authorization 頭；
5. 上游 Key 已失效；
6. 用戶余額不足或渠道被禁用；
7. Codex 仍然請求了 OpenAI 官方接口；
8. 中轉(zhuǎn)平臺沒有兼容 Codex 的某些接口。

解決方法

檢查配置中的幾個關(guān)鍵項：

OPENAI_API_KEY=你的中轉(zhuǎn)平臺 token
OPENAI_BASE_URL=https://你的中轉(zhuǎn)地址/v1

重點確認：

• OPENAI_API_KEY 是中轉(zhuǎn)平臺給你的 key，不是亂填的；
• OPENAI_BASE_URL 是否以 /v1 結(jié)尾；
• 中轉(zhuǎn)平臺是否支持你調(diào)用的模型；
• Codex 是否真的走了中轉(zhuǎn)地址；
• 中轉(zhuǎn)平臺后臺是否有請求日志；
• 上游渠道是否正常。

如果你是站長或中轉(zhuǎn)平臺管理員，還要看服務(wù)端日志，確認請求有沒有到達你的服務(wù)。

七、本地配置混亂

很多人折騰過 Claude Code、Codex、cc-switch、OpenAI API、中轉(zhuǎn)平臺之后，本地環(huán)境變量和配置文件會非?；靵y。

比如你以為 Codex 讀取的是新 key，實際上它讀的是舊環(huán)境變量。

常見沖突來源：

~/.bashrc
~/.zshrc
~/.profile
~/.codex/config.toml
.env
IDE 環(huán)境變量
系統(tǒng)環(huán)境變量
cc-switch 配置

解決方法

建議按順序排查：

echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL
which codex
codex --version

如果你不確定哪里配置錯了，可以先新開一個干凈終端，只設(shè)置必要變量：

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

export OPENAI_API_KEY="你的 key"
export OPENAI_BASE_URL="你的 base_url"

然后再運行 Codex。

八、refresh token 被復(fù)用或刷新失敗

有些 401 是刷新登錄狀態(tài)時出現(xiàn)的。

比如報錯中可能出現(xiàn)：

Failed to refresh token: 401 Unauthorized

這通常說明本地保存的 refresh token 已經(jīng)不能繼續(xù)使用了。

解決方法

這種情況最直接的方式就是清理登錄狀態(tài)后重新登錄：

codex logout
rm -rf ~/.codex/auth.json
codex login

如果還有問題，可以把整個 Codex 配置目錄備份后重置：

mv ~/.codex ~/.codex_backup
codex login

注意：這樣會清掉本地 Codex 的部分配置，建議先備份。

九、請求了不存在或無權(quán)限的模型

有時候錯誤不是認證本身，而是模型權(quán)限問題表現(xiàn)成 401 或類似鑒權(quán)錯誤。

比如你配置了一個模型名：

model = "gpt-xxx-codex"

但當前賬號沒有這個模型權(quán)限，或者中轉(zhuǎn)平臺沒有映射這個模型，就可能請求失敗。

解決方法

檢查模型名是否正確。

可以先換成平臺明確支持的模型測試。如果使用中轉(zhuǎn)平臺，要以中轉(zhuǎn)平臺后臺的模型列表為準。

十、使用非官方 Codex 工具導(dǎo)致認證異常

這個問題也要注意。

使用 Codex 相關(guān)工具時，不要隨便安裝來路不明的 npm 包、桌面客戶端或所謂“增強版 Codex”。

如果某些工具修改了本地配置、劫持了 API 地址，或者保存了錯誤 token，也可能導(dǎo)致 Codex 一直返回 401。

解決方法

建議：

1. 只安裝官方或可信來源的 Codex；
2. 不要隨便運行陌生腳本；
3. 如果懷疑 token 泄露，立刻退出登錄；
4. 重置 OpenAI API Key；
5. 檢查賬號異常用量；
6. 刪除本地可疑包和配置。

可以查看全局 npm 包：

npm list -g --depth=0

如果發(fā)現(xiàn)可疑 Codex 相關(guān)包，建議謹慎卸載。

推薦排查順序

遇到 Codex 401 Unauthorized，可以按這個順序處理。

第一步：確認是不是賬號登錄問題

codex logout
codex login

第二步：確認 Codex 版本

codex --version
npm install -g @openai/codex@latest

第三步：檢查 API Key

echo $OPENAI_API_KEY

第四步：檢查 base_url

echo $OPENAI_BASE_URL

第五步：清理本地認證緩存

rm -rf ~/.codex/auth.json
codex login

第六步：換網(wǎng)絡(luò)或關(guān)閉代理測試

unset HTTP_PROXY
unset HTTPS_PROXY

第七步：如果你使用中轉(zhuǎn)平臺，去后臺看請求日志

重點看：

• 請求有沒有進來；
• Authorization 是否正確；
• 模型名是否支持；
• 用戶余額是否充足；
• 上游渠道是否正常；
• 返回 401 的是中轉(zhuǎn)平臺，還是上游 OpenAI。

總結(jié)

Codex 出現(xiàn) 401 Unauthorized，本質(zhì)上就是身份認證失敗。

常見原因主要有：

1. 登錄狀態(tài)過期；
2. API Key 錯誤；
3. 賬號權(quán)限不足；
4. Codex 版本過舊；
5. 網(wǎng)絡(luò)或代理異常；
6. 第三方中轉(zhuǎn)配置錯誤；
7. 本地環(huán)境變量沖突；
8. refresh token 失效；
9. 模型無權(quán)限；
10. 使用了非官方或可疑工具。

大部分情況下，重新登錄、更新 Codex、檢查 API Key、清理認證緩存，就能解決問題。

如果你是通過中轉(zhuǎn)平臺接入 Codex，那就重點檢查 OPENAI_API_KEY、OPENAI_BASE_URL、模型名、余額、渠道狀態(tài)和服務(wù)端日志。

遇到 401 不要慌，先判斷一句話：

到底是 Codex 沒拿到正確身份，還是服務(wù)端不認可這個身份。

只要沿著這個方向排查，基本都能定位到問題。

以上就是Codex 401 Unauthorized報錯解決教程：登錄失效、API Key、代理和中轉(zhuǎn)配置排查的詳細內(nèi)容，更多關(guān)于Codex 401 Unauthorized報錯解決教程的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論