使用 CC Switch 导入配置

从 1A1API 控制台导入提供商配置，核对应用类型、接口地址和模型，再到目标客户端测试。

适用范围：ccswitch://v1/import 导入流程 内容核对：2026-10-10 客户端实测：本轮未执行真实密钥导入或调用

导入链接包含完整 API 密钥，apiKey=sk-... 不是脱敏展示。仅在自己的设备上打开，不复制到群聊、截图、录屏或公开仓库。

打开 1A1API 控制台查看错误码排查

CC Switch 接入

从控制台导入配置

在控制台“API 密钥”列表找到“导入到 CCS”。该入口按密钥所属分组生成 ccswitch://v1/import 链接，由本机 CC Switch 接收配置。

操作顺序

先安装 CC Switch，再去 1A1API 控制台的“API 密钥”页面点击“导入到 CCS”。浏览器弹出“打开 CC Switch”时允许打开，回到 CC Switch 确认导入即可。

导入内容

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

安装并打开 CC Switch

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

确认密钥与分组

进入“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。链接中包含模型字段时，保存前与当前密钥可用列表核对；导入默认值不能证明模型权限。

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

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

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

深链字段示意：具体值以导入预览为准

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=YOUR_MODEL_ID

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

手动兜底

无法导入时：手动添加提供商

浏览器无法唤起 CC Switch，或看不到导入按钮时，可以手动添加。先确认密钥分组，再选择应用类型，保存后验证请求。

复制 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 从当前密钥可用列表复制。导入预览中的默认模型也需要核对权限。

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：YOUR_MODEL_ID（替换为当前密钥可用模型）
验证：启用后重开 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=YOUR_MODEL_ID&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。想换应用，先换密钥分组或创建对应分组的新密钥。

导入成功是否代表能够调用？

导入成功只表示配置已保存。健康检查或短请求测试会实际调用模型，可能消耗额度；结合回复和调用日志，才能确认密钥、模型、地址与网络是否可用。

用量不显示怎么办？

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

切换后手动核对 Codex 配置

在本机配置界面核对，不打印完整配置或认证文件：
1. 当前启用的应用：Codex
2. 提供商 ID：与你在 CC Switch 启用的提供商一致
3. Base URL：按 Codex 教程确认
4. 模型 ID：在当前密钥可用列表中
5. 认证状态：密钥已设置，来源与当前提供商匹配
6. 重新打开 Codex，再用短请求和调用日志验证

对外仅提供：工具版本、提供商名称、地址、模型、
密钥名称或脱敏尾号、错误时间与脱敏报错。

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

切到 1A1API 后 401 怎么办？

确认 CC Switch 中密钥有效，当前提供商及其认证来源正确，切换后已重新启动 Codex。只在本机核对认证状态，不打印、上传或发送 auth.json。手动使用环境变量接入时，另看 Codex CLI 教程，不要混用两套认证示例。

切到 Claude 模型后 404 怎么办？

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

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

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