外观
CCSwitch 接入
CCSwitch 用来管理和切换 Codex、Claude Code 等客户端的 API 配置。推荐先通过 控制台一键导入，再启动对应客户端。
下载与安装
- 官方网站：ccswitch.io
- 开源仓库与 Releases：farion1231/cc-switch
| 系统 | 推荐安装包 |
|---|---|
| Windows | .msi，更容易注册 ccswitch:// 协议 |
| macOS | .dmg |
| Linux | 按发行版和 CPU 架构选择 Release |
安装后先启动一次 CCSwitch，使系统完成自定义协议注册。
一键导入
- 打开 API 密钥。
- 找到已经绑定正确分组的目标 Key。
- 点击导入到 CCSwitch 的按钮。
- 浏览器询问是否打开 CC Switch 时选择允许。
- 回到 CCSwitch 查看新导入的 FreedomZ AI 配置。
- 点击“启用”，直到配置显示“使用中”。
导入不等于启用
只有配置显示“使用中”，它才是当前客户端实际读取的配置。
手动配置
一键导入失败时，可在 CCSwitch 中手动新增：
| 字段 | 填写 |
|---|---|
| 名称 | FreedomZ AI |
| 类型 | OpenAI Compatible 或对应客户端类型 |
| API Host / Server | https://freedomz.cn |
| OpenAI Base URL | https://freedomz.cn/v1 |
| API Key | 控制台创建的完整密钥 |
CCSwitch 不同版本的字段名称可能不同：字段表示“服务器地址”时通常不带 /v1， 明确表示“OpenAI Base URL”时填写带 /v1 的地址。一键导入生成值优先于手工模板。
验证是否生效
- 确认 FreedomZ AI 配置显示“使用中”。
- 关闭已经打开的 Codex、Claude Code 或 VS Code。
- 重新启动客户端并发送一次最小请求。
- 打开 使用记录 核对新记录。
使用记录出现后，才能确认客户端已经经过 FreedomZ AI。
常见问题
| 现象 | 处理 |
|---|---|
| 浏览器没有打开 CCSwitch | 先启动 CCSwitch；改用 Chrome/Edge；检查协议注册 |
| 已导入但客户端仍走旧配置 | 点击启用，关闭并重新打开客户端 |
| 刷新用量失败 | 检查 Key、分组、余额和 Base URL |
| 客户端能回复但站内无记录 | 客户端仍在使用官方登录或其他 Provider |
| 401 | 停止重试，重新复制 Key 并检查是否已撤销 |
安全提示
CCSwitch 配置中可能保存完整密钥。不要上传配置目录、导出文件或包含密钥的截图。 共用电脑应使用独立的低额度、短有效期 Key。