推荐安装
一条命令安装 FlyHub CLI，并写入配置文件与环境变量（安装 Kimi Code CLI、写入 ~/.kimi-code/config.toml 与 KIMI_MODEL_* 环境变量）。将 Key 换成控制台里的密钥即可。
# 一键安装 CLI 并写入配置（将 Key 替换为控制台密钥）
curl -fsSL https://flyhub.com.cn/install.sh | bash -s -- --setup kimi --key <FLYHUB_API_KEY>
export PATH="$HOME/.flyhub/bin:$PATH"若已安装过 CLI，可只执行 flyhub setup kimi --key <FLYHUB_API_KEY>。已设置 FLYHUB_API_KEY 时可省略 --key。更多工具：flyhub setup list
手动安装
1. 安装 Kimi Code CLI
请先在 FlyHub 控制台创建 API Key。
推荐使用官方安装脚本（无需 Node.js）：
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bashWindows 首次运行前需安装 Git for Windows。也可使用 npm：Node.js 22.19+ 后运行 npm install -g @moonshot-ai/kimi-code
npm install -g @moonshot-ai/kimi-code2. 连接 FlyHub
推荐安装会写入 ~/.kimi-code/config.toml（Windows 为 %USERPROFILE%\.kimi-code\config.toml）。长期使用请改这个文件；下面环境变量只适合临时切换。
只要设置了 KIMI_MODEL_NAME，Kimi Code 就会忽略 config.toml 里的 default_model。一键安装后若改了 toml 仍显示旧模型，先删掉用户级 KIMI_MODEL_*，再新开终端。
2.1 修改 config.toml
打开或新建 .kimi-code/config.toml，保存为该文件名（不要停在编辑器里未保存的「新建」标签）。 只改或新增 default_model、[providers.flyhub] 与 [models."flyhub/<id>"]，保留文件里其他 provider 和模型。将 <FLYHUB_API_KEY> 换成控制台密钥。发给网关的 model 必须是货架 ID（如 kimi-k3、gpt-5.6-sol），不要写成 flyhub/gpt-5.6-sol。
default_model = "kimi-k3"
[providers.flyhub]
type = "openai"
base_url = "https://api.flyhub.com.cn/v1"
api_key = "<FLYHUB_API_KEY>"
[models."kimi-k3"]
provider = "flyhub"
model = "kimi-k3"
max_context_size = 1048576
capabilities = ["thinking", "image_in", "tool_use"]
display_name = "Kimi K3 (FlyHub)"- 换模型时同时改
default_model、表格名[models."…"]和其中的model，三处保持同一个货架 ID - 把
display_name改成对应的模型名；留成 Kimi K3 会让选择器显示错名字 - 模型 ID 用下面的上架表，不要加 flyhub/ 前缀
- 保存后完全退出 kimi，再开新终端运行 kimi
常用对话模型（完整清单以 GET /v1/catalog/models 为准；生图/生视频/音频/向量走各自模型详情页）：
厂商
模型 ID
厂商
模型 ID
厂商
模型 ID
厂商
模型 ID
kimi-k3厂商
模型 ID
厂商
模型 ID
2.2 环境变量（会覆盖 config.toml）
仅当前会话或临时测试时使用。将 <FLYHUB_API_KEY> 替换为 FlyHub Key：
macOS / Linux：
SHELL_RC="$HOME/.zshrc"; case "$SHELL" in *bash*) SHELL_RC="$HOME/.bashrc";; esac
cat >> "$SHELL_RC" <<'EOF'
export KIMI_MODEL_NAME=kimi-k3
export KIMI_MODEL_PROVIDER_TYPE=openai
export KIMI_MODEL_API_KEY=<FLYHUB_API_KEY>
export KIMI_MODEL_BASE_URL=https://api.flyhub.com.cn/v1
export KIMI_MODEL_MAX_CONTEXT_SIZE=1048576
EOF
source "$SHELL_RC"Windows PowerShell（当前会话）：
$env:KIMI_MODEL_NAME = "kimi-k3"
$env:KIMI_MODEL_PROVIDER_TYPE = "openai"
$env:KIMI_MODEL_API_KEY = "<FLYHUB_API_KEY>"
$env:KIMI_MODEL_BASE_URL = "https://api.flyhub.com.cn/v1"
$env:KIMI_MODEL_MAX_CONTEXT_SIZE = "1048576"模型 ID 请以 GET /v1/models 为准；若 FlyHub 未上架 kimi-k3，请改用已上架的 OpenAI 兼容模型 ID。
3. 启动 Kimi Code
配置完成后运行：
kimi4. 故障排查
启动后仍显示 kimi-k3，但 toml 已改成其他模型：用户环境变量 KIMI_MODEL_NAME 会覆盖 config.toml。Windows 可执行：
foreach ($n in @(
"KIMI_MODEL_NAME",
"KIMI_MODEL_PROVIDER_TYPE",
"KIMI_MODEL_API_KEY",
"KIMI_MODEL_BASE_URL",
"KIMI_MODEL_MAX_CONTEXT_SIZE"
)) {
[Environment]::SetEnvironmentVariable($n, $null, "User")
Remove-Item "Env:$n" -ErrorAction SilentlyContinue
}删完后必须新开终端再运行 kimi。环境变量窗口里找不到该变量，说明已经删掉，不要再新建 kimi-k3。
返回 400 product not found：发给 FlyHub 的 model 必须是货架 ID（如 gpt-5.6-sol），不要用 flyhub/gpt-5.6-sol。
API 返回 401 或 invalid_bearer_token：确认 Key 完整、无多余空格、未被删除。若仍失败，请在控制台重新创建 Key 并重试。
模型不可用：先调用 GET /v1/models 获取实时列表，核对模型 ID 拼写。
准备好了？登录控制台 · 充值 · 创建 API Key