디스커버리(GET /v1/models)는 Claude Code의 /model 선택기를 자동으로 채울 수 있습니다. 기본적으로 shunt는 관리자가 선별한 [[models]] 항목을 먼저 반환한 뒤, 레퍼런스 Claude apps gateway를 미러링하는 내장 Claude 모델 카탈로그를 추가합니다. id가 정확히 같은 항목은 선별된 항목을 우선하여 중복을 제거합니다. 선별된 목록만 노출하려면 최상위에 auto_include_builtin_models = false를 설정하세요. 내장 모델은 전용 [[routes]] 항목이 필요하지 않습니다. 일반 라우팅 규칙으로 해석되며, [[routes]]나 [[route_prefixes]] 어느 것에도 매칭되지 않을 때 server.default_provider로 폴백합니다.
Claude Code는 디스커버리된 id가 claude/anthropic으로 시작하지 않으면 무시하므로(프로토콜 레퍼런스), gpt-* 같은 비-Claude 모델에는 Claude 이름 별칭을 사용하세요.
디스커버리와 라우팅 통합
선별한 모델에서 라우팅과 업스트림 변환을 직접 선언할 수 있습니다. 단일 항목 맵의 키는 설정된 provider 이름이고 값은 업스트림으로 보낼 모델 id입니다:
[[models]]
id = "claude-gpt-5.6-sol-via-codex"
display_name = "GPT-5.6-Sol (via Codex)"
[models.upstream_model]
codex = "gpt-5.6-sol"이 별칭을 선택하면 codex로 라우팅하고 업스트림에는 gpt-5.6-sol을 보냅니다. 이 맵은 별도의 [[routes]] 항목보다 권장되는 정확한 id 형식이며, [[routes]], [[route_prefixes]], server.default_provider보다 우선합니다. 항목마다 설정된 provider 하나만 지원하며, 잘못된 맵이나 같은 id의 [[routes]] 항목은 시작 오류입니다.
별도 라우트 사용
맵이 없는 기존 [[models]] 항목은 이전과 호환됩니다. 계속 [[routes]] 항목과 조합하여 실제 업스트림 슬러그로 다시 쓸 수 있습니다:
[[models]]
id = "claude-gpt-5.6-sol-via-codex" # 반드시 claude/anthropic으로 시작
display_name = "GPT-5.6-Sol (via Codex)"
[[routes]]
model = "claude-gpt-5.6-sol-via-codex" # Claude Code가 보내는 별칭
provider = "codex"
upstream_model = "gpt-5.6-sol" # ChatGPT 백엔드로 전달되는 실제 슬러그그런 다음 디스커버리를 활성화하고(Claude Code v2.1.129+) shunt와 Claude Code를 재시작하세요:
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1별칭은 /model에 From gateway로 표시됩니다. 이를 선택하면 claude-gpt-5.6-sol-via-codex를 보내고, shunt는 이를 codex로 라우팅하여 gpt-5.6-sol로 다시 씁니다.
별칭이 없는 gpt-* id에는 대신 ANTHROPIC_CUSTOM_MODEL_OPTION을 사용하세요 — Claude Code 연결을 참고하세요.
Claude Desktop은 tier 이름 id만 인식합니다
Claude Code는 claude/anthropic으로 시작하는 디스커버리 id를 모두 받아들이지만, Claude Desktop은 더 엄격합니다. claude-sonnet-*, claude-opus-*, claude-haiku-*, claude-fable-* 같은 tier 이름 id만 표시합니다. 따라서 위의 claude-<slug>-via-<provider> 별칭은 Claude Code에는 나타나지만 gpt가 tier 이름이 아니므로 Claude Desktop에서는 조용히 버려집니다.
내장 카탈로그는 모두 tier 이름이라 Desktop에서도 그대로 보입니다. 사라지는 것은 선별한 claude-<slug>-via-<provider> 별칭뿐입니다. 비-Anthropic 백엔드를 Claude Desktop에 노출하려면 tier 이름 id를 재사용하고 [[routes]]의 upstream_model로 매핑하세요:
[[routes]]
model = "claude-sonnet-5" # Claude Desktop이 인식하는 tier 이름 id
provider = "codex"
upstream_model = "gpt-5.6-sol" # 실제 백엔드 슬러그Desktop에서 이를 선택하면 의도한 업스트림으로 해석됩니다. 이 route는 해당 id에 대한 내장 카탈로그의 기본 라우팅을 덮어쓰므로, 백엔드 매핑이 사용자에게 여전히 의미 있는 tier 이름을 고르세요.
디스커버리에는 게이트웨이 자격 증명이 필요합니다
claude.ai OAuth 로그인만으로는 디스커버리가 발동하지 않습니다. Claude Code는 ANTHROPIC_AUTH_TOKEN, API 키, 또는 apiKeyHelper가 설정되어 있을 때만 /v1/models 요청을 보냅니다. 순수 Max/Pro 구독 로그인에서는 아무것도 보내지 않으며 — 요청이 shunt에 도달하지 않고, 캐시도 기록되지 않습니다 — 플래그가 켜져 있어도 그렇습니다. 자격 증명 선택을 참고하세요; claude setup-token이 권장 경로입니다.
디버깅
디스커버리는 조용히 실패하고(3초 타임아웃, 모든 리다이렉트는 실패로 간주) 캐시/내장 목록으로 폴백합니다. claude --debug를 실행하고 [gatewayDiscovery] 줄을 찾아 실행되었는지 확인하세요.