Kimi Code 文档

简体中文

English

简体中文

English

Appearance

kimi 命令 ​

kimi 是 Kimi Code CLI 的主命令，用于在终端中启动一次交互式会话。不带任何参数运行时，它会在当前工作目录下开启一个新会话；配合不同的 flag，可以续上历史会话、跳过审批、从 Plan 模式开始，或者指定自定义的 Skills 目录。

sh
kimi [options]
kimi <subcommand> [options]

主命令选项 ​

所有 flag 都是可选的，直接运行 kimi 即可进入交互式会话：

选项简写说明
--version-V打印版本号并退出
--help-h显示帮助信息并退出
--session [id]-S恢复一个会话。带 ID 时直接打开指定会话；不带 ID 时进入交互式选择器
--continue-C继续当前工作目录下最近一次的会话，无需手动指定 ID
--model <model>-m为本次启动指定模型别名。省略时新会话使用配置文件中的 default_model
--prompt <prompt>-p非交互执行单次 prompt，并把 Assistant 输出流式写到 stdout。该模式不会打开 TUI
--output-format <format>设置非交互输出格式，支持 text 与 stream-json。仅可与 --prompt 一起使用，默认 text
--yolo-y自动批准普通工具调用，跳过审批请求
--auto以 auto 权限模式启动；工具审批自动处理，Agent 不会向用户提问
--plan以 Plan 模式启动新会话，AI 会优先使用只读工具进行探索和规划
--skills-dir <dir>从指定目录加载 Skills，替换自动发现的用户和项目目录。可重复传入

-r / --resume 是 --session 的隐藏别名；--yes 和 --auto-approve 是 --yolo 的隐藏别名，在帮助信息中不显示。

注意

--yolo 会跳过普通工具调用的人工确认，包括文件写入和 Shell 命令执行，请只在受信任的工作目录下使用。Plan 模式的退出审批不会被 --yolo 跳过；Plan 模式下的 Bash 按普通放行规则处理。

flag 冲突规则 ​

以下组合会在启动时被拒绝：

  • --continue 与 --session 互斥——两者都表示"恢复历史会话"
  • --yolo 和 --auto 互斥——两种权限模式互斥
  • --yolo 与 --auto 不能与 --continue 或 --session 同时使用——恢复会话时沿用原会话的审批设置
  • --plan 不能与 --continue 或 --session 同时使用——Plan 模式只对新会话生效
  • --prompt 不能与 --yolo、--auto 或 --plan 同时使用——非交互模式固定使用 auto 权限
  • --output-format 只能与 --prompt 一起使用

如需在恢复会话时强制使用 YOLO 或 Plan 模式，请改在交互式会话内通过斜杠命令切换。

典型用法 ​

直接运行开启新会话：

sh
kimi

从上次中断的地方继续（自动找到当前目录最近的会话）：

sh
kimi --continue

从历史会话列表中挑选，或直接指定已知 ID：

sh
kimi --session
kimi --session 01HZ...XYZ

跳过审批确认，适合已知安全的批处理任务：

sh
kimi --yolo

让 Agent 自行处理一切，不再向用户提问：

sh
kimi --auto

先阅读代码、产出实现计划，而不是立刻动手修改文件：

sh
kimi --plan

自定义 Skills 目录 ​

有两种方式指定 Skills 目录，语义不同：

  • --skills-dir <dir>（CLI flag）：替换自动发现的用户和项目目录，仅对本次启动生效。可重复传入以叠加多个目录：

    sh
    kimi --skills-dir /path/to/team-skills --skills-dir ./local-skills

  • extra_skill_dirs（config.toml）：叠加到自动发现的目录之上，长期生效，适合配置团队共享 Skills。详见 Agent Skills。

非交互执行 ​

在脚本或 CI 中运行单次 prompt 时，使用 -p：

sh
kimi -p "Summarize the current repository status"

