Claude Code APIルーターのセットアップ：ベースURL、モデル、使用ログ

Claude Code APIルーターのセットアップは、OpenAI SDKのベースURLを変更するのとは異なります。Claude CodeはAnthropic Messagesゲートウェイの形式を使用するため、重要なチェック項目は、ルーターのルート、認証情報ヘッダー、Claude Codeが送信するモデル名、そしてリクエストが適切なアカウントに到達していることを証明する使用記録です。

このガイドでは、開発者、AI製品チーム、自動化ビルダー、プラットフォームエンジニア、財務担当者、調達レビュー担当者向けに、本番環境を想定したFlatkeyのセットアップを解説します。日常のコーディング作業をClaude Code APIルーターに移行する前に、ベースURL、1トークンのプリフライト、モデル名、ゲートウェイモデルの検出、使用ログ、および障害モードについて説明します。

出典注記: これは2026年6月29日に、公式のClaude Code LLMゲートウェイドキュメント、Claude Codeゲートウェイ接続ガイド、ゲートウェイプロトコルリファレンス、モデル設定ドキュメント、モニタリングドキュメント、および現在のFlatkey公開ページと照合して確認されました。実際のClaude Codeスモークテストにはアカウント固有のFlatkeyキーは使用されていないため、以下のスニペットは、ご自身のキーと承認されたモデルで実行するためのテンプレートです。

クイックアンサー：Claude Code APIルーターのセットアップ

Flatkeyを使用したClaude Code APIルーターのセットアップでは、FlatkeyのClaude Codeルーターのルート、Flatkeyキー、およびアカウントが呼び出せる正確なClaudeモデル名でClaude Codeを設定します。その後、長時間のコーディングセッションを開始する前にAnthropic Messagesエンドポイントをテストします。

以上が簡単な説明です。このClaude Code APIルーターガイドの残りの部分では、これらの項目を再現可能なセットアップ手順書にまとめています。

公式のClaude Codeゲートウェイドキュメントで確認できること

公式のClaude Codeゲートウェイの概要では、LLMゲートウェイはClaude Codeとモデルプロバイダー間のプロキシとして定義されています。Claude CodeはAPIトラフィックをゲートウェイに送信し、ゲートウェイは組織が管理するプロバイダーの認証情報を使用してそれを転送します。同じページには、認証情報の一元管理、使用状況の追跡、コスト管理、監査ログ、プロバイダーの切り替えといったゲートウェイの利点が挙げられています。

ベースURLのルールは明確です。Claude Codeは通常、リクエストをAnthropicのAPIに送信しますが、ANTHROPIC_BASE_URLを設定すると、それらのリクエストは代わりにゲートウェイに向けられます。その後、接続ガイドではanthropic-version: 2023-06-01を付けて$ANTHROPIC_BASE_URL/v1/messagesにPOSTすることでルートを検証します。

ゲートウェイプロトコルリファレンスには、オペレーター側の詳細が追加されています。Anthropic Messages形式の場合、ANTHROPIC_BASE_URLで選択されたゲートウェイは、/v1/messagesと、オプションで/v1/messages/count_tokensを提供する必要があります。また、Claude Codeはサーバー送信イベントを到着時に消費するため、推論応答はストリーミングする必要があると記載されています。

Claude Code APIルーターの場合、これはOpenAI互換のチャット補完パスだけでなく、Anthropic Messagesパスを検証する必要があることを意味します。/v1/messages、ストリーミング、または必須のAnthropicヘッダーが欠落している場合、他のツールではOpenAIルートが機能しても、Claude Codeは失敗する可能性があります。

このセットアップで検証済みのFlatkeyの値

2026年6月29日に確認したFlatkeyのホームページには、One API gateway for production AI teamsというタイトルと、Flatkeyがモデルアクセス、ルーティング、請求、使用状況分析、および運用管理を統合するというメタディスクリプションがあります。同じホームページには、依然としてhttps://console.flatkey.ai/v1と/v1/chat/completionsを使用したOpenAIスタイルの例が表示されていますが、これらはOpenAI互換ツールには役立ちますが、Claude CodeのベースURLパターンではありません。

