Xiaobai Switch

中文 · English

XiaoBaiSwitch

官网：[https://xiaobaiswitch.com](https://xiaobaiswitch.com)

小白也能上手的，以站点驱动的 Claude Code / Codex / Pi 上游配置桌面应用。

以「上游站点」为中心：填好 Base URL 与 API Key，拉取或手输模型，再一键应用到 Claude Code、Codex 或 Pi。

功能

• 站点中心：管理多个上游中转，支持多条线路、测速与一键切换
• 模型管理：从站点拉取模型，也可手输、测试可用性
• 应用中心：分别为 Claude Code、Codex、Pi 选择站点、模型与目标选项后写入
• 线路切换：切换后可同步已应用到工具里的地址
• 配置备份：应用前自动备份，可在应用中心还原
• 链接导入：通过 xiaobaiswitch:// 链接一键导入站点，不会自动应用到工具
• 桌面体验：托盘常驻、开机启动、浅色 / 深色主题、简体中文与 English

软件截图

欢迎页	测试模型
站点中心	应用中心

快速开始

1. 添加一个上游站点，填写名称、Base URL 和 API Key
2. 拉取模型，或手动添加要用的模型 id
3. 打开应用中心，选择 Claude Code、Codex 或 Pi，确认模型与选项后点击应用
4. 重启终端或重新打开对应 CLI，使配置生效

同一站点可配置多条线路，第一项为当前默认线路，可随时测速并切换。

从链接导入站点

安装桌面端后，浏览器或其它应用可以打开 `xiaobaiswitch://` 链接，拉起 XiaoBaiSwitch 并导入上游站点；导入不会自动应用到 Claude Code / Codex / Pi，需在应用中心手动确认。

1. 安装并打开桌面端
2. 点击导入链接，应用会切到站点页并弹出确认框
3. 核对名称、线路、协议、备注和 API Key 前缀后确认
4. 若链接没有 apikey，确认后会打开预填的添加站点表单，补全密钥再保存

同一协议且线路集合相同（顺序无关）视为同一站点：密钥相同则复用，密钥不同则更新密钥；线路多一条或少一条会新建站点，不会自动合并。

链接格式

xiaobaiswitch://sites?name=&baseurls=[&baseurls=…][&apikey=][&protocol=openai_compatible|anthropic][¬es=][&codex-compact=1][&codex-vision=1][&codex-imagegen=1][&codex-search=1]

参数	必填	说明
name	是	站点名称，最长 128
baseurls	是	线路 Base URL，可写多条，最多 20 条
apikey	否	API Key；省略则确认后打开预填表单，由用户补全
protocol	否	openai_compatible（默认）或 anthropic
notes	否	备注，最长 2000
codex-compact	否	Codex 远程压缩预设，1 / true / on / yes 为开
codex-vision	否	Codex 识图预设