報錯排查 MCP/IDE 插件配置━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━排查決策表按癥狀快速定位癥狀第一反應401 Unauthorizedlogout → login → 刪 auth.json502/超時/Re-connecting設置 HTTPS_PROXYcommand not found查 npm prefix 加 PATHNode 版本錯nvm install 22model is at capacity/model 換模型或稍后重試MCP 不生效重啟 codex 檢查 TOML 語法一切玄學問題升級 latest 重置 ~/.codex1. 認證類401/登錄失效codex logout codex login # 第一步rm -rf ~/.codex/auth.json # 第二步:清緩存后再 loginnpm install -g openai/codexlatest # 第三步:舊版 token 刷新有 bug仍不行檢查是否付費套餐、是否登對賬號、Key 有無多余空格。終極手段mv ~/.codex ~/.codex_backup 重置配置目錄。2. 網絡類502/超時export HTTPS_PROXYhttp://127.0.0.1:7890 # 端口換成用戶自己的代理干擾認證時反向禁用http_proxy https_proxy codex ...。內網 DNS 劫持hosts 固定 login.openai.com 的 IP。3. 安裝類command not foundnpm config get prefix 查路徑把其下可執行目錄加 PATH重啟終端裝錯包npm uninstall -g codex npm install -g openai/codex正確包名帶 openai/ 前綴Windows 權限管理員運行 PowerShell或用官方 install.ps1Linux bwrap 缺失sudo apt-get install bubblewrap4. 運行類非 git 目錄用 full-auto 被拒保護機制git init 后再用上下文占滿/compact 壓縮或 codex resume 開新會話插件/擴展安裝IDE 擴展擴展市場搜 Codex 或 OpenAI Codex支持 VS Code/Cursor/Windsurf/JetBrains。IDE 擴展與 CLI 共享 ~/.codex/config.toml 和登錄憑證配一次兩邊通用。MCP 服務器命令行方式推薦codex mcp add context7 -- npx -y upstash/context7-mcpcodex mcp list手動編輯 ~/.codex/config.toml[mcp_servers.my-postgres] # 下劃線,不是連字符command npxargs [-y, modelcontextprotocol/server-postgres, postgresql://localhost/mydb][mcp_servers.remote]url https://example.com/mcphttp_headers { Authorization Bearer token }MCP 常見坑改完 config.toml 必須重啟 codexTOML 語法env 寫 env { KEY value }不能 JSON 冒號會話內 /mcp 確認連接狀態項目級配置放 .codex/config.toml萬能三步更新到最新版 → 重新登錄 → 備份并清理 ~/.codex 重來。90% 問題是舊版本舊憑證。