神稳AI
ONE_CLICK_IMPORT

CCSwitch 一键接入

在 API Key 管理页面点击 CCSwitch 专用入口,即可建立符合用途的金钥并一键导入,不需要手动复制 Base URL、模型与金钥。

专用流程会自动配置所需能力:Codex 可选择稳定、低价或智能通道;Claude Code 会固定使用稳定通道。

一键导入也会自动启用额度查询,CCSwitch 显示的是你在神稳AI的可用余额,不是上游 Sub2API 余额。既有或手动建立的 Provider 不会自动补上这项设置,可重新导入或按下方脚本配置。

API_KEY_REQUIRED

先准备 API 金钥

1. 前往个人页面

登录后到个人页面建立或复制 API Key。金钥长得像 sk-or-v1-xxxxxxxxxxxx,请当密码保管。

前往个人页面

2. 新增 API Key 并选择通道

点击「新增 API Key」,输入便于辨识的名称,再根据用途选择通道:

稳定通道 · 0.22x(Pro 号池)
优先稳定性,支持 OpenAI(Codex 接入)、OpenAI 兼容与 CC 接入。适合长时间运行及重要文字任务。
低价通道 · 0.09x(Plus 号池)
优先价格,支持 OpenAI(Codex 接入)与 OpenAI 兼容。适合日常开发、学习、测试,以及更重视成本的文字任务。

生图请另外选择 OpenAI 生图 Key 或 Grok 生图 Key。文字与生图用途不能混在同一把 Key;需要多个用途时请分别建立。

新增 API Key 窗口,显示稳定、低价与 Grok 通道选择
新增 API Key 时,先选择通道,再确认该金钥需要的支持功能。

3. 确认 Base URL

Codex 导入时使用 https://api.shenwenai.com/v1;Claude Code 导入时使用 https://api.shenwenai.com,不带 /v1。

https://api.shenwenai.com/v1

不要把 API 金钥发给别人,也不要提交到 GitHub、GitLab 或任何公开仓库。

安装并打开 CCSwitch

从 CCSwitch 官方 Releases 下载适合你系统的最新版,完成安装后先启动一次,让系统注册 ccswitch:// 链接协议。

打开 CCSwitch 专用入口

登录神稳AI,进入「API Key 管理」,点击「新增 API Key」旁边的「CCSwitch · 新增 API Key」。

这个入口会自动建立仅包含接入目标所需能力的金钥,不需要在完整能力列表中手动勾选。原本的「新增 API Key」流程仍然可以使用,并会在建立成功窗口提供相同的导入按钮。

选择目标与通道

选择 Codex 时,可按需求选择稳定、低价或智能通道;这些通道会启用 OpenAI(Codex 接入)能力。

选择 Claude Code 时,通道会自动固定为稳定通道,并且只启用 CC 接入能力。填写名称或沿用预设名称后建立金钥。

完整金钥只会显示一次。建立完成后,点击窗口中的 CCSwitch 导入按钮;两种工具都要使用时,请分别通过专用入口建立两把金钥。

允许浏览器打开 CCSwitch

浏览器询问是否打开外部应用时,选择允许。CCSwitch 会显示待导入的服务商资料,确认后完成新增或更新。

导入链接包含完整 API 金钥。不要复制、转发或贴到聊天、工单与公开网页;只从神稳AI帐户页面直接打开。

如果点击后没有反应,先确认 CCSwitch 已安装并启动,再检查浏览器是否封锁外部应用链接。也可以换用 Chrome、Edge 或系统默认浏览器重试。

核对导入内容

CCSwitch 确认画面应显示以下资料。Codex 的 /v1 不可省略;Claude Code 的地址不可加 /v1。

Codex
text
应用:Codex
服务商:神稳AI
API 地址:https://api.shenwenai.com/v1
默认模型:gpt-5.6-sol
Claude Code
text
应用:Claude
服务商:神稳AI
API 地址:https://api.shenwenai.com

确认额度查询

通过神稳AI一键导入的新 Provider 会自动带入用量查询脚本并定期刷新,无需再手动填写。查询使用当前 Provider 的 API Key 调用 https://api.shenwenai.com/v1/usage,只返回这位用户自己的神稳AI可用余额。

如果 Provider 是过去建立、从其他平台迁移或手动新增,CCSwitch 不会自行猜测余额接口。最简单的方式是从神稳AI API Key 页面重新导入;也可以在 CCSwitch 的 Provider 用量查询中启用自定义脚本并粘贴以下内容。Base URL 有无 /v1 都能使用。

CCSwitch 用量查询脚本
javascript
({
  request: {
    url: "{{baseUrl}}".replace(/\/+$/, "")
      + ("{{baseUrl}}".replace(/\/+$/, "").endsWith("/v1") ? "" : "/v1")
      + "/usage",
    method: "GET",
    headers: { "Authorization": "Bearer {{apiKey}}" }
  },
  extractor: function(response) {
    return {
      isValid: response?.isValid ?? true,
      remaining: response?.remaining ?? response?.balance,
      unit: response?.unit ?? "USD"
    };
  }
})

启用服务商并验证

回到 CCSwitch 对应应用页面,把「神稳AI」切换为当前服务商。已经打开的 Codex 或 Claude Code 终端不会自动读取新配置,请退出后重新启动。

Codex 启动后可用 /model 检查并切换模型;Claude Code 可用 /status 检查 Base URL 是否指向 https://api.shenwenai.com。

Codex
bash
codex
Claude Code
bash
claude

常见问题

401 / invalid token:删除旧服务商后重新建立一把金钥并导入,确认金钥完整且没有多余空白。

切换后仍走旧服务商:完全退出正在运行的 CLI,再确认 CCSwitch 中「神稳AI」已是当前服务商后重开。

Codex 无法请求:确认导入到 Codex 分页、地址包含 /v1,且金钥保留 OpenAI(Codex 接入)能力。

Claude Code 无法请求:确认使用稳定通道、金钥保留 CC 接入能力,且地址结尾没有 /v1。

需要手动配置或想保留原本帐号:请改看左侧的 Codex 接入或 Claude Code 接入,里面提供隔离配置与切回方式。