输出采用 transcript 样式：thinking 内容和 Assistant 正文都以 • 开头，换行后两个空格缩进。Assistant 正文输出到 stdout；thinking、工具进度和"恢复会话"提示输出到 stderr。-p 模式不会请求人工审批，普通工具调用按 auto 权限策略处理，静态 deny 规则仍然生效。

临时切换模型：

sh
kimi -m kimi-code/kimi-for-coding -p "Explain the latest diff"

需要结构化读取输出时，使用 stream-json 格式——stdout 每行都是一个 JSON 对象：

sh
kimi -p "List changed files" --output-format stream-json

stream-json 模式下，普通回复输出 Assistant 消息；模型调用工具时，先输出带 tool_calls 的 Assistant 消息，再输出对应的 Tool 消息，最后继续输出后续 Assistant 消息。thinking 内容不会写入 JSONL；工具进度和恢复会话提示仍写到 stderr。

子命令 ​

kimi 提供以下子命令：login（非交互式登录）、acp（ACP IDE 模式）、doctor（校验配置文件）、export（导出会话）、migrate（迁移旧版数据）、upgrade（检查更新）、provider（管理供应商）。

kimi login ​

通过 RFC 8628 device-code 流程登录 Kimi Code OAuth，无需进入 TUI。命令会发起一次 device authorization 请求，将验证地址和用户码打印到 stderr，然后轮询直到浏览器侧完成授权。生成的 token 写入与 TUI /login 相同的本地位置，下次启动 kimi 时会自动加载。

sh
kimi login

该子命令没有任何 flag。在轮询期间随时按 Ctrl-C 可取消登录；取消或失败时退出码为 1，成功为 0。

kimi acp ​

把 Kimi Code CLI 切换到 ACP（Agent Client Protocol）模式，在标准输入/输出上以 JSON-RPC 形式与 IDE 对话，让编辑器直接驱动 kimi 的会话和工具调用。通常不需要手动运行——IDE 会把它作为子进程入口启动。配置方式见在 IDE 中使用，技术细节见 kimi acp 参考。

sh
kimi acp

kimi doctor ​

校验 config.toml 和 tui.toml，不会启动 TUI，也不会修改任一文件。默认检查 KIMI_CODE_HOME 下的文件；未设置该环境变量时检查 ~/.kimi-code。默认路径缺失时会显示为跳过，因为内置默认值仍可生效。

sh
kimi doctor
命令说明
kimi doctor校验默认 config.toml 和 tui.toml
kimi doctor config [path]只校验 config.toml；传入 path 时使用该文件而不是默认文件
kimi doctor tui [path]只校验 tui.toml；传入 path 时使用该文件而不是默认文件

显式传入路径时，文件必须存在。所有被检查的文件都有效或被跳过时，退出码为 0；任何指定文件缺失或配置无效时，退出码为 1。

sh
# 检查默认配置文件
kimi doctor

# 只检查默认运行时配置
kimi doctor config

# 替换正式 TUI 配置前，先检查候选文件
kimi doctor tui ./tui.toml

kimi export ​

把一个会话打包成 ZIP 文件，便于分享、归档或提交问题反馈。

sh
kimi export [sessionId] [options]
参数 / 选项简写说明
sessionId要导出的会话 ID。省略时自动选择当前工作目录下最近一次的会话，并要求确认
--output <path>-o输出 ZIP 文件路径。省略时写入当前目录下的默认文件名
--yes-y跳过默认会话的确认提示，直接导出
--no-include-global-log不打包全局诊断日志。默认包含

导出包含目标会话目录内的所有文件。全局诊断日志（~/.kimi-code/logs/kimi-code.log）默认包含，因为它可能含有其他会话或项目的事件；不想分享时加 --no-include-global-log。

sh
# 导出当前工作目录最近一次会话，跳过确认
kimi export -y

# 导出指定会话到自定义路径
kimi export 01HZ...XYZ -o ./bug-report.zip

