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

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

Codex是很多開發(fā)者的主力 AI 工具,本文詳細(xì)記錄了Codex因端口配置錯(cuò)誤導(dǎo)致的“streamdisdisconnect”報(bào)錯(cuò)排查過程,通過netstat檢查實(shí)際口、curl測(cè)試代理連通性及對(duì)比配置文件,最終確認(rèn)并修復(fù)了端口錯(cuò)誤,確保Codex正常運(yùn)行

導(dǎo)語

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

環(huán)境信息

Windows 11
Codex 26.616.6631.0
自定義模型提供商：DeepSeek（deepseek-v4-flash）
網(wǎng)絡(luò)：筆記本連接手機(jī)熱點(diǎn)

現(xiàn)象

打開 Codex 發(fā)起對(duì)話后，立刻報(bào)錯(cuò)：

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

關(guān)鍵信息：

目標(biāo)地址是 127.0.0.1:15721
報(bào)錯(cuò)是 "stream disconnected"（流中斷），不是 "connection refused"（拒絕連接）

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

排查過程

第一步：理解 Codex 的架構(gòu)

先搞清楚 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 端口。接下來看這個(gè)端口對(duì)不對(duì)。

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

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

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

輸出：

端口	進(jìn)程
57319	codex-plus-plus-manager.exe
57320	codex-plus-plus.exe
57321	codex-plus-plus.exe

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

第三步：驗(yàn)證正確端口

既然 codex-plus-plus 實(shí)際監(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 的報(bào)錯(cuò)（模型名不對(duì)），而不是連接錯(cuò)誤。說明 57321 上的代理服務(wù)一切正常，請(qǐng)求已經(jīng)穿透到了 DeepSeek。

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

第四步：確認(rèn)錯(cuò)誤來源

翻了下 Codex 的自動(dòng)備份：

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

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

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

根因

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

修復(fù)

編輯 ~/.codex/config.toml：

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

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

修改后無需重啟 Codex，對(duì)話立刻恢復(fù)正常。

速查命令

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