CC Switch 接入
难度 🧩 中等 | 接口格式 Claude | base_url
https://byesu.com
CC Switch 是一款开源、跨平台的 AI CLI 统一管理工具，可以在 Claude Code、Codex、Gemini CLI 之间一键切换不同的 API 供应商，无需手动改环境变量或配置文件。把半页酥 API 接进来后，你就能在它里面随时切换到 byesu 的渠道。
CC Switch 管理的是 Claude Code 这类 CLI，因此 Claude Code 走的是 Anthropic 接口格式，base_url 用 https://byesu.com（不带 /v1）。
第 1 步：安装 CC Switch
官方下载：GitHub Releases（Windows / macOS / Linux 全平台安装包）· 官网 ccswitch.io
按你的系统选择安装方式：
brew tap farion1231/ccswitch
brew install --cask cc-switch到 GitHub Releases 下载 MSI 安装包，或下载 portable ZIP 解压即用。# 到 GitHub Releases 下载 DEB 包 / AppImage / RPM
# ArchLinux 用 AUR 安装：
paru -S cc-switch-bin安装完成后打开 CC Switch，左上角切换到 Claude（Claude Code） 这一类。
第 2 步：添加 byesu 供应商
方式一：一键导入（最快）
如果你是在半页酥控制台里操作，可以直接用 ccswitch:// 深链导入，省去手填：
- 进入 控制台 → 令牌，在目标令牌的下拉菜单里选择 CC Switch。
- 在弹出的配置框里：
- 应用类型：选 Claude
- 配置名称：随便起，例如
byesu - 主模型（必填）：选
claude-opus-4-8 - Opus 模型：
claude-opus-4-8 - Sonnet 模型 / Haiku 模型：可选，按需选其他可用模型
- 点 打开 CC Switch，配置会自动导入。
确认 base_url 与令牌
一键导入会自动带上 byesu 的接口地址和你这个令牌的 key。导入后请到供应商详情里核对 base_url 是 https://byesu.com（Anthropic 格式，不带 /v1）。
方式二：手动添加
在 CC Switch 的 Claude 分类里点「新增供应商」，按下表填写：
| 字段 | 填写内容 |
|---|---|
| 名称（Name） | byesu（自定义） |
API 地址 / Base URL（对应 ANTHROPIC_BASE_URL） | https://byesu.com |
API Key / Auth Token（对应 ANTHROPIC_AUTH_TOKEN） | sk-xxxx（你的 byesu 令牌） |
| 主模型 / Opus | claude-opus-4-8 |
| Sonnet | claude-opus-4-8（或其他可用模型） |
| Haiku | 可留默认或选轻量模型 |
模型名要用 byesu 真实可用的
比如 claude-opus-4-8。Claude Code 的 Opus/Sonnet/Haiku 三档都可以指向 byesu 上的同一个或不同模型，确保你的令牌所属分组支持该模型即可。
保存后，在供应商列表里点一下这条 byesu，CC Switch 会把它写入 Claude Code 的配置（环境变量 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN）。
第 3 步：验证是否生效
- 在 CC Switch 里把当前供应商切换到
byesu。 - 新开一个终端，运行 Claude Code：
claude- 随便问一句，例如「你好，报一下你用的模型」。能正常回复、且不报鉴权错误，就说明已经接通 byesu。
如果之前开着 Claude Code，切换供应商后请重启终端再运行，让新的环境变量生效。
卡住了？
- 报 401 / 鉴权失败：令牌填错或带了多余空格；确认 key 形如
sk-xxxx。见 常见错误 #auth。 - 提示无可用渠道 / no channel：当前令牌分组里没有这个模型。换个支持该模型的分组，或改用分组内的模型。见 选择分组 与 常见错误 #no-channel。
- 额度不足 / balance：令牌额度或账户余额不够。见 常见错误 #balance。
- 切了供应商没生效：环境变量在已开的终端里不会自动刷新，重启终端后重试。
更多排查见 常见错误。