CC Switch / CCS

一键导入更省事，但链接包含真实 API 密钥

请只在自己的设备上点击“导入到 CCS”。不要复制、截图、录屏、转发或将导入链接提交到 GitHub。

适用版本：当前 ccswitch://v1/import 导入流程 最后验证：2026-07-20

仅限本机打开

深链中的 apiKey=sk-... 是可直接使用的凭据，不是脱敏展示。

CC Switch 接入

把 API 密钥一键导入 CC Switch

1A1API 控制台的“API 密钥”列表里有“导入到 CCS”按钮。它会根据这个密钥所属分组，自动生成 CC Switch 能识别的 ccswitch://v1/import 链接，比手动复制 Base URL、模型 ID 和 API 密钥更不容易填错。

按钮会自动带什么

导入链接会带当前 sk-... API 密钥、站点 API Base URL、提供商（Provider）名称、客户端类型、用量查询脚本和 30 分钟自动刷新间隔。不要把带真实 API 密钥的链接发到公开聊天或仓库。

安装并打开 CC Switch

先确认系统已经安装 CC Switch，并且浏览器允许打开 ccswitch:// 这种本地协议链接。

选对 API 密钥

进入“API 密钥”，确认这个 API 密钥已启用，并且分组对应你要用的工具：Claude Code、Codex、Gemini 或 Antigravity。

点击“导入到 CCS”

在密钥右侧操作区点击“导入到 CCS”。如果是 Antigravity 分组，会先让你选择导入为 Claude Code 还是 Gemini CLI。

确认导入预览

CC Switch 打开后看清提供商（Provider）名称、应用类型、接口路径和模型 ID，再确认保存。不要误覆盖旧提供商。

做一次最小验证

统一发送 Reply with exactly: ok；Codex 切换后建议重开终端，再做测试。

查看高级手动配置与深链字段参考

Anthropic / Claude 分组自动导入为 app=claude，用于 Claude Code。接口根地址使用控制台公开的 API Base URL，不需要手写 /v1/messages。

OpenAI / Codex 分组自动导入为 app=codex，用于 Codex CLI。当前按钮会带默认模型 gpt-5.6-sol；最终以账号分组可用模型为准。

Gemini 分组自动导入为 app=gemini。适合 Gemini CLI 或支持 Gemini 提供商（Provider）的工作流。

Antigravity 分组点击按钮后会弹出客户端选择：Claude Code 或 Gemini CLI；接口路径会自动追加 /antigravity。

用量查询导入链接会内置 /v1/usage 查询脚本，并设置 usageAutoInterval=30，方便 CC Switch 定时查看余额 / 剩余额度。

“导入到 CCS”按钮实际会生成的核心字段

resource=provider
app=claude / codex / gemini
name=站点名称，例如 1A1API
homepage=控制台公开 API Base URL
endpoint=按密钥分组自动生成
apiKey=当前 API 密钥（sk-...）
configFormat=json
usageEnabled=true
usageScript=内置 /v1/usage 用量查询脚本
usageAutoInterval=30

# 只有 OpenAI / Codex 分组会额外带：
model=gpt-5.6-sol

安全提醒：一键导入链接里包含真实 API 密钥。自己点击可以，截图、发群、写进教程或提交到 GitHub 前，一定要把 apiKey=sk-... 替换成占位符。

手动兜底

按钮不可用时，手动在 CC Switch 里添加

如果浏览器没有唤起 CC Switch，或管理员隐藏了“导入到 CCS”按钮，再用下面的手动方式。手动导入的关键仍然是：先看密钥分组，再选应用类型，最后验证真实请求。

复制 API 密钥

在 1A1API 控制台复制 sk-...，同时看清该 API 密钥所属分组。不同分组对应的应用和接口路径不同。

新增提供商（Provider）

在 CC Switch 里点击添加提供商（Provider）。Claude Code 选 Claude，Codex CLI 选 Codex，Gemini CLI 选 Gemini。

保存后健康检查

能拉到模型列表最好；拉不到也可以手动填模型 ID。保存后用 Stream Check / 健康检查确认 API 密钥、模型 ID、接口路径和流式响应正常。

Claude Code应用选 Claude；Base URL 用 https://api.1a1api.top；模型 ID 从当前 API 密钥可用的 Claude 模型列表复制。

Codex CLI应用选 Codex；Base URL 用 https://1a1api.top；模型 ID 默认使用 gpt-5.6-sol，也可改为账号分组内的其他可用模型。

Gemini CLI应用选 Gemini；Base URL 使用控制台显示的 API Base URL；模型按当前分组可用列表填写。

Antigravity如果手动配置 Antigravity，接口路径通常是在控制台 API Base URL 后追加 /antigravity。

