Codex中端口配置錯誤排查與解決的實戰(zhàn)指南

發(fā)布時間：2026-06-24 11:58:33 作者：用戶710620773340

Codex是很多開發(fā)者的主力 AI 工具,本文詳細記錄了Codex因端口配置錯誤導致的“streamdisdisconnect”報錯排查過程,通過netstat檢查實際口、curl測試代理連通性及對比配置文件,最終確認并修復了端口錯誤,確保Codex正常運行

導語

Codex（原 ChatGPT 桌面版）是很多開發(fā)者的主力 AI 工具。但當你用自定義模型提供商（如 DeepSeek）時，偶爾會踩到一些坑。本文記錄了一次「切換手機熱點后 Codex 無法使用」的問題排查全過程——從報錯信息出發(fā)，逐層定位，最終一行配置改動修復。

環(huán)境信息

Windows 11
Codex 26.616.6631.0
自定義模型提供商：DeepSeek（deepseek-v4-flash）
網絡：筆記本連接手機熱點

現象

打開 Codex 發(fā)起對話后，立刻報錯：

stream disconnected before completion:
error sending request for url (http://127.0.0.1:15721/v1/responses)

關鍵信息：

目標地址是 127.0.0.1:15721
報錯是 "stream disconnected"（流中斷），不是 "connection refused"（拒絕連接）

這說明不是連不上，而是連上之后斷了。

排查過程

第一步：理解 Codex 的架構

先搞清楚 Codex 自定義模型是怎么工作的：

Codex 前端 (Electron)
  → config.toml 中的 base_url
  → 本地代理 (codex-plus-plus.exe，Rust 編寫)
  → 外部模型 API (DeepSeek)

配置文件在 ~/.codex/config.toml，問題就出在這里：

[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = true
base_url = "http://127.0.0.1:15721/v1"

配置里寫的是 15721 端口。接下來看這個端口對不對。

第二步：檢查端口是否存活

# 直接測試 15721
curl http://127.0.0.1:15721/v1/responses
# → curl: (7) Failed to connect to 127.0.0.1 port 15721

# 查看 Codex 相關進程實際監(jiān)聽的端口
netstat -ano | grep LISTENING | grep 127.0.0.1

輸出：

端口	進程
57319	codex-plus-plus-manager.exe
57320	codex-plus-plus.exe
57321	codex-plus-plus.exe

15721 根本不在列表里。配置寫的端口和實際監(jiān)聽的端口不一致。

第三步：驗證正確端口

既然 codex-plus-plus 實際監(jiān)聽的是 57320 和 57321，那就直接試：

curl -X POST http://127.0.0.1:57321/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer test" \
  -d '{"model":"test","input":"hello"}'

返回：

{
  "error": {
    "message": "...supported API model names are deepseek-v4-pro or deepseek-v4-flash...",
    "type": "upstream_error",
    "code": "400"
  }
}

這就是答案。返回的是上游 API 的報錯（模型名不對），而不是連接錯誤。說明 57321 上的代理服務一切正常，請求已經穿透到了 DeepSeek。

小技巧：57320/57321 這兩個端口接受 TCP 連接但不響應裸 HTTP GET 請求，需要 POST 正確的 JSON 才會返回。所以一開始用 curl http://... 看到超時也別慌，試試 POST。

第四步：確認錯誤來源

翻了下 Codex 的自動備份：

ls ~/.codex/backups/
# → codex-plus-live-1781875699298/
# → codex-plus-live-1781876648784/

# 第二份備份的配置
cat ~/.codex/backups/codex-plus-live-1781876648784/config.toml

發(fā)現早期備份里端口是正確的 57321，后來被改成了 15721。問題鎖定了。

根因

維度	分析
直接原因	`config.toml` 中 `base_url` 端口寫錯（15721 → 應為 57321）
為何發(fā)生	手動修改模型配置時誤填了端口號
為何切換熱點后才暴露	熱點觸發(fā)網絡變化 → Codex 后端可能重啟 → 重新寫入配置時帶入了錯誤值
為何沒第一時間發(fā)現	Codex 內部通過 stdio 通信（App ↔ 后端），端口錯誤只影響模型 API 調用路徑

修復

編輯 ~/.codex/config.toml：

# 修改前
base_url = "http://127.0.0.1:15721/v1"

# 修改后
base_url = "http://127.0.0.1:57321/v1"

修改后無需重啟 Codex，對話立刻恢復正常。

速查命令

用途	命令
查看配置	`cat ~/.codex/config.toml`
檢查實際端口	`netstat -ano \| findstr LISTENING \| findstr 127.0.0.1`
測試代理連通性	`curl -X POST http://127.0.0.1:xxxx/v1/responses -H "Content-Type: application/json" -d '{"model":"test","input":"hi"}'`
查看歷史備份	`ls ~/.codex/backups/`
強制重啟 Codex	`taskkill /f /im Codex.exe & taskkill /f /im codex-plus-plus.exe`