Claude Code
Claude Code を、ゲートウェイの Messages API に向けます。ライブの Claude Code バイナリは、ゲートウェイに対して実行されていません(互換性マトリクス では not verified)。
Anthropic は、Claude 以外のモデルと組み合わせた Claude Code を公式にはサポートしていません。
設定
export ANTHROPIC_BASE_URL='https://gateway.example.internal'
export ANTHROPIC_AUTH_TOKEN='yb_…'
Claude ではないモデルへの変換経路では、次も設定します。
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
export CLAUDE_CODE_ATTRIBUTION_HEADER=0
ゲートウェイレジストリのエイリアスでモデルを選ぶか、次のように設定します。
export ANTHROPIC_MODEL='claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4'
モデルの検出:
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
検出された id には claude が含まれている必要があります。実際に動かすレジストリのモデルを指す、claude-sonnet-4-6 のようなエイリアスを登録してください。
エンドポイント
POST /v1/messages。provider=anthropic は cache_control を含めてそのまま転送されます。それ以外のプロバイダは chat completions に変換されます。トークンの見積もりは POST /v1/messages/count_tokens です。
独自のプロバイダキーを持ち込む(BYOK)
組織の管理者は、管理コンソールで上流のプロバイダキーを一度追加します(Settings → Provider keys — BYOK を参照)。モデルが組織の資格情報を経由する場合、クライアントの変更は不要です。上記の yb_… ゲートウェイキーをそのまま使い、ゲートウェイが組織のキーで上流を認証します。
制限
- 変換では
thinking、ホストされたツール、cache_controlが失われます。 - ネイティブの Anthropic モードでは、ツールのゲーティングは適用されません。
- フィクスチャの対象範囲は、ライブの Claude Code 実行ではありません。
確認
curl -sS -o /dev/null -w '%{http_code}\n' \
-H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
-H "anthropic-version: 2023-06-01" \
https://gateway.example.internal/v1/models
200 は、ゲートウェイがキーを受け 入れたことを意味します。Claude Code は起動しません。