字
字节笔记本
2026年5月15日
multi-codex：Codex CLI 多账号并发运行工具使用指南
API中转
¥120
Codex CLI 的多账户管理一直是个痛点：想要同时跑个人账号和工作账号，就得反复退出登录。multi-codex 用一条环境变量搞定这个问题。
核心原理
Codex CLI 通过 CODEX_HOME 环境变量来决定配置目录的位置。multi-codex 的原理就是把每个账户指向不同的文件夹——一个文件夹就是一个独立账户，互不干扰。
安装
前置要求：Node.js 22+ 和 Codex CLI。
bash
# 安装 Codex CLI
npm install -g @openai/codex
# 安装 multi-codex（macOS / Linux）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Spielewoy/multi-codex/main/install.sh)"Windows 用户用 PowerShell（管理员模式）执行：
powershell
irm https://raw.githubusercontent.com/Spielewoy/multi-codex/main/install.ps1 | iex快速上手
创建两个账户试试：
bash
multi-codex new work # 创建 work 账户
multi-codex new personal # 创建 personal 账户
work # 启动 work，首次需登录
personal # 启动 personal，两边可同时跑把账户名变成终端命令：
bash
export PATH="$HOME/CodexProfiles/bin:$PATH"加到 ~/.zshrc 或 ~/.bashrc 后重启终端，之后直接输入账户名就能启动。
账户类型
| 参数 | 说明 |
|---|---|
| (默认) | 完全独立 — 自己的认证、配置、会话、技能 |
--shared | 共享配置/技能，仅认证独立 |
--cli | 纯终端模式，跳过桌面应用 |
bash
multi-codex new work # 完全独立
multi-codex new work --shared # 共享配置
multi-codex new work --cli # 纯终端模式进阶技巧
从模板创建： 先配置好一个账户，保存为模板，后续直接复用：
bash
multi-codex template save work my-template
multi-codex new project --from my-template备份与恢复：
bash
multi-codex export work backup.tar.gz
multi-codex import backup.tar.gz查看运行状态：
bash
multi-codex status # 查看各账户运行状态、大小
multi-codex stats # 磁盘用量分析项目链接
- GitHub：https://github.com/Spielewoy/multi-codex
- 安装：
curl -fsSL https://raw.githubusercontent.com/.../main/install.sh | bash
分享: