Skip to main content
Codex supports custom model providers through config.toml, so you can route Codex requests through Phaseo while keeping the same CLI, app, or IDE workflow. If you also want Codex to read the live Phaseo documentation while it works, add the Docs MCP server as well.
Need reusable agent setup help as well as provider wiring? Install the public Phaseo skills from phaseo.app/docs:

​
Set up with the Phaseo CLI

Install Codex from its official release first. Setup creates a Phaseo CLI: Codex API Key that expires after 90 days and has a $100 monthly spend limit, stores it in the OS credential store, and writes a dedicated Phaseo profile. Codex retrieves the key through the CLI helper, which creates a new key when the old one expires, so no plaintext key is written to config.toml. Start Codex with:
The same Phaseo CLI workflow also launches Cline, Kilo Code, oh-my-pi, Muse Code, and MiniMax Code with isolated temporary provider configuration.

​
Manual configuration

Create or update your user config at ~/.codex/config.toml. For a trusted project, you can also place the same settings in .codex/config.toml inside the repo.
Codex currently uses the Responses wire protocol for custom providers. Keep wire_api = "responses" or omit it and use the default. The Codex App and IDE extension share the same config layers. In the IDE extension, open the config from Codex Settings > Open config.toml.

​
Verification

  • Confirm your model id exists in Models before launching.
  • Use Responses for the default Codex-style flow.

​
Troubleshooting

  • 401 Unauthorized: run phaseo whoami, then rerun phaseo codex.
  • model_not_found: fetch a current id from Models and update model.
  • Provider-specific issues: follow Routing and fallbacks for failover behavior.
Last modified on October 29, 2026