現在のFlatkey Claude Codeのユースケースページには、Claude Codeはhttps://router.flatkey.aiとFlatkey APIキーで設定されると記載されています。また、インストーラーを実行する前にhttps://console.flatkey.ai/keysでキーを作成またはコピーするようにユーザーに指示しています。Flatkeyアカウントで新しい値が提供されない限り、以下の手動設定にはそのClaude Code固有のルーターのルートを使用してください。

2026年6月29日に確認されたFlatkeyの料金ページでは、23のプロバイダーにわたる635のAIモデルのサーバーレンダリングされた料金が公開されています。そのエンドポイントマップには、/v1/messages、/v1/chat/completions、/v1/responses、/v1/images/generations、/v1/video/generations、および/v1beta/models/{model}:generateContentが含まれています。この記事では、これをエンドポイントカバレッジに関する古い公開情報として扱っており、すべてのアカウントがすべてのモデルを呼び出せることを保証するものではありません。

Flatkeyを使用したステップバイステップのセットアップ

1. Flatkeyキーを作成または選択します。 適切な個人、チーム、または環境が所有するキーを使用してください。スクリーンショット、プロンプト、リポジトリ、および問題のコメントには含めないでください。
2. シェルエクスポートから始めます。 1トークンのプリフライトが機能するまで設定を永続化しないでください。
3. Claude Codeルーターのルートを使用します。 現在のFlatkey Claude Codeページでは、その値はhttps://router.flatkey.aiです。
4. 認証情報変数を選択します。 キーをAuthorization: Bearerとして送信する必要がある場合はANTHROPIC_AUTH_TOKENを使用します。ゲートウェイがx-api-keyを期待する場合にのみANTHROPIC_API_KEYを使用します。
5. 最初のテスト用のモデルを設定します。 Flatkeyアカウントで有効になっている現在のClaudeモデルIDを使用します。モデルがClaude Codeのピッカーに表示されない場合は、ゲートウェイディスカバリを使用するか、プリフライトが機能した後にカスタムモデルオプションを追加します。
6. curlプリフライトを実行します。 1トークンのリクエストは、FlatkeyのルーティングをClaude CodeのUI状態から分離します。
7. 同じシェルからClaude Codeを起動します。 これにより、CLIはテストしたばかりの変数を継承します。
8. /statusを実行します。 AnthropicのベースURLの行にFlatkeyルーターが表示され、認証情報の行に設定した変数が表示されることを確認します。
9. 小さなプロンプトを1つ送信します。 その後、Flatkeyの使用状況と、有効にしたClaude Codeのテレメトリを確認します。

シェルの設定

export ANTHROPIC_BASE_URL="https://router.flatkey.ai"
export ANTHROPIC_AUTH_TOKEN="fk_replace_with_your_flatkey_key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

ゲートウェイの説明で明示的にx-api-keyが指定されている場合は、ANTHROPIC_AUTH_TOKENをANTHROPIC_API_KEYに置き換え、プリフライトヘッダーを更新してください。最初のテストでは両方を設定しないでください。認証情報ソースが混在すると、障害の切り分けが難しくなります。

テストが成功した後の永続的な設定

シェルのテストが機能した後、同じ変数を~/.claude/settings.jsonのenvブロックに配置できます。コミットされたプロジェクトの.claude/settings.jsonに認証情報を入れないでください。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://router.flatkey.ai",
    "ANTHROPIC_AUTH_TOKEN": "fk_replace_with_your_flatkey_key",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

Claude Codeを起動する前にMessagesルートをプリフライトする

最も速いClaude Code APIルーターのチェックは、1トークンのMessagesリクエストです。これが失敗した場合は、Claude Codeの設定を変更する前に、Flatkeyキー、ベースURL、ネットワークパス、またはモデルを修正してください。

curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1,
    "messages": [
      {"role": "user", "content": "."}
    ]
  }'

