Codex 多身份管理

一台开发机器上可以有个人、学习、工作区或测试用的不同 Codex 身份。身份一多，如果继续靠临时换号和人的记忆，会话、项目和登录环境很容易缠在一起。

我做这个工具，是为了把它们分开。

有很多同学都购买了GPT plus，但并不是每个人都使用codex，又或者，其实同学们也并不是在同一时间使用codex，或者，当我有多个账号的时候，可以更加平滑地管理额度

因此，这个项目主要解决这些问题

能做什么

• 给已有的 Codex 环境登记一个别名；
• 为另一个身份创建独立的 CODEX_HOME；
• 按别名或项目启动 Codex；
• 用原生 thread UUID 精确恢复会话，不按目录或时间猜测；
• 让多个已授权身份使用同一个会话池，同时保持登录环境隔离；
• 在 VS Code 重新打开项目时恢复受管终端；
• 只输出脱敏状态，不读取凭据和对话正文。

最小使用

# 登记当前默认环境
capabilities/agent-identity/adapters/agent-identity \
  register-current --alias personal

# 创建另一个隔离身份，再进入 Codex 官方登录流程
capabilities/agent-identity/adapters/agent-identity \
  add --alias study --mode manual
capabilities/agent-identity/adapters/agent-identity \
  login --alias study

# 启动
capabilities/agent-identity/adapters/agent-identity \
  launch --alias study --

# 查看脱敏状态
capabilities/agent-identity/adapters/agent-identity status

运行环境主要面向 macOS，需要 Ruby、Codex CLI、sqlite3 和 lsof。OpenClaw 只用于可选的定时续接与远程集成，不是身份隔离和手动启动的前提。

安全边界

Codex 的登录状态由 Codex 自己保存。官方文档说明，缓存凭据可能位于 CODEX_HOME 下的 auth.json 或系统钥匙串中，并且应像密码一样保护。这个项目不会读取、复制、导出或提交这些内容： Codex authentication。

请只登记自己拥有或明确获准使用的身份。这个项目不共享密码，也不用于绕过产品限制。

仓库结构

capabilities/agent-identity/
├── skills/       # Agent 使用说明
├── adapters/     # 命令入口
├── lib/          # 身份、会话与生命周期实现
├── vscode/       # 项目终端恢复扩展
├── openclaw/     # 可选的 OpenClaw 路由集成
└── tests/        # 隔离、恢复与安全边界测试

capabilities/agent-identity/tests/test_agent_identity.sh

当前版本是 0.11.0。这是两头乌中的实际能力包经过脱敏后的公开发行副本，不包含账号、邮箱、凭据、会话内容和私人状态。

MIT License