# Codex 安装与登录排错清单

核验日期：2026-07-21

## 先记录环境

```text
操作系统与版本：
芯片架构：
Codex 使用界面：CLI / App / IDE / Cloud
安装方式：
Codex 版本：
Node.js 版本（如涉及）：
网络环境：直连 / 公司代理 / 个人代理
问题首次出现时间：
```

## 排查顺序

- [ ] 从官方 Quickstart 确认当前界面的安装与登录步骤。
- [ ] 记录 `codex --version`，不要只写“最新版”。
- [ ] 确认终端实际调用的二进制路径：`command -v codex`。
- [ ] 关闭旧终端并重新打开，排除 PATH 尚未刷新。
- [ ] 只保留一种安装来源，避免全局包、包管理器和旧二进制混用。
- [ ] 区分“登录失败”和“模型或额度不可用”，不要混为一个问题。
- [ ] 若返回 401，重新登录前先核对系统时间、账号和认证方式。
- [ ] 若公司网络或代理下失败，使用允许的网络做一次对照测试。
- [ ] 若 CLI 卡住，先在空目录执行最小只读任务，排除仓库配置影响。
- [ ] 若仅特定仓库失败，检查仓库中的 `AGENTS.md`、配置和 MCP。
- [ ] 更新前保存当前版本号；更新后仍失败时保留回滚入口。
- [ ] 提交 Issue 前搜索同版本、同平台、同错误码的已有问题。

## 最小复现记录

```md
### 复现命令

### 预期结果

### 实际结果

### 是否只在特定仓库发生

### 最近一次正常版本

### 已尝试操作与结果
```

## 脱敏要求

- 不粘贴 API key、Cookie、访问码或完整认证头。
- 删除私有仓库地址、用户名、个人目录与客户数据。
- 日志只保留复现所需窗口，不上传整个终端历史。

## 排查结果表

| 检查项 | 原始状态 | 执行操作 | 结果 | 结论 |
| --- | --- | --- | --- | --- |
| 版本 |  |  |  |  |
| 二进制路径 |  |  |  |  |
| 登录 |  |  |  |  |
| 网络 |  |  |  |  |
| 空目录最小任务 |  |  |  |  |
| 特定仓库 |  |  |  |  |

## 何时停止自查

如果最小任务也能稳定复现、已经记录精确版本和复现步骤，并且问题涉及认证异常、数据泄露风险或重复崩溃，不要继续随机重装。保留现场，先查看官方故障排查文档和已有 Issue，再提交脱敏报告。不要为了“试一试”关闭组织安全策略或把生产密钥复制到个人环境。

官方来源：

- https://learn.chatgpt.com/docs/codex/quickstart
- https://learn.chatgpt.com/docs/codex/troubleshooting
- https://github.com/openai/codex/issues