---
url: /kimi-cli/zh/configuration/data-locations.md
---
# 数据路径

Kimi Code CLI 将所有数据存储在用户主目录下的 `~/.kimi/` 目录中。本页介绍各类数据文件的位置和用途。

::: tip 提示
可以通过设置 `KIMI_SHARE_DIR` 环境变量来自定义共享目录路径。详见 [环境变量](./env-vars.md#kimi-share-dir)。

注意：`KIMI_SHARE_DIR` 仅影响上述运行时数据的存储位置，不影响 [Agent Skills](../customization/skills.md) 的搜索路径。Skills 作为跨工具共享的能力扩展，与运行时数据是不同类型的数据。
:::

## 目录结构

```
~/.kimi/
├── config.toml           # 主配置文件
├── kimi.json             # 元数据
├── mcp.json              # MCP 服务器配置
├── credentials/          # OAuth 凭据
│   └── <provider>.json
├── mcp-oauth/            # MCP OAuth token
├── sessions/             # 会话数据
│   └── <work-dir-hash>/
│       └── <session-id>/
│           ├── context.jsonl
│           ├── wire.jsonl
│           └── state.json
├── imported_sessions/    # 导入的会话数据（通过 kimi vis 导入）
│   └── <session-id>/
│       ├── context.jsonl
│       ├── wire.jsonl
│       └── state.json
├── plans/                # Plan 模式方案文件
│   └── <slug>.md
├── user-history/         # 输入历史
│   └── <work-dir-hash>.jsonl
└── logs/                 # 日志
    └── kimi.log
```

## 配置与元数据

### `config.toml`

主配置文件，存储供应商、模型、服务和运行参数。详见 [配置文件](./config-files.md)。

可以通过 `--config-file` 参数指定其他位置的配置文件。

### `kimi.json`

元数据文件，存储 Kimi Code CLI 的运行状态，包括：

* `work_dirs`: 工作目录列表及其最后使用的会话 ID
* `thinking`: 上次会话是否启用 thinking 模式

此文件由 Kimi Code CLI 自动管理，通常不需要手动编辑。

### `mcp.json`

MCP 服务器配置文件，存储通过 `kimi mcp add` 命令添加的 MCP 服务器。详见 [MCP](../customization/mcp.md)。

示例结构：

```json
{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "transport": "http",
      "headers": {
        "CONTEXT7_API_KEY": "ctx7sk-xxx"
      }
    }
  }
}
```

## 凭据

OAuth 凭据存储在 `~/.kimi/credentials/` 目录下。通过 `/login` 登录 Kimi 账号后，OAuth token 会保存在此目录中。

MCP 服务器的 OAuth token 单独存储在 `~/.kimi/mcp-oauth/`。通过 `kimi mcp auth <name>` 授权使用 `--auth oauth` 添加的 MCP 服务器后，后续会话会复用该目录中的 token。可以用 `kimi mcp reset-auth <name>` 清除某个服务器的 MCP OAuth token。

`credentials/` 目录中的文件权限设置为仅当前用户可读写（600），以保护敏感信息。

## 会话数据

会话数据按工作目录分组存储在 `~/.kimi/sessions/` 下。每个工作目录对应一个以路径 MD5 哈希命名的子目录，每个会话对应一个以会话 ID 命名的子目录。

### `context.jsonl`

上下文历史文件，以 JSONL 格式存储会话的完整上下文。文件第一行是系统提示词记录（`_system_prompt`），后续每行是一条消息（用户输入、模型回复、工具调用等）或内部记录（检查点、token 用量等）。

系统提示词在会话创建时生成并冻结，会话恢复时直接复用而不重新生成。

Kimi Code CLI 使用此文件在 `--continue` 或 `--session` 时恢复会话上下文。

### `wire.jsonl`

Wire 消息记录文件，以 JSONL 格式存储会话中的 Wire 事件。用于会话回放和提取会话标题。

### `state.json`

会话状态文件，存储会话的运行状态，包括：

* `title`：用户手动设置的会话标题
* `approval`：审批决策状态（YOLO 和 AFK 模式开关、已自动批准的操作类型）
* `plan_mode`：Plan 模式的开关状态
* `plan_session_id`：当前 Plan 会话的唯一标识符，用于关联 plan 文件
* `plan_slug`：Plan 文件的路径标识（即 `~/.kimi/plans/<slug>.md` 中的 slug），会话重启后可恢复到同一文件
* `subagent_instances`：子 Agent 实例的状态和元数据
* `additional_dirs`：通过 `--add-dir` 或 `/add-dir` 添加的额外工作区目录

恢复会话时，Kimi Code CLI 会读取此文件还原会话状态。此文件使用原子写入，防止崩溃时数据损坏。

### `subagents/<agent_id>/`

每个通过 `Agent` 工具创建的子 Agent 实例在会话目录下有独立的存储目录，包含：

* `context.jsonl`：子 Agent 的对话历史
* `wire.jsonl`：子 Agent 的 Wire 事件记录
* `meta.json`：实例元数据（状态、类型、创建时间等）
* `prompt.txt`：最后执行的 prompt
* `output`：执行输出

恢复会话时，子 Agent 实例的上下文和状态会自动还原，允许通过 `resume` 参数继续使用。

## Plan 方案文件

Plan 模式的方案文件存储在 `~/.kimi/plans/` 目录下。每个 Plan 会话对应一个随机命名的 Markdown 文件（即 `<slug>.md`）。

`plan_slug` 保存在 `state.json` 中，会话重启后仍能恢复到同一方案文件。使用 `/plan clear` 命令可以清除当前 Plan 会话的方案文件。

## 输入历史

用户输入历史存储在 `~/.kimi/user-history/` 目录下。每个工作目录对应一个以路径 MD5 哈希命名的 `.jsonl` 文件。

输入历史用于 Shell 模式下的历史浏览（上下方向键）和搜索（Ctrl-R）。

## 日志

运行日志存储在 `~/.kimi/logs/kimi.log`。默认日志级别为 INFO，使用 `--debug` 参数可启用 TRACE 级别。

日志文件用于排查问题。如需报告 bug，请附上相关日志内容。

## 清理数据

删除共享目录（默认 `~/.kimi/`，或 `KIMI_SHARE_DIR` 指定的路径）可以完全清理 Kimi Code CLI 的所有数据，包括配置、会话和历史。

如只需清理部分数据：

| 需求 | 操作 |
| --- | --- |
| 重置配置 | 删除 `~/.kimi/config.toml` |
| 清理所有会话 | 删除 `~/.kimi/sessions/` 目录 |
| 清理特定工作目录的会话 | 在 Shell 模式下使用 `/sessions` 查看并删除 |
| 清理 Plan 方案文件 | 删除 `~/.kimi/plans/` 目录，或在 Plan 模式下使用 `/plan clear` |
| 清理输入历史 | 删除 `~/.kimi/user-history/` 目录 |
| 清理日志 | 删除 `~/.kimi/logs/` 目录 |
| 清理 MCP 配置 | 删除 `~/.kimi/mcp.json` 或使用 `kimi mcp remove` |
| 清理登录凭据 | 删除 `~/.kimi/credentials/` 目录或使用 `/logout` |