开始使用 Kimi Code CLI
Kimi Code CLI 是一个运行在终端中的 AI Agent，帮助你完成软件开发任务和终端操作。它可以阅读和编辑代码、执行 Shell 命令、搜索和抓取网页，并在执行过程中自主规划和调整方案。
适合场景
编写和修改代码：实现新功能、修复 bug、完成重构
理解项目：探索陌生的代码库，解答架构和实现层面的问题
自动化任务：批量处理文件、运行构建与测试、串联多个脚本
整套 CLI 以 TypeScript 编写，通过 npm 分发，运行在 Node.js 之上。
开始之前
操作系统：macOS、Linux 或 Windows（通过 PowerShell）
Kimi 账号：需拥有 Kimi 会员订阅，或可调用的 API key
Kimi Code CLI 为全交互式 TUI 应用，推荐在支持真彩色与连字的现代终端中运行以获得最佳体验，例如 Kitty 或 Ghostty。
安装
提供两种安装方式：官方安装脚本（推荐，无需预装 Node.js）和 npm 全局安装。
脚本安装（推荐）
macOS / Linux：
Bash
Windows（PowerShell）：
Powershell
脚本会自动下载最新版本、校验 checksum，并把 kimi 可执行文件放到你的 PATH 中。
Windows 用户首次启动前还需要安装 Git for Windows，Kimi Code CLI 会使用其中的 Git Bash 作为 Shell 环境。如果 Git Bash 安装在非标准路径，请把 KIMI_SHELL_PATH 设为 bash.exe 的绝对路径。
npm 安装
如果你已经安装了 Node.js 22.19.0 或更高版本，可以直接用 npm 安装：
Bash
或用 pnpm：
Bash
验证安装
安装完成后，验证可执行文件是否就绪：
Bash
由于 macOS 的安全检查机制（Gatekeeper），首次运行 kimi 命令可能需要较长时间。可以在「系统设置 → 隐私与安全性 → 开发者工具」中添加你的终端应用来加速后续启动。
如果 kimi 命令未找到，请尝试重新打开终端或执行 source ~/.bashrc（或 ~/.zshrc）。
升级与卸载
升级：运行 kimi upgrade，CLI 会检查最新版本并展示更新选项。选择 Install update now 后根据当前安装来源执行升级；也可以直接用包管理器：
Bash
卸载：脚本安装的用户删除 kimi 可执行文件即可；npm 安装的用户：
Bash
第一次启动
启动交互界面
进入项目目录后直接运行 kimi 启动交互界面：
Bash
单条指令
只想执行一条指令而不进入交互界面时，使用 -p：
Bash
继续会话
继续上一次会话加 -C：
Bash
首次登录
首次启动时需要配置 API 来源。在交互界面中输入 /login 进入登录流程：
Text
/login 会弹出平台选择器，支持两种方式：
Kimi Code（OAuth） — 验证码流程，在任意设备打开链接、登录并输入验证码即可授权
Kimi Platform API 密钥 — 输入来自 platform.kimi.com 或 platform.kimi.ai 的 API 密钥
需要退出登录时，输入 /logout 清除当前凭证。
如果你想接入 Anthropic、OpenAI、Google 等其他供应商，需要直接编辑 ~/.kimi-code/config.toml 配置 API 密钥。配置项完整说明见环境变量和配置覆盖文档。
生成 AGENTS.md
在项目目录下执行 /init 命令，Kimi Code CLI 会自动扫描项目结构并生成 AGENTS.md 文件：
Text
AGENTS.md 用于向 AI 提供项目的背景信息、构建步骤、代码规范等上下文，帮助 AI 更准确地理解你的项目。
第一个对话
登录完成后，用自然语言描述任务即可。先让它熟悉当前项目：
Text
Kimi Code CLI 会自动调用文件读取、搜索等工具浏览相关内容后给出回答。只读操作默认自动执行无需确认；对于会修改文件或执行 Shell 命令的操作，默认会在执行前征求确认。
也可以直接描述更具体的任务：
Text
Kimi Code CLI 会规划步骤、修改代码、运行测试，并在每一步告诉你它做了什么。
不知道能做什么？输入 /help 可以打开内置的命令和快捷键面板，按 ↑/↓ 翻看，Esc 关闭。退出时输入 /exit，或按 Ctrl-C 两次，或在输入框为空时按 Ctrl-D。
常用命令与快捷键速查
会话相关命令
命令说明/new开启新会话，清空当前上下文/sessions浏览历史会话，选择恢复/model切换当前使用的模型/compact手动压缩上下文，释放 token/fork派生当前会话，保留历史独立继续
最常用快捷键
快捷键说明Esc中断流式输出 / 关闭弹窗Ctrl-C中断输出；空闲时连按两次退出Shift-Tab切换 Plan 模式Ctrl-S输出中途插入消息，无需等待结束Ctrl-O折叠 / 展开工具输出
想看完整列表，输入 /help 或访问工作模式和交互与输入。
数据存放在哪里
Kimi Code CLI 的本地数据默认保存在 ~/.kimi-code/ 下，包含配置文件、会话记录、日志和更新缓存。如需迁移到别处，通过 KIMI_CODE_HOME 环境变量指定新路径。完整说明见环境变量文档。
常见问题
我填了 API Key 怎么提示鉴权失败
先确认你用的 Key 和 Base URL 是不是同一个平台的。api.kimi.com 和 api.moonshot.cn 是两个完全独立的账号体系，API Key 互不通用：
平台Base URL计费方式Key 创建入口Kimi CodeOpen AI 兼容： https://api.kimi.com/coding/v1 Anthropic 兼容：https://api.kimi.com/coding/Kimi 会员订阅（含额度）Kimi Code 控制台Kimi 开放平台https://api.moonshot.cn/v1按量付费Kimi 开放平台官网
安装后 kimi 命令找不到
安装脚本会将 kimi 添加到 PATH，但需要重启终端或执行 source ~/.bashrc（或 source ~/.zshrc）才能生效。如果仍然找不到，检查 ~/.local/bin 是否在你的 PATH 中。
/login 后浏览器没有弹出
如果在远程服务器或无图形界面的环境中，/login 会显示一个 URL，手动复制到浏览器打开即可完成授权。
更多问题请参考常见问题。
下一步
交互与输入 — 输入框操作、审批流程、Plan 模式和 YOLO 模式详解
会话与上下文 — 恢复会话、上下文压缩、导出会话
常见使用案例 — 典型任务的 prompt 示例