Setup guide - Codex
Set up CodeForge for Codex
Install the Codex CLI, use your CodeForge key, run the generated setup script for your platform, and start coding from your terminal.
1. Install the Codex CLI
The Codex CLI runs entirely in the terminal. Install it with the official script, Homebrew, npm or Cargo.
npm or Cargo
Install the CLI globally with npm or Cargo.
npm install -g @openai/codex
cargo install codex-cli
Homebrew or npm
Install the CLI with Homebrew, npm or Cargo.
brew install codex
npm install -g @openai/codex
cargo install codex-cli
Official script or npm
Use the official install script, npm or Cargo.
curl -fsSL https://codex.openai.com/install | bash
npm install -g @openai/codex
cargo install codex-cli
2. Download the CodeForge setup utility
Run the native utility, enter your CodeForge API key, and choose OpenCode or Codex. It validates your key and configures only CodeForge settings without replacing your other harness settings.
Choose your platform
The utility is a native executable. No .NET runtime is required on the computer where you run it.
chmod +x <file> and run it from a terminal. The utility waits for confirmation before it exits.
3. Allowed models from your tier
Sign in to see the models available on your plan and generate a ready-to-run setup for them.
Sign in / Sign up4. Manual config for the Codex CLI
Sign in to generate your personal CodeForge endpoint and API key, then apply them to your preferred client.
Sign in / Sign up