Kimi Code CLI是月之暗面科技有限公司推出的终端AI编程代理，基于Kimi K2.5系列模型，支持长达200万汉字的上下文窗口。本文提供一份完整的Kimi Code CLI安装教程，涵盖Windows、macOS、Linux三大平台的多种安装方式，包括官方脚本安装、Homebrew安装、npm与pnpm安装，以及安装后的验证、登录、配置、升级与卸载全流程，帮助开发者快速在终端中部署这一AI编码助手。

第一章 Kimi Code CLI概述与环境准备

一、Kimi Code CLI简介

Kimi Code CLI是一个运行在终端中的AI Agent（智能代理），能够帮助开发者完成软件开发任务和日常终端操作。它可以读取和编辑代码、执行Shell命令、搜索文件、抓取网页，并在执行过程中根据反馈自主规划和调整下一步行动。该工具由月之暗面科技有限公司（Moonshot AI）开发，于2026年1月底至2月初正式发布，采用开源协议。

Kimi Code CLI的典型应用场景包括：

• 编写和修改代码：实现新功能、修复bug、完成重构
• 理解项目：探索陌生的代码库，解答架构和实现层面的问题
• 自动化任务：批量处理文件、运行构建与测试、串联多个脚本

该工具提供交互式会话、Shell命令模式，并支持通过ACP（Agent Client Protocol，代理客户端协议）协议与IDE集成，以及通过MCP（Model Context Protocol，模型上下文协议）扩展工具能力。2026年1月，其品牌名称由“Kimi CLI”正式更改为“Kimi Code CLI”。

二、安装前的系统与环境要求

在开始执行Kimi Code CLI安装教程的具体步骤之前，需要确认系统环境满足以下基本要求：

（一）操作系统支持

Kimi Code CLI支持三大主流操作系统：

• macOS（推荐在支持真彩色与连字的现代终端中运行，如Kitty或Ghostty）
• Linux（各类主流发行版）
• Windows（通过PowerShell运行）

（二）账号要求

使用Kimi Code CLI需要拥有Kimi账号，并具备Kimi会员订阅或可调用的API Key。API Key可以通过以下途径获取：

• Kimi Code控制台（https://www.kimi.com/code/console）：使用Kimi会员订阅
• Kimi开放平台（https://platform.kimi.com）：按量付费模式

注意：api.kimi.com和api.moonshot.cn是两个完全独立的账号体系，API Key互不通用。

（三）Windows用户的额外要求

Windows用户在首次启动Kimi Code CLI之前，必须安装Git for Windows。Kimi Code CLI会使用Git for Windows中捆绑的Git Bash作为Shell环境。如果Git Bash安装在非标准路径，需要通过环境变量KIMI_SHELL_PATH指定bash.exe的绝对路径。

（四）终端推荐

Kimi Code CLI为全交互式TUI（终端用户界面）应用，推荐在支持真彩色与连字的现代终端中运行以获得最佳体验，例如Kitty或Ghostty。

第二章 Kimi Code CLI安装教程：多种安装方式详解

本章提供完整的Kimi Code CLI安装教程，涵盖四种主要安装方式。开发者可以根据自己的操作系统和工具链偏好选择最适合的方式。

一、官方脚本安装（推荐方式）

官方安装脚本是执行Kimi Code CLI安装教程最快捷的方式。它会安装单个Kimi Code二进制文件，不需要预装Node.js，避免了PATH配置和全局模块冲突等问题。脚本会自动下载最新版本、校验checksum，并将kimi可执行文件添加到系统的PATH中。

（一）macOS / Linux

在终端中执行以下命令：

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

（二）Windows（PowerShell）

在PowerShell中执行以下命令：

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

（三）脚本安装的注意事项

1. macOS Gatekeeper安全机制：由于macOS的安全检查机制（Gatekeeper），首次运行kimi命令可能需要较长时间。可以在「系统设置 → 隐私与安全性 → 开发者工具」中添加终端应用来加速后续启动。
2. Windows前置条件：如前所述，Windows用户必须先安装Git for Windows。
3. PATH未生效：如果安装后kimi命令未找到，请尝试重新打开终端或执行source ~/.bashrc（或~/.zshrc）。

二、Homebrew安装（macOS / Linux）

对于习惯使用Homebrew包管理器的macOS和Linux用户，可以通过Homebrew完成Kimi Code CLI安装教程的相关步骤：

brew install kimi-code

Homebrew方式会自动处理依赖关系和PATH配置，与官方脚本安装得到的是相同的二进制文件。

三、npm全局安装

如果开发者已经安装了Node.js环境，可以使用npm（Node Package Manager，Node.js包管理器）进行全局安装。此方式需要Node.js 22.19.0或更高版本。

（一）使用npm安装

node --version  # 确认Node.js版本≥22.19.0
npm install -g @moonshot-ai/kimi-code

（二）使用pnpm安装

pnpm add -g @moonshot-ai/kimi-code

说明：npm和pnpm安装方式需要Node.js环境，因为它们使用JavaScript包管理器。官方脚本安装则不需要Node.js。

四、四种安装方式横向对比

第三章 安装验证与首次启动配置

完成Kimi Code CLI安装教程的安装步骤后，需要进行验证和首次启动配置。

一、验证安装是否成功

安装完成后，在终端中执行以下命令验证可执行文件是否就绪：

kimi --version

如果正确显示版本号，说明Kimi Code CLI安装教程的安装部分已成功完成。如果kimi命令未找到，请尝试：

• 重新打开终端
• 执行source ~/.bashrc（Bash用户）或source ~/.zshrc（Zsh用户）
• 检查~/.local/bin是否在PATH中

二、首次启动与登录

（一）启动交互界面

进入项目目录后，直接运行kimi启动交互界面：

cd your-project
kimi

（二）单条指令模式

如果只想执行一条指令而不进入交互界面，使用-p参数：

kimi -p "帮我看一下这个项目的目录结构"

（三）继续上一次会话

使用-C或--continue参数继续上一次会话：

kimi -C

（四）首次登录（/login）

首次启动时需要在交互界面中输入/login进入登录流程。/login会弹出平台选择器，支持两种认证方式：

1. Kimi Code（OAuth） ：验证码流程，在任意设备打开链接、登录并输入验证码即可授权
2. Kimi Platform API密钥：输入来自platform.kimi.com或platform.kimi.ai的API密钥

注意：如果在远程服务器或无图形界面的环境中执行/login，会显示一个URL，手动复制到浏览器打开即可完成授权。

如需退出登录，输入/logout清除当前凭证。

三、接入其他AI供应商

如果想接入Anthropic、OpenAI、Google等其他供应商，需要直接编辑~/.kimi-code/config.toml配置文件，设置API密钥。配置项的完整说明详见配置文件和环境变量文档。

第四章 Kimi Code CLI的项目初始化与配置

一、生成AGENTS.md文件

在项目目录下执行/init命令，Kimi Code CLI会自动扫描项目结构并生成AGENTS.md文件：

/init

AGENTS.md用于向AI提供项目的背景信息、构建步骤、代码规范等上下文，帮助AI更准确地理解项目。这是让Kimi Code CLI高效工作的关键一步。

二、配置文件说明

Kimi Code CLI把所有长期偏好写入~/.kimi-code/下的TOML（一种结构清晰的纯文本配置格式）文件。配置文件包含以下核心设置：

• API供应商和模型：配置不同的模型提供商、API地址和密钥
• Agent行为参数：如每轮最多执行步骤数

Kimi Code CLI支持TOML和JSON两种配置格式。如需迁移数据到其他位置，可以通过KIMI_CODE_HOME环境变量指定新路径。

三、常用CLI选项

安装并完成首次配置后，以下CLI（命令行界面）选项在日常使用中最为常用：

四、CLI子命令

Kimi Code CLI提供了一系列子命令，用于完成特定任务：

第五章 Kimi Code CLI的升级与卸载

一、升级Kimi Code CLI

Kimi Code CLI会持续迭代更新。2026年5月已进行了从1.42.0到1.45.0的版本迭代。根据安装方式的不同，升级方法也有所区别。

（一）通过内置升级命令

运行kimi upgrade，CLI会检查最新版本并展示更新选项。选择“Install update now”后根据当前安装来源执行升级。

（二）通过包管理器升级

• npm安装的用户：

  npm install -g @moonshot-ai/kimi-code@latest
  

• Homebrew安装的用户：

  brew upgrade kimi-code
  

二、卸载Kimi Code CLI

卸载方式同样取决于初始安装方式：

• 脚本安装的用户：直接删除kimi可执行文件即可
• npm安装的用户：

  npm uninstall -g @moonshot-ai/kimi-code
  

• Homebrew安装的用户：

  brew uninstall kimi-code
  

第六章 Kimi Code CLI的进阶使用与常见问题

一、IDE集成（ACP协议）

Kimi Code CLI原生支持ACP（Agent Client Protocol，代理客户端协议），因此ACP兼容的编辑器和IDE（集成开发环境）可以通过kimi acp子命令驱动会话。

以Zed编辑器为例，在~/.config/zed/settings.json中添加以下配置：

{
  "agent_servers": {
    "Kimi Code CLI": {
      "type": "custom",
      "command": "kimi",
      "args": ["acp"],
      "env": {}
    }
  }
}

配置完成后，即可在Zed的Agent面板中创建Kimi Code CLI线程。JetBrains系列IDE的配置方法类似，详见官方文档。

二、Zsh集成

Kimi Code CLI还支持与Zsh集成，通过AI代理能力增强Shell体验。安装zsh-kimi-cli插件：

git clone https://github.com/MoonshotAI/zsh-kimi-cli.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/kimi-cli

然后在~/.zshrc中添加插件：

plugins=(... kimi-cli)

重启Zsh后，可以通过按Ctrl-X切换到代理模式。

三、内置工具与权限管理

Kimi Code CLI内置了多种工具，不同类型的工具有不同的默认审批策略：

只读操作默认自动执行无需确认；对于会修改文件或执行Shell命令的操作，默认在执行前征求确认。

四、常见问题（FAQ）

问：Kimi Code CLI可以免费安装吗？

答：是的。Kimi Code CLI是开源的，可免费安装。但底层模型或服务的访问权限取决于Kimi Code套餐，具体可参考Kimi Code定价页面。

问：安装Kimi Code CLI需要Node.js吗？

答：官方脚本安装方式不需要Node.js。npm和pnpm安装方式需要Node.js 22.19.0或更高版本。

问：安装后kimi命令找不到怎么办？

答：安装脚本会将kimi添加到PATH，但需要重启终端或执行source ~/.bashrc（或source ~/.zshrc）才能生效。如果仍然找不到，检查~/.local/bin是否在你的PATH中。

问：/login后浏览器没有弹出怎么办？

答：如果在远程服务器或无图形界面的环境中，/login会显示一个URL，手动复制到浏览器打开即可完成授权。

问：我填了API Key怎么提示鉴权失败？

答：先确认使用的Key和Base URL是否属于同一个平台。api.kimi.com和api.moonshot.cn是两个完全独立的账号体系，API Key互不通用。

问：如何继续之前的会话？

答：在同一项目目录中运行kimi --continue可继续最近一次会话。要选择特定会话，可在shell中使用kimi --session [id]，或在TUI内使用/sessions。

问：/plan和普通模式有什么区别？

答：普通模式让Agent直接开展工作。Plan Mode适用于范围大、风险高或不明确的任务：Kimi Code会先探索、写出计划，并在计划获批后才执行。

问：--yolo安全吗？

答：--yolo会跳过常规工具调用的审批。只应在可信且受版本控制的工作区使用。面对不熟悉的仓库或生产数据时，请保持审批开启。

问：数据存放在哪里？

答：Kimi Code CLI的本地数据默认保存在~/.kimi-code/下，包含配置文件、会话记录、日志和更新缓存。如需迁移到别处，通过KIMI_CODE_HOME环境变量指定新路径。