用途:当用户希望在一台机器上把 Codex CLI 或 Codex Desktop 的工作、个人、学校、客户或项目上下文分开时使用。它封装 Codex 的 CODEX_HOME 支持,让每个配置拥有独立的认证、配置、会话、连接器、插件、缓存、日志和本地状态,也用于诊断当前激活的配置或确认配置是否已登录。
主要能力:创建独立 Codex home、查看路径与状态、登录、以指定配置运行 CLI、通过 env 或 shell-init 进入一次性 shell 会话,以及在确认用户可接受应用/进程中断后启动 Desktop 配置。
使用方式:先确认是仅 CLI 切换还是 Desktop 启动;Desktop 操作可能退出、启动、克隆或重建应用实例,须获明确批准。已安装时可查看 codex-profile --help、codex-profile doctor、codex-profile list、codex-profile status。未安装时优先使用可审查的包管理器安装:npm install -g codex-profile 或 brew install Ducksss/tap/codex-profile,不要自动运行远程安装脚本。创建并指定配置可用 codex-profile init work、codex-profile path work、codex-profile login work。CLI 任务可用 codex-profile cli work 或 codex-profile cli work exec "run tests and summarize failures"。若包装器不可用,可说明底层边界:CODEX_HOME="$HOME/.codex-work" codex,或 CODEX_HOME="$HOME/.codex-work" codex exec "review this change"。Desktop 启动示例为 codex-profile app work ~/Dev/project 与 codex-profile app work --instance ~/Dev/project。
限制与安全:该项目为社区维护,非 OpenAI 官方工具;仅通过独立 CODEX_HOME 隔离 Codex 状态,不隔离系统用户、shell 历史、SSH 密钥、浏览器 Cookie、GitHub CLI 认证等;Desktop 启动行为以 macOS 为主且随版本变化;已有会话可能仍含旧项目上下文;不替代重要 Codex 状态的备份。不要复制、打印、解析或迁移 auth.json 令牌;删除配置前需确认路径与备份需求。命令标志可能变化,应以已安装版本的 --help 为准。