Token小铺 入门教程

CCSwitch 一键导入和 Codex 使用教程

这份教程按小白视角写。先安装 CCSwitch，再修复一键导入协议，最后在 Token小铺里点“导入到 CCS”。如果你只想用 Codex，也可以继续看下面的 API Key 和 Base URL 部分。

从 CCSwitch 开始 打开 Token小铺 CCSwitch 官网
先记住一句话：卡密只负责充值余额，Codex 和 CCSwitch 里使用的是 API 密钥页生成的 sk- 开头 Key。不要把卡密填进 Codex 或 CCSwitch。

下载区

Windows 用户建议先下载完整包。完整包里包含 CCSwitch Windows 安装包和一键导入修复补丁。

下载完整包 只下载修复补丁 打开 CCSwitch 官网
完整包适合第一次安装。修复补丁适合已经装好 CCSwitch，但点击“导入到 CCS”仍提示未安装或无法打开的用户。

一、安装 CCSwitch

  1. 点击上面的“下载完整包”。
  2. 下载后右键解压，不要直接在压缩包里运行。
  3. 先安装或打开里面的 CCSwitch Windows 程序。
  4. 打开 CCSwitch 后，先不要着急配置，保持程序能正常启动即可。
CCSwitch 是本地客户端，用来管理不同 AI 服务配置。Token小铺的“导入到 CCS”会把接口地址和 Key 自动写入 CCSwitch，省掉手动复制。

二、运行一键导入修复补丁

有些 Windows 电脑装了 CCSwitch 后，浏览器仍然不知道怎么打开 ccswitch:// 链接。这个补丁就是用来修复这件事。

  1. 解压完整包，找到 双击运行-修复CCSwitch导入.bat。
  2. 双击运行，看到 Windows 提示时允许执行。
  3. 如果脚本自动找到 CCSwitch，会直接完成修复。
  4. 如果弹出选择窗口，请手动选择 cc-switch.exe。
  5. 修复完成后，关闭浏览器页面，再重新打开 Token小铺。
补丁不会读取你的 Token小铺账号，也不会读取你的 API Key。它只会在当前 Windows 用户下注册 ccswitch:// 打开方式。

三、在 Token小铺里一键导入到 CCSwitch

  1. 打开 Token小铺并登录。
  2. 进入左侧菜单的“API 密钥”。
  3. 如果还没有 Key，先点击“创建密钥”。
  4. 找到需要导入的 Key，在右侧操作区点击“导入到 CCS”。
  5. 浏览器弹出“是否打开 CCSwitch”时选择允许。
  6. CCSwitch 打开后确认导入，随后可以在 CCSwitch 里测试连接。
Token小铺 API 密钥页导入到 CCS 按钮位置
图 1：在 API 密钥页面点击“导入到 CCS”，系统会自动把配置导入 CCSwitch。

四、导入后检测失败怎么办

如果 CCSwitch 里提示查询失败、HTTP 503 或模型不可用，按下面顺序排查。

现象 处理方法
提示未安装 CCSwitch 先打开 CCSwitch，再运行修复补丁，然后重新点“导入到 CCS”。
浏览器没有反应 检查是否被浏览器拦截。也可以换 Chrome 或 Edge 再试一次。
HTTP 503 先在 Token小铺后台确认渠道可用。用户侧可以把模型改成当前可用模型，例如 gpt-5.4 或 gpt-5.4-mini。
Key 无效 确认复制的是 API 密钥页的 sk- 开头 Key，别把卡密填进去。
余额不足 回到“兑换”页面继续兑换卡密。

五、创建 API Key

1登录网站进入 Token小铺用户端
2兑换卡密把卡密换成余额
3创建 Key生成 sk 开头密钥
4导入或复制给 CCSwitch 或 Codex 使用
  1. 左侧点击“API 密钥”。
  2. 点击“创建密钥”。
  3. 名称建议写 ccswitch 或 codex，方便以后区分。
  4. 创建后复制 sk- 开头的 Key。
API Key 相当于你的消费凭证，不要发到群里，也不要公开完整截图。

六、Codex 用户怎么填

如果你用 Codex App 或 Codex CLI，可以使用下面两项信息。

Base URL https://api.zgonline.top/v1
API Key 使用 Token小铺“API 密钥”页面生成的 sk- 开头 Key。
推荐模型 先用 gpt-5.4 测试，想省余额可以用 gpt-5.4-mini。

配置文件方式

如果 Codex App 里找不到 Base URL 设置页，可以改 Codex 配置文件。

model_provider = "tokenshop"
model = "gpt-5.4"
review_model = "gpt-5.4"

[model_providers.tokenshop]
name = "Token小铺"
base_url = "https://api.zgonline.top/v1"
wire_api = "responses"
requires_openai_auth = true

然后在终端里登录自己的 API Key。

printf 'sk-替换成你的完整APIKey' | codex login --with-api-key

七、给小白的常见问题

问题 答案
卡密和 API Key 有什么区别 卡密用来充值余额。API Key 用来给 CCSwitch、Codex 或其他客户端调用接口。
我应该下载哪个包 第一次使用下载完整包。已经安装 CCSwitch 但导入失败，只下载修复补丁即可。
补丁要不要管理员权限 通常不需要。它写入当前用户的协议注册表。如果公司电脑有安全限制，可能需要管理员协助。
导入后可以删除补丁吗 可以。修复完成后，Windows 已经知道怎么打开 ccswitch:// 链接。
为什么点击导入后浏览器会弹确认框 这是浏览器保护机制。选择允许后，浏览器才会把导入链接交给 CCSwitch。

Token小铺使用教程，最后更新：2026-06-06