Ampが1年ぶりにBYOKを再開：AIHubMixの接続と設定

Amp はBYOK（Bring Your Own Key）を再開し、 AIHubMix がこれをサポートするようになりました。このガイドでは、AnthropicのClaudeモデルを例に、AmpをAIHubMix APIに向ける方法を Custom URL と Model Routing を通じて説明します。APIキー、モデル名のマッピング、プロジェクトの設定についてもカバーします。

「Amp BYOKの設定」、「AmpをAIHubMixに接続する」、「AIHubMix APIキー」、「Amp Custom URL」、「Amp Model Routing」を検索している場合、以下の手順が役立ちます。

Ampの利点は何ですか？

マルチモデルワークフロー：異なるモデルを異なるモードやエージェントに割り当てることができます — Claude、GPT、または軽量作業用の高速モデル。
プロジェクト全体のコンテキスト：Ampはコードベース全体を読み取り、ファイルを編集し、コマンドを実行し、テストを実行します。
BYOKとカスタムルーティング：Model Routing、Custom URL、およびサードパーティAPIサービスを通じて、自分のモデルとプロバイダーを選択できます。
WebとCLIの統合：ブラウザでモデルを設定し、その後ターミナルから作業を続けることができます。
チーム向けに構築：任意のスレッドを共有し、チームメイトと共に作業を進めることができます。
クラウド同期スレッド：すべてのスレッドは自動的にクラウドに同期されるため、チームは常に同じ状態から作業を再開できます。

このガイドの残りの部分では、AnthropicのClaudeモデルを使用してAIHubMixをAmpに接続する方法を示します。

なぜAmpをAIHubMix経由でルーティングするのですか？ 1つのキーと1つのBase URLで400以上のモデルにアクセスでき、エンドポイントはAnthropic Messages APIと互換性があるため、Ampはネイティブに通信できます。また、キーごとのモデル名マッピングとエラーフォールバックにより、クライアントが期待する名前に適応できます。アカウントを作成する →

パート1 — APIを接続する

ステップ1：個人設定を開く

Ampのホーム画面から、左下の 個人設定 をクリックします。

ステップ2：カスタムモデルルートを追加する

左のサイドバーで Model Routing を見つけ、右側の追加をクリックし、 Custom URL を選択します。

ステップ3：APIキーを作成し、モデル名のマッピングを設定する

AIHubMixコンソールに移動し、APIキーを作成し、それにモデル名のマッピングを設定します。

Ampはモデル名を provider/model 形式で期待します — 例えば anthropic/claude-fable-5-1です。AIHubMixのモデルIDには provider/ プレフィックスがないため、Ampが送信する名前をAIHubMixが提供するモデルIDに書き換えるマッピングを追加します：

エイリアス（Ampが送信するもの）	ターゲット（AIHubMixモデルID）
`anthropic/claude-fable-5-1`	`claude-fable-5-1`

エイリアスを使用したリクエストはターゲットモデルIDに書き換えられます。各キーは最大5つのマッピングをサポートし、リクエストがエラーになった場合に順番に再試行されるフォールバックモデルをオプションで追加できます。

ステップ4：接続の詳細を入力する

Ampの Custom URL 画面に戻り、フィールドに入力します：

APIキー：AIHubMixで作成したキー。
API形式： Anthropic Messages APIと互換性あり を選択します。
Base URL： https://aihubmix.com — Ampはフィールドの下にリクエストが https://aihubmix.com/v1/messages に送信されることを確認します。
モデル：マッピングしたエイリアスを1行ごとにリストします（例： anthropic/claude-fable-5-1）。Ampはそれぞれを解決し、その表示名を下に表示します。

作成後にアクティブ化 にチェックを入れて、新しいリクエストがすぐにプロバイダーを通じてルーティングされるようにし、次に作成をクリックします。

ステップ5：接続を確認する

保存後、 Model Routing ページに新しい Custom URL が表示されます。 アクセスを確認 をクリックして接続をテストします。

動作するキーは、 GET https://aihubmix.com/v1/models プローブとともに Valid Key を返し、 HTTP 200 の応答と可視モデルのカウントを返します。以下のモデルリストには、このCustom URLがアクセスできるすべてのモデルが表示されます。

パート2 — プロジェクトとスレッドを作成する

ステップ6：プロジェクトを作成する

左下のプロジェクトエントリをクリックし、右上の新規プロジェクトボタンをクリックします。

最初から始める を選択し、プロジェクト名を入力してプロジェクトの作成を完了します。

ステップ7：スレッドを作成する

プロジェクト内で、 新しいスレッド をクリックしてタスクを開始します。

パート3 — モデルを割り当てて作業を開始する

ステップ8：各役割にモデルを割り当てる

個人設定 に戻り、 モードダイヤル を開きます。各モードは自動的にモデルを選択します。ここでは、モードの メインエージェント 、 オラクル 、および サブエージェント のために特定のモデルと推論の努力を固定できます。自動のままにしておくと、Ampの独自のルーティングが引き続き適用されます。