文章

Codex CLI 多账号配置隔离实践

见字如面,与大家分享实践中的经验与思考。

如果你在不同项目里使用不同的 Codex 账号,最烦的事情不是启动 CLI,而是登录态来回切换。

这篇文章分享一个 macOS / zsh 下的小技巧:用不同的 CODEX_HOME 隔离配置和登录状态,再用 alias 做成几个常用命令。

以下示例基于本机 codex-cli 0.133.0

images-20260522-17.26.17@2x

背景

Codex CLI 默认会使用本地的一套配置和登录状态。大多数时候这没问题,因为一个开发环境通常只用一个账号。

但如果你有多个账号,它们默认会挤在同一个本地环境里。你当然可以用 login / logout 来回切,但很打断节奏,也容易忘记自己当前用的是哪个账号。

有时候你还会希望不同账号有不同配置。比如个人项目一套,工作项目一套,测试新功能时再单独隔离一套。

这不是说一个账号不好。一个账号当然最省事。多账号一般是因为个人和工作要分开、权限或额度不同,或者想把测试环境和主力账号隔离开。

所以核心不是“多开几个终端”,而是“让不同命令使用不同的 Codex 配置目录”。

实现过程

思路很简单:复制多份 ~/.codex,然后启动 Codex 时用 CODEX_HOME 指向不同目录。

# 准备两套新的 Codex 配置目录
cp -R ~/.codex ~/.codex-work1
cp -R ~/.codex ~/.codex-work2
​
# 打开 zsh 配置文件
sublime ~/.zshrc

然后在 ~/.zshrc 里加入:

alias codex-work1='CODEX_HOME=$HOME/.codex-work1 codex'
alias codex-work2='CODEX_HOME=$HOME/.codex-work2 codex'

images-20260522-17.53.21@2x

保存后,让配置生效:

source ~/.zshrc

之后你就可以这样使用。也可以按用途给它们起更清晰的名字,比如 codex-personalcodex-workcodex-test

codex       -> 个人主账号
codex-work1 -> 工作账号 A
codex-work2 -> 工作账号 B

它们看起来都是 Codex CLI,但背后使用的是不同的 CODEX_HOME

问题澄清

01 多账号并行使用,会不会带来账号风险?

这种方式不是为了绕过账号规则,只是减少反复登录登出的麻烦。不同目录只是隔离本地配置和登录状态,账号本身仍然要正常登录、正常使用。

相比来回切号,这种方式的好处是每个账号都有固定入口。你一看命令名,就知道自己在哪个环境里。

02 完成任务的效果,会不会变差?

我会把它拆成两件事看。

账号本身不会改变模型能力。真正影响效果的是:上下文有没有给够,项目规则是不是一致。

我现在的做法是把项目通用规则放到仓库里的 AGENTS.md。Codex 官方文档也说明,Codex 会读取 Codex home 和项目目录里的 AGENTS.md,并按层级合并。这样多个账号在同一个仓库里工作时,至少能共享同一份项目级上下文。

但不要把“模型 cache”当成跨账号共享上下文。OpenAI 的 Prompt Caching 主要是优化延迟和成本,不会改变最终输出;官方也说明 prompt cache 不会在不同 organization 之间共享。

所以,真正可靠的还是显式上下文:AGENTS.md、README、任务说明,以及你在对话里明确给出的信息。

03 减少使用全局配置

注意,复制目录会把当前 ~/.codex 里的内容一起复制过去。如果复制时已经登录了某个账号,新目录里可能也带着当时的状态。

所以实际使用时,建议分别进入对应 alias 后检查登录状态,需要的话重新登录。

如果某些规则是项目共享的,优先放在仓库里的 AGENTS.md。至于 MCP、Skills、个人偏好这类配置,可以按账号或用途决定是否隔离。

最后

这个技巧适合经常切换 Codex CLI 账号的人。它简单、直接,不需要额外工具,也不需要改 Codex CLI 本身。

但有几个注意点:

  • 不要把这些目录提交到 Git。

  • 不要把这些目录打包分享给别人。

  • 多套目录会带来配置漂移,比如插件、MCP、偏好设置可能不一致。

  • 减少对全局配置的依赖,把项目共享规则尽量维护在仓库里,比如 AGENTS.md

如果你只是偶尔切一次账号,手动登录登出也可以。但如果你每天都要在多个账号之间来回切,这种基于 CODEX_HOME 的方式会省心很多。


欢迎关注公众号"Eric技术圈",原创技术文章第一时间推送。

许可协议:  CC BY 4.0