Skip to content

使用 CC Switch 一键导入 NiceAI ​

CC Switch 是一款开源桌面工具,用来统一管理 Claude Code、Codex、Gemini CLI 等命令行工具的供应商配置。NiceAI 控制台支持把 API 密钥一键导入 CC Switch,不用手动填写接口地址和密钥。

准备工作 ​

  1. 注册并登录 NiceAI,在「充值」页面充值余额。
  2. 在电脑上安装 CC Switch(在其 GitHub Releases 页面下载对应系统的安装包)。安装后至少运行一次,系统才会注册 ccswitch:// 链接。
  3. 在控制台「API 密钥」页面创建密钥,并选择分组:
想用的工具选择的分组
Claude CodeClaude
CodexOpenAI
Gemini CLIGemini

一键导入 ​

  1. 打开控制台「API 密钥」页面,找到要使用的密钥。
  2. 点击该密钥的「导入」→「导入到 CCS」。
  3. 如果弹出「选择客户端」,按需要选择 Claude Code 或 Gemini CLI。
  4. 浏览器询问是否打开 CC Switch 时,选择「打开」。
  5. 在 CC Switch 的确认窗口中检查供应商名称和接口地址,确认导入。
  6. 在 CC Switch 中把新导入的 NiceAI 供应商设为当前使用,然后重启终端里的 Claude Code / Codex / Gemini CLI。

余额显示

导入时会自动配置余额查询,CC Switch 每 30 分钟刷新一次该密钥的剩余额度。

接口地址 ​

导入时会自动填写下表地址;手动添加时也按此填写。

客户端接口地址
Claude Codehttps://api.niceai.dev
Codexhttps://api.niceai.dev(不要加 /v1,CC Switch 会自动补全)
Gemini CLIhttps://api.niceai.dev

手动添加 ​

如果点击「导入到 CCS」没有反应,可以手动添加:

  1. 在控制台复制 API 密钥。
  2. 在 CC Switch 中切换到对应应用(Claude / Codex / Gemini),新增自定义供应商。
  3. 按上表填入接口地址,粘贴 API 密钥并保存,然后设为当前使用。

常见问题 ​

点击「导入到 CCS」没有反应? ​

确认 CC Switch 已安装并至少运行过一次。部分浏览器会拦截自定义协议,请在弹出的提示中允许打开。仍无效时按上文手动添加。

导入后请求返回 401? ​

检查密钥是否被禁用、余额是否充足,以及 CC Switch 当前选中的是否为刚导入的 NiceAI 供应商。

Codex 请求返回 404? ​

Codex 的接口地址末尾不要手动加 /v1。CC Switch 会自动拼接,重复的 /v1/v1 会导致 404。

注意

导入链接中包含你的 API 密钥,请勿把链接发给他人。

NiceAI · 稳定的 AI 大模型 API 中转站