CCSwitch 一键接入
在 API Key 管理页面点击 CCSwitch 专用入口,即可建立符合用途的金钥并一键导入,不需要手动复制 Base URL、模型与金钥。
专用流程会自动配置所需能力:Codex 可选择稳定、低价或智能通道;Claude Code 会固定使用稳定通道。
一键导入也会自动启用额度查询,CCSwitch 显示的是你在神稳AI的可用余额,不是上游 Sub2API 余额。既有或手动建立的 Provider 不会自动补上这项设置,可重新导入或按下方脚本配置。
先准备 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;需要多个用途时请分别建立。

3. 确认 Base URL
Codex 导入时使用 https://api.shenwenai.com/v1;Claude Code 导入时使用 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
服务商:神稳AI
API 地址:https://api.shenwenai.com/v1
默认模型:gpt-5.6-sol应用: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 都能使用。
({
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。
codexclaude常见问题
401 / invalid token:删除旧服务商后重新建立一把金钥并导入,确认金钥完整且没有多余空白。
切换后仍走旧服务商:完全退出正在运行的 CLI,再确认 CCSwitch 中「神稳AI」已是当前服务商后重开。
Codex 无法请求:确认导入到 Codex 分页、地址包含 /v1,且金钥保留 OpenAI(Codex 接入)能力。
Claude Code 无法请求:确认使用稳定通道、金钥保留 CC 接入能力,且地址结尾没有 /v1。
需要手动配置或想保留原本帐号:请改看左侧的 Codex 接入或 Claude Code 接入,里面提供隔离配置与切回方式。