Installation

Homebrew (macOS / Linux)

brew install pleaseai/tap/shunt

Cargo

The crate is published as shunt-gateway (the binary is still shunt):

cargo install shunt-gateway

Prebuilt binaries

Each GitHub release attaches standalone binaries for macOS (arm64/x64) and Linux (arm64/x64), plus a SHA256SUMS file:

# Selects the right asset for your OS/CPU (darwin/linux × arm64/x64)
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m); case "$ARCH" in x86_64) ARCH=x64 ;; aarch64) ARCH=arm64 ;; esac
curl -fsSLO "https://github.com/pleaseai/shunt/releases/latest/download/shunt-${OS}-${ARCH}"
chmod +x "shunt-${OS}-${ARCH}" && mv "shunt-${OS}-${ARCH}" /usr/local/bin/shunt

From source

Requires stable Rust with cargo:

git clone https://github.com/pleaseai/shunt
cd shunt
cargo build --release   # -> target/release/shunt

You can also run straight from the source tree with cargo run -- <args>.

Prerequisites for connecting Claude Code

• Claude Code — any recent version; v2.1.129+ only if you want model discovery.
• A credential for whichever provider you map:
  • an OpenAI API key for the openai provider, or
  • a ChatGPT login via the Codex CLI (codex login) for the codex provider.
• Your normal Anthropic credential (claude.ai login or an API key) — shunt forwards it through for every model you don’t map.

Next: the Quickstart.