# CC Switch 一键导入

[CC Switch](https://github.com/farion1231/cc-switch) 是一个开源的配置切换工具（MIT 许可），可以在多个服务商之间切换 Claude Code、Codex 的配置。2api 控制台自带导入按钮，适合已经在用 CC Switch 的人。没装过的话，更推荐 [magpie](https://docs.2api.dev/magpie/)。

1. 从 [GitHub Releases](https://github.com/farion1231/cc-switch/releases) 下载安装 CC Switch，打开一次，确认能正常启动。

2. 登录 [2api.dev](https://2api.dev)，进入「API 密钥」页面。

3. 找到要用的 Key，点后面的「导入到 CCS」。浏览器会唤起 CC Switch，自动填好服务商名称、接口地址和 Key。GPT 分组的 Key 会导入到 Codex，「CC-Max」分组的会导入到 Claude Code。

4. 在 CC Switch 里选中刚导入的 2api 配置，然后**重新打开**终端或编辑器，新开一个会话。

## 常见情况

- **点导入没反应**：本机没装 CC Switch，或者浏览器没允许打开 `ccswitch://` 链接。先确认 CC Switch 能正常启动，再点一次，浏览器弹窗时选「允许」。
- **切换后还是旧配置**：系统环境变量或 `~/.zshrc` 里如果还写着旧的地址或 Key，会覆盖 CC Switch 写入的配置，删掉后重开终端。Codex 只在启动时读配置，切换后要完全退出再打开。
- **插件、hooks、MCP 配置不见了**：老版本 CC Switch 会整个覆盖配置文件，请升级到最新版。被覆盖的文件可以在 `~/.cc-switch/backups/` 里找回。
- **用了路由模式**：配置里的地址会变成 `http://127.0.0.1:...`，这时 CC Switch 必须一直开着。