AI と連携する

このプロジェクトでは HopBase のClaude モデルのみを接続し、以下の契約に従ってください。

対象範囲
- Claude API または Claude Codeに必要な範囲だけを実装してください。このコントラクトで選ばれていないモデルファミリーを追加・設定・テストしないでください。
- 既存のフレームワーク、SDK、コードスタイルを維持し、この接続に必要な最小限の変更だけを行ってください。
- キーの配置とアーキテクチャを選ぶ前に、これがローカルのシングルユーザーツールなのか、社内向けサービスなのか、それとも下流の顧客やテナントにサービスを提供するアプリケーションなのかを判断してください。

キーとモデル
- Claude プランのキーのみを使用してください。複数モデルを扱うプロジェクトでは HOPBASE_CLAUDE_API_KEY または既存のシークレットマネージャーを優先してください。HOPBASE_API_KEY の再利用は、単一モデルのプロジェクトであることが明確な場合に限ります。
- キーを新規作成したり、他のモデルファミリーのキーを読み取ったり、実際のキーを会話に貼り付けるよう私に求めたりしないでください。キーが利用できない場合は作業を止め、ローカルまたはシークレットマネージャーでの設定を私に依頼してください。
- まずこのキーで GET https://api.hop-base.com/v1/models を呼び出し、レスポンスからclaude- で始まるモデル IDのみを選択してください。
- model_not_found が返った場合は /v1/models を取得し直し、返された完全なモデル ID を使用してください。モデル名を推測したり書き換えたりしないでください。

接続
- Anthropic プロトコルを使用し、Base URL は https://api.hop-base.com とし、/v1 は付けません。
- Anthropic SDK では api_key を、ネイティブ HTTP では x-api-key を使用します。既存の Anthropic コードはネイティブの認証方式をそのまま維持してください。
- SDK は Claude API のリクエストを POST /v1/messages に送信します。これを OpenAI Chat Completions に変換しないでください。
- Claude Code では ANTHROPIC_BASE_URL=https://api.hop-base.com を使用し、ANTHROPIC_AUTH_TOKEN には選択した Claude のキーを設定します。

実装
- 現在の依存関係と設定を確認し、インストール済みの SDK を再利用してください。関係のない他プロバイダーの設定はすべてそのまま維持してください。
- Base URL、キーの変数名、デフォルトモデルは既存の設定の仕組みに組み込んでください。.env.example は実際のキーを追加せずに更新してください。
- 下流やマルチテナント向けの呼び出しでは、キーを必ずサーバー側に保持し、呼び出し元の認証を再利用した上で、モデルのアローリスト、リクエスト制限、タイムアウト、レート制限、利用状況の帰属管理、マスキングしたログを追加してください。
- ローカルのシングルユーザーツールに、プロキシサービスやマルチテナント向けゲートウェイを追加しないでください。
- デフォルトモデルは /v1/models が返す Claude モデルの中からのみ選んでください。ドキュメントの例をそのままハードコードしないでください。
- Anthropic の SSE はエンドツーエンドでそのまま透過し、モデル自身が返す 4xx や 5xx のステータスと安全なエラー詳細を保持してください。

検証と引き渡し
- 設定が完了したら、最小限の実際のリクエストを 1 回送信してください。プロジェクトが実際にストリーミングを使用する場合のみ、ストリーミングのテストを追加してください。
- レスポンスに含まれる Claude モデルに Messages 経由で「ok とだけ返信してください」と伝え、content を確認してください。
- 変更したファイル、キーの変数名、モデル ID、エンドポイント、HTTP ステータス、マスキングしたレスポンスの要約を報告してください。起動・検証・ロールバックの各コマンドも添えてください。