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로 설치합니다. 두 환경 변수로 동작을 바꿀 수 있습니다:
SHUNT_VERSION— 설치할 릴리스(예:0.55.0). 기본값은 스크립트가 게시될 때의 릴리스, 즉 최신 릴리스입니다.SHUNT_INSTALL_DIR— 설치 디렉터리(기본값~/.local/bin). 이 디렉터리가PATH에 없으면 스크립트가 추가할 줄을 출력합니다.
curl -fsSL https://shunt.sh/install.sh | SHUNT_VERSION=0.55.0 shCargo (Git 저장소)
소스 저장소에서 직접 설치합니다. 바이너리 이름은 여전히 shunt입니다:
cargo install --git https://github.com/pleaseai/shunt새 버전은 Homebrew와 GitHub 릴리스 바이너리로 배포됩니다. crates.io 패키지는 마지막으로 게시된 버전에서 중단됩니다.
사전 빌드 바이너리
각 GitHub 릴리스에는 macOS(arm64/x64)와 Linux(arm64/x64)용 독립 실행 바이너리와 SHA256SUMS 파일이 첨부됩니다:
# 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/shuntcargo 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 — 최신 버전이면 무엇이든 됩니다. 모델 디스커버리를 원한다면 v2.1.129+가 필요합니다.
- 매핑할 프로바이더에 대한 자격 증명:
openai프로바이더용 OpenAI API 키, 또는codex프로바이더용 Codex CLI를 통한 ChatGPT 로그인(codex login).
- 일반적인 Anthropic 자격 증명(claude.ai 로그인 또는 API 키) — shunt는 매핑하지 않은 모든 모델에 대해 이를 그대로 전달합니다.
다음: 빠른 시작.