Kimi Code操作手册—编写自k3 ^置顶！

2026-07-18 | 0 评论 | 0 浏览

Kimi Code 操作手册

适用版本：Kimi Code CLI（终端 AI 编程助手） 官方文档：https://www.kimi.com/code/docs/en/ 编写日期：2026-07-18

一、产品简介

Kimi Code CLI 是一款运行在终端中的 AI 智能体（Agent），可协助完成软件开发任务和日常终端操作：

读写代码：实现新功能、修复 Bug、完成重构
理解项目：探索陌生代码库，解答架构和实现问题
自动化任务：批量处理文件、运行构建和测试、串联多个脚本

它能读写文件、执行 Shell 命令、搜索文件、抓取网页，并根据执行反馈自主规划下一步动作。CLI 使用 TypeScript 编写，通过 npm 分发，运行在 Node.js 之上。

二、安装与卸载

2.1 安装

方式一：官方安装脚本（推荐，无需预装 Node.js）

Windows（PowerShell）：

irm https://code.kimi.com/kimi-code/install.ps1 | iex

macOS / Linux：

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

Windows 用户注意：首次启动前需先安装 Git for Windows，Kimi Code CLI 使用其自带的 Git Bash 作为 Shell 环境。如果 Git Bash 安装在自定义位置，需将环境变量 KIMI_SHELL_PATH 设置为 bash.exe 的绝对路径。

方式二：npm 全局安装（要求 Node.js 22.19.0 或更高版本）

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

2.2 验证、升级与卸载

kimi --version                              # 验证安装
kimi upgrade                                # 检查并升级
npm install -g @moonshot-ai/kimi-code@latest  # 或通过 npm 升级
npm uninstall -g @moonshot-ai/kimi-code       # 卸载（npm 安装方式）

**脚本安装方式卸载时，直接删除 **kimi 可执行文件即可。

三、首次启动与登录

**进入项目目录，运行 **kimi 启动交互界面：

cd your-project
kimi

首次启动需要配置 API 来源，在交互界面输入：

/login

/login 会打开平台选择器，支持两种方式：

Kimi Code（OAuth）：设备码流程——在任意设备上打开链接、登录并输入验证码完成授权
Kimi Platform API key：输入来自 platform.kimi.com 或 platform.kimi.ai 的 API Key

**退出登录使用 **/logout，可清除当前凭据。

也可以在终端直接登录（不进入 TUI）：

kimi login

四、基本使用方式

4.1 交互模式（TUI）

kimi                    # 在当前目录开启新会话
kimi -c                 # 继续当前目录最近一次会话
kimi --session          # 交互式选择历史会话
kimi --session <id>     # 恢复指定 ID 的会话
kimi --plan             # 以 Plan 模式启动（先出计划再动手）
kimi --yolo             # 跳过工具调用审批（仅在可信目录使用）
kimi --auto             # 自动权限模式，不向用户提问
kimi -m <模型别名>       # 指定本次使用的模型

4.2 非交互模式（脚本 / CI 场景）

kimi -p "看一下这个项目的目录结构"           # 单次执行，不进入 TUI
kimi -p "列出变更文件" --output-format stream-json   # JSON 流式输出，便于程序解析

-p 模式下不请求人工审批，常规工具调用按 auto 权限策略执行。

4.3 开始第一段对话

登录后用自然语言描述任务即可，例如：

看一下这个项目的目录结构，简要说明每个目录的用途。

或更具体的任务：

在 src/utils 中添加一个把任意字符串转换为 kebab-case 的函数，并为它写一个单元测试。

只读操作默认自动执行；涉及修改文件或运行命令的操作会先弹出审批确认。

五、交互与输入技巧

5.1 输入框基本操作

操作	说明
`Enter`	发送当前输入
`Shift-Enter`/`Ctrl-J`	插入换行
`↑`/`↓`	浏览输入历史（空输入框时）
`Ctrl-G`	用外部编辑器编辑当前输入（保存后写回输入框）

5.2 粘贴图片和视频

Windows：Alt-V
macOS / Linux：Ctrl-V

**粘贴后输入框显示占位符，发送时才会附带实际媒体内容。可直接讨论截图、UI 设计稿、架构图；**视频输入是 Kimi Code 的特色能力，可让模型分析视频内容、UI 流程或代码演示。

5.3 引用文件（@ 语法）

**输入 **@ 触发文件路径补全，选中路径后会以相对路径插入消息，Agent 读取消息时直接加载文件内容。文件夹建议以 / 结尾，可继续补全内部路径。

@ 引用与 / 命令是两套机制：@ 提供文件上下文，/ 调用内置功能或技能。

