---
url: /kimi-cli/zh/reference/kimi-command.md
---
# `kimi` 命令

`kimi` 是 Kimi Code CLI 的主命令，用于启动交互式会话或执行单次查询。

```sh
kimi [OPTIONS] COMMAND [ARGS]
```

## 基本信息

| 选项 | 简写 | 说明 |
|------|------|------|
| `--version` | `-V` | 显示版本号并退出 |
| `--help` | `-h` | 显示帮助信息并退出 |
| `--verbose` | | 输出详细运行信息 |
| `--debug` | | 记录调试日志（输出到 `~/.kimi/logs/kimi.log`） |

## Agent 配置

| 选项 | 说明 |
|------|------|
| `--agent NAME` | 使用内置 Agent，可选值：`default`、`okabe` |
| `--agent-file PATH` | 使用自定义 Agent 文件 |

`--agent` 和 `--agent-file` 互斥，不能同时使用。详见 [Agent 与子 Agent](../customization/agents.md)。

## 配置文件

| 选项 | 说明 |
|------|------|
| `--config STRING` | 加载 TOML/JSON 配置字符串 |
| `--config-file PATH` | 加载配置文件（默认 `~/.kimi/config.toml`） |

`--config` 和 `--config-file` 互斥。配置字符串和文件均支持 TOML 和 JSON 格式。详见 [配置文件](../configuration/config-files.md)。

## 模型选择

| 选项 | 简写 | 说明 |
|------|------|------|
| `--model NAME` | `-m` | 指定 LLM 模型，覆盖配置文件中的默认模型 |

## 工作目录

| 选项 | 简写 | 说明 |
|------|------|------|
| `--work-dir PATH` | `-w` | 指定工作目录（默认当前目录） |
| `--add-dir PATH` | | 添加额外目录到工作区范围，可多次指定 |

工作目录决定了文件操作的根目录。在工作目录内可使用相对路径，操作工作目录外的文件需使用绝对路径。

