CodexManager
Account management and local gateway forwarding tool for Codex CLI
Download CodexManager
Installer for Apple Silicon (M1/M2/M3) Macs (.dmg)
Other downloads (4)
Getting a "can't verify the developer" warning?
If you see a warning on first launch, go to System Settings > Privacy & Security and click "Open Anyway". Open source software usually isn't signed with an Apple developer certificate, which is normal.
Clicking "Download" takes you to a source confirmation page first; the download starts after confirmation.
About CodexManager
一个Codex cli 账号管理与切换工具。为 Codex cli提供本地网关转发。
See incorrect information? Tell us
Risk notice
The author states in the README that only the Windows desktop app is guaranteed to work; the macOS/Linux packages have not been fully verified. The project is intended for learning and development purposes. When using multi-account management, please comply with the terms of service of OpenAI and other providers. Also note that the project runs a local service process and involves local gateway forwarding.
Who it's for
- Developers who need to manage multiple Codex CLI accounts in a unified way
- Users who want to view account usage and remaining quotas in one place
- Teams that need a local gateway for Codex CLI, Gemini CLI, and similar tools
- Users who sign in to ChatGPT accounts via browser authorization or Device Code
- Advanced users who need to manage multiple models, platform keys, and plugins
Who it's not for
- Users who use only a single Codex account and have no management needs
- Users who do not want to run a local service process
- Users who need official stable cross-platform support (especially macOS/Linux)
- Users who rely on account hosting or proxy services
Install guide
Installation Guide
Choose the installer that matches your operating system and CPU architecture.
Windows (x64)
- Recommended installer:
CodexManager_0.5.2_x64-setup.exe - For a portable version, download
CodexManager-portable.exe
Run the installer or the portable executable to launch the desktop app.
macOS
- Apple Silicon (arm64):
CodexManager_0.5.2_aarch64.dmg - Intel (x64):
CodexManager_0.5.2_x64.dmg - Portable (architecture unknown; please verify):
CodexManager-macos-portable.zip
Open the .dmg and drag the app into the "Applications" folder. If you see a message about the app being from an unidentified developer, go to "System Settings → Privacy & Security" and click "Open Anyway", or right-click the app icon and select "Open".
Linux (Optional)
Although Linux is not listed as an officially supported platform, the following files are provided:
- Debian/Ubuntu (x64):
CodexManager_0.5.2_amd64.deb - Debian/Ubuntu (arm64):
CodexManager_0.5.2_arm64.deb - AppImage (x64):
CodexManager_0.5.2_amd64.AppImage - AppImage (arm64):
CodexManager_0.5.2_aarch64.AppImage
Install with the appropriate package manager, or make the AppImage executable before running it.
Service Version (Optional)
If you only need to run the local gateway and web management page, download the CodexManager-service-* and CodexManager-web-* zip packages for your platform, extract them, and start per the README.
First Run
- Launch the desktop app and click "Start Service".
- Go to "Account Management", select browser authorization or Device Code to sign in to
chatgpt.com. - If the browser authorization callback fails, manually paste the callback link to finish parsing.
- Refresh usage and confirm account status.
For detailed configuration (port, proxy, database, etc.), refer to the project documentation.
FAQ
Is CodexManager free?
Yes. The project is open source under the MIT license, so it is free to use, modify, and redistribute.
Which operating systems are supported?
macOS and Windows are officially supported, and Linux packages are also provided. The author states in the README that only the Windows desktop app is guaranteed to work, so users on other platforms are advised to test thoroughly before use.
How do I update to a new version?
The desktop app's settings page supports automatic updates. You can also download the latest version from the project's GitHub Releases or the official website. Backups are kept in the database directory during upgrades.
Do I need to install Codex CLI beforehand?
CodexManager is an account management and gateway forwarding tool for Codex CLI, so it is typically used alongside Codex CLI. It is recommended to install OpenAI's Codex CLI first, then use CodexManager to sign in and manage accounts.
How do I import accounts?
Two methods are supported: browser authorization (chatgpt.com sign-in) and Device Code sign-in. You can also use the JSON generated by ChatGPT's `/api/auth/session` to batch-import accounts into the account pool.