命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
生成分析Claude Code会话的报告
/insights 是 Claude Code 的内置 Slash 命令,在会话内执行后分析当前机器上本地存储的历史会话记录,并生成一份 HTML 格式的个人使用分析报告。报告涵盖会话统计、工作流模式、摩擦点识别,以及可直接复制到 CLAUDE.md 的规则建议。
数据处理方式:所有分析在本地完成,不向 Anthropic 服务器上传任何会话内容。
截至 2026-06-14,code.claude.com 官方命令参考页（/docs/en/commands）的命令列表中未单独收录此命令,以下信息来源于多个第三方技术文章的实测。不同来源在若干内部实现细节上存在出入,本文会注明分歧点。
在任意活跃的 Claude Code 会话中输入:
/insights
无需任何参数或 flag。命令只在会话内部有效,不能在终端直接作为 CLI 子命令执行。
命令执行后会显示进度提示(分析中),完成后输出生成的 HTML 报告路径。各来源仅说明报告会保存到本地路径,未提及命令结束后会自动在浏览器中打开该文件,因此打开报告需自行操作。
报告横跨本机全部项目的历史会话,不局限于当前打开的 repo。时间窗口为滚动 30 天。
报告输出路径:不同来源的实测路径存在差异——
| 来源 | 报告路径 |
|---|---|
| angelo-lima.fr 实测 | ~/.claude/usage-data/report.html |
| blog.vincentqiao.com 实测 | ~/.claude/data/report.html |
建议运行后查看命令本身输出的实际路径,不要硬编码其中一个。
缓存目录:增量分析的缓存存储在 ~/.claude/usage-data/ 下,后续运行只分析新增会话,速度更快。
原始会话数据:会话以 JSONL 格式存储于 ~/.claude/projects/<project-hash>/<session-id>.jsonl。
各来源描述的具体节数略有不同,但以下内容在多个实测中均有出现:
| 报告模块 | 说明 |
|---|---|
| 统计摘要 | 会话总数、消息数、累计时长、Git 提交/推送次数、统计覆盖的日期范围 |
| 项目领域 | 自动归纳出若干工作主题及各主题的会话计数 |
| 交互风格分析 | 概括你与 Claude 协作的习惯模式 |
| 有效工作流 | 识别出效率最高的几类交互模式 |
| 摩擦点分析 | 分类列出常见障碍(如指令被误解、代码有 bug、动作被拒等),附真实会话示例 |
| CLAUDE.md 建议 | 从重复出现的指令模式中提炼出可直接粘贴的规则 |
| 功能推荐 | 根据使用模式建议尝试尚未用到的功能(各来源仅笼统提及 feature recommendations / features to try,未枚举具体功能类别) |
| 约束 | 说明 |
|---|---|
| 会话内执行 | 必须在活跃 Claude Code 会话中输入,无法作为独立 CLI 命令运行 |
| 分析会话数上限 | 不同来源报告的上限存在分歧(50 新增/次 vs 200 总量),超出时优先处理最近记录 |
| 过滤规则 | 子 agent 会话、少于 2 条用户消息的会话、时长不足 1 分钟的会话会被排除 |
| 仅限本地数据 | 不聚合团队数据,不读取其他机器的会话 |
| 无参数/flag | 命令本身不支持任何选项 |
| 原语 | 数据来源 | 输出格式 | 数据范围 |
|---|---|---|---|
/insights | 本地历史会话 JSONL | HTML 报告(浏览器打开) | 个人 · 30 天 · 全项目 |
/tasks | 当前会话的后台任务 | 会话内实时列表 | 当前会话 |
/context | 当前上下文窗口 | 显示上下文窗口用量/走势 | 当前会话 |
| Analytics 仪表板（官方） | Anthropic 云端遥测 | Web UI | 团队 · 可配置周期 |
Analytics 仪表板需要组织账户权限,详见
code.claude.com/docs/en/analytics.md。/insights则完全离线、面向个人。
/insights 无效:此命令只在交互式 Claude Code 会话内识别,在 shell 中单独执行不会触发任何操作。/insights)