CC Switch 操作指南（sub2api 版）

本页基于 CC Switch 官方仓库与用户手册整理，目标是让你的客户能直接把 sub2api 接入到 CC Switch 并稳定使用。

sub2api Base URL https://sub.041714.xyz/v1

API Key 变量名 OPENAI_API_KEY

文档更新时间 2026-05-11 (Asia/Hong_Kong)

2. 购买与兑换卡密

使用 CC Switch 接入前，需要先在发卡网购买兑换码/卡密，并到 sub2api 控制台兑换成余额、订阅或并发权益。兑换完成后，再去中转站创建 sk-... API Key。

01

购买卡密

打开购买入口，选择套餐，填写邮箱或联系方式后完成支付。

打开 pay.041714.xyz

02

兑换权益

登录 sub2api 控制台，进入“兑换”，粘贴兑换码并点击“兑换”。

03

创建 Key

确认余额或订阅已更新后，在中转站创建 API Key。

04

填入 CC Switch

把创建出的 sk-... 填入供应商配置里的 API Key 字段。

3. 三分钟接入流程

先从发卡网购买兑换码/卡密。
登录 sub2api 控制台，在“兑换”页面兑换卡密，让账号获得余额、订阅或并发权益。
到中转站创建 sk-... API Key。
打开 CC Switch，点右上角 + 添加供应商。
应用选择 OpenCode 或 OpenClaw，预设选 OpenAI Compatible。
填写 API Key 和 baseURL = https://sub.041714.xyz/v1。
点击“获取模型”，从下拉框选择可用模型（如 gpt-5.5）。
保存后点击“启用”，按工具要求重启终端生效。

4. 添加 sub2api 供应商

推荐方式：OpenAI Compatible 预设

进入当前应用（OpenCode / OpenClaw）的供应商页。
点击“添加供应商”。
预设选择 OpenAI Compatible。
填写 API Key 与 baseURL 后保存并启用。

如果你希望一份配置同时覆盖多个应用，可以改用“统一供应商（Universal Provider）”并勾选 OpenCode / OpenClaw。

推荐参数模板（可直接照填）

Provider Type: OpenAI Compatible
API Key: sk-...
Endpoint / baseURL: https://sub.041714.xyz/v1
Model: gpt-5.5 (或从“获取模型”下拉选择)

5. 自动获取模型（推荐）

CC Switch 支持调用 OpenAI 兼容的 /v1/models 自动发现模型，官方文档明确覆盖五个应用（含 OpenCode / OpenClaw）。

先确保供应商里已填写 API Key 与端点。
点击模型输入框旁的“获取模型”按钮。
从分组下拉里选择模型并保存。

sub2api 当前可选模型：gpt-5.2、gpt-5.5、gpt-5.4、gpt-5.4-mini、gpt-5.3-codex、gpt-image-1、gpt-image-1.5、gpt-image-2。

6. 切换与生效规则

启用供应商后，不同工具生效方式不同：

Claude Code

通常可热切换（无需重启终端）。

Codex

需重启终端后生效。

Gemini CLI

通常即时生效。

OpenCode / OpenClaw

建议重启终端，确保新配置加载。

若你启用了 Routing（路由）模式，供应商切换会在路由层即时生效，但官方路由入口当前主要针对 Claude/Codex/Gemini。

7. MCP / Prompts / Skills / Sessions

MCP

CC Switch 的 MCP 面板支持 Claude / Codex / Gemini / OpenCode；OpenClaw 在官方手册中标注暂不支持该面板管理。

Prompts

支持按应用管理提示词并同步到对应文件，例如 OpenCode / OpenClaw 的 AGENTS.md。

Skills

支持从 GitHub 或 ZIP 安装技能，文档标注支持 Claude / Codex / Gemini / OpenCode。

Sessions

支持多应用会话统一浏览与恢复，包含 OpenCode 与 OpenClaw 会话源。

8. 常见坑位（sub2api 场景）

端点路径错

baseURL 必须是 https://sub.041714.xyz/v1，不要漏 /v1，也不要写成 /v1/v1。

Full URL Mode 未判断

默认模式会把 base_url 当“前缀”自动拼接路径；若上游要求“完整 endpoint”，需开启 Full URL Mode 并填写完整 URL。

/v1/models 拉取失败

401/403 多为 Key 问题；404/405 多为路径不兼容或端点写错。

切换后无效果

OpenCode / OpenClaw 常见原因是未重启终端；Routing 模式下还要确认“路由活跃”状态。

9. 交付检查清单

客户已从发卡网购买兑换码/卡密，并在 sub2api 控制台兑换成功。
客户账号余额、订阅或并发权益已经更新。
客户已在中转站创建 sk-... API Key。
客户已能在 CC Switch 中成功添加 sub2api 供应商。
客户已能成功点击“获取模型”，并选到目标模型。
客户已理解 Base URL 必须为 https://sub.041714.xyz/v1。
客户已知道何时需要开启 Full URL Mode。
客户已验证切换后生效（OpenCode / OpenClaw 重启终端）。
客户已完成至少一次真实请求测试。

10. 参考来源

tmp/cc-switch/README_ZH.md
tmp/cc-switch/docs/user-manual/zh/1-getting-started/1.4-quickstart.md
tmp/cc-switch/docs/user-manual/zh/2-providers/2.1-add.md
tmp/cc-switch/docs/user-manual/zh/2-providers/2.2-switch.md
tmp/cc-switch/docs/user-manual/zh/3-extensions/*
tmp/cc-switch/docs/user-manual/zh/4-proxy/*
tmp/cc-switch/docs/user-manual/en/2-providers/2.1-add.md
tmp/cc-switch/docs/release-notes/v3.13.0-en.md

CC Switch 接入 sub2api 全流程