把一台机器的 AI 工具指向网关

模块页 全局配置 里的一个开关，让一台受管机器上的 Claude Code、Codex 和 Gemini 改用中枢的 AI 网关。作用于这台机器上运行 VS Code、code-server、CloudCLI 或 Codeg 的账户。

开始之前，中枢的 AI 网关要已有能用的模型，见 AI。这台机器上要有 VS Code、code-server、CloudCLI 或 Codeg 的实例，被控端要在线。

打开

1. 在 模块 页的 选择机器 里选这台机器。
2. 在 全局配置 里打开 这台机器的 AI 工具使用中枢的 AI 网关。

开关按下就生效，没有应用栏。被控端离线时，开关是灰的；网关还没有可用的模型时，开关打不开。

第一次用时，机器从中枢取一份 cc-switch，用它逐个账户改写工具的设置文件。

选模型

1. 在 全局配置 里选择 配置。
2. 给 Claude Code 选 默认模型、Opus 档位、Sonnet 档位 和 Haiku 档位。
3. 给 Codex 选 模型 和 推理强度。
4. 给 Gemini 选 模型。
5. 选择 保存。

每一项都能留在 网关默认，这时用网关的第一个模型。取消 不保存改动。

作用于哪些账户

开关下面一行列出作用的账户名。每个账户一行：账户名、它有实例的模块、上一次的结果。

结果	意思
使用中枢的 AI 网关	这个账户的工具已经指向网关
使用自己原来的设置	这个账户的工具用它自己的设置
失败，后面跟原因	这一步没做成
正在等待被控端上报。	开关开着，机器还没上报这个账户的结果

还没有这样的账户时，开关照样能打开。以后哪个账户加了实例，机器那时再切换它。

每一步都以这个账户的身份运行。cc-switch 用这个账户 Neutrino 目录里单独的一份存放处，账户自己的 ~/.cc-switch 和 CC Switch 应用保持原样。

关掉

再按一次开关。每个账户的工具切回原来的设置，原来的文件按原样写回。还有账户没切回时，开关仍读开着，再按一次就再试一次。

下面这些时候，机器也把账户切回原来的设置：

• 账户的最后一个实例删掉时。
• 卸载被控端时。
• 机器离开中枢时。
• 网关不再有可用的模型时；网关又有模型后，机器自动重新指向网关。

某个账户失败时

修好原因后再按开关重试；开关读开着时，先关掉，再打开。各个原因见故障排查。

同时装了客户端的电脑

受管机器上也装着桌面客户端时，客户端 AI 页的开关和 配置 是灰的，原因行指向面板的模块页。客户端以前把这台电脑的工具指向过网关的，先切回一次。客户端的用法见桌面客户端。