手动导入前先测试模型列表和用量接口

export OPENAI_API_KEY="sk-your-api-key"

# Codex / OpenAI 兼容模型列表
curl https://1a1api.top/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

# Claude 兼容模型列表；如果这里不支持模型发现，就在 CC Switch 里手动填写模型 ID
curl https://api.1a1api.top/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

# CC Switch 一键导入会使用类似这个用量接口
curl https://1a1api.top/v1/usage \
  -H "Authorization: Bearer $OPENAI_API_KEY"

手动填写清单

Claude Code：
应用：Claude
提供商名称：1A1API Claude
API 格式：Anthropic Messages
Base URL：https://api.1a1api.top
API 密钥：sk-your-api-key
获取模型：点模型输入框旁边的下载 / 获取模型按钮
默认模型：YOUR_CLAUDE_MODEL_ID
验证：点击提供商卡片的健康检查 / Stream Check

Codex CLI：
应用：Codex
提供商名称：1A1API Codex
API 格式：OpenAI Responses
Base URL：https://1a1api.top
API 密钥：sk-your-api-key
获取模型：点模型输入框旁边的下载 / 获取模型按钮
默认模型 ID：gpt-5.6-sol
验证：启用后重开 Codex 终端

深度链接模板（只用于排查，不建议手写）

# Claude provider 深度链接结构
ccswitch://v1/import?resource=provider&app=claude&name=1A1API&homepage=https%3A%2F%2Fapi.1a1api.top&endpoint=https%3A%2F%2Fapi.1a1api.top&apiKey=sk-your-api-key&configFormat=json&usageEnabled=true&usageScript=BASE64_USAGE_SCRIPT&usageAutoInterval=30

# Codex provider 深度链接结构
ccswitch://v1/import?resource=provider&app=codex&model=gpt-5.6-sol&name=1A1API&homepage=https%3A%2F%2F1a1api.top&endpoint=https%3A%2F%2F1a1api.top&apiKey=sk-your-api-key&configFormat=json&usageEnabled=true&usageScript=BASE64_USAGE_SCRIPT&usageAutoInterval=30

# 安全建议：
# 1. 公开教程不要放真实 sk-... 密钥
# 2. 发给团队前先把 apiKey 参数清空或替换成占位符
# 3. 正常用户优先点控制台“导入到 CCS”，不要手写这一长串

点击“导入到 CCS”没有反应怎么办？

通常是 CC Switch 未安装、系统没有注册 ccswitch:// 协议，或浏览器拦截了外部应用打开请求。先打开一次 CC Switch，再回浏览器重试；仍不行就用手动填写清单。

为什么导入成了 Codex，不是 Claude？

“导入到 CCS”按 API 密钥所属分组判断应用类型。OpenAI 分组会导入 Codex，Anthropic / Claude 分组会导入 Claude。想换应用，先换密钥分组或创建对应分组的新密钥。

为什么一键导入后还要做健康检查？

导入只代表配置写进去了；健康检查会真的发请求，确认 API 密钥、模型权限、接口路径、流式响应和网络都正常。

用量不显示怎么办？

一键导入会带 /v1/usage 查询脚本。如果余额不显示，先确认 API 密钥仍启用、账号有权限访问用量接口、Base URL 没被浏览器或代理拦截。

切换后手动核对 Codex 配置

# CC Switch 切换后，建议核对这两个文件是否同步
sed -n '1,80p' ~/.codex/config.toml
sed -n '1,40p' ~/.codex/auth.json

# 重点看：
# 1. model_provider 是否为 OpenAI 或你在 CC Switch 里设置的 provider 名
# 2. base_url 是否为 https://1a1api.top
# 3. auth.json 是否写入当前 1A1API 的 sk-... 密钥
# 4. 已经打开的 codex 窗口不要指望热切换，重开最稳

常见坑：Claude Code 通常能被 CC Switch 热切换；Codex 当前窗口不一定会稳定热更新。切换 Codex 提供商（Provider）后，最稳的方式是关闭当前 Codex 会话，重新打开一个新窗口再测试。

切到 1A1API 后 401 怎么办？

先确认 CC Switch 里填的是 1A1API 的 sk-...，不是旧中转密钥、官方密钥或过期密钥；再检查 Codex 的 auth.json 是否真的同步。

切到 Claude 模型后 404 怎么办？

多数是 Base URL 写错。Claude 提供商（Provider）用 https://api.1a1api.top，不要写成 https://api.1a1api.top/v1/messages。

为什么 CC Switch 切了，Codex 还是旧模型？

Codex 不一定热读取配置。先看 ~/.codex/config.toml 是否变化，再重开 Codex。只看正在运行的旧窗口，容易误判。