一鍵接管 AI 程式工具
一鍵接管（Takeover）讓你無需手動編輯任何設定檔，即可將常用的 AI 程式 CLI 工具導向本地 AI 閘道。接管後，這些工具的請求將經由 http://127.0.0.1:11580 統一導流至你在閘道中設定的供應商通道，並納入集中的用量與成本統計。
運作原理
當你對每個工具執行一鍵接管時，閘道會依序完成：
- 檢查閘道健康狀態，確保代理端點可用。
- 自動建立專屬虛擬金鑰（僅在建立時明文返回一次，閘道會寫入工具設定）。
- 備份原始設定檔，新增
.bak副檔名（例如~/.claude/settings.json.bak）。 - 精準寫入 ／ 深層合併 指向閘道的設定，保留你其他個人設定不變。
- 更新介面狀態，顯示目前的接管情形。
移除接管同樣是「精準移除」：僅當設定確實指定本閘道時，才會移除相關金鑰，避免誤刪你自行設定的其他選項。
接管狀態
每個工具會在 AI 閘道 → 端點（Endpoints） 頁面顯示以下四種狀態之一：
| 狀態 | 解釋 |
|---|---|
| 已接管（本閘道） | 工具已指向本機 AI 閘道 |
| 已連接（其他地址） | 工具已被設定成其他地址（你手動設定或指向其他閘道），不會自動覆蓋 |
| 未接管 | 已偵測到工具，但尚未指向本閘道 |
| 未偵測到 | 未在本機找到該工具的設定目錄 |
前置條件
- 已登入 ServBay 帳號，且已在 通道 頁面設定至少一個可用通道。
- 目標 AI 工具已安裝於本機（閘道依其設定目錄判斷是否存在）。
一鍵接管操作
進入 AI 閘道 → 端點（Endpoints） 頁面，在工具列表找到目標工具，點擊 一鍵接管。接管成功後狀態將顯示「已接管（本閘道）」。若需移除，點擊 移除 / 還原 即可。
各工具接管詳情
下表列出每個工具被接管時實際修改的設定檔及內容，方便你查閱與排查：
| 工具 | 設定檔 | 寫入內容 | 閘道地址 |
|---|---|---|---|
| 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 |
| Gemini CLI | ~/.gemini/.env | GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY 兩行 | http://127.0.0.1:11580 |
| 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：表示本機找不到該工具的設定目錄。請先安裝並執行一次該工具，生成設定目錄後再進行接管。
總結
一鍵接管將「手動編輯每個工具設定檔」這項繁複又容易出錯的操作，簡化為一次點擊：自動建立金鑰、備份設定、精準寫入、隨時還原。結合通道與統一用量控管，你可讓所有 AI 程式工具共用同一套供應商設定與成本視圖。如需於自身程式中呼叫閘道，請參閱 端點與環境變數。
