一、为什么要切换 Codex 账号？

Codex 的使用额度与当前登录账号和套餐有关。当一个账号进入 5 小时窗口限制、周额度不足，或者暂时无法继续执行任务时，最直接的处理方式是换到你自己拥有的另一个可用账号。

Codex Switcher 是一个第三方桌面工具，定位是管理多个个人 OpenAI Codex 账号。它提供账号命名、快速切换、额度查看、OAuth 登录以及导入现有 auth.json 等功能。它不会替你购买额度，也不是 OpenAI 官方客户端。它的切换逻辑主要是更新 Codex 使用的认证文件，而不是清理 Codex 的会话记录。

二、切换前先做这 4 件事

最稳妥的方式，是在项目根目录建立一个上下文文件，例如 docs/codex-context.md。把当前任务、已经完成的修改、尚未解决的问题、重要路径和下一步操作写进去。这样即使换了账号，也能在新会话里快速恢复状态。

# 当前 Codex 任务

## 目标
- 完成什么功能

## 已完成
- 修改了哪些文件
- 已验证哪些结果

## 待处理
- 下一步要做什么
- 当前遇到的限制

## 约定
- 运行命令
- 不要修改的文件

如果你不想手动整理，可以在切换前让 Codex 先生成一份“交接摘要”，然后把摘要保存到项目里。这个文件属于项目资料，不依赖某一个账号的聊天窗口。

三、安装并添加账号

四、额度用完后如何切换？

# 继续最近一个会话
codex resume --last

# 打开会话选择器（可搜索全部会话）
codex resume --all

五、切换账号后聊天记录会不会丢？

你的使用经验是对的。OpenAI 官方 Codex CLI 文档说明：保存的交互会话 transcript 会保存在本地，使用 /resume 或 codex resume 可以重新加载会话，并“保留原有历史”。Codex Switcher 切换时主要更新 ~/.codex/auth.json，因此切换账号本身不会删除 Codex 会话。

• 对话记录：切换的是登录账号和额度配置，不是删除 Codex 本地会话；之前的对话仍可在 Codex 中继续查看或用 codex resume 恢复。
• 项目工作进度：代码、图片、配置和项目里的 Markdown 文件不会因为换账号消失。把关键上下文写进项目文件，可以让后续任务更容易衔接。

需要注意的是，不同 Codex 版本、安装方式或本地配置可能会影响会话列表的显示。切换后如果暂时看不到对话，先刷新或重启 Codex，再运行 codex resume --all 检查会话。不要删除旧账号、清空 Codex 数据目录或覆盖原来的凭证文件。

六、切换后如何继续原来的对话？

1. 先停止当前 Codex 任务，保存项目文件。
2. 打开 Codex Switcher，选择需要使用的账号并完成切换。
3. 回到 Codex 的会话列表，打开之前的对话；也可以运行 codex resume --last。
4. 如果列表没有立即刷新，先刷新或重启 Codex，再运行 codex resume --all 检查全部会话。

如果你经常在两个账号之间切换，仍然建议在项目里维护一个简短的交接记录，例如按日期追加“本次完成 / 下次继续 / 已知问题”。这样即使会话列表暂时没有刷新，也能快速恢复工作状态。

七、常见问题