直接回答
Claude Code には単なる text endpoint ではなく Anthropic Messages の動作が必要です。client の前に gateway を直接検証します。
このガイドで解決できること
Claude Code gateway の接続、認証、model mapping、streaming 互換エラーを修正する。
Claude CodeAnthropic Messages 互換 gatewayBearer / x-api-key 認証SSE / tool use
01
症状
custom gateway 設定後に Claude Code が接続、認証、model、stream error を報告します。
汎用 curl が text を返しても Messages path、event type、tool use で Claude Code は失敗します。
02
主な原因
- Base URL に Claude Code が追加する resource path がすでに含まれる。
- environment variable が credential を誤った auth header に mapping する。
- Claude model alias が実際に対応する upstream model へ route されない。
- gateway が必要な Messages streaming・tool-use semantics を実装していない。
03
診断手順
- 01境界を確定Claude Code status と有効な Base URL、model、credential source を機密除去して確認します。
- 02基準を作成gateway へ最小 non-stream Messages request を直接送ります。
- 03一項目を比較Bearer token と x-api-key mapping を gateway 文書と比較します。
- 04決定的な証拠を記録mapped model を確認後、streaming と tool use を個別に試します。
最小診断コマンド言語：bash
printf 'ANTHROPIC_BASE_URL=%s\n' "$ANTHROPIC_BASE_URL"
test -n "$ANTHROPIC_AUTH_TOKEN" && echo 'Bearer token is set'
test -n "$ANTHROPIC_API_KEY" && echo 'x-api-key credential is set'
claude --version
claude --debug-file /tmp/claude-gateway-debug.log
# セッション内で /status を実行します。ログを共有する前に機密情報を除去します。
04
修正
- 01障害レイヤーを修正Messages resource path が一度だけ追加される root を設定します。
- 02必要な動作を復元credential variable と gateway header mapping を一致させます。
- 03一時回避策を除去対応済み model mapping を明示し、検証済み protocol capability だけを有効化します。
修正例言語：bash
export ANTHROPIC_BASE_URL='https://<your-gateway-host>'
read -rsp 'Gateway token: ' ANTHROPIC_AUTH_TOKEN && printf '\n'
export ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_API_KEY
claude
# セッション終了後: unset ANTHROPIC_AUTH_TOKEN05
検証
- 有効 Base URL に Messages path が一度だけ含まれる。
- 送信 auth header が gateway の期待と一致する。
- 各 Claude Code model 名が実対応 model ID に解決される。
- non-stream、stream、tool use が個別に成功する。
06
機密情報の扱い
- environment 確認時に Claude・gateway credential を表示しない。
- model alias で別 model へ黙って downgrade しない。
- gateway 経由でも permission prompt と tool restriction を維持する。
- version、環境変数名、mapping、UTC 時刻、request ID を機密除去して共有する。
公式情報と検証範囲
本ガイドはプロトコル仕様とクライアント公式文書を根拠にしています。エラー文、再試行ヘッダー、設定項目はサービスやバージョンで変わるため、参照元を確認し、ログとリクエスト例を秘匿してから共有してください。
ドキュメントの適用範囲を見る