一鍵接管 AI 程式開發工具
一鍵接管（Takeover）讓你不必手動編輯任何設定檔，就能把常用的 AI 程式開發 CLI 工具指向本機 AI 閘道。接管後，這些工具的請求會經由 http://127.0.0.1:11580 統一路由到你於閘道中設定的供應商通路，並納入統一的用量與成本統計。
運作原理
對每個工具執行一鍵接管時，閘道會依序完成：
- 檢查閘道健康狀態，確認代理端點可用。
- 自動建立一組專屬虛擬金鑰（閘道會寫入工具設定；明文可隨時在金鑰頁取回）。
- 備份原始設定檔為
.bak副檔名（例如~/.claude/settings.json.bak）。 - 精確寫入 / 深度合併指向閘道的設定，保留你的其他設定不變。
- 重新整理介面狀態，顯示目前接管情況。
停止接管時同樣是「精確移除」：只有當設定確實指向本閘道時，才會撤除對應的鍵，避免誤刪你手動設定的其他設定；同時會撤銷接管時自動建立的虛擬金鑰。
接管狀態
每個工具在 AI 閘道 → 接入管理 → 用戶端 頁面會顯示以下四種狀態之一：
| 狀態 | 意義 |
|---|---|
| 已接管（本閘道） | 工具已指向本機 AI 閘道 |
| 已連線（其他位址） | 工具已設定其他位址（你手動設定或指向其他閘道），閘道不會擅自覆蓋 |
| 未接管 | 已偵測到工具，但尚未指向閘道 |
| 未偵測到 | 未在本機找到該工具的設定目錄 |
先決條件
- 已登入 ServBay 帳號，且已在 通路 頁面設定至少一個可用通路。
- 目標 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：表示本機未找到該工具的設定目錄。請先安裝並執行一次該工具，讓它產生設定目錄後再接管。
總結
一鍵接管把「手動編輯各工具設定檔」這件繁瑣又容易出錯的事，簡化為一次點擊：自動建立金鑰、自動備份、精確寫入、隨時還原。搭配統一的通路與用量統計，你可以讓手邊所有 AI 程式開發工具共用同一套供應商設定與成本檢視。若你要在自己的程式碼中呼叫閘道，請參閱 端點與環境變數。
