Kimi Code CLI 命令行使用——终端里的 AI 编程助手

一句话

装好 @kimi/code，终端里跑 kimi chat，就有一个 AI 编程助手跟你对话——可以读你当前目录的代码、帮你改 bug、写新功能、跑测试。

安装与登录（快速回顾）

# 全局安装
npm install -g @kimi/code

# 登录（浏览器自动打开 Kimi 登录页）
kimi login

# 验证安装
kimi --version

四个核心子命令

命令	说明
`kimi chat`	启动交互式编程对话
`kimi acp`	启动 ACP 服务（给 IDE 集成用）
`kimi install`	在当前项目目录初始化 Kimi Code 配置
`kimi upgrade`	升级到最新版本

交互式模式（kimi chat）

启动

cd /path/to/your/project
kimi chat

Kimi Code 会自动：

读取当前项目的目录结构
识别项目类型（前端 / 后端 / 数据科学等）
加载项目上下文（package.json / requirements.txt / AGENTS.md 等）

对话示例

你好，我看到这是一个 Next.js 项目。当前你想做什么？
> 帮我看看 /app/page.tsx 这个文件，解释下它的结构和每个模块的作用

Kimi Code：
/app/page.tsx 是 Next.js App Router 的首页组件，结构如下：
1. ...（逐模块解释）
2. ...

> 这个组件的 fetchData 函数有 bug，帮我看看为什么数据没显示

Kimi Code：
（读取代码）我发现问题了——fetchData 的错误处理里把 404 当成了正常情况返回空数组，
但实际上后端 404 是因为参数格式不对。让我帮你修一下：

（修改后的代码 + diff 展示）

> 好的，帮我跑一下测试看看有没有通过

Kimi Code：
（自动运行 npm test）
✓ 5 passed
✗ 1 failed：测试期望返回 5 条数据但只返回了 3 条
（继续分析...）

特殊指令

在 kimi chat 交互模式下，可以用以下特殊指令：

指令	说明
`/files`	列出当前项目的所有文件
`/read <path>`	读取指定文件
`/run <cmd>`	执行任意终端命令
`/diff`	查看最近的代码变更
`/commit`	帮你生成 commit message 并提交
`/model <name>`	切换模型（k2.6 / k3 / k3-thinking）
`/clear`	清空对话历史
`/exit`	退出

ACP 协议集成（kimi acp）

ACP（Agent Client Protocol）是 Kimi 推出的 IDE 集成协议。通过 kimi acp 子命令，Kimi Code 可以和任何支持 ACP 的 IDE 通信：

IDE	支持方式
VS Code	官方扩展（通过 ACP 通信）
Cursor	原生支持 ACP
Zed	原生支持 ACP
JetBrains	AI Chat 插件兼容 ACP
Paseo	原生支持 ACP

ACP 工作流

终端运行 kimi acp → 启动 Kimi Code 的 ACP 服务
IDE 配置 ACP 后端 → 连接到 kimi acp 输出的地址
在 IDE 里使用 Kimi Code（和 CLI 里的对话是独立的上下文）

项目配置（kimi install）

在每个项目里跑一次 kimi install，会自动：

创建 .kimi/ 目录
生成默认的 AGENTS.md
生成 .kimiignore（类似 .gitignore，告诉 Kimi 哪些文件不要读）
可以配置项目级模型偏好

.kimiignore 示例

node_modules/
dist/
build/
.env.local
*.log
coverage/

这个文件能显著提升 Kimi Code 的分析速度、降低 token 消耗。

实战场景

场景一：代码审查

kimi chat
> 帮我审查一下刚才的 git diff，重点关注：
> 1. 性能问题
> 2. 安全隐患
> 3. 边界条件

场景二：新项目快速搭建

mkdir my-project && cd my-project
kimi chat
> 帮我从零搭建一个 Express + TypeScript + Prisma 的后端项目，
> 包含用户 CRUD、JWT 认证、分页查询
> 每完成一步告诉我你做了什么

场景三：复杂 Bug 排查

kimi chat
> 我的项目启动报错 "Cannot find module xxx"，
> 帮我分析根因、修复、并验证能不能跑通
> （你可以随意运行命令）

场景四：大规模重构

kimi chat
> 这个项目里用了大量的 class-based 组件，
> 帮我重构为函数式组件 + hooks，
> 保持行为不变、测试通过
> 建议分批进行，每改一批帮我跑一次测试

高级技巧

用 AGENTS.md 自定义行为

在项目根目录创建 AGENTS.md，定义项目级规则（见看板与插件）。Kimi Code 进入项目时自动读取。

用 K3 Thinking 模型解决难题

> /model k3-thinking
> 我有一个复杂的性能问题，帮我深入分析根因

配合 Git 工作流

# 让 Kimi Code 帮你写 commit message
kimi chat
> 帮我看看最近的改动，生成一个合适的 commit message

常见问题

Kimi Code CLI 消耗 credits 吗？

会。取决于模型选择（K2.6 便宜，K3 贵）和思考强度。具体额度见会员与额度。

能在远程服务器上用吗？

可以。SSH 到远程服务器 → 安装 @kimi/code → kimi login → kimi chat。Kimi Code 会直接读取远程服务器上的代码和文件。

Kimi Code 和 Kimi Work 的区别？

维度	Kimi Code	Kimi Work
定位	编程专用 Agent	通用本地 Agent
运行位置	终端 / IDE	桌面端
能力	代码分析 / 编写 / 执行	本地文件 / 定时任务 / 浏览器自动化
适合谁	开发者	知识工作者 + 开发者

继续阅读

Kimi Code 安装：完整安装流程
VS Code 集成：IDE 里的 Kimi Code 用法
Cursor 与 Zed 支持：ACP 协议在不同 IDE 里的用法
会员与额度：credits 消耗说明