1. 安装 Claude Desktop 与 CC Switch
Claude 模型请使用 Anthropic 原生协议。请先在 FlyHub 控制台创建 API Key。
若已安装 Claude Desktop 与 CC Switch,可跳过本节。
- 从 Claude 官网下载并安装 Claude Desktop(macOS 可用 brew install --cask claude)
- 安装 CC Switch 3.16.5 或更高版本:brew install --cask cc-switch,或从 GitHub Releases 下载
- macOS 若被 Gatekeeper 拦截,请在系统设置 → 隐私与安全性 中允许运行
2. 通过 CC Switch 连接 FlyHub
CC Switch 未内置 FlyHub 预设时,请手动添加自定义提供商:
- 打开 CC Switch,切换到 Claude Desktop 标签页
- 点击右上角橙色「+」添加提供商
- 提供商名称:
FlyHub - Anthropic API Base URL:
https://api.flyhub.cn(不含 /v1) - API Key:粘贴 FlyHub 控制台 Key(将 <FLYHUB_API_KEY> 替换为实际密钥)
- 保存后,在主页启用 FlyHub 提供商
Claude Code CLI 与 Codex 也可在 CC Switch 对应标签页中添加 FlyHub,步骤类似。
3. 启动 Claude Desktop
若 Claude Desktop 已在运行,请完全退出后重新打开,以加载 CC Switch 写入的新配置。
连接成功后,可在 FlyHub 控制台查看各次请求的用量。
4. 故障排查
Windows 若提示 Virtual Machine Platform not available:按 Win+R 输入 optionalfeatures,勾选「虚拟机平台」,重启电脑后再打开 Claude Desktop。
401 错误:确认 CC Switch 中 API Key 正确,且 Base URL 为 Anthropic 格式(不含 /v1)。
准备好了?登录控制台 · 充值 · 创建 API Key