VS Code Codex 登录失败（1455 端口占用）处理说明

问题现象

在 VS Code 中进行 Codex 登录时失败，提示错误信息类似：

{"code":-32603,"message":"failed to start login server: Port 127.0.0.1:1455 is already in use"}

该错误表明：
Codex 扩展在本机启动 OAuth 回调用的本地登录服务时，默认监听的 127.0.0.1:1455 端口已被其他进程占用，导致登录服务无法启动。

---

原因说明

• Codex 登录流程依赖一个本地 HTTP 回调服务
• 默认端口为 1455
• 当该端口已被占用（常见于 VS Code 或相关子进程异常残留）时，登录流程会直接失败
• 错误与网络、防火墙或账号无关，属于本地端口冲突问题

---

适用环境

• 本机 Windows
• 本机直接运行 VS Code
• 非 Remote-SSH / WSL / Dev Container 场景

---

排查与解决步骤

1. 确认端口占用情况

在 PowerShell 或 CMD 中执行：

netstat -ano | findstr :1455

若看到类似以下输出：

TCP 127.0.0.1:1455  0.0.0.0:0      LISTENING   <PID>

说明 1455 端口正在被某个进程监听，其中 <PID> 为进程 ID。

---

2. 定位占用端口的进程

执行：

tasklist /fi "PID eq <PID>"

常见结果包括：

• Code.exe
• node.exe
• Codex 相关辅助进程

通常属于 VS Code 或其扩展的残留进程。

---

3. 释放端口（推荐做法）

强制结束占用端口的进程：

taskkill /PID <PID> /F

该操作仅影响对应进程，不涉及系统服务。

---

4. 彻底重启 VS Code（关键步骤）

为防止端口被再次占用，需要完全退出 VS Code：

• 关闭所有 VS Code 窗口
• 打开任务管理器
• 确认不存在 Code.exe / node.exe 等相关进程
• 重新启动 VS Code
• 再次执行 Codex 登录

仅“重载窗口”或关闭单个窗口通常不足以释放端口。

---

常见误区

以下情况通常无法解决该问题：

• 修改 Codex 登录端口（多数版本不支持）
• 调整防火墙或安全软件
• 处理 TIME_WAIT 状态的连接

本问题的核心始终是：端口已被监听，且监听进程未正确退出。

---

兜底方案

如果端口反复被占用，可考虑：

• 重启操作系统（一次性清理残留进程）
• 登录前固定检查并释放 1455 端口

---

总结

• 该错误属于本地端口冲突
• 占用者通常是异常残留的 VS Code / 扩展进程
• 正确做法是：定位进程 → 结束进程 → 完全重启 VS Code
• 处理完成后即可恢复正常登录流程

该问题在 Windows 环境下较为常见，属于已知行为，并非配置或使用错误。