接入 FlyHub · CC Switch

1. 安装 CC Switch

请先在 FlyHub 控制台创建 API Key。

或从 CC Switch GitHub Releases 下载：macOS .dmg/.zip、Windows .msi/.zip、Linux .deb/.rpm/.AppImage。需 3.15.0 或更高版本（Claude Desktop 支持从 3.15.0 开始）。

4.x 各工具的入口在左侧边栏，3.15–3.16 是顶部标签页，功能一致。

2. 连接 Claude Code

• 打开 CC Switch → Claude Code 标签页 → 点击右上角「+」
• 添加自定义提供商：名称 FlyHub
• Anthropic Base URL：https://api.flyhub.com.cn
• API Key：FlyHub 控制台 Key
• 保存后在主页点击 Enable 启用
• 重新打开终端，运行 claude

Claude Code 从零安装参见 Claude Code 命令行接入页。

3. 连接 Claude Desktop

• 打开 CC Switch 的 Claude Desktop 页（4.x 左侧边栏 / 3.x 顶部标签页）
• 点「+」→ 选「自定义配置」（Custom），不要选模型映射预设
• API Base URL：https://api.flyhub.com.cn（不含 /v1）
• API Key：粘贴 FlyHub 控制台 Key
• 保持「需要模型映射（Needs model mapping）」关闭：FlyHub 的 claude-* 模型 ID 能被 Desktop 直接识别
• 保存后在卡片上点 Enable，然后完全退出并重开 Claude Desktop（3P 配置只在启动时读取）

CC Switch 写的是 Claude Desktop 的官方 3P 推理配置，不是 claude_desktop_config.json 的 MCP；想回官方登录时选「Claude Desktop Official」再 Enable。Linux 目前不支持写入。

4. 连接 Codex

• CC Switch → Codex 标签页 → Add provider
• Provider 名称 FlyHub，OpenAI Base URL https://api.flyhub.com.cn/v1
• 粘贴 API Key 并保存，启用后重启 Codex 进程

Codex 详细 config.toml 配置参见 Codex 客户端 / Codex CLI 接入页。

5. 故障排查

API 返回 401 或 invalid_bearer_token：确认 Key 完整、无多余空格、未被删除。若仍失败，请在控制台重新创建 Key 并重试。

模型不可用：先调用 GET /v1/models 获取实时列表，核对模型 ID 拼写。