5.4 Shell 模式

**在空输入框输入 **! 进入 Shell 模式，直接运行终端命令，输出会写入对话上下文供 Agent 后续参考：

**进入：空输入框输入 **!，或粘贴以 ! 开头的命令
**退出：空输入框按 **Backspace 或 Esc；提交命令后自动回到普通模式
**后台运行：命令运行中按 **Ctrl+B 转为后台任务
**历史命令：Shell 模式下空输入框按 **↑ 浏览并重复执行

**例如 **!gh auth login 可在不离开会话的情况下登录 GitHub CLI。

5.5 流式输出期间的操作

Ctrl-S：把输入框内容立即注入正在运行的回合（中途引导，无需等待结束）
Esc / Ctrl-C：中断当前回合
Ctrl-O：折叠 / 展开工具输出和压缩摘要

5.6 审批流程

当 Agent 调用有副作用的工具（修改文件、运行命令）时，会弹出审批面板：

↑ / ↓ 选择选项，Enter 确认；或直接按数字键 1~9 快速选择
Esc / Ctrl-C / Ctrl-D 均为拒绝
Ctrl-E 展开 / 折叠 diff 或文件预览
**面板通常包含 **Approve for this session 选项：本次会话内自动批准同类调用；永久规则可在 config.toml 中配置 allow / deny

六、运行模式说明

6.1 Plan 模式（计划模式）

Agent 先输出行动计划，经你批准后才会修改文件——适合复杂或高风险任务。

切换：Shift-Tab 或 /plan
清除当前计划：/plan clear
计划生成后可批准、拒绝或要求修改；即使开启 YOLO，退出 Plan 模式仍需确认（Auto 模式除外）

6.2 YOLO 模式

/yolo 切换。跳过几乎所有工具调用的审批确认，适合已知安全的批量任务。

**⚠️ **警告：YOLO 模式会跳过文件写入和命令执行的确认，仅在可信的工作目录中使用。

6.3 Auto 模式

/auto 切换。工具审批自动处理，且 Agent 不会向用户提问——适合无人值守但又不完全关闭审批的场景。

6.4 权限模式配置

**默认权限模式可在 **config.toml 中设置：

default_permission_mode = "manual"   # manual（每次询问）| auto | yolo

**也可在 TUI 中用 **/permission 命令切换。

七、斜杠命令大全

**在输入框输入 **/ 触发命令补全，候选列表实时过滤。部分命令仅在空闲状态可用（输出流式进行中需先按 Esc 或 Ctrl-C 中断）。

7.1 账户与配置

命令	别名	说明
`/login`	—	选择账户或平台登录（OAuth 设备码 / API Key）
`/logout`	—	清除当前账户凭据
`/provider`	—	打开交互式 Provider 管理器（查看、添加、删除）
`/model`	—	切换当前会话使用的模型
`/settings`	`/config`	打开 TUI 内的设置面板
`/experiments`	`/experimental`	打开实验性功能面板
`/permission`	—	选择权限模式
`/editor`	—	配置`Ctrl-G`启动的外部编辑器
`/theme`	—	切换终端 UI 配色主题

7.2 会话管理

命令	别名	说明
`/new`	`/clear`	开启全新会话，丢弃当前上下文
`/sessions`	`/resume`	浏览历史会话并切换 / 恢复
`/tasks`	`/task`	浏览后台任务列表
`/fork`	—	从当前会话分叉出新会话（保留完整历史，互不影响）
`/title [<文本>]`	`/rename`	无参数显示当前标题；带参数设置新标题（最长 200 字符）
`/compact [<指令>]`	—	手动压缩上下文，可附带提示告知模型保留重点
`/undo [<数量>]`	—	撤销最近的提问；无参数打开选择器
`/reload`	—	重载当前会话并应用最新的`config.toml`和`tui.toml`
`/reload-tui`	—	仅重载`tui.toml`UI 偏好
`/init`	—	分析当前代码库并生成`AGENTS.md`
`/export-md [<路径>]`	`/export`	将当前会话导出为 Markdown 文件
`/export-debug-zip`	—	导出调试 ZIP 包（同`kimi export`）
`/add-dir [<路径>]`	—	为当前会话添加额外工作目录

7.3 模式与运行控制

命令	别名	说明
`/yolo [on\\|off]`	`/yes`	切换 YOLO 模式（跳过常规工具审批）
`/auto [on\\|off]`	—	切换 Auto 自动权限模式
`/plan [on\\|off]`	—	切换 Plan 计划模式
`/plan clear`	—	清除当前计划
`/swarm on\\|off`	—	开关 Swarm 模式
`/swarm <任务>`	—	开启 Swarm 并发送任务，回合正常结束后自动关闭
`/goal [...]`	—	启动或管理自主目标（见第十节）

