应使用 codex-profiles 工具管理多账号:安装后通过 codex-profiles save 保存 profile,用 codex-profiles use 切换或 codex --profile 临时指定,避免手动修改 auth.json 导致 401 错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在团队开发中快速切换 Codex 账号,避免因个人账号额度耗尽导致代码审查中断、Git 提交失败或 AGENTS.md 协作流程卡顿。手动覆盖 ~/.codex/auth.json 不仅会破坏当前会话,还可能让其他正在运行的 Codex CLI 进程读取到损坏的 Token,导致后续所有请求返回 401 错误。
安装并初始化 codex-profiles 工具
执行 npm install -g codex-profiles 安装命令行管理工具。该工具不上传任何配置,所有档案均安全存放在本地 ~/.codex/profiles/ 目录下。
安装后无需重启终端,即可直接使用 codex-profiles 命令。
为当前登录账号保存命名档案
确保你已用目标账号完成登录:codex login。终端显示 “Login successful” 后,再执行下一步。
执行 codex-profiles save personal,工具自动捕获 ~/.codex/auth.json 和 ~/.codex/config.toml 的当前快照,并存入 profiles/personal/ 子目录。
这一步必须在登录成功后立即操作,否则保存的可能是过期或空的认证信息。
切换至另一套配置(如公司账号)
方法一:使用软链接切换
先用公司账号重新登录 codex login;务必等待至少3秒,防止 OAuth 缓存复用前一个会话;再执行 codex-profiles save work。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
确认 work 档案保存成功后,运行 codex-profiles use work。该命令会原子性地将 work/ 下的 auth.json 和 config.toml 软链接至 ~/.codex/ 根目录,并触发 Codex CLI 自动重载配置。
此时执行 codex status,可立即看到团队名称、配额剩余量和模型提供商已更新为公司环境。
方法二:临时指定 profile 运行(不修改全局配置)
直接执行 codex --profile work your-command。此方式跳过软链接步骤,只对本次命令生效,适合调试或单次任务。
注意:--profile 参数只接受 profile 名称(如 work),不支持路径或文件扩展名;且该 profile 必须已通过 codex-profiles save 创建。
验证与排查配置是否生效
第一步:运行 codex status,检查输出中的 “Team”、“Quota”、“Model Provider” 字段是否匹配目标 profile 预期值。
第二步:执行 codex "写一个 Python 函数,计算斐波那契数列第 n 项",观察响应头是否含公司域名或对应 provider 标识。
第三步:若报错 model provider 'xxx' not found,说明 config.toml 中引用了未定义的 provider ID——TOML 语法正确但逻辑引用缺失,需检查 ~/.codex/work.config.toml 内 [model_providers.xxx] 是否存在且拼写一致。










