メインコンテンツまでスキップ

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 は起動しません。