Claude MaxおよびAnthropic Enterpriseのサポート

備考

ベータ版

この機能はベータ版です。アカウント管理者は、アカウント コンソールの [プレビュー] ページからこの機能へのアクセスを管理できます。Databricksのプレビューを管理するを参照してください。

Claude MaxおよびAnthropic Enterpriseサポートにより、既存のClaude Pro、Max、Enterprise、またはTeamプランをUnity AI Gatewayで使用できます。Anthropic APIキーを保存する代わりに、Unity AIゲートウェイは各呼び出し元自身のAnthropic OAuthトークンをAnthropicに中継します。リクエストは呼び出し元のサブスクリプションに対して課金され、Unity AIゲートウェイがアクセス、ルーティング、および使用状況を管理します。

これはClaude Codeのみに適用されます。Claude Code独自のAnthropicサブスクリプションログインに依存しているためです。

要件

• CREATE SERVICE モデルプロバイダーサービスを作成するスキーマ、およびそのカタログとスキーマに対する USE CATALOG 権限と USE SCHEMA 権限。
• クエリー実行時に認証を行うための Claude Pro、Max、Enterprise、または Team サブスクリプション。

モデルプロバイダーサービスを作成

接続をリレーされた モデルプロバイダーサービス として一度登録します。モデルプロバイダーサービスを作成する際は、 Claude Max/Enterprise 認証モードを選択してください。このサービスは認証情報を保存しません。これは、各呼び出し元のAnthropic OAuthトークンを中継し、Unity Catalogの権限でアクセスを管理できるようにするために存在します。

Claude Codeに接続

ヒント

ほとんどのユーザーには、ucodeが推奨されるパスです。Databricks OAuthトークンを取得および更新し、ヘッダーを設定して、Claude Codeをゲートウェイに自動的に向けます。ucodeが使用できない場合にのみ、以下の手動セットアップを使用してください。

ステップ 1: Databricks トークンを取得する

X-Databricks-AI-Gateway-Token ヘッダーには、Unity AI Gatewayへのリクエストを認証するDatabricksトークンが含まれています。Unity AI Gatewayは、アクセス制御とLogsをこのトークンに紐付けられたIDに帰属させるため、クエリを実行するユーザーに属するトークンを使用してください。

次のいずれかを選択してください：

• Databricks CLI を使用した OAuth ユーザーマシン間 (U2M) 認証 (推奨)。 CLI で一度ログインし、有効期間の短い OAuth トークンを発行します：

  Bash

  databricks auth login --host https://<workspace-url>
  databricks auth token --host https://<workspace-url> | jq -r .access_token

  「OAuth を使用して Databricks へのユーザー アクセスを承認する」および「Databricks CLI の認証」を参照してください。U2M OAuth トークンの有効期限は約 1 時間であるため、対話型で使用する場合は、有効期限が切れたときに更新し、変数を再エクスポートする必要があります。トークンの更新を自動化するには、ucode を使用します。これは、リクエストごとに OAuth トークンを自動的に更新するローカルプロキシをランします。

• パーソナル アクセストークン (PAT) (バックアップ用) OAuth を使用できない場合は、PAT を作成し、それを <databricks-token> として使用してください。PAT は 1 時間の OAuth サイクルで期限切れになることはありませんが、ユーザーの ID に紐付けられた長期有効な資格情報です。Databricks のパーソナル アクセストークン (レガシー) を使用した認証を参照してください。

ステップ2: 環境変数を設定する

シェル構成ファイル（~/.zshrc または ~/.bashrc）に以下を追加します：

Bash

export ANTHROPIC_BASE_URL="https://<workspace-url>/ai-gateway/anthropic"
export ANTHROPIC_CUSTOM_HEADERS="X-Databricks-AI-Gateway-Token: <databricks-token>
Databricks-Model-Provider-Service: <catalog>.<schema>.<name>"

• <workspace-url> をワークスペースの URL に置き換えます。
• <databricks-token> をステップ 1 の Databricks トークンに置き換えます。
• <catalog>.<schema>.<name> を、モデルプロバイダーサービスの完全修飾名に置き換えます。

