codex-bridge

Use external models alongside your ChatGPT subscription in Codex CLI. Requires Codex CLI; tested with 0.164.0.

Install

Linux, installed for your user. No sudo needed.

x86_64 / amd64

curl -fL https://github.com/agent0ai/codex-bridge/releases/latest/download/codex-bridge-linux-amd64 -o codex-bridge-linux-amd64 &&
install -Dm 755 codex-bridge-linux-amd64 "$HOME/.local/bin/codex-bridge"

ARM64 / aarch64

curl -fL https://github.com/agent0ai/codex-bridge/releases/latest/download/codex-bridge-linux-arm64 -o codex-bridge-linux-arm64 &&
install -Dm 755 codex-bridge-linux-arm64 "$HOME/.local/bin/codex-bridge"

Add it to PATH for this shell, and put the same line in ~/.bashrc (Bash) or ~/.zshrc (Zsh) for future terminals:

export PATH="$HOME/.local/bin:$PATH"

Quick start

# Edit the models config and replace the example API key
codex-bridge edit

# Start the proxy service
codex-bridge start

# Sync models (--force restarts the Codex server)
codex-bridge sync --force

# Start Codex as usual and choose a model with /model
codex

Config · Guide · MIT License · Contributing · Third-party notices

---

Made by Agent Zero

Website · GitHub · Discord · X · YouTube · Sponsor