Kilo Code API Key 配置

Kilo Code API Key 怎么填:kilo.json 配置

把下面这段贴进 kilo.json,换上你自己的 API Key,Kilo Code 就能用 Claude、GPT 模型了,按量付费。

~/.config/kilo/kilo.jsonjson
config
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicodewith/claude-haiku-4-5-20251001",
  "provider": {
    "aicodewith": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI Code With",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "sk-***"
      },
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}

配置步骤

一键长期设置 Key

登录后会填入你本人的 Key。复制并在终端执行一次,写入这个工具实测过的配置位置;换终端也还在。

bash
mkdir -p "$(dirname "$HOME/.config/kilo/kilo.json")"
cat > "$HOME/.config/kilo/kilo.json" << 'EOF'
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicodewith/claude-haiku-4-5-20251001",
  "provider": {
    "aicodewith": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI Code With",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "sk-***"
      },
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}
EOF

没登录时只显示占位符。登录后会自动填你的 Key。 去控制台取 Key

复制成功只表示命令已复制到剪贴板。还要在终端执行,或把 Key 贴进工具设置。 获取 API Key 教程

以下步骤在 Linux(bash)实测。macOS 和 Windows 的写法还没实测,暂不列出。

  1. 还没装 Kilo Code?先安装(装过可跳过)

    运行 npm i -g @kilocode/cli,再运行 kilo --version,打印出版本号就装好了。

    安装 Kilo Code CLI:npm i -g @kilocode/cli,然后 kilo --version 输出 7.8.8,说明安装成功
  2. 把配置贴进 kilo.json,换上你的 API Key

    打开 ~/.config/kilo/kilo.json,贴入页首那段配置,把 sk-*** 换成你的 API Key(获取 API Key)。保存后有 "apiKey": "sk-…" 这一行就对了,新开终端、重启电脑都不用再设。

    把 Key 直接写进 ~/.config/kilo/kilo.json 的 provider.aicodewith.options.apiKey(图中已打码为 sk-***)
  3. 新开终端,测试 Kilo Code

    新开一个终端,运行 kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK",看到 OK 就说明 Kilo Code 能用你的 API Key 了。

    验证:关掉终端、新开一个(不 export 任何变量),运行 kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK",回复 OK 即配置好
  4. 没看到 OK?对着报错找

    把终端里的报错和下面的常见报错对一下,每条都写了原因和改法。

  5. Kilo Code 换模型:-m 后面换名字

    -m 后面写 aicodewith/ 加 kilo.json 里 models 下已有的模型名,例如 aicodewith/gpt-5.5。要加新模型,先在 models 里登记它的 Model ID,见模型与价格。

常见报错

没设 Key:Error: Unauthorized: 请在请求中提供有效的 API Key。

出现什么

Error: Unauthorized: 请在请求中提供有效的 API Key。
原因
kilo.json 里 apiKey 写的是 {env:AICODEWITH_API_KEY},新开的终端里没有这个变量
怎么改
按第 2 步把 apiKey 直接写成你的 Key

回到第 2 步:把配置贴进 kilo.json →

没设 Key:apiKey 还是 {env:AICODEWITH_API_KEY},新终端里没有这个变量。运行 kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK",原始报错:Error: Unauthorized: 请在请求中提供有效的 API Key。

Key 填错:Error: Unauthorized: 请在请求中提供有效的 API Key。

出现什么

Error: Unauthorized: 请在请求中提供有效的 API Key。
原因
apiKey 填错了,报错和没设 Key 一样
怎么改
从控制台重新复制 Key,替换 apiKey 引号里的内容

回到第 2 步:把配置贴进 kilo.json →

Key 填错:grep -n sk-wrong ~/.config/kilo/kilo.json 显示第 10 行是 "apiKey": "sk-wrong";运行 kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK",原始报错:Error: Unauthorized: 请在请求中提供有效的 API Key。(和没设 Key 时完全一样)

Error: Model not found

出现什么

Error: Model not found
原因
-m 后面的模型名不在 kilo.json 的 models 里(例如 aicodewith/no-such-model),Kilo Code 自己就报错了
怎么改
改成 models 里已有的模型名,例如 aicodewith/gpt-5.5

回到第 3 步:新开终端,测试 Kilo Code →

常见报错:模型名写错时(这里用 aicodewith/no-such-model),kilo 会返回 Error: Model not found。这是 Kilo 自己报的错(该模型不在 kilo.json 的 models 里),请求没有发出去。改成配置里已有的模型名即可,例如 aicodewith/gpt-5.5

常见问题

Kilo Code 怎么用自己的 API Key?

在 ~/.config/kilo/kilo.json 的 provider 里加一个 aicodewith 提供商,baseURL 填 https://api.aicodewith.ai/v1,apiKey 直接写你的 Key。新开终端也能用。

Kilo Code 的 Base URL 要不要加 /v1?

要,填 https://api.aicodewith.ai/v1。

Kilo Code 的 kilo.json 放在哪里?

全局配置在 ~/.config/kilo/kilo.json。

Kilo Code 提示 Unauthorized 怎么办?

kilo.json 里的 apiKey 没写或写错了,改法见上面的常见报错。

参考来源

相关链接