Lampese/codex-switcher

Kết luận: partial · Công nghệ: tauri · rust · desktop-app · openai-codex · account-switching

Lampese/codex-switcher là một ứng dụng desktop để quản lý và chuyển đổi giữa nhiều tài khoản OpenAI Codex CLI, phù hợp cho dev làm việc đa môi trường hoặc đa danh tính. Repo dùng stack Tauri/Rust, đã có độ chú ý tốt (566 stars), nên đáng theo dõi như một tool vận hành hơn là nguồn học thuật về agent.

📖 Giới thiệu chi tiết

🧩 Nó là gì?

Lampese/codex-switcher là một ứng dụng desktop giúp bạn quản lý nhiều tài khoản OpenAI Codex CLI trong cùng một nơi. Nói đơn giản: thay vì tự tay đổi file đăng nhập qua lại, bạn mở app lên và chọn tài khoản muốn dùng.

🎯 Giải quyết vấn đề gì? Dành cho ai?

Khi dùng Codex CLI, mỗi tài khoản thường có quota, giới hạn phiên, trạng thái đăng nhập và thông tin sử dụng riêng. Nếu bạn có nhiều tài khoản hợp lệ của chính mình, việc đổi qua lại thủ công dễ nhầm, mất thời gian và khó theo dõi giới hạn.

Codex Switcher phù hợp với:

• Dev dùng Codex CLI trong nhiều môi trường làm việc khác nhau.
• Người có nhiều tài khoản OpenAI/ChatGPT cá nhân và muốn quản lý gọn hơn.
• Người muốn theo dõi quota, reset time, usage stats mà không phải kiểm tra thủ công.
• Người hay chuyển tài khoản trong ngày và muốn thao tác nhanh từ system tray.

Lưu ý quan trọng: công cụ này dành cho người tự quản lý tài khoản của chính mình, không dành cho chia sẻ tài khoản, gom tài khoản chung, hoặc lách điều khoản sử dụng của OpenAI.

⚙️ Hoạt động ra sao?

Cơ chế chính của Lampese/codex-switcher có thể hiểu như sau:

• Lưu nhiều tài khoản Codex: bạn có thể thêm, đổi tên, ẩn bớt thông tin nhạy cảm, import/export và quản lý nhiều account trong một giao diện.
• Chuyển account nhanh: chọn tài khoản trong cửa sổ chính, native tray menu hoặc tray popup để đổi account đang dùng cho Codex CLI.
• Hỗ trợ 2 kiểu đăng nhập: đăng nhập bằng ChatGPT OAuth hoặc import file auth.json có sẵn.
• Theo dõi usage/quota: hiển thị giới hạn 5 giờ, giới hạn theo tuần, thời điểm reset, credit còn lại và ngày hết hạn subscription nếu có.
• Usage Stats cho OAuth account: xem lifetime tokens, hôm nay, 7 ngày gần nhất, 30 ngày gần nhất, streaks, task dài nhất và các insight hoạt động.
• Manual reset credits: hiển thị số credit reset thủ công còn lại, kèm ngày hết hạn gần nhất.
• Automatic Warm-Up: gửi một request tối thiểu để “khởi động” account, giúp usage window có hoạt động trước khi bạn cần dùng.
• System tray controls: có thể đổi account, xem quota, refresh usage, mở cửa sổ chính hoặc thoát app từ khay hệ thống.
• Blocked Switch Recovery: nếu đang có session Codex chạy và việc đổi account bị chặn, app phát hiện và đưa ra luồng force-close rồi thử đổi lại.
• macOS Dock/Menu Bar mode: trên macOS, app có thể hiện trong Dock hoặc chạy kiểu menu bar only.

🆚 Khi nào nên dùng / không nên

Nên dùng Codex Switcher khi:

• Bạn thật sự có nhiều tài khoản OpenAI/ChatGPT cá nhân cần dùng với Codex CLI.
• Bạn thường xuyên đổi account và muốn thao tác bằng giao diện desktop.
• Bạn muốn xem quota, reset window, usage stats và credit trong một nơi.
• Bạn muốn chạy app nền ở system tray để chuyển account nhanh.

