外观
使用 CC Switch 一键导入 NiceAI
CC Switch 是一款开源桌面工具,用来统一管理 Claude Code、Codex、Gemini CLI 等命令行工具的供应商配置。NiceAI 控制台支持把 API 密钥一键导入 CC Switch,不用手动填写接口地址和密钥。
准备工作
- 注册并登录 NiceAI,在「充值」页面充值余额。
- 在电脑上安装 CC Switch(在其 GitHub Releases 页面下载对应系统的安装包)。安装后至少运行一次,系统才会注册
ccswitch://链接。 - 在控制台「API 密钥」页面创建密钥,并选择分组:
| 想用的工具 | 选择的分组 |
|---|---|
| Claude Code | Claude |
| Codex | OpenAI |
| Gemini CLI | Gemini |
一键导入
- 打开控制台「API 密钥」页面,找到要使用的密钥。
- 点击该密钥的「导入」→「导入到 CCS」。
- 如果弹出「选择客户端」,按需要选择 Claude Code 或 Gemini CLI。
- 浏览器询问是否打开 CC Switch 时,选择「打开」。
- 在 CC Switch 的确认窗口中检查供应商名称和接口地址,确认导入。
- 在 CC Switch 中把新导入的 NiceAI 供应商设为当前使用,然后重启终端里的 Claude Code / Codex / Gemini CLI。
余额显示
导入时会自动配置余额查询,CC Switch 每 30 分钟刷新一次该密钥的剩余额度。
接口地址
导入时会自动填写下表地址;手动添加时也按此填写。
| 客户端 | 接口地址 |
|---|---|
| Claude Code | https://api.niceai.dev |
| Codex | https://api.niceai.dev(不要加 /v1,CC Switch 会自动补全) |
| Gemini CLI | https://api.niceai.dev |
手动添加
如果点击「导入到 CCS」没有反应,可以手动添加:
- 在控制台复制 API 密钥。
- 在 CC Switch 中切换到对应应用(Claude / Codex / Gemini),新增自定义供应商。
- 按上表填入接口地址,粘贴 API 密钥并保存,然后设为当前使用。
常见问题
点击「导入到 CCS」没有反应?
确认 CC Switch 已安装并至少运行过一次。部分浏览器会拦截自定义协议,请在弹出的提示中允许打开。仍无效时按上文手动添加。
导入后请求返回 401?
检查密钥是否被禁用、余额是否充足,以及 CC Switch 当前选中的是否为刚导入的 NiceAI 供应商。
Codex 请求返回 404?
Codex 的接口地址末尾不要手动加 /v1。CC Switch 会自动拼接,重复的 /v1/v1 会导致 404。
注意
导入链接中包含你的 API 密钥,请勿把链接发给他人。