7.4 信息与状态

命令	别名	说明
`/help`	`/h`、`/?`	显示快捷键和全部可用命令
`/btw [问题]`	—	在分叉的子 Agent 中开启侧边对话，不影响主会话
`/usage`	—	显示 Token 用量、上下文消耗和配额信息
`/status`	—	显示当前会话运行状态（版本、模型、目录、权限模式等）
`/mcp`	—	列出当前会话的 MCP 服务器及连接状态
`/plugins`	—	打开交互式插件管理器
`/version`	—	显示版本号
`/feedback`	—	提交反馈（可附诊断日志和代码库上下文）

7.5 退出

命令	别名	说明
`/exit`	`/quit`、`/q`	退出 Kimi Code CLI

7.6 内置技能命令

命令	说明
`/mcp-config`	配置 MCP 服务器、处理 MCP OAuth 登录
`/custom-theme [<文本>]`	创建或编辑自定义 TUI 配色主题
`/update-config`	查看或编辑`config.toml`与`tui.toml`
`/check-kimi-code-docs`	对照官方文档回答 Kimi Code 产品问题
`/import-from-cc-codex`	从 Claude Code / Codex 导入指令、技能和 MCP 设置

**外部安装的 Skill 会自动注册为 **/skill:<名称> 形式的斜杠命令；名称未冲突时也可直接输入 /<名称>。

八、键盘快捷键

8.1 通用快捷键

快捷键	功能
`Enter`	提交当前输入
`Shift-Enter`/`Ctrl-J`	输入换行
`↑`/`↓`	浏览输入历史
`Esc`	关闭弹窗 / 取消补全 / 中断流式输出
`Ctrl-C`	中断输出或清空输入框；空闲时连按两次退出
`Ctrl-D`	输入框为空时退出（需按两次确认）
`Ctrl-T`	展开 / 折叠被截断的待办列表

8.2 模式切换

快捷键	功能
`Shift-Tab`	切换 Plan 模式
`!`	进入 Shell 模式（空输入框时）

8.3 输入与编辑

快捷键	功能
`Ctrl-G`	在外部编辑器中编辑当前输入
`Ctrl-V`	粘贴图片 / 视频（Unix / macOS）
`Alt-V`	粘贴图片 / 视频（Windows）
`Ctrl--`	撤销
`Esc` `Esc`	打开撤销选择器（空闲时双击）

8.4 流式输出期间

快捷键	功能
`Ctrl-S`	中途注入消息（Steer），无需等待当前回合结束
`Esc`/`Ctrl-C`	中断当前流式输出

8.5 工具输出

快捷键	功能
`Ctrl-O`	折叠 / 展开工具输出和压缩摘要

8.6 审批面板

快捷键	功能
`↑`/`↓`	在选项间移动
`Enter`	确认选中项
`1`~`9`	直接选择对应序号选项
`Esc`/`Ctrl-C`/`Ctrl-D`	拒绝当前请求
`Ctrl-E`	展开 / 折叠 diff 或文件预览

8.7 弹窗浏览

快捷键	功能
`↑`/`↓`	逐行滚动
`PageUp`/`PageDown`	每次滚动 10 行
`Esc`/`Enter`/`q`	关闭面板

九、会话管理

9.1 恢复会话

kimi --continue          # 恢复当前目录最近一次会话（-c）
kimi --session           # 交互式浏览历史会话
kimi --session <id>      # 按 ID 恢复指定会话

--continue 与 --session 互斥，不能同时使用。

9.2 上下文压缩

对话变长时，接近上下文窗口上限会自动压缩；也可随时手动触发：

/compact                              # 手动压缩
/compact 保留关于数据库迁移的讨论       # 带提示压缩，告知保留重点

9.3 分叉会话

/fork

**分叉出两个完全独立的会话，适合在不干扰当前对话的情况下探索新方向。可用 **/sessions 随时切换回原会话。注意：已保存的 /goal 不会复制到分叉会话。

9.4 导出会话

kimi export <sessionId>                  # 导出指定会话为 ZIP
kimi export -y                           # 导出当前目录最近会话，跳过确认
kimi export <sessionId> -o ./report.zip  # 指定输出路径

TUI 内导出：

/export-md（别名 /export）：导出为可读的 Markdown 文件
/export-debug-zip：导出调试 ZIP（同 kimi export）

导出文件可能包含代码、命令输出、文件路径等敏感信息，分享前请先检查。

十、目标模式（Goal）