`--add-dir` 可以将工作目录之外的目录纳入工作区范围，使所有文件工具可以访问该目录中的文件。添加的目录会随会话状态持久化。运行中也可以通过 [`/add-dir`](./slash-commands.md#add-dir) 斜杠命令添加。

## 会话管理

| 选项 | 简写 | 说明 |
|------|------|------|
| `--continue` | `-C` | 继续当前工作目录的上一个会话 |
| `--session [ID]` / `--resume [ID]` | `-S` / `-r` | 恢复会话。带 ID 时恢复指定会话（不存在则创建新会话）；不带 ID 时打开交互式会话选择器（仅 Shell 模式） |

`--continue` 和 `--session`/`--resume` 互斥。

## 输入与命令

| 选项 | 简写 | 说明 |
|------|------|------|
| `--prompt TEXT` | `-p` | 传入用户提示，不进入交互模式 |
| `--command TEXT` | `-c` | `--prompt` 的别名 |

使用 `--prompt`（或 `--command`）时，Kimi Code CLI 会处理完查询后退出（除非指定 `--print`，否则仍以交互模式显示结果）。

## 循环控制

| 选项 | 说明 |
|------|------|
| `--max-steps-per-turn N` | 单轮最大步数，覆盖配置文件中的 `loop_control.max_steps_per_turn` |
| `--max-retries-per-step N` | 单步最大重试次数，覆盖配置文件中的 `loop_control.max_retries_per_step` |
| `--max-ralph-iterations N` | Ralph 循环模式的迭代次数；`0` 表示关闭；`-1` 表示无限 |

### Ralph 循环

[Ralph](https://ghuntley.com/ralph/) 是一种把 Agent 放进循环的技术：同一条提示词会被反复喂给 Agent，让它围绕一个任务持续迭代。

当 `--max-ralph-iterations` 非 `0` 时，Kimi Code CLI 会进入 Ralph 循环模式，自动循环执行任务，直到 Agent 输出 `<choice>STOP</choice>` 或达到迭代上限。

## UI 模式

| 选项 | 说明 |
|------|------|
| `--print` | 以 Print 模式运行（非交互式），隐式启用 `--afk` |
| `--quiet` | `--print --output-format text --final-message-only` 的快捷方式 |
| `--acp` | 以 ACP 服务器模式运行（已弃用，请使用 `kimi acp`） |
| `--wire` | 以 Wire 服务器模式运行（实验性） |

四个选项互斥，只能选择一个。默认使用 Shell 模式。详见 [Print 模式](../customization/print-mode.md) 和 [Wire 模式](../customization/wire-mode.md)。

## Print 模式选项

以下选项仅在 `--print` 模式下有效：

| 选项 | 说明 |
|------|------|
| `--input-format FORMAT` | 输入格式：`text`（默认）或 `stream-json` |
| `--output-format FORMAT` | 输出格式：`text`（默认）或 `stream-json` |
| `--final-message-only` | 仅输出最终的 assistant 消息 |

`stream-json` 格式使用 JSONL（每行一个 JSON 对象），用于程序化集成。

## MCP 配置

| 选项 | 说明 |
|------|------|
| `--mcp-config-file PATH` | 加载 MCP 配置文件，可多次指定 |
| `--mcp-config JSON` | 加载 MCP 配置 JSON 字符串，可多次指定 |

默认加载 `~/.kimi/mcp.json`（如果存在）。详见 [Model Context Protocol](../customization/mcp.md)。

## 审批控制

| 选项 | 简写 | 说明 |
|------|------|------|
| `--yolo` | `-y` | 自动批准所有工具调用（用户仍可回应 `AskUserQuestion`） |
| `--yes` | | `--yolo` 的别名 |
| `--auto-approve` | | `--yolo` 的别名 |
| `--afk` | | Away-from-keyboard 模式：自动批准所有工具调用，并自动 dismiss `AskUserQuestion`，适用于无人值守场景 |

::: warning 注意
YOLO 或 AFK 模式下，所有文件修改和 Shell 命令都会自动执行，请谨慎使用。
:::

## 计划模式

| 选项 | 说明 |
|------|------|
| `--plan` | 以计划模式启动新会话 |

使用 `--plan` 启动时，AI 只能使用只读工具探索代码库并编写实现计划。恢复已有会话时，`--plan` 会强制开启计划模式；不带 `--plan` 恢复的会话保留其原有状态。

也可以在配置文件中设置 `default_plan_mode = true`，每次启动新会话时默认进入计划模式。详见 [配置文件](../configuration/config-files.md)。

## Thinking 模式

| 选项 | 说明 |
|------|------|
| `--thinking` | 启用 thinking 模式 |
| `--no-thinking` | 禁用 thinking 模式 |

Thinking 模式需要模型支持。如果不指定，使用上次会话的设置。

## Skills 配置

| 选项 | 说明 |
|------|------|
| `--skills-dir PATH` | 追加额外的 skills 目录（可重复指定） |

不指定时，Kimi Code CLI 会按优先级自动发现用户级和项目级 Skills 目录。详见 [Agent Skills](../customization/skills.md)。

## 子命令

| 子命令 | 说明 |
|--------|------|
| [`kimi login`](#kimi-login) | 登录 Kimi 账号 |
| [`kimi logout`](#kimi-logout) | 登出 Kimi 账号 |
| [`kimi info`](./kimi-info.md) | 显示版本和协议信息 |
| [`kimi acp`](./kimi-acp.md) | 启动多会话 ACP 服务器 |
| [`kimi mcp`](./kimi-mcp.md) | 管理 MCP 服务器配置 |
| [`kimi plugin`](../customization/plugins.md) | 管理插件（Beta） |
| [`kimi term`](./kimi-term.md) | 启动 Toad 终端 UI |
| [`kimi export`](#kimi-export) | 导出会话为 ZIP 文件 |
| [`kimi vis`](./kimi-vis.md) | 启动 Agent Tracing Visualizer（技术预览） |
| [`kimi web`](./kimi-web.md) | 启动 Web UI 服务器 |

### `kimi login`

登录 Kimi 账号。执行后会自动打开浏览器，完成账号授权后自动配置可用的模型。

```sh
kimi login
```

### `kimi logout`

登出 Kimi 账号。会清理存储的 OAuth 凭据并移除配置文件中的相关配置。

```sh
kimi logout
```

### `kimi export`

将会话数据导出为 ZIP 文件。ZIP 中包含会话目录下的所有文件（`context.jsonl`、`wire.jsonl`、`state.json` 等）及相关的诊断日志。

```sh
kimi export [<session_id>] [-o <output_path>] [--yes]
```

| 参数 / 选项 | 说明 |
|------|------|
| `<session_id>` | 要导出的会话 ID。省略时，CLI 会预览并确认当前工作目录的上一个会话，然后再导出 |
| `--output, -o` | 输出 ZIP 文件路径（默认为当前目录下的 `session-<id>.zip`） |
| `--yes, -y` | 跳过默认会话的确认提示，直接导出 |

::: info 新增
新增于 1.20 版本。
:::

### `kimi vis`

::: warning 注意
技术预览功能，可能不稳定。
:::

启动 Agent Tracing Visualizer，通过浏览器查看和分析会话追踪数据。

```sh
kimi vis [OPTIONS]
```

| 选项 | 简写 | 说明 |
|------|------|------|
| `--host TEXT` | `-h` | 绑定的主机地址（默认：`127.0.0.1`） |
| `--network` | `-n` | 监听所有网络接口（绑定到 `0.0.0.0`），自动检测并显示局域网 IP |
| `--port INTEGER` | `-p` | 绑定的端口号（默认：`5495`） |
| `--open / --no-open` | | 自动打开浏览器（默认：启用） |
| `--reload` | | 启用自动重载（开发模式） |

详见 [Agent Tracing Visualizer](./kimi-vis.md)。

### `kimi web`

启动 Web UI 服务器，通过浏览器访问 Kimi Code CLI。

```sh
kimi web [OPTIONS]
```

如果默认端口被占用，服务器会自动尝试下一个可用端口（默认范围 `5494`–`5503`），并在终端打印提示。

| 选项 | 简写 | 说明 |
|------|------|------|
| `--host TEXT` | `-h` | 绑定的主机地址（默认：`127.0.0.1`） |
| `--network` | `-n` | 监听所有网络接口（绑定到 `0.0.0.0`），自动检测并显示局域网 IP |
| `--port INTEGER` | `-p` | 绑定的端口号（默认：`5494`） |
| `--reload` | | 启用自动重载（开发模式） |
| `--open / --no-open` | | 自动打开浏览器（默认：启用） |

示例：

```sh
# 默认启动，自动打开浏览器
kimi web

# 指定端口
kimi web --port 8080

# 不自动打开浏览器
kimi web --no-open

# 绑定到所有网络接口（允许局域网访问）
kimi web --host 0.0.0.0
```

详见 [Web UI](./kimi-web.md)。