Codex连接超时需按规范重登：先确认状态栏“离线”超90秒且输入框灰显，再彻底退出客户端，检查author.json是否存在；存在则直接重启续连，缺失则通过浏览器授权或更新API密钥恢复。

Codex 连接超时后，通常会出现无法继续对话、左下角持续显示“Reconnecting”，或直接弹出登录失效提示。遇到这种情况时，需要重新建立身份认证；但不能简单地点击“退出再登录”，因为缓存中的 author.json 可能已经过期或被清空，直接重新登录往往会卡在授权页，或者返回401错误。

确认超时是否真实发生

打开 Codex 界面 → 观察左下角状态栏：若显示「离线」或「连接中断」且持续超过 90 秒，同时输入框灰显、发送按钮不可点，则判定为连接超时；若仍可发送但响应极慢（>30秒无回复），则属于服务端延迟，非登录失效，无需重登。

【切勿在状态未明确前刷新页面，否则本地未保存的对话历史将永久丢失】

官方账号重登流程（带 Token 缓存恢复）

第一步：关闭 Codex 桌面客户端（不是仅关闭窗口，要右键任务栏图标→退出，或 macOS 菜单栏→Quit Codex）

第二步：打开终端，执行以下命令定位配置目录：

macOS/Linux：ls ~/.codex/author.json → 若文件存在且大小 >100 字节，说明 Token 仍在；若报错“No such file”，则需重建。

Windows：dir %USERPROFILE%.codexauthor.json

第三步：若 author.json 存在，直接双击启动 Codex → 它会自动读取该文件并尝试续连；若失败或文件缺失，进入浏览器手动触发新授权：

访问 https://www.php.cn/link/8de88f52d2003c4b6da384cc0cf1c86e → 使用原账号密码登录 → 登录成功后，回到 Codex 启动器，点击“使用其他方式登录”→选择“ChatGPT 账号”→按提示完成 OAuth 授权闭环。

API 模式账号重登（88api 等中转服务）

方法一：通过 CC Switch 工具刷新配置

打开 CC Switch → 选中当前失效的 Codex 配置项 → 点击编辑图标 → 重新粘贴最新 API Key（务必从 88api 后台「API 令牌」页复制，旧 Key 可能已被平台主动注销）→ 修改 API 请求地址为 https://api.88api.shop/v1（注意保留 /v1）→ 点击启用 → 关闭并重启 Codex。

方法二：手动更新 config.toml

请使用文本编辑器打开 ~/.codex/config.toml（Windows 为 C:Users用户名.codexconfig.toml），然后定位到 [model_providers.openai_http] 区块，将 api_key = "sk-..." 这一行更新为新的密钥；保存文件后，重启 Codex，让修改生效。

⚠️ 注意：如果修改后仍报 401 错误，请检查 88api 后台该 Key 的状态是否为「启用中」，部分服务商会在 Key 连续 7 天未调用后自动停用。

多账号环境下的快速切换重登

使用 cockpit-tools 工具管理时，重登操作完全隔离：

启动 cockpit-tools → 在左侧 Codex 列表中，找到对应账号条目 → 点击右侧「刷新凭证」按钮 → 工具会自动打开浏览器跳转至 ChatGPT 授权页 → 完成授权后，Codex 实例将立即以新 Token 启动，旧会话不受影响。

这一步操作起来很简单，直接点按钮就行。但注意：若账号已开启双重验证（2FA），必须在浏览器授权页完成信息或验证器校验，否则工具无法获取新 Token。