NC API 文档

外观

NC API × CC Switch 新手接入指南 ​

通过 CC Switch 一键导入并启用 NC API 配置。

你不需要手动填写 Base URL、模型名称、协议，也不需要编辑任何配置文件。跟着下面 5 步操作即可。

开始前准备 ​

请先确认以下两件事：

  1. 你已经注册并登录 NC API。
  2. 你已经安装了准备使用的 Codex 客户端或命令行工具。CC Switch 负责管理配置，不会替代 Codex 本身。

安全提醒： 只在 NC API 已登录的页面点击导入按钮。不要向任何人发送 API Key、网站密码、验证码，或包含导入信息的链接和截图。

操作流程 ​

text
登录 NC API → 充值 / 创建 API Key → 安装 CC Switch → 点击“导入CCS” → 启用 → 发起请求验证

第 1 步：充值并创建 API Key ​

充值或兑换 ​

登录后，前往 充值 / 兑换 补充额度；如有兑换码，也可以在对应页面兑换到账户余额。

创建 API Key ​

  1. 打开 API Key 页面。
  2. 选择分组后，点击“创建密钥”。
  3. 名称建议填写为 CCSwitch-电脑名称，例如 CCSwitch-Office。
  4. 按页面提示完成创建。

一个设备或一种用途使用一个独立 Key，更方便以后定位和禁用。怀疑密钥泄露时，到 API Key 页面禁用该 Key 后重新创建即可。

第 2 步：下载并安装 CC Switch ​

请只从 CC Switch 官方发布页 下载软件。

Windows ​

  1. 在发布页下载文件名包含 Windows.msi 的最新版安装包。
  2. 双击下载的 .msi 文件。
  3. 按安装向导完成安装。
  4. 从开始菜单打开 CC Switch。

如果不想安装，也可以下载 Windows-Portable.zip：解压后直接运行其中的 CC Switch 程序。

macOS ​

任选一种方式：

  • 有 Homebrew：在终端运行 brew install --cask cc-switch。
  • 没有 Homebrew：下载 .dmg 文件，打开后将 CC Switch 拖到“应用程序”文件夹。

Linux ​

在发布页选择与你的系统匹配的安装包：

  • Ubuntu / Debian：选择 .deb
  • Fedora / RHEL：选择 .rpm
  • 其他发行版：选择 .AppImage

安装完成后，打开 CC Switch 一次，再继续下一步。

若系统安全提示阻止打开，请先确认安装包来自上面的官方发布页，并检查文件名和发布版本是否正确；不要从聊天群、网盘或陌生网站下载同名安装包。

第 3 步：从网页一键导入 CC Switch ​

  1. 保持 CC Switch 已打开，或至少已经成功启动过一次。
  2. 登录 NC API，打开 API Key 页面。
  3. 找到要使用的 API Key，在该行的操作区点击 “导入CCS”（与“使用密钥”等操作位于同一区域）。
  4. 浏览器弹出“是否打开 CC Switch”时，选择“打开”或“允许”。
  5. 等待 CC Switch 自动弹出或切换到前台。

导入成功后，NC API 的配置会出现在 CC Switch 的供应商列表中。

这一步不需要复制粘贴参数。 网站的“导入CCS”按钮会将所需配置直接交给 CC Switch；请勿再手动新建相同配置，以免以后不知道哪一个正在生效。

第 4 步：启用刚导入的配置 ​

  1. 回到 CC Switch 的供应商列表。
  2. 找到刚刚导入的 NC API 配置。
  3. 选中该配置。
  4. 在应用列表中选择 Codex。
  5. 点击“启用”。

看到启用状态后，完全退出正在运行的 Codex 客户端或终端，再重新打开它。重新启动后，新配置才会被读取。

日后要切换配置时，只需回到 CC Switch 选择另一个供应商并点击“启用”，然后重启 Codex。无需重复导入，也不要手改配置文件。

第 5 步：验证是否成功 ​

打开 Codex 后，发送一条简单请求，例如：

text
请用一句话介绍你能做什么。

随后打开 NC API 的使用记录：

  • 能看到本次请求的模型、Token、耗时和扣费：说明已成功接入。
  • 没有看到记录：请按下方“常见问题”逐项检查。

常见问题 ​

点击“导入 CC Switch”没有反应 ​

按顺序检查：

  1. CC Switch 是否已经安装，并且至少成功打开过一次。
  2. 是否在 NC API 已登录状态下点击了 API Key 对应行的“导入CCS”按钮。
  3. 浏览器是否拦截了“打开 CC Switch”的确认窗口；重新点击后选择“打开”或“允许”。
  4. 关闭 CC Switch 后重新打开，再回网页点击一次导入按钮。

已导入，但 Codex 没有使用新配置 ​

  1. 在 CC Switch 中确认已选中刚导入的配置。
  2. 确认已对 Codex 点击“启用”。
  3. 完全退出 Codex 或终端后重新打开，而不是只新开一个聊天窗口。
  4. 再发起一次简短请求，并检查使用记录。

模型名称没有显示，是否代表失败？ ​

不一定。部分客户端不会显示自定义模型名称。以 NC API 的使用记录为准：只要能看到对应请求，就表示配置已经生效。

API Key 泄露了怎么办？ ​

立即到 API Key 页面禁用或删除泄露的 Key，然后新建 Key 并重新通过网页导入 CC Switch。不要继续使用已经泄露的密钥。

仍然无法使用 ​

前往联系我们，并提供：注册邮箱、API Key 名称、报错截图、系统版本、CC Switch 版本和问题发生时间。

请勿发送完整 API Key。