Kimi Code CLI 上手指南:安装到跑通指令
从安装认证到第一个终端任务,基于官方文档的实际可用功能。
安装前提:Node.js 环境
Kimi Code CLI 基于 Node.js,所以首先确保电脑上已安装 Node.js(版本建议 >=18)。如果还没有,去 nodejs.org 下载安装。
安装 Kimi Code CLI
可以通过 npm 全局安装:
`bash
npm install -g @moonshotai/kimi-code`
官方也提供安装脚本,具体请参照起步指南(https://moonshotai.github.io/kimi-cli/en/guides/getting-started.html)。安装完成后,运行 kimi 进入交互模式。
注意:Kimi Code CLI 正在逐步取代旧版 Kimi CLI(旧包名为 kimi-cli),安装新版本时会自动迁移已有的配置和会话,无需手动迁移。
必须的登录认证
安装完成后,在终端运行 kimi 命令,会进入交互模式。但第一次使用,需要先登录你的 Kimi 账号(账号需在 platform.kimi.ai 注册)。
如何登录:在 Kimi CLI 交互界面中,输入 /login 并回车。系统会引导你完成 OAuth 认证(通常会在浏览器打开一个页面,授权即可)。登录成功后,会话会保存,下次无需重复登录。
> 重要:不登录完成认证,无法正常使用命令行操作。很多新手卡在这一步,以为装好就能用,实际上必须先 /login。
第一个任务:让 Kimi 帮你做件事
登录成功后,你就可以在交互模式直接输入自然语言指令了。例如,输入“帮我列出当前目录的文件”,Kimi 会自动执行 ls 并返回结果。输入“创建一个 Python 脚本,打印斐波那契数列的前 10 个数”,Kimi 会生成代码并询问是否写入文件。
注意:交互模式下,Kimi 会自主规划步骤、执行 shell 命令、读取和编辑文件,然后给出反馈。你只需要写清楚需求即可。
切换 Shell 命令模式(Ctrl-X)
Kimi Code CLI 内置了一个实用的 shell 命令模式:按 Ctrl-X 切换。在这个模式下,你可以直接运行 shell 命令(cd 等内置命令暂不支持),不用退出 Kimi。例如按 Ctrl-X 后输入 ls -la,效果和终端一样。再按一次 Ctrl-X 回到 AI 对话模式。
与 VS Code 等 IDE 集成(可选)
如果你希望直接在 IDE 里使用 Kimi Code CLI,官方提供了 VS Code 扩展(搜索“Kimi Code”)以及通过 ACP(Agent Client Protocol)集成到 Zed、JetBrains 等编辑器。配置方法详见官方文档(https://github.com/MoonshotAI/kimi-cli)。简单来说,运行 kimi acp 启动 ACP 服务器,然后在编辑器的 ACP 配置中添加相应的 JSON 配置。
注意事项
项目正处于过渡期:GitHub 仓库名仍是 kimi-cli,但已标注“evolving into Kimi Code CLI”。安装新包会自动迁移旧配置。
更多能力:还支持 Zsh 插件、MCP 服务器等,适合进阶用户探索。
总之,安装后先登录,然后就可以用自然语言指挥它干活了。