CC Switch / CCS

用“导入到 CCS”少填少错

推荐优先使用 1A1API API 密钥页的一键导入，少手填 Base URL、模型 ID 和 Key。

CC Switch 接入

把 API 密钥一键导入 CC Switch

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

按钮会自动带什么

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

安装并打开 CC Switch

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

选对 API 密钥

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

点击“导入到 CCS”

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

确认导入预览

CC Switch 打开后看清 provider 名称、应用类型、endpoint 和模型 ID，再确认保存。不要把旧 provider 覆盖错。

做一次最小验证

Claude Code 问一句 Reply with ok；Codex 切换后建议重开终端；Gemini CLI 也先跑一个最短请求。

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

OpenAI / Codex 分组自动导入为 app=codex，用于 Codex CLI。当前按钮会带默认模型 gpt-5.4；导入后可在 CC Switch 里改成你账号可用的 gpt-5.5 / GPT-5.5 等模型 ID。

Gemini 分组自动导入为 app=gemini。适合 Gemini CLI 或支持 Gemini provider 的工作流。

Antigravity 分组点击按钮后会弹出客户端选择：Claude Code 或 Gemini CLI；endpoint 会自动追加 /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.4

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

手动兜底

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

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

复制 API Key

在 1A1API 控制台复制 sk-...，同时看清这个 Key 的分组。不同分组对应的应用和 endpoint 不一样。

新增 provider

在 CC Switch 里点击添加供应商。Claude Code 选 Claude，Codex CLI 选 Codex，Gemini CLI 选 Gemini。

保存后健康检查

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

Claude Code应用选 Claude；Base URL 用 https://api.1a1api.top；常用模型 claude-sonnet-4-6、claude-opus-4-7、claude-haiku-4-5。

Codex CLI应用选 Codex；Base URL 用 https://1a1api.top；模型 ID 可先用按钮默认的 gpt-5.4，也可改为你账号可用的 gpt-5.5 / GPT-5.5。

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

Antigravity如果手动配 Antigravity，endpoint 通常是在控制台 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 Key：sk-your-api-key
获取模型：点模型输入框旁边的下载 / 获取模型按钮
默认模型：claude-sonnet-4-6
验证：点击供应商卡片的健康检查 / Stream Check

Codex CLI：
应用：Codex
供应商名称：1A1API Codex
API 格式：OpenAI Responses
Base URL：https://1a1api.top
API Key：sk-your-api-key
获取模型：点模型输入框旁边的下载 / 获取模型按钮
默认模型 ID：gpt-5.4、gpt-5.5 或 GPT-5.5
验证：启用后重开 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.4&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-... Key
# 2. 发给团队前先把 apiKey 参数清空或替换成占位符
# 3. 正常用户优先点控制台“导入到 CCS”，不要手写这一长串

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

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

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

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

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

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

用量不显示怎么办？

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

CC Switch：Claude Code provider 推荐填写

名称：1A1API Claude
类型：Claude / Anthropic / Claude Code
Base URL：https://api.1a1api.top
API Key / Auth Token：sk-your-api-key
默认模型：claude-sonnet-4-6
Opus 模型：claude-opus-4-7
Sonnet 模型：claude-sonnet-4-6
Haiku 模型：claude-haiku-4-5
额外环境变量：CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

CC Switch：Codex provider 推荐填写

名称：1A1API Codex
类型：OpenAI / Responses / Codex
Base URL：https://1a1api.top
API Key：sk-your-api-key
模型 ID：gpt-5.4、gpt-5.5 或 GPT-5.5
Review 模型 ID：gpt-5.4、gpt-5.5 或 GPT-5.5
Reasoning Effort：xhigh
Wire API：responses
disable_response_storage：true
network_access：enabled

切换后手动核对 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-... Key
# 4. 已经打开的 codex 窗口不要指望热切换，重开最稳

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

切到 1A1API 后 401 怎么办？

先确认 CC Switch 里填的是 1A1API 的 sk-...，不是旧中转、官方 Key 或过期 Key；再检查 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。只看正在运行的旧窗口，容易误判。