Kimi Code CLI 接入火山引擎方舟 Agent Plan 配置教程Windows适用环境Windows 10/11 PowerShellKimi Code CLI ≥ 0.41.0目标让kimi命令行通过火山引擎方舟Agent Plan的 OpenAI 兼容接口调用模型1. 背景与原理Kimi Code CLI 支持自定义 OpenAI 兼容的模型平台provider通过~\.kimi-code\config.toml配置。火山方舟 Agent Plan 提供 OpenAI 兼容接口Base URLhttps://ark.cn-beijing.volces.com/api/plan/v3末尾不加斜杠协议OpenAI Chat CompletionsAPI Key必须在火山方舟控制台「开通管理 → Agent Plan」页签生成的专属 Key与方舟在线推理的 Key不通用模型Agent Plan 支持的模型 id如ark-code-latest、kimi-k3等以控制台列表为准⚠️ 注意区分新旧版本新版 Kimi Code CLI → 配置文件~\.kimi-code\config.tomlTOML 格式旧版 kimi-cli → 配置文件~\.kimi\config.yamlYAML 格式两者不通用判断方法运行kimi --version并查看Get-Command kimi的路径。2. 升级/安装 Kimi Code CLI旧版本对第三方 provider 支持不完整建议先升级到最新版0.41.0irmhttps://code.kimi.com/kimi-code/install.ps1|iex验证kimi--versionWindows 原生安装不支持自动更新以后升级都重跑这条命令即可。3. 编辑配置文件备份后打开Copy-Item$HOME\.kimi-code\config.toml$HOME\.kimi-code\config.toml.bak-ErrorAction SilentlyContinue code$HOME\.kimi-code\config.toml完整配置模板default_model ark-plan/kimi-k3 [providers.ark-plan] type openai base_url https://ark.cn-beijing.volces.com/api/plan/v3 api_key 在这里填AgentPlan专属Key [models.ark-plan/ark-code-latest] provider ark-plan model ark-code-latest max_context_size 200000 capabilities [thinking, image_in, tool_use] [models.ark-plan/kimi-k2.7-code] provider ark-plan model kimi-k2.7-code max_context_size 200000 capabilities [thinking, image_in, tool_use] [models.ark-plan/kimi-k3] provider ark-plan model kimi-k3 max_context_size 1000000 capabilities [thinking, image_in, tool_use] [models.ark-plan/doubao-seed-2.0-mini] provider ark-plan model doubao-seed-2.0-mini max_context_size 128000 capabilities [image_in, tool_use]字段说明字段位置说明default_model文件第一行顶层启动时默认使用的模型别名必须与[models....]完全一致[providers.名字]平台段声明一个接入平台名字自定示例用ark-plantype平台段协议类型OpenAI 兼容填openaibase_url平台段接口地址写到/v3为止末尾不加斜杠api_key平台段Agent Plan 专属 Key[models.别名]模型段模型别名建议平台名/模型id便于管理含/必须加引号provider模型段指向的平台名与[providers.xxx]一致model模型段真实模型 id不要带版本号后缀max_context_size模型段上下文长度必填否则报 config.invalidcapabilities模型段能力标记如thinking推理/image_in视觉输入/tool_use4. 验证kimi doctor# 应显示 config.toml validkimi# 启动页 Model 应显示 ark-plan/kimi-k3进入会话后/status # 确认当前平台和模型 /model # 临时切换模型仅当前会话发一条消息测试正常回复即接入成功。5. 日常使用切换平台和模型关键认知/provider界面是「管理平台」不是「切换平台」/provider↑/↓ 浏览、d删除、[ Add New Platform ]回车添加。选中已有平台按回车不会切换。切换模型的三种方式改配置里的default_model永久生效推荐会话内/model临时生效启动时kimi -m ark-plan/kimi-k3单次生效注意-m后只写别名不要跟提示词6. 常见报错对照表报错原因解决Model xxx is not configured... Add a [models.xxx] entry with max_context_size模型段缺失或缺max_context_size检查[models.xxx]段完整性Provider ark-plan ... is not configured平台段字段名错误必须是[providers.ark-plan]type openai不是model_providers/protocol那是其他工具的写法404探测base或base/models走了 registry 探测地址不对Agent Plan 不提供模型列表必须显式写models段且 base_url 写到/v3401 UnauthorizedKey 错误确认用的是 Agent Plan 页签的专属 Key不是在线推理 Key改了配置没反应文件没保存 / 改了旧版.kimi\config.yamlCtrlS 保存确认改的是.kimi-code\config.toml/reload或重启列表里回车没反应误以为/provider可切换用/model或改default_model见第 5 节万能排查三步kimi doctor# 1. 校验配置语法Get-Content$HOME\.kimi-code\config.toml# 2. 看磁盘上的真实内容# 3. 仍不行就删掉手写配置用 /provider → Add New Platform 让 CLI 自己生成再对照字段7. 安全注意事项API Key 不要明文贴到聊天记录、截图或公开仓库贴配置前先打码Key 一旦泄露立即去火山方舟控制台作废重生成配置文件留在本机即可不要同步到网盘/Git8. 参考Kimi Code CLI 官方文档https://www.kimi.com/code/docs/zh-CN/providers火山引擎方舟 Agent Plan控制台「开通管理 → Agent Plan」页签
Kimi Code CLI 接入火山引擎方舟 Agent Plan 配置教程Windows适用环境Windows 10/11 PowerShellKimi Code CLI ≥ 0.41.0目标让kimi命令行通过火山引擎方舟Agent Plan的 OpenAI 兼容接口调用模型1. 背景与原理Kimi Code CLI 支持自定义 OpenAI 兼容的模型平台provider通过~\.kimi-code\config.toml配置。火山方舟 Agent Plan 提供 OpenAI 兼容接口Base URLhttps://ark.cn-beijing.volces.com/api/plan/v3末尾不加斜杠协议OpenAI Chat CompletionsAPI Key必须在火山方舟控制台「开通管理 → Agent Plan」页签生成的专属 Key与方舟在线推理的 Key不通用模型Agent Plan 支持的模型 id如ark-code-latest、kimi-k3等以控制台列表为准⚠️ 注意区分新旧版本新版 Kimi Code CLI → 配置文件~\.kimi-code\config.tomlTOML 格式旧版 kimi-cli → 配置文件~\.kimi\config.yamlYAML 格式两者不通用判断方法运行kimi --version并查看Get-Command kimi的路径。2. 升级/安装 Kimi Code CLI旧版本对第三方 provider 支持不完整建议先升级到最新版0.41.0irmhttps://code.kimi.com/kimi-code/install.ps1|iex验证kimi--versionWindows 原生安装不支持自动更新以后升级都重跑这条命令即可。3. 编辑配置文件备份后打开Copy-Item$HOME\.kimi-code\config.toml$HOME\.kimi-code\config.toml.bak-ErrorAction SilentlyContinue code$HOME\.kimi-code\config.toml完整配置模板default_model ark-plan/kimi-k3 [providers.ark-plan] type openai base_url https://ark.cn-beijing.volces.com/api/plan/v3 api_key 在这里填AgentPlan专属Key [models.ark-plan/ark-code-latest] provider ark-plan model ark-code-latest max_context_size 200000 capabilities [thinking, image_in, tool_use] [models.ark-plan/kimi-k2.7-code] provider ark-plan model kimi-k2.7-code max_context_size 200000 capabilities [thinking, image_in, tool_use] [models.ark-plan/kimi-k3] provider ark-plan model kimi-k3 max_context_size 1000000 capabilities [thinking, image_in, tool_use] [models.ark-plan/doubao-seed-2.0-mini] provider ark-plan model doubao-seed-2.0-mini max_context_size 128000 capabilities [image_in, tool_use]字段说明字段位置说明default_model文件第一行顶层启动时默认使用的模型别名必须与[models....]完全一致[providers.名字]平台段声明一个接入平台名字自定示例用ark-plantype平台段协议类型OpenAI 兼容填openaibase_url平台段接口地址写到/v3为止末尾不加斜杠api_key平台段Agent Plan 专属 Key[models.别名]模型段模型别名建议平台名/模型id便于管理含/必须加引号provider模型段指向的平台名与[providers.xxx]一致model模型段真实模型 id不要带版本号后缀max_context_size模型段上下文长度必填否则报 config.invalidcapabilities模型段能力标记如thinking推理/image_in视觉输入/tool_use4. 验证kimi doctor# 应显示 config.toml validkimi# 启动页 Model 应显示 ark-plan/kimi-k3进入会话后/status # 确认当前平台和模型 /model # 临时切换模型仅当前会话发一条消息测试正常回复即接入成功。5. 日常使用切换平台和模型关键认知/provider界面是「管理平台」不是「切换平台」/provider↑/↓ 浏览、d删除、[ Add New Platform ]回车添加。选中已有平台按回车不会切换。切换模型的三种方式改配置里的default_model永久生效推荐会话内/model临时生效启动时kimi -m ark-plan/kimi-k3单次生效注意-m后只写别名不要跟提示词6. 常见报错对照表报错原因解决Model xxx is not configured... Add a [models.xxx] entry with max_context_size模型段缺失或缺max_context_size检查[models.xxx]段完整性Provider ark-plan ... is not configured平台段字段名错误必须是[providers.ark-plan]type openai不是model_providers/protocol那是其他工具的写法404探测base或base/models走了 registry 探测地址不对Agent Plan 不提供模型列表必须显式写models段且 base_url 写到/v3401 UnauthorizedKey 错误确认用的是 Agent Plan 页签的专属 Key不是在线推理 Key改了配置没反应文件没保存 / 改了旧版.kimi\config.yamlCtrlS 保存确认改的是.kimi-code\config.toml/reload或重启列表里回车没反应误以为/provider可切换用/model或改default_model见第 5 节万能排查三步kimi doctor# 1. 校验配置语法Get-Content$HOME\.kimi-code\config.toml# 2. 看磁盘上的真实内容# 3. 仍不行就删掉手写配置用 /provider → Add New Platform 让 CLI 自己生成再对照字段7. 安全注意事项API Key 不要明文贴到聊天记录、截图或公开仓库贴配置前先打码Key 一旦泄露立即去火山方舟控制台作废重生成配置文件留在本机即可不要同步到网盘/Git8. 参考Kimi Code CLI 官方文档https://www.kimi.com/code/docs/zh-CN/providers火山引擎方舟 Agent Plan控制台「开通管理 → Agent Plan」页签
