推荐安装
一条命令安装 FlyHub CLI，并写入配置文件与环境变量（安装 dsh、写入 ~/.dsh 配置与 FLYHUB_API_KEY）。将 Key 换成控制台里的密钥即可。
# 一键安装 CLI 并写入配置（将 Key 替换为控制台密钥）
curl -fsSL https://flyhub.com.cn/install.sh | bash -s -- --setup deepseek-harness --key <FLYHUB_API_KEY>
export PATH="$HOME/.flyhub/bin:$PATH"若已安装过 CLI，可只执行 flyhub setup deepseek-harness --key <FLYHUB_API_KEY>。已设置 FLYHUB_API_KEY 时可省略 --key。更多工具：flyhub setup list
手动安装
1. 准备工作
开始前请在 FlyHub 控制台准备有效的 API Key（sk- 开头）。使用 dsh 命令行版才需要 Node.js；DSH 桌面版自带运行环境，无需额外安装。
Harness 走 OpenAI 兼容协议，下面这些模型都可以写入配置。默认会话用 deepseek-v4-pro。
常用对话模型（完整清单以 GET /v1/catalog/models 为准；生图/生视频/音频/向量走各自模型详情页）：
厂商
模型 ID
厂商
模型 ID
厂商
模型 ID
厂商
模型 ID
kimi-k3厂商
模型 ID
厂商
模型 ID
1.1 安装 Node.js 24（命令行版需要）
只用 DSH 桌面版的话可跳过本节。命令行版需要 Node.js 24（自带 npm）。安装后重新打开终端并检查版本：
node --version
npm --versionnode --version 输出应以 v24. 开头。
2. 一键配置并启动
把下方命令中的 API Key 替换为你的 FlyHub Key（sk- 开头，不要带尖括号），复制整段到终端执行。脚本会写好 ~/.dsh 配置与 Key，再确保 dsh 可用（已装则跳过，桌面版无需 npm）。
curl -fsSL https://flyhub.com.cn/install.sh | bash -s -- --setup deepseek-harness --key <FLYHUB_API_KEY>同一台机器可以反复重跑这条命令：配置会先备份再合并，只更新 FlyHub 自己的部分；货架上新模型后重跑即可带上。
dsh web启动后终端会显示本地地址（通常为 http://127.0.0.1:3080）。在指定项目目录中使用时，请先 cd 到项目目录再运行 dsh web。
3. 验证连接
dsh web在打开的界面里随便问一句，能正常回答说明 Harness 已通过 FlyHub 调用模型。若提示找不到 dsh 命令，新开一个终端再试。
4. 添加与切换模型
在 ~/.dsh/settings.yaml 里，agent-default-model.model 是新会话的默认模型。models 列表与上表同一批上架 ID：
llm-pi-ai:
providers:
flyhub:
displayName: FlyHub
apiKeyEnv: FLYHUB_API_KEY
api: openai-completions
baseURL: https://api.flyhub.com.cn/v1
models:
- id: gpt-5.6-luna
name: GPT-5.6 Luna
- id: gpt-5.6-sol
name: GPT-5.6 Sol
- id: gpt-5.6-terra
name: GPT-5.6 Terra
- id: claude-opus-5
name: Claude Opus 5
- id: claude-sonnet-5
name: Claude Sonnet 5
- id: claude-fable-5-1
name: Claude Fable 5.1
- id: claude-haiku-4-5
name: Claude Haiku 4.5
- id: gemini-3.1-pro
name: Gemini 3.1 Pro
- id: gemini-3.7-flash
name: Gemini 3.7 Flash
- id: kimi-k3
name: Kimi K3
- id: glm-5.3
name: GLM-5.3
- id: glm-5.3-flash
name: GLM-5.3 Flash
- id: deepseek-v4-pro
name: DeepSeek V4 Pro
- id: deepseek-v4-flash
name: DeepSeek V4.1 Flash
agent-default-model:
provider: flyhub
model: deepseek-v4-pro实时模型列表请调用 GET /v1/models。FlyHub 模型目录会持续更新，请以接口返回为准。
5. 故障排查
安装后提示找不到 dsh：npm install -g 不会刷新当前窗口的 PATH。推荐用一键安装（会写入 FlyHub bin 下的 dsh 入口）。若仍找不到，Windows 把 %APPDATA%\npm 加入 Path，macOS / Linux 把 $(npm prefix -g)/bin 加入 PATH，或新开终端。
401 / invalid_bearer_token：确认 Key 完整、无空格、未被删除。仍失败请在控制台轮换 Key 后重试。
准备好了？登录控制台 · 充值 · 创建 API Key