Goal 模式让 Kimi Code 围绕一个明确的结果跨多个自动回合持续工作。与普通提示"下一步做什么"不同，目标描述的是"什么必须成立"。

10.1 启动目标

/goal 修复 issue  tracker 中列出的所有 Bug。

好的目标应写明终点和验证证据：

/goal 修复所有标记为 checkout-regression 的 Bug，为每个修复补充测试，并跑通 checkout 测试套件

避免只给宽泛方向（如"找出代码库中所有 Bug"），那会导致目标无法收敛。

10.2 生命周期管理

命令	作用
`/goal`或`/goal status`	查看当前目标及进度（已用时间、回合数、Token 数）
`/goal pause`	暂停目标（保留不删除）
`/goal resume`	恢复已暂停 / 受阻的目标
`/goal cancel`	删除当前目标
`/goal replace <新目标>`	替换当前目标
`/goal next <目标>`	排队下一个目标，当前目标完成后自动开始
`/goal next manage`	交互式管理排队目标（排序、编辑、删除）

**目标的三种结束方式：**complete（完成）、paused（暂停）、blocked（受阻，会说明原因）。

10.3 非交互模式

kimi -p "/goal 修复失败的 checkout 测试"

**退出码：完成 **0、受阻 3、暂停 6。

**在 **manual 权限模式下，Goal 工作可能因工具审批而暂停；无人值守任务请使用与仓库风险匹配的权限模式。

十一、配置文件

11.1 文件位置

主配置：~/.kimi-code/config.toml（Agent 与运行时设置）
UI 配置：~/.kimi-code/tui.toml（主题、编辑器、通知、自动更新）
项目级配置：<项目根目录>/.kimi-code/local.toml（项目专属，建议加入 .gitignore）

**可用环境变量 **KIMI_CODE_HOME 迁移数据目录。TOML 字段名一律使用 snake_case；键名含 . 时必须加引号，如 [models."gpt-4.1"]。

11.2 常用顶层字段（config.toml）

字段	默认值	说明
`default_model`	—	默认模型别名（须在`models`中定义）
`default_permission_mode`	`manual`	新会话默认权限模式：`manual`/`auto`/`yolo`
`default_plan_mode`	`false`	新会话是否默认进入 Plan 模式
`merge_all_available_skills`	`true`	是否合并所有目录中的 Agent Skills
`extra_skill_dirs`	—	额外的技能搜索目录
`telemetry`	`true`	匿名遥测开关

11.3 常用配置示例

default_model = "kimi-code/kimi-for-coding"
default_permission_mode = "manual"

[providers."managed:kimi-code"]
type = "kimi"
base_url = "https://api.kimi.com/coding/v1"
api_key = ""

[models."kimi-code/kimi-for-coding"]
provider = "managed:kimi-code"
model = "kimi-for-coding"
max_context_size = 262144
capabilities = [ "thinking", "always_thinking", "image_in", "video_in", "tool_use" ]

[thinking]
enabled = true
effort = "high"

# 权限规则：按顺序匹配，第一条命中的规则生效
[[permission.rules]]
decision = "allow"
pattern = "Read"

[[permission.rules]]
decision = "deny"
pattern = "Bash(rm -rf*)"

Provider 支持类型：kimi、anthropic、openai、openai_responses、google-genai、vertexai。

注意：CLI 只从配置文件读取凭据，不会自动读取 Shell 环境变量中的 API Key。

11.4 tui.toml 示例

theme = "auto"          # auto | dark | light | 自定义主题名

[editor]
command = ""            # 外部编辑器命令，留空则用 $VISUAL / $EDITOR

[notifications]
enabled = true
notification_condition = "unfocused"   # unfocused | always

[upgrade]
auto_install = true

**修改后重启生效，或用 **/reload（同时重载 config 与 tui）、/reload-tui（仅 tui）立即生效。

11.5 校验配置

kimi doctor                    # 校验 config.toml 和 tui.toml
kimi doctor config             # 仅校验 config.toml
kimi doctor tui ./tui.toml     # 校验指定文件

十二、kimi 命令行参数与子命令

12.1 主命令参数

参数	简写	说明
`--version`	`-V`	打印版本号并退出
`--help`	`-h`	显示帮助并退出
`--session [id]`	`-S`	恢复会话：带 ID 直接打开，不带则进入选择器
`--continue`	`-c`	继续当前目录最近一次会话
`--model <模型>`	`-m`	指定本次启动的模型别名
`--prompt <提示词>`	`-p`	非交互执行单个提示词，输出到 stdout
`--output-format <格式>`	—	配合`-p`使用：`text`或`stream-json`
`--yolo`	`-y`	自动批准常规工具调用
`--auto`	—	自动权限模式，不向用户提问
`--plan`	—	以 Plan 模式启动新会话
`--skills-dir <目录>`	—	从指定目录加载 Skills（可重复，替换自动发现目录）
`--add-dir <目录>`	—	添加额外工作目录（可重复）