メッセージIDで始まり、contentフィールドを含むJSONレスポンスは、ルートと認証情報が機能していることを意味します。公式ドキュメントには、不明なモデルのエラーが発生した場合でも、ゲートウェイがモデル名を拒否する前にリクエストを認証したことが証明されると記載されています。401は、認証情報が拒否されたか、間違ったヘッダーで送信されたことを意味します。

解決されたURLを注意深く確認してください。ANTHROPIC_BASE_URL=https://router.flatkey.aiの場合、テストはhttps://router.flatkey.ai/v1/messagesに到達します。コマンドが/v1/v1/messagesを作成した場合、クライアントSDKのベースURLをClaude Codeのゲートウェイフィールドにコピーしたことになります。

モデル名：エイリアス、ディスカバリ、カスタムエントリ

モデル名は、Claude Code APIルーターの障害の2番目に一般的な原因です。ベースURLはトラフィックをFlatkeyに送信しますが、Claude Codeはリクエストで送信するモデル値を依然として必要とします。

モデル設定のドキュメントによると、Claude Codeはdefault、best、sonnet、opus、haikuなどの組み込みモデル設定や、sonnet[1m]やopus[1m]のようなロングコンテキストのバリアントをサポートしています。同じドキュメントには、ANTHROPIC_MODELはそれを指定して起動したセッションにのみ適用され、/modelは後のセッションのためにインタラクティブな選択を保存できると記載されています。

Flatkeyルートの場合、安全なルールは、Flatkeyがキーに対して有効にした完全なClaudeモデルIDから始め、次にピッカーでそれを公開するかどうかを決定することです。一般的なファミリー名、マーケティングラベル、またはプロバイダーの行タイトルがリクエストモデルIDとして受け入れられると想定しないでください。

ゲートウェイモデルのディスカバリー

Claude Codeは、ANTHROPIC_BASE_URLがAnthropic Messagesゲートウェイを指し、ディスカバリーが有効になっている場合、起動時にゲートウェイの/v1/modelsエンドポイントにクエリを実行できます。プロトコルのドキュメントによると、リクエストは3秒のタイムアウト付きのGET /v1/models?limit=1000であり、Claude Codeはレスポンスからidとオプションのdisplay_nameを読み取ります。

export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
claude --debug

共有キーがすべての到達可能なモデルをすべてのユーザーに公開しないように、ディスカバリーはデフォルトでオフになっています。ディスカバリーが失敗した場合、Claude Codeはキャッシュされた、または組み込みのピッカーにフォールバックします。Flatkeyアカウントがディスカバリーに表示されないエイリアスでモデルを提供している場合は、代わりカスタムオプションを追加してください。

カスタムモデルオプション

export ANTHROPIC_CUSTOM_MODEL_OPTION="claude-sonnet-4-6"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Sonnet via Flatkey"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Claude model routed through the Flatkey API router"

カスタムモデルオプションは、そのモデルIDのクライアントサイド検証をスキップするため、管理されたパイロットテストに役立ちます。これはプリフライトリクエストの代わりにはなりません。組織の許可リストがアクティブな場合は、そこにカスタムモデルIDも含めてください。

使用ログ：最初のプロンプトの後に確認すべきこと

信頼性の高いClaude Code APIルーターのセットアップは、単に成功したレスポンスだけでなく、使用の証拠をもって完了します。Flatkeyの公式な位置づけでは、課金、使用状況分析、運用管理を統合するとされています。Claude Codeゲートウェイのドキュメントでも、使用状況の追跡とコスト管理がゲートウェイの利点として挙げられています。両方のレイヤーを意図的に使用してください。

Claude Codeのテレメトリについては、意図的なプライバシー設定でのみOpenTelemetryを有効にしてください。モニタリングのドキュメントによると、プロンプトテキストはデフォルトで編集されますが、OTEL_LOG_USER_PROMPTS=1、OTEL_LOG_TOOL_DETAILS=1、OTEL_LOG_RAW_API_BODIESなどの設定は機密性の高い詳細を追加します。セキュリティレビューで承認されない限り、生のボディロギングはデフォルトの開発者セットアップから除外してください。

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

