Skip to content

Agentsflare Kilo CLI 配置方案

Kilo CLI 是 Kilo Code 推出的终端 coding agent。它是 OpenCode 的 fork,支持相同的配置选项,可切换使用数百种 LLM。

安装配置 Kilo CLI

安装 Kilo CLI

使用 npm 安装:

bash
npm install -g @kilocode/cli

验证安装:

bash
kilo --version

升级:

bash
kilo upgrade

老 CPU(无 AVX 指令集)

在不支持 AVX 的老 CPU 上 CLI 可能因 "Illegal instruction" 崩溃,请从 Kilo Releases 下载对应平台的 -baseline 版本。

配置 Kilo CLI

Kilo CLI 的全局配置文件为 ~/.config/kilo/kilo.json(项目级 ./kilo.json 优先级更高)。编辑全局配置文件,添加以下内容:

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 环境变量:

bash
export AGENTSFLARE_API_KEY="你的 Agentsflare API Key"

重启终端使配置生效,运行 kilo 启动 TUI,选择 agentsflare 下的模型即可使用。

如需添加更多模型,在配置文件的 provider.agentsflare.models 下注册即可,模型 ID 见 模型支持列表

交互式配置

也可以通过交互方式添加 provider 凭据:

  1. 运行 kilo,使用 /connect 命令添加 provider 凭据。
  2. 或使用 kilo auth 命令管理 AI provider 与凭据。
  3. 使用 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)。

相关文档

本文档遵循 CC BY-SA 4.0 协议。