| 症状 | 原因 / 対処 |
|---|---|
ChatGPT auth not found; run codex login |
shunt が ~/.codex/auth.json を読めない。codex login を実行。 |
マッピングされたモデルで authentication_error |
プロバイダー認証情報が期限切れ／不在 — codex login を再実行するか OPENAI_API_KEY をエクスポート。shunt はバックエンドの本当の detail メッセージを表面化します。 |
400 … model is not supported when using Codex with a ChatGPT account |
-codex スラッグ（またはアカウントが entitle されていないもの）を使った。models.json の entitle されたスラッグ（例 gpt-5.6-sol、gpt-5.5）を使うか upstream_model を設定。 |
/model にモデルが表示されない |
gpt-* id には ANTHROPIC_CUSTOM_MODEL_OPTION を使う。discovery は claude/anthropic プレフィックスの id のみを表面化します。 |
| Discovery が発火しない | ゲートウェイ認証情報（ANTHROPIC_AUTH_TOKEN、API キー、または apiKeyHelper）に加え CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 にゲートされています。claude --debug → [gatewayDiscovery] の行でデバッグ。 |
config check failed |
正確な理由（バインドアドレス、ルート内の未知のプロバイダー、誤ったアダプター/認証）は shunt check を実行。 |
| Claude Code がログインを求めてくる | shunt がマッピングされていないモデル向けに転送できる Anthropic 認証情報（ANTHROPIC_AUTH_TOKEN / ログイン）を設定。base URL だけでは認証情報になりません。 |
マッピングされたモデルでエフォートが medium に固定される |
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT=1 を設定 — Effort & Context を参照。 |
| マッピングされたモデルでツール検索が無効(毎ターン全ツールのスキーマが送られる) | ENABLE_TOOL_SEARCH=true を設定。Claude Code はファーストパーティでない base URL の背後で楽観的なツール検索を自動で無効化します。shunt は tool_reference ブロックを転送し、遅延スキーマを必要なときに明らかにします — ChatGPT / Codex → ツール検索 を参照。 |
| ツール検索は動くがコンテキストを削減しない(シムは完全なスキーマの送信を遅らせるだけ) | ネイティブな Responses tool_search プロトコルにオプトインする — 標準 OpenAI または ChatGPT/Codex 系のプロバイダーで gpt-5.4 以降のモデルへルーティングしている場合、[providers.<name>] に tool_search = true を設定します。非対応のフレーバー/モデルは静かにテキストシムのままです — ChatGPT / Codex → ツール検索 → オプトインのネイティブプロトコル を参照。 |
| マッピングされたモデルでコンテキスト長エラーの後にセッションが立ち往生 | shunt は上流のオーバーフローエラーを prompt is too long … へ書き換えるため Claude Code は自動コンパクトして再試行します — コンテキストオーバーフローの回復 を参照。数ターンごとに再発する場合は CLAUDE_CODE_MAX_CONTEXT_TOKENS をモデルの実ウィンドウへ下げてください。 |
| Cloudflare の背後でストリームが切れる（524） | sse_keepalive_seconds を 0 ではなくデフォルト（30）のままにする。 |
| 共有ゲートウェイでマッピングされたモデルに 401 | クライアントトークンが欠落／無効 — ANTHROPIC_AUTH_TOKEN=<token>（Authorization: Bearer として受理、プール専用ゲートウェイ）または ANTHROPIC_CUSTOM_HEADERS="x-shunt-token: <token>"（パススルーモデルが混在する場合は必須）を設定。ゲートウェイの共有 を参照。 |
完全なゲートウェイのトラブルシューティング表については、Connect Claude Code to an LLM gateway を参照してください。