面向 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

本文介绍如何通过 ArkCLI Helper 为 Kimi Code 配置方舟 Coding Plan,并在项目目录中启动工具完成首次对话。

前提条件#

第 1 步 · 安装工具#

  1. 按操作系统安装 Kimi Code,命令来自 Kimi Code 官方 README。

在终端执行官方安装脚本。

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

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

PowerShell
irm https://code.kimi.com/kimi-code/install.ps1 | iex
  1. 安装最新版 ArkCLI。

    Bash
    npm install -g @volcengine/ark-cli@latest
    
  2. 打开新的终端会话,检查安装结果。以下命令应分别显示 Kimi Code 和 ArkCLI 版本。

    Bash
    kimi --version
    arkcli --version
    

第 2 步 · 配置接入#

  1. 登录 ArkCLI,并查看可用 profile。

    Bash
    arkcli auth login
    arkcli profile list
    
  2. 选择 coding-plan 类型的 profile。将 <CODING_PLAN_PROFILE> 替换为列表中对应的 profile 名称。

    Bash
    arkcli helper configure kimi-code --profile <CODING_PLAN_PROFILE> --model ark-code-latest
    

    Helper 使用 OpenAI Chat Completions 协议,Base URL 为 https://ark.cn-beijing.volces.com/api/coding/v3。ark-code-latest 使用控制台配置的路由策略;如需指定模型,将其替换为套餐支持的 Model Name。可用模型参见 套餐支持的模型。

  1. 确认 Helper 输出的模型和 Base URL 与所选资源一致。

    Helper 默认写入 ~/.kimi-code/config.toml:providers 保存 OpenAI provider,models 保存模型清单,default_model 指向选定模型。配置文件权限为 0600。设置 KIMI_CODE_HOME 后,配置写入该环境变量指定的目录。

第 3 步 · 启动并验证#

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

    Bash
    kimi
    
  2. 输入以下需求,验证模型能够回复并读取工作区。

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

    如果返回当前项目的文件结构,说明 Kimi Code 已完成方舟接入。

  3. 如果配置后仍使用旧模型,退出 Kimi Code,确认启动终端中的 KIMI_CODE_HOME 与配置时一致,再重新启动。

    如果 ArkCLI 提示不支持 kimi-code,升级 ArkCLI 后重新配置;如果返回鉴权错误,核对 profile、API Key 和 Base URL 是否属于同一接入方式。更多检查命令参见 ArkCLI Helper 命令参考。

ArkCLI 认证与配置。

ArkCLI Helper 命令参考。