部門、チームID、コストセンターなどのカーディナリティの低い所有権フィールドにはOTEL_RESOURCE_ATTRIBUTESを使用してください。可観測性バックエンドがカーディナリティとプライバシーへの影響を処理できない限り、ユーザーが入力したプロジェクト名やチケットIDをラベルとして使用することは避けてください。

最初にデバッグすべき障害モード

チーム向けの運用チェックリスト

チーム全体でClaude Code APIルーターを標準化する前に、将来のインシデントや財務レビューで必要となる運用上の事実を記録してください。

内部移行パス

Flatkeyが複数の開発者ツールで共有ルートになりつつある場合、Claude Codeのセットアップを統合クラスターの他の部分と整合させてください。SDKのベースURLパターンについては、OpenAI互換API移行ガイドを使用しますが、Claude Codeは/v1/chat/completionsの代わりにAnthropic Messagesルートを使用することを忘れないでください。

デスクトップクライアントのセットアップについては、Cherry Studio APIセットアップガイドを比較してください。Claude Codeに隣接する開発者マシンのルーティングパターンについては、cc-switch Claude Codeセットアップを参照してください。最初のプロンプトが機能したら、Flatkeyモデルの価格を確認し、次に別の認証情報境界が必要な追加環境のためにキーを取得してください。

よくある質問

FlatkeyでClaude Code APIルーターを使用する場合、どのベースURLを使用すればよいですか？

アカウントに表示されるClaude Code固有のFlatkeyルーターのルートを使用してください。2026年6月29日、FlatkeyのClaude Codeユースケースページには、Claude Codeはhttps://router.flatkey.aiで設定されると記載されていました。プリフライトは、正確に1つの/v1/messagesパスに到達する必要があります。

ANTHROPIC_AUTH_TOKENとANTHROPIC_API_KEYのどちらを使用すればよいですか？

ゲートウェイがAuthorizationヘッダーでベアラートークンを期待している場合はANTHROPIC_AUTH_TOKENを使用します。x-api-keyを期待している場合はANTHROPIC_API_KEYを使用します。推測して401エラーが出た場合は、変数を切り替えて再テストしてください。

Claude CodeにOpenAI互換のFlatkeyベースURLを使用できますか？

コピーしたフィールドとして直接使用することはできません。OpenAI互換ツールは/v1で終わるベースURLを使用することが多いですが、Claude CodeはANTHROPIC_BASE_URLに/v1/messagesを追加します。Flatkey Claude Codeルーターの値を使用し、最終的なURLを確認してください。

FlatkeyモデルをClaude Codeのモデルピッカーに追加するにはどうすればよいですか？

ゲートウェイが/v1/modelsを提供する場合はCLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1を有効にするか、ANTHROPIC_CUSTOM_MODEL_OPTIONを使用して手動でピッカー行を1つ追加します。どちらの場合も、お使いのFlatkeyキーで正確なモデルIDが有効になっていることを確認してください。

セットアップ後に確認すべき使用ログは？

Flatkeyの使用状況で、キー、モデル、エンドポイントファミリー、タイムスタンプ、トークン、および利用可能な場合はコストを確認してください。また、組織のテレメトリが有効になっている場合は、Claude Codeの/statusと、claude_code.cost.usageやclaude_code.token.usageなどのOpenTelemetryメトリクスも使用してください。

結論

信頼性の高いClaude Code APIルーターのセットアップには、4つの証明ポイントがあります。Flatkey Claude CodeのベースURL、正しい認証情報ヘッダー、テスト済みのモデル名、そして財務チームやプラットフォームチームがレビューできる使用履歴です。まず1トークンの/v1/messagesプリフライトから始め、/statusを確認し、ログとロールバックが文書化された後にのみルートをスケールします。共有ゲートウェイ経由でClaude Codeをルーティングする準備ができたら、キーを取得して、最小のプロンプトを最初にテストしてください。