一键接管 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 编程工具共享同一套供应商配置与成本视图。若你要在自己的代码中调用网关，请参阅 端点与环境变量。
