报错排查 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% 问题是旧版本旧凭证。