Kimi Code CLI

Kimi Code CLI 快速入门

月之暗面出品的终端 AI 编程 Agent：开源免费（MIT），搭载刚登顶编程榜单的 Kimi K3 模型，API 同时兼容 OpenAI 和 Anthropic 两种协议。

这是什么？适合谁？

Kimi Code CLI 是运行在终端里的 AI Agent，官方定位是”帮助你完成软件开发任务和日常终端操作——阅读和修改代码、执行 Shell 命令、搜索文件、抓取网页”。现行版本是 TypeScript 实现（GitHub 4,857 stars，2026-07-24 核验），旧 Python 版（kimi-cli）已停止维护。它支持 Plan 模式、子代理、MCP、Skills，还有 VS Code 扩展形态。

适合谁？三类用户：一是已经习惯 Claude Code 这类终端编程工具、想低成本体验 K3 编程能力的开发者——Kimi Code 的 API 直接兼容 Anthropic 协议，Claude Code 里也能填 Kimi 的 Key；二是国内开发者，官方线路直连、中文文档完善、人民币结算；三是需要”高速输出”的场景，高速版最高 100 tokens/s，约为普通版 5–6 倍。不适合完全零预算的用户：它没有独立免费层，最低门槛是 ¥49/月的会员。

准备工作

• 运行环境：Node.js ≥ 22.19.0（npm 安装方式）；或用官方安装脚本（macOS/Linux 用 install.sh，Windows 用 PowerShell 的 install.ps1，需 Git Bash）
• 账号要求：kimi.com 注册账号
• 付费要求：Kimi 会员（Kimi Code 含在套餐内）：Andante ¥49/月（1 倍额度）、Moderato ¥99/月（4 倍额度，可调用 k3）、Allegretto ¥199/月（20 倍额度，解锁 1M 上下文和高速版）、Allegro ¥699/月（2026-07-24 官方定价页核验）
• 注意：额度按 7 天周期刷新，另有每 5 小时频率限制；临时加量可买”加油包”（25 元起）

3 步快速上手

第 1 步：安装

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

安装完成后运行 kimi 启动。预期输出：进入全交互式 TUI 界面，提示登录或配置 API Key。

第 2 步：登录并选模型

按提示用浏览器完成 kimi.com 账号授权。用斜杠命令 /model 查看当前模型——Moderato 及以上会员可选 k3。/help 可以查看全部斜杠命令（/new、/compact、/fork 等）。

第 3 步：跑第一个编程任务

在你的项目目录下启动 kimi，输入：“阅读 src 目录，找出启动入口，并说明项目结构。“预期输出：它会自主列出文件、读取关键代码，然后给出结构说明。想让它直接改代码，先用 Plan 模式让它给方案，确认后再执行——这是避免”AI 乱改代码”的标准姿势。

常见踩坑

踩坑 1：npm 安装后命令找不到或启动报错

• 症状：kimi 命令不存在，或启动即崩溃
• 原因：Node.js 版本低于 22.19.0
• 解决：node -v 检查版本，用 nvm 升级后重装

踩坑 2：选不到 k3 模型

• 症状：/model 列表里没有 k3
• 原因：k3 需要 Moderato（¥99/月）及以上会员档位
• 解决：升级会员，或先用 kimi-for-coding（K2.7 Code）模型

踩坑 3：用到一半提示额度耗尽

• 症状：会话中途被拒绝服务
• 原因：7 天周期额度用完，或触发 5 小时频控
• 解决：Web 控制台查额度；临时需求买加油包（25 元起），重度用户升 Allegretto

踩坑 4：从旧 Python 版 kimi-cli 迁移后配置丢失

• 症状：旧版的配置文件新版不识别
• 原因：TypeScript 重写版是全新代码库，旧版已停止维护
• 解决：按新文档重新配置；旧仓库（MoonshotAI/kimi-cli）仅作参考，不要再装

初级用法

1. Plan 模式先行：复杂改动先让它出计划，人工确认再执行，返工率最低。

2. 用 /compact 压缩上下文：长会话变慢时执行一次，保留关键信息、释放上下文窗口。

3. 接入第三方客户端：在 Web 控制台生成 API Key，Base URL 填 https://api.kimi.com/coding/v1——它同时兼容 OpenAI 和 Anthropic 协议，所以 Claude Code、Roo Code 都能直接用 Kimi 的 Key。

高级玩法

1. 高速版处理批量任务：Allegretto 会员可用高速版（最高 100 tokens/s），跑批量代码审查、批量重命名这类任务效率提升 5–6 倍。

2. 子代理 + MCP 编排：把重复性检查（如”扫描所有 TODO 并整理成表”）交给子代理并行执行；通过 MCP 接入公司内部文档库，让它改代码时能查内部规范。

3. 程序化调用：需要把 CLI 能力嵌进自己的工具链时，用官方的 Kimi Agent SDK 程序化调用运行时，而不是 shell 包裹 CLI。

小技巧

• 在干净的项目目录里先跑 /new 开会话，避免历史上下文污染
• 大仓库先让它”只读分析”再决定改什么，省钱也省额度
• 额度快用完时切回普通版模型，高速版消耗更快
• 关注 GitHub release（0.29.1 于 2026-07-24 发布），TS 版迭代非常快

常见问题 FAQ

Q: Kimi Code CLI 免费吗？ A: 软件本身开源免费（MIT），但模型能力需要 Kimi 会员，最低 ¥49/月，无独立免费层。

Q: 和 Claude Code 比怎么样？ A: 两者是竞品也是”宿主”关系——Kimi Code 的 API 兼容 Anthropic 协议，官方文档支持在 Claude Code 里填 Kimi Key 用 K3。差异在价格和模型：Kimi 走人民币会员制、搭载 K3；Claude Code 绑定 Anthropic 订阅。

Q: 能离线/本地部署吗？ A: 不能。CLI 在本地运行，但模型在云端，必须联网调用。

Q: 我的代码会被用于训练吗？ A: 官方 API 数据安全页明确承诺”通过 API 提交的用户数据不会被用于训练或改进 Kimi 的模型”。但 Kimi Code 走会员订阅，消费端条款可能与纯 API 政策不同，敏感项目建议先阅读最新会员协议。

Q: 旧版 kimi-cli（Python）还能用吗？ A: 官方已声明旧版停止维护，建议尽快迁移到 TypeScript 新版。

参考链接

• Kimi Code 官网：https://www.kimi.com/code/zh
• 官方文档：https://www.kimi.com/code/docs/
• 会员定价：https://www.kimi.com/zh-cn/help/membership/membership-pricing
• 权益与计费说明：https://www.kimi.com/zh-cn/help/kimi-code/benefits
• API 数据安全：https://www.kimi.com/zh-cn/help/kimi-api/api-data-security
• GitHub（新版）：https://github.com/MoonshotAI/kimi-code
• GitHub（旧版，停维护）：https://github.com/MoonshotAI/kimi-cli

相关产品

• Kimi K3：本工具搭载的 2.8T 开源模型——权重、部署与 API 细节见模型收录页

本文基于官方文档和公开资料整理，AI辅助生成。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。