Skip to main content
Before installing an AI CLI, make sure you’ve completed Yellow.pro’s account setup first — connecting your wallet, creating a sub-account, and completing verification. See Agent Onboarding for the full walkthrough. The steps below assume your Yellow.pro account is already set up and you’re ready to pair an AI agent to it.
If codex --version already works in your terminal, skip ahead to Installation and use yellow-pro setup codex. Otherwise, follow the steps below first.
1

Install

Install Codex CLI globally via npm:
Alternative install methods:
2

Verify

Open a new terminal window (a window that was already open won’t see an updated PATH), then run:
If you see command not found: codex, npm’s global bin directory likely isn’t on your PATH. Check where npm installs global packages with npm config get prefix, then add <that path>/bin to your PATH (e.g. in ~/.zshrc) and open a fresh terminal window.
3

Log in

Run:
This opens a browser-based sign-in flow using your ChatGPT account. Check that it worked with:
For headless machines without a browser, use codex login --device-auth instead. To authenticate with an API key rather than a ChatGPT account, use codex login --with-api-key or set the CODEX_API_KEY environment variable.
Next: continue to Installation and run yellow-pro setup codex to register the Yellow.pro MCP server with Codex CLI.