# 排除全局诊断日志
kimi export 01HZ...XYZ -o ./bug-report.zip --no-include-global-log

kimi migrate ​

将旧版 kimi-cli 的本地数据迁移到 kimi-code，包括历史会话和配置文件。纯交互式运行，会引导你完成全流程。

sh
kimi migrate

完整迁移说明见从 kimi-cli 迁移。

kimi upgrade ​

立即检查最新版本并展示更新提示，选择操作后退出。

sh
kimi upgrade

对全局 npm、pnpm、yarn、bun 以及 macOS / Linux native 安装，kimi upgrade 会展示更新选项；选择 Install update now 后运行对应的前台安装命令。当前安装方式无法自动升级时（如 Windows native 安装），改为打印手动更新命令。

kimi provider ​

在 shell 中管理供应商，相当于 TUI 中 /provider 的非交互版本。适合脚本化部署、CI 初始化，以及在新机器上一行完成配置。

sh
kimi provider <action> [options]

包含五个动作：

kimi provider add <url> ​

从自定义 registry（api.json）批量导入所有供应商。命令会拉取 registry，为每个条目创建 [providers.<id>] 和 [models.<alias>]，并写入 source 元数据，使 TUI 下次启动时自动刷新模型列表。

参数 / 选项说明
<url>Registry 地址
--api-key <key>访问 registry 时携带的 Bearer token。未传时回退到环境变量 KIMI_REGISTRY_API_KEY，必填
sh
kimi provider add https://registry.example.com/v1/models/api.json --api-key YOUR_KEY

# 或通过环境变量（适合 CI / .envrc）
KIMI_REGISTRY_API_KEY=YOUR_KEY kimi provider add https://registry.example.com/v1/models/api.json

如果某个 provider id 已存在，会先删除再重新写入。不会自动设置默认模型，后续可用 -m 或 TUI 内的 /model 选择。

kimi provider remove <providerId> ​

删除指定供应商及其所有模型 alias。如果被删除的供应商正好是 default_model 所属，则同时清空 default_model。

sh
kimi provider remove kohub

kimi provider list ​

按行打印每个已配置的供应商，含类型、模型数量、来源。加 --json 可输出原始的 providers 和 models 表，便于程序化处理。

sh
kimi provider list
kimi provider list --json | jq '.providers | keys'

kimi provider catalog list [providerId] ​

在不修改任何配置的情况下浏览公开的 models.dev 模型目录。不传参数时列出所有供应商及协议类型和模型数量；传 providerId 时列出该供应商下所有模型的上下文窗口和能力。

参数 / 选项说明
[providerId]可选，要查看的供应商 id
--filter <substring>按 id 或 name 大小写不敏感子串过滤
--url <url>覆盖 catalog 地址，默认 https://models.dev/api.json
--json以 JSON 形式输出匹配片段
sh
kimi provider catalog list
kimi provider catalog list --filter anthropic
kimi provider catalog list anthropic

kimi provider catalog add <providerId> ​

按 id 从 catalog 直接导入一个已知供应商，协议类型、base URL、模型信息均由 catalog 提供，只需提供 API key。

参数 / 选项说明
<providerId>catalog 中的供应商 id，如 anthropic、openai
--api-key <key>供应商 API key。未传时回退到 KIMI_REGISTRY_API_KEY，必填
--default-model <modelId>可选，导入后把 default_model 设为 <providerId>/<modelId>
--url <url>覆盖 catalog 地址，默认 https://models.dev/api.json
sh
kimi provider catalog list anthropic          # 先看可选的模型
kimi provider catalog add anthropic --api-key sk-ant-... --default-model claude-opus-4-7

下一步 ​

  • 斜杠命令 — 交互式 TUI 内的控制命令速查
  • 配置文件 — default_model、权限模式等启动参数的持久化配置
  • Agent Skills — --skills-dir 加载的 Skill 文件格式