Codex Tools
Codex account switching, usage monitoring, and API reverse proxy tool
Download Codex Tools
Installer for Apple Silicon (M1/M2/M3) Macs (.dmg)
Other downloads (3)
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 Codex Tools
代理,快捷切换codex 账号, 监控codex用量的工具,以及对codex进行api反代 , 支持多语言
See incorrect information? Tell us
Risk notice
The macOS installer may not be notarized by Apple, and the system may block it on first launch; you will need to manually allow it or remove the quarantine attribute. The tool modifies auth.json and config.toml under ~/.codex, and may expose local services to the public internet via cloudflared. Please ensure your environment is secure and back up your configuration beforehand.
Who it's for
- Developers who use multiple Codex accounts and need to switch frequently
- Users who need to monitor Codex usage and account plans
- AI tool users who want to access Codex accounts through a local API reverse proxy
- Users who want to manage Codex login state via a GUI on macOS or Windows
- Teams or individuals who need to expose a pool of Codex accounts as an OpenAI-compatible API
Who it's not for
- Users who do not use Codex or do not have a Codex account
- Users who only need a single account and do not require features like switching or usage monitoring
- Users who need a Linux desktop client or server-side proxy (the installer is only available for macOS and Windows)
Install guide
Choose the installer that matches your system:
- macOS Apple Silicon (M-series): Download
Codex.Tools_2.5.0_aarch64.dmg, double-click to open it, then dragCodex Tools.appinto the Applications folder. - macOS Intel: Download
Codex.Tools_2.5.0_x64.dmgand follow the same steps. - macOS portable version: Alternatively, download
Codex.Tools_aarch64.app.tar.gz(Apple Silicon) orCodex.Tools_x64.app.tar.gz(Intel), extract it, and use it directly. - Windows x64: Download
Codex.Tools_2.5.0_x64-setup.exe(setup wizard) orCodex.Tools_2.5.0_x64_en-US.msi(MSI installer), double-click to run it, and follow the prompts to complete the installation.
After installation, open the app to import accounts, view usage, and switch.
To use the command-line interface, run the following in your terminal:
npm i -g @170-carry/ctcThen use ctc ui to open the desktop app, or directly use commands like ctc list, ctc switch, etc.
Common first-run issues:
- macOS alert: "Cannot open because it is from an unidentified developer": In "System Settings" -> "Privacy & Security", click "Open Anyway"; or run
xattr -d com.apple.quarantine /Applications/Codex\ Tools.app(if the app is located elsewhere, adjust the path). - Windows SmartScreen warning: Click "More info" -> "Run anyway".
- CLI missing native packages after installation: If you disabled optional dependencies when installing via npm, re-run
npm i -g @170-carry/ctc --include=optional.
FAQ
Is Codex Tools free?
Yes, the project is open-source under the MIT license. You can download and use it for free, and you can also view and modify the source code.
Which operating systems and architectures are supported?
macOS (Apple Silicon and Intel) and Windows x64 are supported. For macOS, choose the dmg file for aarch64 (Apple Silicon) or x64 (Intel); for Windows, choose the x64 exe or msi.
How do I update to a new version?
The desktop app supports automatic updates. You can also manually download the latest installer from the GitHub Releases page (https://github.com/170-carry/codex-tools/releases/latest) and overwrite the previous installation.
Do I need to install Codex CLI first?
Some features (such as `ctc login`, which invokes the official login) depend on having Codex CLI installed on your machine. If you only use the desktop GUI to import existing accounts and switch, it may not be required. It is recommended to install Codex and log in at least once beforehand.
The tool modifies my Codex configuration files. Is it safe?
The tool reads and writes `~/.codex/auth.json` and `config.toml` to implement account switching and API reverse proxy, and attempts to back them up before making changes. Since account credentials are involved, it is recommended that you back up the configuration files yourself and use the tool in a trusted environment.