インストール

Homebrew、インストールスクリプト、Git リポジトリからの Cargo、ビルド済みバイナリ、またはソースから shunt をインストールする。

Homebrew (macOS / Linux)

brew install pleaseai/tap/shunt

バックグラウンドサービスとして実行する

brew services start shunt

ログは $(brew --prefix)/var/log/shunt.log に出力されます。brew services stop は SIGTERM を送信し、shunt は実行中のリクエストを完了させてから終了します — 待機するのは最大で [server] shutdown_timeout_seconds(既定は 30 秒。この値の変更には再起動が必要)であり、それを過ぎると待機をやめて終了します。設定ファイルを変更しても再起動は不要です — shunt が自動的にホットリロードします。詳細（設定探索パスなど）は Running as a service を参照してください。

インストールスクリプト (macOS / Linux)

curl -fsSL https://shunt.sh/install.sh | sh

スクリプトは OS と CPU に合ったビルド済みバイナリを GitHub リリースからダウンロードし、リリースの SHA256SUMS で検証してから ~/.local/bin/shunt にインストールします。2 つの環境変数で動作を変更できます:

SHUNT_VERSION — インストールするリリース（例: 0.55.0）。デフォルトはスクリプトが公開された時点のリリース、つまり最新リリースです。
SHUNT_INSTALL_DIR — インストール先ディレクトリ（デフォルト ~/.local/bin）。このディレクトリが PATH にない場合、スクリプトが追加すべき行を表示します。

curl -fsSL https://shunt.sh/install.sh | SHUNT_VERSION=0.55.0 sh

Cargo（Git リポジトリ）

ソースリポジトリから直接インストールします。バイナリ名は引き続き shunt です。

cargo install --git https://github.com/pleaseai/shunt

新しいバージョンは Homebrew と GitHub リリースバイナリで配布されます。crates.io パッケージは、最後に公開されたバージョンで更新を停止します。

ビルド済みバイナリ

各 GitHub リリースには、macOS（arm64/x64）と Linux（arm64/x64）のスタンドアロンバイナリ、および SHA256SUMS ファイルが添付されています。

# 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

ソースから

cargo を備えた stable Rust が必要です。

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

cargo run -- <args> でソースツリーから直接実行することもできます。

既定のビルドは Node ツールチェーンを必要とせず、管理ダッシュボードのバンドルも含みません。管理 SPA を埋め込んだバイナリをビルドするには、先にバンドルをビルドしてから ui フィーチャーを有効にします。バンドルのビルドには Node.js 22.12 以降が必要です。

cd ui && npm ci && npm run build && cd ..
cargo build --release --features ui

上記の配布リリースバイナリはこの方法でビルドされているため、この手順が必要なのはソースからビルドする場合だけです。このフィーチャーが何を追加するかはエンドポイントを参照してください。

Claude Code に接続するための前提条件

Claude Code — 最近のバージョンならどれでも。model discovery が必要な場合のみ v2.1.129+。
マッピングするプロバイダーの認証情報:
- openai プロバイダー向けの OpenAI API キー、または
- codex プロバイダー向けの、Codex CLI（codex login）による ChatGPT ログイン。
通常の Anthropic 認証情報（claude.ai ログインまたは API キー） — shunt はマッピングしないすべてのモデルについてこれを転送します。

次へ: Quickstart。