推荐安装
一条命令安装 FlyHub CLI，并写入配置文件与环境变量（合并写入 ~/.workbuddy/models.json）。将 Key 换成控制台里的密钥即可。
# 一键安装 CLI 并写入配置（将 Key 替换为控制台密钥）
curl -fsSL https://flyhub.com.cn/install.sh | bash -s -- --setup workbuddy --key <FLYHUB_API_KEY>
export PATH="$HOME/.flyhub/bin:$PATH"若已安装过 CLI，可只执行 flyhub setup workbuddy --key <FLYHUB_API_KEY>。已设置 FLYHUB_API_KEY 时可省略 --key。更多工具：flyhub setup list
手动安装
1. 写入 models.json
请先在 FlyHub 控制台创建 API Key。
WorkBuddy 的自定义模型写在 ~/.workbuddy/models.json（Windows 为 %USERPROFILE%\.workbuddy\models.json）。页顶命令会按模型 ID 合并进这个文件，并保留你已有的其他模型。保存后客户端会自动加载，一般不用重启。
不要设置 CODEBUDDY_BASE_URL。WorkBuddy 会在该地址后面追加 /v2，那是私有协议，接到 FlyHub 会 404。
还没有这个文件时，可以新建并写入下面这一份。把 <FLYHUB_API_KEY> 换成控制台 Key。要加更多模型，就按同一结构再放一条，并把 id 写进 availableModels，否则选择器里不会出现。
{
"models": [
{
"id": "claude-sonnet-5",
"name": "claude-sonnet-5",
"vendor": "FlyHub",
"url": "https://api.flyhub.com.cn/v1",
"apiKey": "<FLYHUB_API_KEY>",
"useCustomProtocol": false,
"supportsToolCall": true,
"supportsImages": true,
"supportsReasoning": true
}
],
"availableModels": ["claude-sonnet-5"]
}常用对话模型（完整清单以 GET /v1/catalog/models 为准；生图/生视频/音频/向量走各自模型详情页）：
厂商
模型 ID
厂商
模型 ID
厂商
模型 ID
厂商
模型 ID
kimi-k3厂商
模型 ID
厂商
模型 ID
- 接口地址只写
https://api.flyhub.com.cn/v1。不要写成 /chat/completions，客户端会自己补上 - 文件里已有同名 id 时，只替换这一条，不要整份覆盖
- 工具调用字段名是
supportsToolCall - 当前项目里如果有
.workbuddy/models.json，会盖过用户目录里的这一份，排障时先看项目目录
2. 在设置里添加
- 打开 WorkBuddy → 左下角账户图标 → Settings → Models
- Add model → Provider 选择 Custom
- Endpoint：
https://api.flyhub.com.cn/v1 - API Key：粘贴 FlyHub Key
- 模型 ID 用上一节的表，其余选项保持默认 → Save
保存后在模型列表里选择刚添加的模型 ID。name 要和 id 相同，不要写成「展示名 (FlyHub):id」，选择器会把两段叠在一起。
3. 从零安装
从 WorkBuddy 官网 下载安装。Windows 需要 10 及以上，macOS 需要 12 及以上。装好后用页顶命令写入配置，或按前面两节手动添加。
4. 故障排查
API 返回 401 或 invalid_bearer_token：确认 Key 完整、无多余空格、未被删除。若仍失败，请在控制台重新创建 Key 并重试。
模型不可用：先调用 GET /v1/models 获取实时列表，核对模型 ID 拼写。
请求打到 /v2 并返回 404：本机设置了 CODEBUDDY_BASE_URL。去掉这个变量，改用 flyhub setup workbuddy 或上面的 models.json。
设置里看不到模型：models 里有 id，还要写进 availableModels。项目目录下的 .workbuddy/models.json 会盖过用户目录里的文件。
flyhub setup workbuddy 提示 unknown target：本机 CLI 还是旧版。重新安装 CLI，或直接改 models.json。
准备好了？登录控制台 · 充值 · 创建 API Key