本文介绍如何在 Kimi Code 中配置并使用方舟 Coding Plan。
核心配置#
接入工具的核心参数如下:
模型配置#
支持以下两种方式配置模型:
在工具配置文件中指定 Model Name,可实时切换模型。支持配置的 Model Name:
doubao-seed-evolvingdoubao-seed-2.1-prodoubao-seed-2.1-litedoubao-seed-2.0-miniglm-5.3(glm-latest)glm-5.3-flashdeepseek-v4.1-flashdeepseek-v4.1-flash-economydeepseek-v4-flashdeepseek-v4-prokimi-k2.8-previewkimi-k3.1-pro
- 在配置文件中指定模型为
ark-code-latest。 - 通过 开通管理页面 选择或切换目标模型,切换模型后 3-5 分钟即可生效。
支持 Auto 模式,通过「效果 + 速度」双维度智能算法自动选择模型。
Base URL#
不同的工具配置的 Base URL 根据兼容的协议会有不同:
- 兼容 Anthropic 接口协议工具:
https://ark.cn-beijing.volces.com/api/coding - 兼容 OpenAI 接口协议工具:
https://ark.cn-beijing.volces.com/api/coding/v3
API Key#
前提条件#
-
您已按需订阅 Coding Plan 套餐。如未订阅,请访问 方舟 Coding Plan 活动 按需订阅套餐。
-
安装 Node.js 18 或更新版本。
安装 Kimi Code#
在命令行界面,执行以下命令安装 Kimi Code。
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
安装结束后,执行以下命令查看安装结果,若显示版本号则安装成功。
kimi --version
首次启动前安装 Git for Windows,Kimi Code 使用其提供的 Git Bash 运行 shell 命令。在 PowerShell 中执行以下安装命令。
irm https://code.kimi.com/kimi-code/install.ps1 | iex
安装结束后,执行以下命令查看安装结果,若显示版本号则安装成功。
kimi --version
配置 Kimi Code#
方式 1:一键配置(推荐)#
Ark CLI 是火山方舟平台官方命令行工具,支持在本地终端快速完成认证与资源管理,并可将能力安装到常用 AI Agent 中,降低手动配置的时间成本和出错风险。
-
安装 Ark CLI
环境要求:Node.js 18 或更新版本。支持 macOS、Linux、Windows。
npm install -g @volcengine/ark-cli@latest
arkcli --version
-
登录 Ark CLI
根据界面提示选择登录方式,推荐选择 火山 SSO (浏览器登录),在浏览器中完成授权即可。
arkcli auth login
- 一键配置 Kimi Code
arkcli helper
运行 ArkCLI Helper,根据界面提示完成配置。
- 选择 Profile:
coding-plan_cn-beijing_personal。 - 选择默认 model:按需选择。
- 选择 AI Agent:
KimiCode。
配置完成后,Kimi Code 会自动识别配置的模型。启动 Kimi Code 即可使用。
方式 2:手动配置#
创建并编辑 ~/.kimi-code/config.toml 文件,Windows 系统为 %USERPROFILE%\.kimi-code\config.toml。关注的配置信息如下:
<ARK_API_KEY>:替换为您自己的 API Key。model:支持配置 Model Name(实时切换模型)或ark-code-latest(控制台切换模型)。具体配置方式参见 模型配置。
default_model = "volcengine-coding-plan/ark-code-latest"
[providers.volcengine-coding-plan]
type = "openai"
base_url = "https://ark.cn-beijing.volces.com/api/coding/v3"
api_key = "<ARK_API_KEY>"
[models."volcengine-coding-plan/ark-code-latest"]
provider = "volcengine-coding-plan"
model = "ark-code-latest"
max_context_size = 256000
使用 Kimi Code#
-
在终端进入需要使用的项目目录,启动 Kimi Code。
kimi -
输入以下需求,验证模型能够回复并读取工作区。如果返回当前项目的文件结构,说明 Kimi Code 已完成方舟接入。
简单介绍一下当前目录的文件结构。