Kilo Code API Key 配置
Kilo Code API Key 怎么填:kilo.json 配置
把下面这段贴进 kilo.json,换上你自己的 API Key,Kilo Code 就能用 Claude、GPT 模型了,按量付费。
{
"$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。复制并在终端执行一次,写入这个工具实测过的配置位置;换终端也还在。
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 的写法还没实测,暂不列出。
还没装 Kilo Code?先安装(装过可跳过)
运行
npm i -g @kilocode/cli,再运行kilo --version,打印出版本号就装好了。安装 Kilo Code CLI:npm i -g @kilocode/cli,然后 kilo --version 输出 7.8.8,说明安装成功 把配置贴进 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-***) 新开终端,测试 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 即配置好 没看到 OK?对着报错找
把终端里的报错和下面的常见报错对一下,每条都写了原因和改法。
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
Key 填错:Error: Unauthorized: 请在请求中提供有效的 API Key。
出现什么
Error: Unauthorized: 请在请求中提供有效的 API Key。
- 原因
- apiKey 填错了,报错和没设 Key 一样
- 怎么改
- 从控制台重新复制 Key,替换 apiKey 引号里的内容
Error: Model not found
出现什么
Error: Model not found
- 原因
- -m 后面的模型名不在 kilo.json 的 models 里(例如 aicodewith/no-such-model),Kilo Code 自己就报错了
- 怎么改
- 改成 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 没写或写错了,改法见上面的常见报错。