🚀 Kilo Code CLI 接入火山方舟 Coding Plan（Windows 完全指南）
适用场景 ：在 Windows 终端（CMD / PowerShell / WSL）下使用 Kilo Code CLI，并希望调用火山方舟 Coding Plan 套餐内的多种模型（如 DeepSeek V4、GLM-5.2、Kimi K2.7 等），同时消耗套餐额度，避免产生额外费用。
📌 目录
- 准备工作
- [安装 Kilo Code CLI（Windows）](#安装 Kilo Code CLI（Windows）)
- 定位配置文件
- 编辑配置文件（核心）
- 验证接入是否成功
- 常用命令与模型切换
- 注意事项与避坑指南
1. 准备工作
在开始配置前，请确保你已经完成以下两步（必须）：
-
订阅火山方舟 Coding Plan
访问火山引擎方舟控制台，找到"Coding Plan"活动页面，根据你的需求订阅对应套餐（免费试用或付费包）。
-
获取专属 API Key
在方舟控制台 → API Key 管理 中，新建 一个 API Key，并复制保存 （建议保存到记事本，后续使用）。
⚠️ 注意：请使用 Coding Plan 专属的 API Key，不要误用其他项目的 Key。
2. 安装 Kilo Code CLI（Windows）
如果你尚未安装 Kilo Code CLI，请按以下步骤操作：
-
使用 npm 全局安装 （需要 Node.js 环境）
打开 CMD 或 PowerShell，执行：
bashnpm install -g @kilocode/cli -
验证安装
bashkilo --version如果正常显示版本号，说明安装成功。
💡 替代方案：你也可以从 GitHub Releases 下载 Windows 可执行文件（.exe），将其所在目录添加到系统 PATH 环境变量中。
如果失败的话，可以清理一下npm缓存
bash
npm uninstall -g @kilocode/cli
npm cache clean --force
npm install -g @kilocode/cli3. 定位配置文件
Kilo Code CLI 在 Windows 上的配置文件路径为：
C:\Users\<你的用户名>\.config\kilo\config.json例如，如果你的用户名是 zhangsan，则路径为：
C:\Users\zhangsan\.config\kilo\config.json📁 如果
kilo文件夹或config.json不存在，请先手动创建该目录和文件。
4. 编辑配置文件（核心）
用任意文本编辑器（如 VSCode、Notepad++、记事本）打开 config.json，将以下完整配置 粘贴进去，并替换 apiKey 字段中的 <ARK_API_KEY> 为你自己保存的 API Key。
json
{
"$schema": "https://kilo.ai/config.json",
"provider": {
"volcengine-plan": {
"npm": "@ai-sdk/openai-compatible",
"name": "Volcano Engine",
"options": {
"baseURL": "https://ark.cn-beijing.volces.com/api/coding/v3",
"apiKey": "你的API Key（替换这里）"
},
"models": {
"glm-5.2": {
"name": "glm-5.2",
"limit": {
"context": 1024000,
"output": 32768
},
"modalities": {
"input": ["text"],
"output": ["text"]
}
},
"deepseek-v4-flash": {
"name": "deepseek-v4-flash",
"limit": {
"context": 1024000,
"output": 32768
}
},
"deepseek-v4-pro": {
"name": "deepseek-v4-pro",
"limit": {
"context": 1024000,
"output": 32768
}
},
"minimax-m3": {
"name": "minimax-m3",
"limit": {
"context": 512000,
"output": 4096
},
"modalities": {
"input": ["text", "image"],
"output": ["text"]
}
},
"kimi-k2.6": {
"name": "kimi-k2.6",
"limit": {
"context": 256000,
"output": 4096
},
"modalities": {
"input": ["text", "image"],
"output": ["text"]
}
},
"kimi-k2.7-code": {
"name": "kimi-k2.7-code",
"limit": {
"context": 256000,
"output": 4096
},
"modalities": {
"input": ["text"],
"output": ["text"]
}
}
}
}
}
}📝 配置参数说明（重要）
| 字段 | 说明 |
|---|---|
baseURL |
必须使用 https://ark.cn-beijing.volces.com/api/coding/v3，这是 Coding Plan 的专属网关，确保费用从套餐扣除。 |
apiKey |
你的 Coding Plan API Key，务必替换。 |
npm |
使用了 @ai-sdk/openai-compatible，表示兼容 OpenAI 接口，无需额外安装 SDK。 |
models |
列出了 6 种可用模型，每个模型都有 name（实际调用名）和 limit（上下文/输出长度限制），部分模型支持图像输入。 |
✅ 你可以根据需要增删 模型，但请确保
name与火山方舟提供的模型名完全一致（如deepseek-v4-flash、glm-5.2等）。
5. 验证接入是否成功
保存配置文件后，在终端执行：
bash
kilo进入交互式 CLI 后，输入以下命令查看已配置的模型列表：
bash
/models如果输出中出现了 volcengine-plan 分组，并列出你配置的所有模型（如 deepseek-v4-flash），说明接入成功！
你还可以执行 /status 查看当前默认模型和连接状态。
6. 常用命令与模型切换
-
切换默认模型
在 Kilo 会话中，使用
/model <模型名称>切换当前使用的模型，例如：/model deepseek-v4-pro -
开始对话
直接输入你的问题，Kilo 会使用当前模型回复。
-
查看用量 （如有）
部分套餐支持查看 Token 消耗，可执行
/usage（视版本而定）。
7. 注意事项与避坑指南
⚠️ 务必使用正确的 Base URL
- 正确 ：
https://ark.cn-beijing.volces.com/api/coding/v3（走套餐） - 错误 ：
https://ark.cn-beijing.volces.com/api/v3（走通用计费，不扣套餐额度，会产生额外费用）
⚠️ API Key 权限
确保你使用的 API Key 是在 Coding Plan 下生成的，如果混用其他项目的 Key，可能导致认证失败或计费错误。
⚠️ 模型名称大小写敏感
配置中的 name 字段（如 deepseek-v4-flash）必须与火山方舟控制台展示的名称完全一致，包括大小写和连字符。
⚠️ 网络与防火墙
如果企业网络有代理限制，你可能需要设置 HTTP_PROXY 环境变量，否则 Kilo 可能无法连接方舟网关。
⚠️ 配置文件语法
JSON 格式不允许有注释，请确保你粘贴的配置是纯 JSON（本教程的配置不含注释，可直接使用）。
🎯 结语
至此，你已经成功在 Windows 上将 Kilo Code CLI 接入火山方舟 Coding Plan。你可以享受多模型切换、代码辅助、对话编程等强大功能，同时充分利用你的套餐额度，无需担心费用超支。
如果在配置过程中遇到任何问题，欢迎在评论区留言，我会尽力解答。Happy Coding！🚀
📢 本文首发于 CSDN，转载请注明出处。
如果你觉得本文有帮助，请点赞、收藏、转发，让更多开发者受益！