Kimi CLI 完整上手指南：如何在终端让 AI 替你写代码

Kimi CLI 完整上手指南：如何在终端让 AI 替你写代码

【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cli

测试红了，报错滚出屏幕 30 屏之外，要改的函数藏在 3000 行文件的第 400 行——这就是 Kimi CLI 想解决的场景。它是跑在终端里的 AI 开发 Agent，读代码、改代码、执行命令都自己来，适合天天泡终端的开发者。接下来在一台新机器上从零跑通它。

Kimi CLI 安装与首次登录：一台新机器从零跑通

Kimi CLI 安装命令（Linux / macOS）

为什么不手动折腾依赖：官方脚本把环境一步配齐。打开终端敲：

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

它干两件事：先补齐 uv 这个 Python 包管理器，再借 uv 把 Kimi CLI 装下来。跑完终端会给出收尾信息，通常一两分钟结束。

Kimi CLI Windows 安装

Windows 用 PowerShell，命令对应换掉：

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

机器上已有 uv 的话，两条脚本都可以跳过，直接跑uv tool install --python 3.13 kimi-cli；它支持 Python 3.12–3.14，3.13 兼容性最好。

验证安装

装完先花十秒确认命令能跑：

kimi --version

看到一行版本号就对了；没反应说明脚本没跑成功，重跑一遍。

Kimi CLI 首次登录配置

先 cd 进一个真正要干活的仓库再启动，因为工作目录就是它的活动范围：

kimi

进入交互界面后，第一件事是配置模型来源。输入/login，浏览器自动打开，选 Kimi Code 平台走一遍 OAuth 授权，回来设置已存进~/.kimi/config.toml，界面自动重载，就能对话了。

手头只有 Moonshot AI 开放平台 key 的话，改用/setup走一遍向导，填 key、选模型，结果一样。

macOS 第一次启动kimi可能慢得像个卡死，那是系统安全检查在跑，不是真卡。嫌慢就把终端应用加进「系统设置 → 隐私与安全性」，后续启动快很多。

实战两个任务：让 Kimi CLI 读项目、修 bug

一句话让 Kimi CLI 读懂陌生项目

刚接手一个没听过的仓库，直接打一句"这个项目是干什么的，入口在哪，帮我理一下结构"。它会自己翻目录、读关键文件，然后把架构讲给你听——比你翻 30 屏历史快多了，因为它不用翻页。

想点具体文件就用@开头，路径自动补全；Git 仓库走git ls-files，几万文件的项目也能秒回。

仓库里没有AGENTS.md就先跑/init：AI 分析一遍项目生成这个文件，之后每次进仓库它都自带背景知识。

让 Kimi CLI 修 bug 并跑测试

测试报错了，把报错贴进去说"找到原因，修掉，再跑相关测试确认"。定位、修改、验证由它规划，你不用指挥每一步。

两个细节值得知道：

• 改文件、跑命令前会弹预览征求同意：可以允许、本会话一直允许、或拒绝，拒绝时还能附一句意见让它重来。
• 耗时的命令（构建、全量测试）会丢到后台，干完自动回来汇报，中途用/task看进度。

分工很清楚：它干活，你把关。

用 Ctrl-X 切到 Shell 模式

Ctrl-X在"AI 模式"和"纯 Shell 模式"之间来回切。后者就是普通终端，git status、ls -la直接敲，省得 Alt-Tab 换窗口。

Shell 模式下每条命令独立执行，cd、export这类改变环境的操作不生效，别指望切进去cd再干活。

Kimi CLI

【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cli