面向 AI 助手:本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/coding-plan-personal-ai-kimi-code.md,全部文档索引见 https://ark.volcengine.com/llms.txt。

Kimi Code

本文介绍如何在 Kimi Code 中配置并使用方舟 Coding Plan。

核心配置#

接入工具的核心参数如下:

模型配置#

支持以下两种方式配置模型:

在工具配置文件中指定 Model Name,可实时切换模型。支持配置的 Model Name:

  • doubao-seed-evolving
  • doubao-seed-2.1-pro
  • doubao-seed-2.1-lite
  • doubao-seed-2.0-mini
  • glm-5.3 (glm-latest)
  • glm-5.3-flash
  • deepseek-v4.1-flash
  • deepseek-v4.1-flash-economy
  • deepseek-v4-flash
  • deepseek-v4-pro
  • kimi-k2.8-preview
  • kimi-k3.1-pro
  1. 在配置文件中指定模型为ark-code-latest。
  2. 通过 开通管理页面 选择或切换目标模型,切换模型后 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#

获取 API Key

前提条件#

安装 Kimi Code#

在命令行界面,执行以下命令安装 Kimi Code。

Bash
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

安装结束后,执行以下命令查看安装结果,若显示版本号则安装成功。

Bash
kimi --version

首次启动前安装 Git for Windows,Kimi Code 使用其提供的 Git Bash 运行 shell 命令。在 PowerShell 中执行以下安装命令。

PowerShell
irm https://code.kimi.com/kimi-code/install.ps1 | iex

安装结束后,执行以下命令查看安装结果,若显示版本号则安装成功。

Bash
kimi --version

配置 Kimi Code#

方式 1:一键配置(推荐)#

Ark CLI 是火山方舟平台官方命令行工具,支持在本地终端快速完成认证与资源管理,并可将能力安装到常用 AI Agent 中,降低手动配置的时间成本和出错风险。

  1. 安装 Ark CLI

    环境要求:Node.js 18 或更新版本。支持 macOS、Linux、Windows。

Bash
npm install -g @volcengine/ark-cli@latest
arkcli --version
  1. 登录 Ark CLI

    根据界面提示选择登录方式,推荐选择 火山 SSO (浏览器登录),在浏览器中完成授权即可。

Bash
arkcli auth login
  1. 一键配置 Kimi Code
Bash
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(控制台切换模型)。具体配置方式参见 模型配置。
toml
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#

  1. 在终端进入需要使用的项目目录,启动 Kimi Code。

    Bash
    kimi
    
  2. 输入以下需求,验证模型能够回复并读取工作区。如果返回当前项目的文件结构,说明 Kimi Code 已完成方舟接入。

    text
    简单介绍一下当前目录的文件结构。