Vercel AI Gateway는 여러 모델 벤더를 키 하나 뒤에 놓고 Anthropic 호환 엔드포인트를
노출합니다 — shunt는 Claude Code의 Messages 요청을 그대로 전달하고 게이트웨이 키를 주입합니다. 내장
프리셋이 없으므로, 업스트림이 kind와 base_url을 명시적으로 선언합니다.
빠른 시작
코딩 에이전트가 대신 구성하도록 하세요 — 이름이 있는 블루프린트가 없는 프로바이더의 경우 shunt add가
일반 리서치 가이드에 문서 URL을 삽입합니다(오프라인·읽기 전용이며, 구성은 에이전트가 편집하고 이 명령은
절대 편집하지 않습니다):
shunt add upstream https://vercel.com/docs/ai-gateway --print | claude또는 아래의 수동 단계를 따르세요.
업스트림 구성
[[upstreams]]
name = "anthropic"
provider = "anthropic" # 라우트가 없는 모델(예: claude-*)의 기본값으로 Anthropic을 유지
[[upstreams]]
name = "vercel"
kind = "anthropic"
base_url = "https://ai-gateway.vercel.sh"
auth = { mode = "api_key", env = "AI_GATEWAY_API_KEY" }
[[routes]]
model = "anthropic/claude-opus-4.8"
provider = "vercel"순서가 있는 [[upstreams]]는 shunt의 내장 프로바이더를 대체하므로, 구성은 여전히 폴백 대상인
anthropic 기본값을 선언해야 합니다(server.default_provider의 기본값은 anthropic입니다).
이 게이트웨이는 bearer 인증(기본값)과 Anthropic의 x-api-key 헤더를 모두 받아들입니다 — 후자를
선호한다면 auth 맵에 header = "x_api_key"를 추가하세요. 레거시 [providers.vercel] 테이블 형식도
계속 지원됩니다 — 다만 한 파일에서 [[upstreams]]와 [providers.*]를 섞지 마세요.
자격 증명
export AI_GATEWAY_API_KEY='...'키를 구성 파일에 절대 쓰지 마세요. shunt check는 구성의 구조를 검증하지만 키의 값을 읽지는 않습니다 —
AI_GATEWAY_API_KEY가 설정되어 있지 않으면 vercel로 라우팅된 첫 요청이 인증 오류를 반환합니다.
모델
AI Gateway 모델 id는 vendor/model 슬러그입니다(예: anthropic/claude-opus-4.8) —
AI Gateway 모델 카탈로그를 참고하고 도달 가능하게 하고 싶은
슬러그마다 [[routes]] 항목을 하나씩 추가하세요. Claude Code에서 라우팅된 id는 ANTHROPIC_MODEL,
ANTHROPIC_CUSTOM_MODEL_OPTION, 또는 서브에이전트의 model: 프론트매터로 선택하세요. 대신 /model
선택기에 항목을 드러내려면, [models.upstream_model] 맵과 함께 claude 프리픽스가 붙은 별칭을
광고하세요 — 모델 디스커버리를 참고하세요.
검증
shunt check # -> config ok
shunt run
curl -sS http://127.0.0.1:3001/v1/messages \
-H 'anthropic-version: 2023-06-01' \
-H 'content-type: application/json' \
-d '{"model":"anthropic/claude-opus-4.8","max_tokens":16,"messages":[{"role":"user","content":"Reply with OK."}]}'응답의 x-gateway-upstream 헤더가 vercel을 가리키는지 확인한 다음,
Claude Code를 shunt로 지정하세요.