接入 FlyHub · Claude 桌面客户端

1. 安装 Claude Desktop 与 CC Switch

Claude 模型请使用 Anthropic 原生协议（/v1/messages）。请先在 FlyHub 控制台创建 API Key。

Claude Desktop 的第三方推理（3P）是 Anthropic 官方支持的部署模式，CC Switch 只是帮你把 3P 配置写进客户端，不用手动改配置文件、也不用登录 Anthropic 账号。

• 从 Claude 官网下载安装 Claude Desktop（macOS 也可 brew install --cask claude）
• 安装 CC Switch 3.15.0 或更高版本：brew install --cask cc-switch，或从 GitHub Releases 下载对应系统安装包
• macOS 若被 Gatekeeper 拦截，请在系统设置 → 隐私与安全性 中允许运行

CC Switch 4.x 的 Claude Desktop 入口在左侧边栏（3.15–3.16 是顶部标签页），功能一致。

2. 通过 CC Switch 连接 FlyHub

CC Switch 未内置 FlyHub 预设时，请手动添加自定义提供商：

• 打开 CC Switch 的 Claude Desktop 页（4.x 左侧边栏 / 3.x 顶部标签页）
• 点右上角「+」→ 选「自定义配置」（Custom）
• 提供商名称：FlyHub
• API Base URL：https://api.flyhub.com.cn（不含 /v1，Desktop 会自己拼 /v1/messages）
• API Key：粘贴 FlyHub 控制台 Key（将 <FLYHUB_API_KEY> 替换为实际密钥）
• 保持「需要模型映射（Needs model mapping）」关闭：FlyHub 提供的 claude-* 模型 ID 能被 Desktop 直接识别
• 保存（Add）后，在提供商卡片上点 Enable 启用

CC Switch 写入的是 Claude Desktop 的 3P 推理配置（inferenceProvider=gateway + Base URL + Key），不是 claude_desktop_config.json 里的 MCP 配置。只有选「模型映射」模式时才需要 CC Switch 常驻运行（本地路由 127.0.0.1:15721）；直连模式不用。

Claude Code CLI 与 Codex 也可在 CC Switch 对应页面添加 FlyHub，步骤类似。

不装 CC Switch 也行：Claude Desktop 自带官方 3P 配置入口——Help → Troubleshooting → Enable Developer Mode，重启后在 Developer → Configure Third-Party Inference 里填同样的 Base URL 和 Key，效果一致（适合 Linux 用户）。

3. 启动 Claude Desktop

3P 配置只在启动时读取：请完全退出 Claude Desktop（macOS Cmd+Q，Windows 需从托盘退出）再重新打开，关窗口不等于退出。

启动后不应出现 Anthropic 登录页；在模型菜单里选 FlyHub 下的 claude-sonnet-5、claude-opus-5 等模型即可对话。连接成功后可在 FlyHub 控制台查看各次请求的用量。

4. 故障排查

答非所问 / 模型说「没收到消息」：在模型菜单里改用 claude-opus-5 或 claude-haiku-4-5。sonnet 系列（claude-sonnet-5 / 5-5 / 4-6）和 claude-fable-5-1 经该网关会丢正文（实测约 40% 概率），与 Desktop 配置无关。

模型菜单为空或只有默认模型：Desktop 只认 claude-sonnet-* / claude-opus-* / claude-haiku-* 这类角色族 ID。先确认 Key 能拿到列表（GET /v1/models，FlyHub 会返回 claude-opus-5、claude-sonnet-5、claude-haiku-4-5 等）；若仍为空，在 CC Switch 里改用「模型映射」模式，并保持 CC Switch 运行。

401 错误：Base URL 不要带 /v1；确认 Key 完整、无多余空格；改完必须完全退出并重开 Claude Desktop。

想恢复 Anthropic 官方登录：在 CC Switch 里选「Claude Desktop Official」并点 Enable，再完全退出重开。CC Switch 的直连配置会隐藏 claude.ai 登录入口，这是预期行为。

Linux 目前不支持：CC Switch 只对 macOS / Windows 写入 Claude Desktop 的 3P 配置。Linux 用户改用 Desktop 自带的 Developer → Configure Third-Party Inference 手动配置（见上一节的第二种方式），或直接用 Claude Code CLI 接入。

Windows 若提示 Virtual Machine Platform not available：按 Win+R 输入 optionalfeatures，勾选「虚拟机平台」，重启电脑后再打开 Claude Desktop。