Không nên dùng khi:

• Bạn chỉ có một tài khoản Codex CLI; lúc này cài thêm app có thể hơi thừa.
• Bạn muốn học sâu về agent AI hoặc kiến trúc Codex; repo này thiên về tool vận hành hơn là tài liệu học thuật.
• Bạn định dùng để chia sẻ tài khoản, account pooling, hoặc né giới hạn dịch vụ; đây không phải mục đích của dự án.
• Bạn không muốn cài ứng dụng desktop hoặc không cần theo dõi quota thường xuyên.

So với cách thủ công như tự thay file auth.json, Codex Switcher tiện hơn vì có giao diện, tray, thống kê usage và cơ chế đổi account rõ ràng. Đổi lại, bạn cần tin tưởng và cài thêm một ứng dụng desktop vào máy.

🚀 Bắt đầu nhanh

Cách dễ nhất là tải bản release mới nhất tại:

https://github.com/Lampese/codex-switcher/releases/latest

Chọn đúng file theo hệ điều hành:

macOS Apple Silicon: Codex.Switcher_*_aarch64.dmg
macOS Intel:         Codex.Switcher_*_x64.dmg
Windows:             Codex.Switcher_*_x64-setup.exe hoặc Codex.Switcher_*_x64_en-US.msi
Linux Debian/Ubuntu: Codex.Switcher_*_amd64.deb
Linux AppImage:      Codex.Switcher_*_amd64.AppImage
Linux RPM:           Codex.Switcher-*-1.x86_64.rpm

Nếu dùng macOS và gặp cảnh báo app bị damaged vì bản build chưa được Apple-notarized, làm như sau:

sudo xattr -dr com.apple.quarantine "/Applications/Codex Switcher.app"
open "/Applications/Codex Switcher.app"

Sau khi mở app:

1. Mở Codex Switcher.
2. Thêm tài khoản bằng ChatGPT OAuth hoặc import file auth.json.
3. Đặt tên dễ nhớ cho từng account, ví dụ: Work, Personal, Test.
4. Chọn account muốn dùng.
5. Mở Codex CLI và làm việc như bình thường.
6. Khi cần đổi account, quay lại app hoặc dùng system tray để switch.

Nếu muốn build từ source:

git clone https://github.com/Lampese/codex-switcher.git
cd codex-switcher

pnpm install
pnpm tauri dev

Build bản production:

pnpm tauri build

Trên Windows, không dùng pnpm tauri trong PowerShell/CMD. Hãy dùng:

pnpm tauri:win dev
pnpm tauri:win build

Nếu muốn chạy dashboard qua trình duyệt:

pnpm lan

Có thể cấu hình host/port bằng:

CODEX_SWITCHER_WEB_HOST
CODEX_SWITCHER_WEB_PORT

✅ Điểm mạnh & ⚠️ Hạn chế

Điểm mạnh:

• Quản lý nhiều Codex account trong một giao diện rõ ràng.
• Chuyển tài khoản nhanh từ app chính hoặc system tray.
• Có theo dõi quota, reset timing, weekly usage và manual reset credits.
• Hỗ trợ Usage Stats khá chi tiết cho ChatGPT OAuth accounts.
• Có Automatic Warm-Up và Timed Warm-Up để chủ động thời điểm account bắt đầu usage window.
• Hỗ trợ nhiều nền tảng: macOS, Windows và Linux.

Hạn chế:

• Chỉ thật sự hữu ích nếu bạn có nhiều tài khoản Codex CLI hợp lệ.
• Bản macOS hiện chưa Apple-notarized, nên có thể cần xử lý quarantine thủ công.
• Một số thống kê nâng cao phụ thuộc vào ChatGPT OAuth accounts.
• Đây là tool vận hành, không phải framework để học hoặc xây agent AI.
• Cần cẩn trọng với việc quản lý account và tuân thủ điều khoản sử dụng của OpenAI.
• Vì app can thiệp vào luồng đăng nhập/switch account, bạn nên đọc kỹ disclaimer và chỉ dùng với tài khoản thuộc sở hữu của mình.