AIコーディングツールをワンクリックでテイクオーバー
ワンクリックテイクオーバー（Takeover）を使えば、設定ファイルを手動で編集することなく、よく使う AI コーディング CLI ツールをローカル AI ゲートウェイに向けることができます。テイクオーバー後、これらのツールのリクエストは http://127.0.0.1:11580 を経由して、ゲートウェイで設定したプロバイダーチャネルへ統一的にルーティングされ、統一的な使用量とコストの統計に含まれます。
仕組み
各ツールでワンクリックテイクオーバーを実行すると、ゲートウェイは順番に以下を実行します：
- ゲートウェイのヘルス状態を確認し、プロキシエンドポイントが利用可能であることを確認します。
- 専用の仮想キーを自動作成します（ゲートウェイがツール設定に書き込みます。平文はキーページでいつでも再取得できます）。
- 元の設定ファイルを
.bak拡張子でバックアップします（例：~/.claude/settings.json.bak）。 - ゲートウェイを指す設定を正確に書き込み / ディープマージし、その他の設定はそのまま保持します。
- 画面の状態を更新し、現在のテイクオーバー状況を表示します。
テイクオーバー停止時も同様に「正確な削除」を行います。設定が実際に本ゲートウェイを指している場合にのみ該当キーを削除し、手動設定したその他の設定を誤って削除しないようにします。同時に、テイクオーバー時に自動作成された仮想キーを失効させます。
テイクオーバー状態
各ツールは AIゲートウェイ → 接続管理 → クライアント ページで4つの状態のいずれかを表示します：
| 状態 | 意味 |
|---|---|
| テイクオーバー済み（本ゲートウェイ） | ツールはローカル AI ゲートウェイを指しています |
| 接続済み（その他のアドレス） | ツールに別のアドレスが設定されています（手動設定または別のゲートウェイを指す）。ゲートウェイは勝手に上書きしません |
| 未テイクオーバー | ツールは検出されましたが、まだゲートウェイを指していません |
| 未検出 | 本機で該当ツールの設定ディレクトリが見つかりません |
前提条件
- ServBay アカウントにログイン済みで、チャネル ページで少なくとも1つの利用可能なチャネルを設定済みであること。
- 対象の AI ツールが本機にインストール済みであること（ゲートウェイは設定ディレクトリの有無で判断します）。
ワンクリックテイクオーバー操作
AIゲートウェイ → 接続管理 → クライアント ページに移動し、ツール一覧から対象ツールを探して ワンクリックテイクオーバー をクリックします。テイクオーバーに成功すると状態が「テイクオーバー済み（本ゲートウェイ）」になります。撤回する場合は テイクオーバー停止 をクリックします。
各ツールのテイクオーバー詳細
以下の表は、各ツールがテイクオーバーされた際に実際に変更される設定ファイルと内容を一覧にしたもので、理解とトラブルシューティングに役立ちます：
| ツール | 設定ファイル | 書き込み内容 | ゲートウェイアドレス |
|---|---|---|---|
| Claude Code | ~/.claude/settings.json | env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN | http://127.0.0.1:11580（/v1 なし） |
| Codex | ~/.codex/config.toml | [model_providers.servbay] セクション + トップレベル model_provider = "servbay" | http://127.0.0.1:11580/v1 |
| Qwen Code | ~/.qwen/.env | OPENAI_BASE_URL + OPENAI_API_KEY（OpenAI 互換） | http://127.0.0.1:11580/v1 |
| Kimi CLI | ~/.kimi/config.toml | [model_providers.servbay] セクション + モデル定義 | http://127.0.0.1:11580/v1 |
| CodeBuddy | ~/.codebuddy/models.json | servbay モデルノードをディープマージ | http://127.0.0.1:11580/v1 |
| opencode | ~/.config/opencode/opencode.json | provider.servbay ノードをディープマージ（各チャネルのモデルを集約） | http://127.0.0.1:11580/v1 |
| Crush | ~/.config/crush/crush.json | providers.servbay ノードをディープマージ | http://127.0.0.1:11580/v1 |
Claude Code のアドレスに /v1 が付かない理由
Claude Code は Anthropic プロトコルを使用しており、ゲートウェイが /v1/messages などのパスを自分で結合するため、ANTHROPIC_BASE_URL はゲートウェイのルートアドレス（/v1 なし）でなければなりません。その他のほとんどのツールは OpenAI 互換プロトコルを使用するため、/v1 サフィックスが必要です。ワンクリックテイクオーバーは各ツールの規約に従って自動的に入力するため、手動で区別する必要はありません。
復元とトラブルシューティング
- 元の設定を復元 — 削除 をクリックすると、ゲートウェイは本ゲートウェイを指す設定を正確に削除します。同じディレクトリにある
.bakバックアップファイルを使って手動で復元することもできます。 - 状態が「接続済み（その他のアドレス）」と表示される — このツールが現在別のアドレスを指していることを示します（手動設定または別のゲートウェイを指す）。設定の上書きを避けるため、ゲートウェイは自動でテイクオーバーしません。先に手動でその設定をクリアしてからテイクオーバーしてください。
- テイクオーバー後もツールがエラーを報告する — ゲートウェイのプロキシサービスが実行中であること、対応するチャネルが正常であること、仮想キーが失効していないことを確認してください。統計とモニタリング ページでリクエストがゲートウェイに到達しているか確認できます。
よくある質問（FAQ）
- Q：ワンクリックテイクオーバーは元のツール設定を壊しますか？
- A：いいえ。ゲートウェイはゲートウェイに関連するキーのみを正確に書き込み / マージし、書き込み前に元ファイルを
.bakとしてバックアップします。その他の設定は変更されません。
- A：いいえ。ゲートウェイはゲートウェイに関連するキーのみを正確に書き込み / マージし、書き込み前に元ファイルを
- Q：テイクオーバー後、手動で元に戻せますか？
- A：はい。「削除」をクリックしてゲートウェイに撤回させるか、
.bakバックアップを使って手動で復元できます。
- A：はい。「削除」をクリックしてゲートウェイに撤回させるか、
- Q：テイクオーバーに使う仮想キーはどこにありますか？
- A：ゲートウェイはテイクオーバーされた各ツール専用の仮想キーを自動作成します。キー ページで確認および管理できます。
- Q：一覧でツールが「未検出」と表示されますか？
- A：本機でそのツールの設定ディレクトリが見つからないことを意味します。まず該当ツールをインストールして一度実行し、設定ディレクトリを生成してからテイクオーバーしてください。
まとめ
ワンクリックテイクオーバーは、「各ツールの設定ファイルを手動で編集する」という煩雑でミスしやすい作業を、1回のクリックに簡素化します。キーの自動作成、自動バックアップ、正確な書き込み、いつでも復元が可能です。統一されたチャネルと使用量統計と組み合わせることで、手持ちのすべての AI コーディングツールに同じプロバイダー設定とコストビューを共有させることができます。自分のコードでゲートウェイを呼び出す場合は、エンドポイントと環境変数 を参照してください。
