Agentsflare Kilo CLI 配置方案
Kilo CLI 是 Kilo Code 推出的终端 coding agent。它是 OpenCode 的 fork,支持相同的配置选项,可切换使用数百种 LLM。
安装配置 Kilo CLI
安装 Kilo CLI
使用 npm 安装:
npm install -g @kilocode/cli验证安装:
kilo --version升级:
kilo upgrade老 CPU(无 AVX 指令集)
在不支持 AVX 的老 CPU 上 CLI 可能因 "Illegal instruction" 崩溃,请从 Kilo Releases 下载对应平台的 -baseline 版本。
配置 Kilo CLI
Kilo CLI 的全局配置文件为 ~/.config/kilo/kilo.json(项目级 ./kilo.json 优先级更高)。编辑全局配置文件,添加以下内容:
{
"$schema": "https://app.kilo.ai/config.json",
"provider": {
"agentsflare": {
"npm": "@ai-sdk/openai-compatible",
"name": "agentsflare",
"options": {
"baseURL": "https://api.agentsflare.com/v1",
"apiKey": "{env:AGENTSFLARE_API_KEY}"
},
"models": {
"claude-sonnet-5": {
"name": "Claude Sonnet 5",
"limit": {
"context": 200000,
"output": 64000
},
"modalities": {
"input": ["text", "image"],
"output": ["text"]
}
},
"claude-opus-5": {
"name": "Claude Opus 5",
"limit": {
"context": 200000,
"output": 32000
},
"modalities": {
"input": ["text", "image"],
"output": ["text"]
}
},
"claude-haiku-4-5-20251001": {
"name": "Claude Haiku 4.5",
"limit": {
"context": 200000,
"output": 64000
},
"modalities": {
"input": ["text", "image"],
"output": ["text"]
}
}
}
}
},
"model": "agentsflare/claude-sonnet-5"
}然后在 shell 配置文件(~/.bashrc、~/.zshrc 等)中设置 API Key 环境变量:
export AGENTSFLARE_API_KEY="你的 Agentsflare API Key"重启终端使配置生效,运行 kilo 启动 TUI,选择 agentsflare 下的模型即可使用。
如需添加更多模型,在配置文件的 provider.agentsflare.models 下注册即可,模型 ID 见 模型支持列表。
交互式配置
也可以通过交互方式添加 provider 凭据:
- 运行
kilo,使用/connect命令添加 provider 凭据。 - 或使用
kilo auth命令管理 AI provider 与凭据。 - 使用
kilo models agentsflare查看已配置 provider 下的可用模型。
常见问题
{env:AGENTSFLARE_API_KEY} 被忽略并出现警告
{env:VAR} 引用只在受信任的配置中生效:全局配置(~/.config/kilo/)或通过 KILO_CONFIG / KILO_CONFIG_CONTENT 传入的配置。提交到仓库的项目级 kilo.json 无法使用 {env:VAR}——请把 API Key 引用放在全局配置中,或在项目配置中直接写 Key。
如何切换模型
默认模型使用 provider_id/model_id 格式(例如 "model": "agentsflare/claude-opus-5"),也可以在 TUI 内直接切换模型。
从 OpenCode 迁移?
Kilo CLI 1.0 不再读取 ~/.config/opencode 或 ./.opencode/ 下的配置。请将全局配置迁移到 ~/.config/kilo/,项目配置迁移到 ./.kilo/(或 ./kilo.json)。