ステップ3: Claude Codeを起動する

Bash

claude

ステップ 4: Claudeサブスクリプションでログインする

まだログインしていない場合、Claude Codeは認証を促します。 Option 1 - Claude アカウント with subscription を選択し、Anthropicアカウントでログインします。

問題が発生した場合は、claude /logout でログアウトしてから、もう一度ログインしてください。

Claude Codeのリクエストは、Unity AIゲートウェイを経由してルーティングされるようになりました。リクエストはAnthropicのサブスクリプションに対して課金され、一元化されたアクセス、ルーティング、および使用状況のガバナンスを利用できます。

Claude MaxおよびAnthropic Enterpriseサポートの仕組み

Claude Code が Unity AI Gateway を使用するように構成しても、Claude Code は引き続き Anthropic で認証を行います。これは Authorization ヘッダーを送信し、Unity AI Gateway はリクエストごとに OAuth トークンを Anthropic に中継します。

Authorization ヘッダーはClaudeサブスクリプションの認証情報用に予約されているため、Unity AI Gatewayは独自のDatabricks認証情報用に別のヘッダー X-Databricks-AI-Gateway-Token を使用します。これにより、AnthropicとDatabricksの両方の認証メカニズムを共存させることができます。

Databricks-Model-Provider-Service ヘッダーは、Unity AI Gatewayが解決するモデルプロバイダーサービスを指定します。そのサービスはUnity Catalogの保護可能なオブジェクトであるため、一度登録すれば、Unity Catalogの権限でアクセスを管理し、Unity AI Gatewayを介してクエリーを実行できます。標準のモデルプロバイダーサービスとの唯一の違いは、各リクエストの認証方法です。

次の図は、2つの資格情報がどのように連携して移動し、それぞれがどこで使用されるかを示しています。Unity AIゲートウェイは、Anthropicの資格情報を保存することはありません。リクエストのたびに中継されます。

ucode でのセットアップを自動化する

ucode (Unity AI Gateway Coding CLI) は、Claude Codeのインストール、認証、構成を自動的に行います。これはヘッダーを設定し、ローカルプロキシを介してOAuthトークンの更新を管理し、Claude Codeをゲートウェイに向けるため、上記の環境の手動セットアップを省略できます。

ステップ1: ucodeをインストールする

Bash

uv tool install git+https://github.com/databricks/ucode

ステップ2: モデルプロバイダーサービスに対してClaude Codeを開く

モデルプロバイダーサービスの完全修飾名 (<catalog>.<schema>.<name>) を --provider に、ワークスペース URL を --workspace に渡します：

Bash

ucode claude --provider main.default.claude_subscription --workspace https://<workspace>.databricks.com

ucode Claude Code が Databricks-Model-Provider-Service ヘッダーを送信するように構成し、Unity AI Gateway Endpoint に直接ではなく、ローカルの更新プロキシを指すようにします。プロキシは各リクエストを https://<workspace-url>/ai-gateway/anthropic に転送し、X-Databricks-AI-Gateway-Token ヘッダーを追加します。サービスは認証情報を保存しないため、ucode は API キーの代わりに Anthropic OAuth トークンを中継します。

注記

--provider Claude Max/Enterpriseモデルプロバイダーサービスは、ucode claudeでのみサポートされています。

制限事項

• リクエストは呼び出し元の Anthropic サブスクリプションに対して課金され、そのサブスクリプションのレート制限が適用されます。
• Claude MaxおよびAnthropic Enterpriseをサポートするモデルプロバイダーサービスは資格情報を保存しないため、呼び出し元のAnthropic OAuthトークンを中継するリクエストのみを処理できます。

次のステップ

• 外部モデルプロバイダー (モデルプロバイダーサービス) のクエリー
• 外部モデルプロバイダー (モデルプロバイダーサービス) へのアクセスを検出および管理します
• 外部モデルプロバイダー（モデルプロバイダーサービス）の管理