本文介绍如何通过 ArkCLI Helper 为 Kimi Code 配置方舟 Coding Plan,并在项目目录中启动工具完成首次对话。
前提条件#
- 本文通过 npm 安装 ArkCLI,需提前安装 Node.js LTS。
- 已订阅 Coding Plan,并获取 API Key。订阅步骤参见 Coding Plan 快速开始。
第 1 步 · 安装工具#
- 按操作系统安装 Kimi Code,命令来自 Kimi Code 官方 README。
在终端执行官方安装脚本。
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
在 PowerShell 中执行官方安装脚本。首次启动前安装 Git for Windows,Kimi Code 使用其提供的 Git Bash 运行 shell 命令。
irm https://code.kimi.com/kimi-code/install.ps1 | iex
-
安装最新版 ArkCLI。
npm install -g @volcengine/ark-cli@latest -
打开新的终端会话,检查安装结果。以下命令应分别显示 Kimi Code 和 ArkCLI 版本。
kimi --version arkcli --version
第 2 步 · 配置接入#
-
登录 ArkCLI,并查看可用 profile。
arkcli auth login arkcli profile list -
选择
coding-plan类型的 profile。将<CODING_PLAN_PROFILE>替换为列表中对应的 profile 名称。arkcli helper configure kimi-code --profile <CODING_PLAN_PROFILE> --model ark-code-latestHelper 使用 OpenAI Chat Completions 协议,Base URL 为
https://ark.cn-beijing.volces.com/api/coding/v3。ark-code-latest使用控制台配置的路由策略;如需指定模型,将其替换为套餐支持的 Model Name。可用模型参见 套餐支持的模型。
-
确认 Helper 输出的模型和 Base URL 与所选资源一致。
Helper 默认写入
~/.kimi-code/config.toml:providers保存 OpenAI provider,models保存模型清单,default_model指向选定模型。配置文件权限为0600。设置KIMI_CODE_HOME后,配置写入该环境变量指定的目录。
第 3 步 · 启动并验证#
-
在终端进入需要使用的项目目录,启动 Kimi Code。
kimi -
输入以下需求,验证模型能够回复并读取工作区。
简单介绍一下当前目录的文件结构。如果返回当前项目的文件结构,说明 Kimi Code 已完成方舟接入。
-
如果配置后仍使用旧模型,退出 Kimi Code,确认启动终端中的
KIMI_CODE_HOME与配置时一致,再重新启动。如果 ArkCLI 提示不支持
kimi-code,升级 ArkCLI 后重新配置;如果返回鉴权错误,核对 profile、API Key 和 Base URL 是否属于同一接入方式。更多检查命令参见 ArkCLI Helper 命令参考。