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カスタムURL」、「Ampモデルルーティング」を検索している場合、以下の手順が役立ちます。

Ampは何に役立つのか？

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

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

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

パート1 — APIに接続する

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

Ampのホーム画面から、左下の Personal Settings をクリックします。

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

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

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

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

Ampはモデル名を provider/model 形式で期待します — 例えば anthropic/claude-fable-5-1。AIHubMixのモデルIDには provider/ プレフィックスがないため、Ampがモデル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と互換性あり を選択します。
ベースURL： https://aihubmix.com — Ampはフィールドの下にリクエストが https://aihubmix.com/v1/messages に送信されることを確認します。
モデル：マッピングしたエイリアスを1行ごとにリストします（例： anthropic/claude-fable-5-1）。Ampは各エイリアスを解決し、その表示名を下に表示します。

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

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

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

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

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

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

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

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

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

プロジェクト内で、 New Thread をクリックしてタスクを開始します。

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

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

Personal Settings に戻り、 Mode Dial を開きます。各モードは自動的にモデルを選択しますが、ここで特定のモデルと推論の努力をモードの Main Agent 、 Oracle 、および Subagents に固定できます。 Auto に残されたものは、Ampの独自のルーティングに従い続けます。