互斥规则：

--continue 与 --session 互斥
--yolo 与 --auto 互斥
--prompt 不能与 --yolo、--auto、--plan 同用
--output-format 只能与 --prompt 同用

12.2 子命令一览

子命令	说明
`kimi login`	非交互 OAuth 设备码登录
`kimi acp`	ACP 模式（供 IDE 调用，一般无需手动运行）
`kimi server`	运行 / 管理本地 REST + WebSocket 服务（`run`/`install`/`start`/`stop`/`status`等）
`kimi web`	启动本地服务并在浏览器打开 Web 界面（等价`kimi server run --open`）
`kimi doctor`	校验配置文件
`kimi export`	导出会话为 ZIP
`kimi migrate`	从旧版 kimi-cli 迁移数据
`kimi upgrade`	检查并升级版本
`kimi vis`	在浏览器中可视化查看会话
`kimi provider`	在 Shell 中管理 Provider（`add`/`remove`/`list`/`catalog`），适合脚本化部署

十三、常见问题（FAQ）

Q1：/login 时模型列表为空，提示 "No models available"？

API Key 无效或过期：检查 Key 是否正确、仍有效
**网络问题：确认能访问 **api.kimi.com 或 api.moonshot.cn
注意区分平台：Kimi Code 会员（https://api.kimi.com/coding/，订阅制）与 Kimi 开放平台（https://api.moonshot.cn/v1，按量付费）的 Base URL 和 Key 不通用

Q2：API Key 无效？

检查是否有多余空格或缺字符；在控制台确认 Key 状态（是否过期 / 被吊销）

Q3：会员过期或配额耗尽？

**用 **/usage 查看当前配额与会员状态，前往 Kimi Code 官网续费或升级

Q4：粘贴图片失败，提示不支持图像输入？

**当前模型不具备 **image_in 能力，切换到支持视觉的模型；并确认剪贴板中是真实图像数据而非文件路径

Q5：macOS 首次启动很慢？

Gatekeeper 首次安全检查所致，耐心等待；也可在系统设置 → 隐私与安全性 → 开发者工具中添加终端应用

Q6：如何升级？

**运行 **kimi upgrade，或 npm install -g @moonshot-ai/kimi-code@latest

Q7：问题仍未解决？

发送邮件至 code@moonshot.ai，描述问题、复现步骤及相关日志

十四、数据存储位置

**默认数据目录为 **~/.kimi-code/（可用 KIMI_CODE_HOME 环境变量更改）：

~/.kimi-code/
├── config.toml            # 主配置
├── tui.toml               # UI 偏好
├── session_index.jsonl    # 会话索引
├── logs/
│   └── kimi-code.log      # 全局诊断日志
└── sessions/
    └── <工作目录标识>/
        └── <sessionId>/
            ├── state.json          # 会话元数据（标题、创建时间）
            └── agents/
                ├── main/wire.jsonl        # 主 Agent 事件流
                └── <子AgentId>/wire.jsonl # 子 Agent 事件流

**⚠️ 不要手动编辑 **sessions/ 目录内的文件，否则可能导致会话无法恢复。

附录：快速上手速查卡

我想……	怎么做
开始新会话	`kimi`
继续上次对话	`kimi -c`
单次执行任务	`kimi -p "任务描述"`
登录 / 退出登录	`/login`/`/logout`
切换模型	`/model`或`kimi -m <别名>`
让 AI 先出方案再动手	`Shift-Tab`（Plan 模式）
跳过审批快速执行	`/yolo`（谨慎使用）
压缩上下文释放空间	`/compact`
引用文件给 AI 看	输入`@`选择文件
粘贴截图	`Alt-V`（Windows）
跑个终端命令	输入`!`进入 Shell 模式
中途补充指示	输入后按`Ctrl-S`
中断当前输出	`Esc`或`Ctrl-C`
查看用量配额	`/usage`
导出对话记录	`/export-md`
查看全部命令	`/help`
退出程序	`/exit`或空闲时`Ctrl-C`两次

本手册内容基于 Kimi Code 官方文档（https://www.kimi.com/code/docs/en/）整理，如有出入以官方文档为准。

标题：Kimi Code操作手册—编写自k3
作者：llp
地址：https://llinp.cn/articles/2026/07/18/1784345538506.html