kimi 命令

​

代码块​

Plain Text

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

​

•

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

非交互执行​

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

​

代码块​

Plain Text

kimi -p "Summarize the current repository status"​

​

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

临时切换模型：​

​

代码块​

Plain Text

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

​

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

​

代码块​

Plain Text

​

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

子命令​

kimi 提供以下子命令：login（非交互式登录）、acp（ACP IDE 模式）、server（运行并管理本地 REST/WebSocket/web 服务）、web（kimi server run --open 的别名）、doctor（校验配置文件）、export（导出会话）、migrate（迁移旧版数据）、upgrade（检查更新）、provider（管理供应商）。​

​

代码块​

Plain Text

kimi login​

​

kimi login​

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

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

kimi acp​

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

​

代码块​

Plain Text

kimi acp​

​

kimi server​

运行并管理本地 Kimi 服务 —— 同一个进程同时挂载 REST + WebSocket API 与 web UI。父命令拆成按需入口 (run) 与 OS 级生命周期管理 (install、uninstall、start、stop、restart、status)。kimi server run 会确保一个后台守护进程在运行、健康后返回；如需把服务挂在当前终端，请加 --foreground。​

服务运行时，GET /openapi.json 会返回 REST OpenAPI 文档，GET /asyncapi.json 会返回本地 WebSocket 协议的 AsyncAPI 文档。​

​

代码块​

Plain Text

kimi server run # 启动或复用一个后台守护进程kimi server run --foreground # 挂在当前终端前台运行kimi server install # 注册到 launchd / systemd / schtaskskimi server start # 启动 OS 管理的服务kimi server status # 查看安装与运行状态​

​

kimi server run​

​

​

kimi server run 只绑定本机 loopback 地址。默认会 spawn 一个后台守护进程（多次运行会复用同一个），健康后即退出；守护进程在最后一个 web 客户端断开后自行关闭。加 --keep-alive 可让它在空闲超时后继续运行，或加 --foreground 则在当前进程中运行——保持挂在终端，在 SIGINT / SIGTERM 时干净退出。​

警告​

--dangerous-bypass-auth 会彻底关闭鉴权。任何能访问该端口的人都能完全控制你的会话、文件系统和 shell。请仅在可信网络或自有鉴权反向代理之后使用，用完后运行 kimi server kill 停止服务。​

kimi server install​

把服务注册成 OS 管理的进程，开机自启、崩溃后自动重启。根据当前平台选择对应后端：​

•

macOS：写 LaunchAgent plist 到 ~/Library/LaunchAgents/ai.moonshot.kimi-server.plist，并通过 launchctl bootstrap gui/ 启动。​

•

Linux：写 --user systemd unit 到 ~/.config/systemd/user/kimi-server.service，并执行 systemctl --user enable --now。​

•

Windows：通过 schtasks /Create /XML 注册名为 KimiServer 的计划任务。​

​

​

本机地址、选定的端口和日志级别会写入 ~/.kimi-code/server/install.json，即便服务停掉 kimi server status 也能读到。​

生命周期子命令​

​

​

kimi web​

在浏览器中打开 Kimi 的图形会话界面，作为终端 TUI 的替代入口。​

等价于 kimi server run --open：在后台启动本地 Kimi 服务（若已运行则复用），用默认浏览器打开 web UI，随后命令返回，服务驻留后台。与 kimi server run 的唯一区别是默认启用 --open（自动打开浏览器），其余行为一致。​

​

代码块​

Plain Text

kimi web # 后台启动服务并打开浏览器（已运行则复用）kimi web --no-open # 不打开浏览器，等同 `kimi server run`kimi web --foreground # 在当前终端前台运行，同时打开浏览器​

​

停止服务使用 kimi server kill，查看活动连接使用 kimi server ps；--port、--log-level 等选项与 kimi server run 一致。​

kimi doctor​

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

​

代码块​

Plain Text

kimi doctor​

​

​

​

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

​

代码块​

Plain Text

# 检查默认配置文件kimi doctor# 只检查默认运行时配置kimi doctor config# 替换正式 TUI 配置前，先检查候选文件kimi doctor tui ./tui.toml​

​

kimi export​

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

​

代码块​

Plain Text

kimi export [sessionId] [options]​

​

​

​

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

​

代码块​

Plain Text

# 导出当前工作目录最近一次会话，跳过确认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，包括历史会话和配置文件。纯交互式运行，会引导你完成全流程。​

​

代码块​

Plain Text

kimi migrate​

​

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

kimi upgrade​

立即检查最新版本并展示更新提示，选择操作后退出。也可以使用别名 kimi update。​

​

代码块​

Plain Text

kimi upgrade​

​

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

kimi vis​

在浏览器中启动会话可视化工具，直观查看一次会话的全过程。命令会启动一个指向本地会话的进程内服务器，打印访问地址并打开浏览器，持续运行直到你按下 Ctrl-C。​

​

代码块​

Plain Text

kimi vis [sessionId] [options]​

​

​

​

​

代码块​

Plain Text

​

kimi provider​

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

​

代码块​

Plain Text

kimi provider [options]​

​

包含五个动作：​

kimi provider add ​

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

​

​

​

代码块​

Plain Text

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 ​

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

​

代码块​

Plain Text

​

kimi provider list​

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

​

代码块​

Plain Text

kimi provider listkimi provider list --json | jq '.providers | keys'​

​

kimi provider catalog list [providerId]​

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

​

​

​

代码块​

Plain Text

kimi provider catalog listkimi provider catalog list --filter anthropickimi provider catalog list anthropic​

​

kimi provider catalog add ​

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

​

​

​

代码块​

Plain Text

kimi provider catalog list anthropic # 先看可选的模型kimi provider catalog add anthropic --api-key sk-ant-... --default-model claude-opus-4-7​

​

​