multi-codex - 同时运行多个 Codex CLI 账户的多账户启动器

本文介绍 multi-codex，一个简洁实用的多账户启动器，让你可以同时运行多个 Codex CLI 账户，无需反复登录切换。

项目简介

multi-codex 是一个开源的命令行工具，由开发者 Spielewoy 创建维护。截至目前，该项目在 GitHub 上已获得 51 stars，主要使用 Shell 编写，采用 MIT 许可证。

当使用 Codex CLI 时，每次切换账号都需要退出重新登录，效率很低。multi-codex 解决了这个问题：它利用 CODEX_HOME 环境变量，为每个账户分配独立的配置目录，一个目录就是一个账号。

核心特性

1. 多账户并行运行

可同时启动多个 Codex CLI 实例，每个实例使用独立的账号、配置、会话、技能和代理，互不干扰。

2. 多种账户类型

• 完全独立（默认）- 认证、配置、会话、技能完全隔离
• 共享模式（--shared）- 配置、技能、代理共享，仅认证独立
• 纯终端模式（--cli）- 跳过桌面应用，始终在终端运行

3. 完整的账户管理

支持创建、重命名、删除、克隆、备份和还原账户，将账户保存为模板复用。

安装指南

前置要求

• Node.js 22+
• Codex CLI：npm install -g @openai/codex

安装 multi-codex

macOS / Linux：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/ProGambler67/multi-codex/main/install.sh)"

Windows（管理员 PowerShell）：

irm https://raw.githubusercontent.com/ProGambler67/multi-codex/main/install.ps1 | iex

快速开始

# 创建 work 账户
multi-codex new work

# 创建 personal 账户
multi-codex new personal

# 启动 work（首次需登录）
work

# 启动 personal，两边可同时运行
personal

将账户名变成终端命令，加到 shell 配置中：

export PATH="$HOME/CodexProfiles/bin:$PATH"

常用命令

技术栈

• Shell / PowerShell - 跨平台 CLI 实现
• Node.js - 运行环境

项目链接

• GitHub 仓库：Spielewoy/multi-codex
• 许可证：MIT