クライアントの接続
クライアントがリクエストをルートおよびポリシー経由で送信するように、プロバイダではなくModel Gatewayを参照するようにします。各クライアントには、アクセスキーと、そのキーで使用できるルートのルートIDが必要です。
Anthropic互換クライアントの接続
Model Gatewayは、Authorization ヘッダー内のbearerトークンとしてのaccess keyのみを受け付けます。 Anthropicクライアントはデフォルトで x-api-key ヘッダーに認証情報を送信するため、代わりにbearerトークンを送信するようにクライアントを設定してください。 modelをroute IDに設定します。
<model-gateway-host> を、Access key generated ダイアログに表示されたURLのホストに置き換えてください。例: https://ai.workato.com。
ROUTE IDの命名
Claude Desktopは、claude-sonnet-4-5 や汎用的な anthropic/claude のように、ClaudeのモデルIDに似たroute IDのみを受け付けます。 gateways-test のようなroute IDは失敗します。 Model Gatewayはroute名からroute IDを生成するため、routeは使用するモデルにちなんだ名前にする必要があります。
次の手順を完了して、Claude DesktopをModel Gatewayに接続します。
サインインせずにClaude Desktopを開きます。
メニューバーから Help > Troubleshooting > Enable Developer Mode を選択します。
メニューバーから Developer > Configure Third-Party Inference を選択します。
Developer menu（開発者メニュー）
Connection ドロップダウンメニューで Gateway を選択します。
Configure third-party inference（サードパーティ推論の設定）
Gateway credentials の下の Credential kind ドロップダウンメニューで Static API key を選択します。
Gateway base URL フィールドに <model-gateway-host>/anthropic を入力します。 <model-gateway-host> を、Access key generated ダイアログに表示されたサンプルリクエストURLのホストに置き換えてください。たとえば、ダイアログに https://ai.workato.com/v1/chat/completions と表示されている場合は、https://ai.workato.com/anthropic と入力します。
Gateway API key フィールドにaccess keyを入力します。
Auth scheme ドロップダウンメニューで Bearer を選択します。 Bearer 認証スキームは、Authorization ヘッダー内のbearerトークンとしてaccess keyを送信します。
Model list の Model ID フィールドにroute IDを入力します。
Model list（モデル一覧）
任意。 Display name フィールドに名前を入力します。 Claude Desktopは、この名前をモデルピッカーに表示します。このフィールドを空白のままにすると、route IDから名前が自動生成されます。
Apply Changes をクリックし、必要に応じてClaude Desktopを再起動します。
これらの変数は、Claude CodeのCLIおよびIDE拡張機能に適用されます。 Claude Desktop内のClaude Codeは、代わりにClaude Desktopのgateway設定を使用します。
Claude Codeを起動する前に、次のコマンドを実行します。
export ANTHROPIC_BASE_URL=<model-gateway-host>/anthropic
export ANTHROPIC_AUTH_TOKEN=<access-key>
export ANTHROPIC_MODEL=<route-id>
export ANTHROPIC_DEFAULT_OPUS_MODEL=<route-id>
export ANTHROPIC_DEFAULT_SONNET_MODEL=<route-id>
export ANTHROPIC_DEFAULT_HAIKU_MODEL=<route-id>
unset ANTHROPIC_API_KEYANTHROPIC_AUTH_TOKEN は、access keyをbearerトークンとして送信します。 ANTHROPIC_API_KEY は x-api-key ヘッダーを送信しますが、これはModel Gatewayではサポートされていません。
サブエージェントと /model メニューは opus、sonnet、haiku のモデルエイリアスを使用し、ANTHROPIC_DEFAULT_*_MODEL 変数を設定しない場合はClaudeのモデル名に解決されます。各変数をroute IDに設定し、これらのリクエストもrouteに解決されるようにしてください。各エイリアスを別々のrouteに向けることもできます。
access keyは api_key ではなく auth_token として渡します。
import anthropic
client = anthropic.Anthropic(
base_url="<model-gateway-host>/anthropic",
auth_token="<access-key>",
)
message = client.messages.create(
model="<route-id>",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello"}],
)access keyは apiKey ではなく authToken として渡します。
import Anthropic from '@anthropic-ai/sdk';
const client = new Anthropic({
baseURL: '<model-gateway-host>/anthropic',
authToken: '<access-key>',
});
const message = await client.messages.create({
model: '<route-id>',
max_tokens: 1024,
messages: [{ role: 'user', content: 'Hello' }],
});最終更新日: