🤖 AI 跟我学 新手入门

Kimi Code CLI 安装教程：Windows/Mac 全流程

Kimi Code CLI 安装一步步实操，本文覆盖 Windows / macOS / Linux 三端、Node.js 准备、登录配置、常见坑、一行命令快速复制

发布 2026/05/20

30 秒了解：装 Kimi Code CLI 到底要干啥

Kimi Code CLI 是一个跑在你终端里的 AI 编程 Agent，能读你电脑上的项目代码、修改文件、跑命令。装它本质上只做三件事：① 装 Node.js → ② 一行命令安装 CLI → ③ 用 /login 登录。

整个过程顺利的话 10 分钟搞定。最容易卡壳的不是 CLI 本身，而是 Node.js 版本和 PATH 环境变量。下面分平台一步步讲。

如果你还不清楚 Kimi Code 是什么，先看 Kimi Code 是什么 那篇打底。

准备工作

开始前确认：

  1. 一个 Kimi 账号（Kimi 怎么注册）
  2. 电脑能联网访问 kimi.com（国内直连，不需要科学上网）
  3. 终端基本操作（能开终端、能 cd 目录、能 paste 命令）
  4. 大约 500MB 磁盘（主要是 Node.js 占）

兼容性：

  • macOS：10.15 Catalina 及以上（Intel / Apple Silicon 都行）
  • Windows：10 / 11（需要 PowerShell 5.1+，建议 PowerShell 7）
  • Linux：主流发行版（Ubuntu 20+ / Debian 11+ / Fedora 35+ 等）

详细操作步骤

第 1 步：装 Node.js（如果还没装）

Kimi Code CLI 依赖 Node.js 运行时。最低要求 Node 18，推荐 Node 22 或 24。

先检查有没有：

node -v

如果输出 v22.x.x 或更高，跳过这一步。如果显示 command not found 或者版本低于 18，继续装。

macOS / Linux 上装 Node.js（用 fnm，推荐）

fnm 是一个轻量版本管理器，比 nvm 快很多：

curl -fsSL https://fnm.vercel.app/install | bash
# 重启终端，或者跑 source ~/.zshrc 让 fnm 生效
fnm install 24
fnm default 24
node -v

Windows 上装 Node.js（用 winget）

打开 PowerShell（管理员）：

winget install OpenJS.NodeJS
# 关掉再重开 PowerShell
node -v

如果 winget 没装，从 nodejs.org 下安装包双击装也行。

[此处放截图：node -v 输出版本号]

第 2 步：装 Kimi Code CLI

Node.js 准备好之后，装 CLI 是一行命令的事。注意区分两条不同的官方安装路径，按你的网络情况选：

方式 A：官方安装脚本（推荐）

macOS / Linux 终端跑：

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

Windows PowerShell 跑：

Invoke-RestMethod https://code.kimi.com/install.ps1 | Invoke-Expression

脚本会自动下载二进制、放到合适的目录、加 PATH。

方式 B：通过 npm 装（备选）

如果上面脚本下载慢，可以走 npm 全局安装（具体包名以官网为准）：

npm install -g @moonshot/kimi-cli

[此处放截图：安装脚本运行完成的成功提示]

第 3 步：让 kimi 命令在终端生效

安装完最容易踩的坑是「命令找不到」。这是因为新安装的 CLI 还没被加到当前 shell 的 PATH。

macOS / Linux：

# zsh 用户
source ~/.zshrc

# bash 用户
source ~/.bashrc

# fish 用户
source ~/.config/fish/config.fish

或者直接关掉终端再开一个新窗口。

Windows：直接关掉 PowerShell 再开一个新窗口即可。

验证安装成功：

kimi --version

输出版本号就是装好了。

第 4 步：登录 Kimi 账号

第一次跑 kimi 会要求登录。在终端跑：

kimi

进入交互界面后输入：

/login

会弹出一个浏览器页面，用你已有的 Kimi 账号登录（手机号 / 微信 / 邮箱都行）。授权之后 CLI 自动拿到 token，回到终端就能用了。

[此处放截图：登录授权页面]

如果浏览器没自动开，复制终端里的 URL 手动粘贴到浏览器。

第 5 步：跑一个最小测试

随便 cd 到一个目录，跑：

cd ~/Desktop
mkdir kimi-test && cd kimi-test
kimi

进入对话后输入：

你好。请在当前目录创建一个 hello.txt 文件，写「Hello from Kimi Code」。然后用 ls 命令列出目录。

第一次 CLI 会问你**「允许 Kimi 在此目录执行命令吗？」**，选 Yes。等几秒，AI 会创建文件、跑 ls、给你看结果。

看到 hello.txt 出现就是装好了。

5 个高级技巧

技巧 1：项目级配置文件 KIMI.md

在你常用项目根目录建一个 KIMI.md，写下「这个项目是什么、代码风格、常用命令」。Kimi Code 启动后会自动读这个文件作为上下文，省得你每次重新解释。

技巧 2：切换工作模式（自动 / 半自动 / 手动）

CLI 支持不同执行权限模式：

  • 手动确认（默认）：每个改文件 / 跑命令的动作都要你按 Y
  • 半自动：读 / 改文件自动，跑命令要确认
  • 自动：全自动跑（适合熟练项目）

切换命令在 CLI 交互界面里，输入 /mode 切。新项目用「手动确认」更安全。

技巧 3：会话上下文管理

长任务里别把所有东西塞一个会话。CLI 支持 /new 开新会话、/resume 续上次会话、/sessions 查历史会话。复杂任务建议分阶段：先用一个会话让 AI 探索，把结论写到一个 markdown 文档，下一个会话从读那个文档开始。

技巧 4：把它当 Cursor 的模型后端

如果你已经在用 Cursor，可以把 Cursor 的模型换成 Kimi K2，享受 Cursor 的图形界面 + Kimi 的国内合规。详细步骤看 Cursor 接入 Kimi Code。

技巧 5：和 WebBridge 联动

装上 Kimi WebBridge 之后，CLI 还能控制你的浏览器——查在线文档、读登录后才能看的内容、做爬虫任务。这是国产 Agent 工具链里相对完整的一套组合。

常见坑 + 解决办法

现象原因解决
command not found: kimiPATH 没更新关重开终端，或 source ~/.zshrc
安装脚本下载失败网络问题换 npm 方式装，或者换网络重试
node 版本太低报错系统自带 Node 老fnm / nvm 装新版，覆盖系统版本
Windows 上 PowerShell 拒绝跑脚本执行策略限制跑 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
登录后回不到终端浏览器没拿到回调复制 token 手动粘贴回终端
跑命令一直要确认默认手动模式/mode 切到半自动
中文乱码终端编码不是 UTF-8Windows：chcp 65001；macOS / Linux 默认 UTF-8
启动慢第一次拉模型上下文第二次后会快很多
我的项目读不到不在项目目录cd 到项目根目录再跑 kimi

一个实战示范：装完到第一段代码任务

把第 1-4 步都做完后，假设你想让 Kimi Code 帮你写一个最简单的 Node.js 命令行工具：

mkdir my-first-tool && cd my-first-tool
kimi

进入对话后贴：

📋 Prompt 模板 
帮我创建一个 Node.js 命令行小工具。
【需求】
    

  • 工具名：sayhi
    • 

  • 用法：在终端跑 node index.js 你的名字
    • 

  • 行为：打印「你好，{名字}！现在是 {当前时间}」
    • 

【交付】
    

  1. 创建 package.json（ESM）
    2. 

  2. 创建 index.js 实现上述逻辑
    3. 

  3. 创建 README.md，写 3 行使用说明
    4. 

  4. 跑一次 node index.js 张三 确认能跑通
    5. 

完成后告诉我做了什么。

整个过程 1-2 分钟。看着 AI 在你电脑上 touch 文件、写代码、跑命令——这是装好之后最爽的体验。

Windows 用户的额外注意

Windows 跑 Node.js 工具有几个小坑：

  1. 路径分隔符：脚本里用正斜杠 / 而不是反斜杠 \，避免被当转义
  2. 行尾符：Git 默认会自动转 LF / CRLF，建议项目根目录加 .gitattributes 锁定 LF
  3. Windows Terminal：比默认 cmd / PowerShell 体验好，从 Microsoft Store 装一个
  4. WSL2：如果你有 Linux 偏好，在 WSL2 里跑 Kimi Code 体验跟 Mac 几乎一样

macOS 用户的额外注意

  1. Apple Silicon (M 系列)：原生 ARM 支持，无需 Rosetta
  2. iTerm2 比默认终端体验更好
  3. 权限提示：第一次跑会弹「允许 kimi 访问你的文档」之类，授权即可

Linux 用户的额外注意

  1. 不同发行版包管理器差异大，遇到依赖问题去看 CLI 错误日志
  2. 长会话内存占用可能高，建议至少 8GB 内存
  3. 服务器环境可以纯命令行用，但要装一个 xdg-utils 让浏览器登录回调能跑

进阶 / 下一步

常见问题

Q：装完跟 Claude Code 同时用会冲突吗？

不会。两个 CLI 二进制名不同、配置目录不同，可以共存。

Q：能不装 Node.js 吗？

不能。Kimi Code CLI 现在依赖 Node 运行时。如果你完全不想装 Node，可以用 VS Code 插件版（不需要 Node 18）。

Q：装完占多少磁盘？

CLI 本身 < 50MB，Node.js 大约 200-300MB，加上后续会缓存模型上下文，总磁盘 500MB-1GB 是常态。

Q：能不能不登录就试用？

不行。Kimi 模型推理走服务器，必须登录绑 token。但首次登录后免费档度量够你试用一周。

Q：升级 CLI 怎么办？

跑同样的 install 脚本会覆盖更新。或者用 npm 装的，跑 npm update -g @moonshot/kimi-cli。

Q：卸载怎么干净？

跑 kimi --uninstall（如果支持），或者删二进制 + 删配置目录（~/.kimi/ 或 ~/.config/kimi/），再从 PATH 里清掉。Windows 在控制面板「程序和功能」里也能找到。