How to Connect Your Codex Account to UsageBuddy

Last checked: September 25, 2026

UsageBuddy brings usage and reset information for your coding-agent accounts into one dashboard. This guide covers Codex CLI setup and the UsageBuddy connection flow.

⚠️ Important: UsageBuddy currently runs on 64-bit Windows 10 (version 1809 or later) and Windows 11. Its website says the Mac app is coming soon. The macOS Codex CLI steps below install Codex, but they do not let you run UsageBuddy on a Mac yet.

Install or update Codex CLI

UsageBuddy checks for the provider's command-line tool when you add an account. Install Codex CLI before connecting. The commands below come from OpenAI's current Codex CLI instructions.

Windows

  1. Open PowerShell from the Start menu.

  2. Paste this installer command and press Enter:

    powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
    
  3. After installation, check that Codex is available:

    codex --version
    

macOS

  1. Open Terminal from Applications > Utilities.

  2. Paste the official installer command and press Return:

    curl -fsSL https://chatgpt.com/codex/install.sh | sh
    
  3. Check that Codex is available:

    codex --version
    

Updating an existing installation

Update Codex through the same method you used to install it. For an installation made with OpenAI's standalone installer, run that installer command again. For an npm installation, use npm install -g @openai/codex@latest; for Homebrew on macOS, use brew upgrade --cask codex. Then run codex --version again. Avoid installing a second copy through a different method, since your computer could keep launching the older one.

Ask an AI assistant to check it for you

You can paste this plain-English request into a coding assistant. It contains no terminal commands:

Check this computer for the official OpenAI Codex CLI. If it is missing, install the latest stable version using OpenAI's current instructions for this operating system. If it is installed, identify how it was installed, compare it with the latest version, and update it through that same installation method if needed. Do not create a second installation or change installation methods. Verify the version afterward. Report the result as “old version -> new version”; if it was missing, report “not installed -> new version,” and if it was already current, say so. End with this exact line: “Now you’re ready to connect with UsageBuddy.”

Connect Codex in UsageBuddy

  1. Open UsageBuddy.

  2. Click Add Account.

  1. Select Codex.

  2. Enter an account name. Choose a label you will recognize later, such as “Personal” or “Work.”

  1. Click Continue.

  1. Wait for the browser to open. UsageBuddy will send you to the Codex account authorization page.

  2. Sign in to the ChatGPT account you want to track. If you are already signed in to the wrong account, switch accounts before continuing.

  1. Close the browser after authorization finishes.

  2. Return to the UsageBuddy dashboard.

Once connected, UsageBuddy can show that account's reported usage and reset information beside your other connected accounts, so you can check them in one place.

Frequently asked questions

Do I need Codex CLI if I already use Codex in my browser?

Yes. UsageBuddy checks for the provider's command-line tool when adding an account. Install Codex CLI on the Windows PC where you run UsageBuddy.

What if UsageBuddy says Codex CLI is missing?

Open a new PowerShell window and run codex --version. If it does not print a version, complete the installation above. If UsageBuddy shows I installed it, click that button to check again.

Can I add more than one ChatGPT account?

Yes. Repeat Add Account for each login, give each account a different name, and check which ChatGPT account is active in the browser before approving it.

Can UsageBuddy track Codex usage billed to an API key?

The connection steps here use a ChatGPT browser login. UsageBuddy has not published support for tracking API-key-billed Codex usage.