免費開源工具

在一台電腦上
管理多個 Codex 帳號

儲存多個 OpenAI Codex 登入狀態，一個指令即時切換，不需要重新登入。
支援 Windows、Linux、macOS。

PowerShell
PS> irm https://raw.githubusercontent.com/yazelin/codex-auth-switcher/main/install-oneliner.ps1 | iex
bash / zsh
$ bash <(curl -fsSL https://raw.githubusercontent.com/yazelin/codex-auth-switcher/main/install-oneliner.sh)

需要先安裝 Git。沒有 Git？點這裡看安裝方法

為什麼需要它
解決 Codex 多帳號的痛點
儲存

多個帳號登入狀態

把每個 Codex 帳號的 auth token 分別存成獨立 profile，不會互相干擾。

切換

一個指令即時切換

cx switch 開啟互動選單，選好按 Enter，自動結束現有 Codex、切換帳號。

追蹤

自動追蹤用量上限

每次 Codex 結束後自動掃描限額狀態，哪個帳號到限、何時重置，一目了然。

共用

設定與歷史完全共用

config、hooks、session 歷史通通共用，只有 auth token 會切換，其他不受影響。

運作原理
切換時，到底換了什麼？
項目位置切換 / 共用
帳號 auth token~/.codex/auth.json每個 profile 切換
設定、hooks~/.codex/config.toml、hooks.json共用
sessions、/resume 歷史、sqlite 狀態~/.codex/共用
skills、plugins~/.codex/共用
只有 auth.json（帳號 token）會切換，其餘全部共用。你透過 codex（wrapper）啟動時用的是一般的 ~/.codex，所以對話、/resume、設定在各帳號間都共用。
新增帳號是安全的：cx login 會在一個獨立的暫時環境登入，完全不碰其他已存帳號——所以多個帳號（含同一個 ChatGPT 帳號下的多個 workspace）能並存、不會互相把對方登出。
操作步驟
從安裝到第一次切換
1

開啟 PowerShell，貼上安裝指令

按 Win + X，選「Windows PowerShell」或「終端機」，將以下指令完整複製並貼上（Ctrl+V），按 Enter。

PowerShell
PS> irm https://raw.githubusercontent.com/yazelin/codex-auth-switcher/main/install-oneliner.ps1 | iex

安裝完成後，終端機會自動印出後續步驟說明。

2

儲存你目前的 Codex 帳號

如果你的電腦已經登入過 Codex，執行這行把現有登入狀態存成叫做「main」的 profile：

PowerShell
PS> cx import main

「main」只是名稱，你也可以用自己的名字或帳號暱稱。

3

新增第二個帳號

執行 cx login 加上你想取的名稱，Codex 的登入視窗就會開啟：

PowerShell
PS> cx login work # 登入完成後，work profile 就儲存好了
4

查看所有帳號狀態

PowerShell
PS> cx list CURRENT PROFILE LOGIN EMAIL PLAN LIMIT * main ok ma***@gmail.com plus - work ok wo***@company.com team -

* 號代表目前使用中的帳號。

5

用互動選單切換帳號

這是最推薦的切換方式——會自動先關掉正在跑的 Codex，再切換：

PowerShell
PS> cx switch
操作方式：↑↓ 選擇帳號   Enter 確認切換   Esc 取消
6

啟動 Codex

PowerShell
PS> codex

以後就用 codex（不是直接執行原本的 codex.exe）來啟動，這樣切換才會生效。

1

開啟終端機，貼上安裝指令

bash / zsh
$ bash <(curl -fsSL https://raw.githubusercontent.com/yazelin/codex-auth-switcher/main/install-oneliner.sh)
2

重新載入 shell（或開新終端機）

bash
$ source ~/.bashrc # zsh 用戶請改為：source ~/.zshrc
3

儲存現有帳號、新增更多帳號

bash
$ cx import main # 儲存現有帳號 $ cx login work # 新增第二個帳號
4

切換帳號

bash
$ cx use work # 切換到 work 帳號 $ codex # 啟動 Codex
互動切換介面
cx switch 選單示意
PowerShell / bash — cx switch
Codex Profile Switcher (Up/Down: navigate | Enter: switch | Esc: cancel) ───────────────────────────────────────────────────────────── * main ok 5h 97% left @06:15 | W 48% left @Sun 05:45 (4m) work ok 5h 22% left @03:59 | W 59% left @Sun 10:06 (2h) !hit until 2026-05-27 09:00 personal ok

藍色反白 = 目前選到的帳號  /  * = 目前使用中  /  !hit = 達到用量上限

完整指令列表
所有 cx 指令
指令功能說明
cx switch [--live]NEW互動選單切換帳號，自動先關閉 Codex；--live 會先更新用量
cx killNEW立即關閉所有正在運行的 Codex 程序
cx import <名稱>把目前登入狀態存成 profile
cx login <名稱>開啟 Codex 登入，存成新 profile
cx use <名稱>切換共用的 active profile
cx list [--live]列出所有 profile 及其狀態；--live 會先更新用量
cx usage [name|--all]更新 live usage；不帶參數時更新全部 profile
cx info [名稱]顯示單一 profile 詳細資訊
cx current顯示目前使用中的 profile 名稱
cx remove <名稱>刪除一個 profile
cx ps顯示目前偵測到的 Codex 程序
cx doctor診斷工具，顯示路徑、程序狀態、profile 概覽
cx export profiles.tgz將所有 profile 備份成壓縮檔
cx restore profiles.tgz從壓縮檔還原 profile
cx ok <名稱>手動清除某 profile 的用量限制標記
cx help顯示內建指令說明
codex在目前 profile 下啟動 Codex
常見問題
FAQ
沒有安裝 Git，要怎麼辦？

Windows：在 PowerShell 輸入：

winget install --id Git.Git -e --source winget

安裝完後關掉 PowerShell 再重開，就有 git 了。

Linux（Ubuntu/Debian）：

sudo apt install git

macOS：在終端機輸入 git，macOS 會自動提示安裝 Xcode Command Line Tools。

執行安裝指令時出現「執行原則」錯誤？

Windows 有時會封鎖 PowerShell 腳本的執行。先執行這行解除限制，再重貼安裝指令：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
cx 或 codex 指令在新開的 PowerShell 視窗裡不能用？

安裝指令會把設定加到你的 PowerShell profile，但需要重新開啟 PowerShell 才生效。如果還是不行，確認 profile 檔案裡有這行：

notepad $PROFILE

裡面應該有一行 . "C:\Users\你的名字\codex-auth-switcher\shell\powershell.ps1"。沒有的話，手動加上去存檔，再重開 PowerShell。

cx switch 顯示「cannot find console」或畫面跑掉？

cx switch 需要在互動式終端機視窗裡執行（Windows Terminal、PowerShell 視窗等），不能在 VS Code 的 Output 面板或 CI 環境中使用。

替代方案：直接用 cx use <名稱> 來切換。

兩個帳號可以同時開著 Codex 嗎？

可以。透過 codex wrapper 啟動時，Codex 會使用一般的 ~/.codex，所以同一個 active profile 可以雙開或三開，也會共用 /resume 歷史。cx use 和 cx login 這類會改 auth.json 的操作會在 Codex 執行中拒絕，避免跑到一半被切換帳號。

auth token 安全嗎？會上傳到雲端嗎？

不會。所有 auth token 只存在你自己電腦的 ~/.codex_auth_profiles/ 資料夾裡，不會傳送到任何伺服器。這個工具完全在本機運行。

請勿把 ~/.codex_auth_profiles/ 資料夾 commit 到 Git 倉庫。

LIMIT 欄位顯示「hit until ...」是什麼意思？

這個帳號已達到 Codex 的使用上限，顯示的時間是重置時間。重置後 cx list 會自動清掉這個標記。

如果確定已經重置但標記還在，可以手動清除：cx ok <名稱>