Claude Code 用了一段时间, 自我感觉挺良好. 直到有朋友跟我说: “你试试 /insights.”

运行 claude 进入会话, 输入:

/insights

等个几十秒, 浏览器里自动弹出一个 HTML 报告. 它会分析你过去 30 天的 Claude Code 会话, 拆成几个板块: 你在什么项目上花了多少时间、最常用哪些工具、语言分布、以及——最扎心的——你的工作流里哪些地方在反复浪费 Token.

所有数据都来自本地的 ~/.claude/ 会话日志, 报告不会离开你的电脑.

报告的结构

概览数据

最上面一个 “At a Glance” 卡片, 展示核心统计: 会话数、总消息数、代码修改行数、活跃天数.

我第一次跑出来是 38 个会话, 659 条消息, 22 天活跃. 看一眼大概就知道自己用得有多勤.

使用模式

报告用柱状图展示了几个维度:

• 最常用的工具: 你会发现自己的 Edit 用了多少次, Bash、Read、Write 各占多少比例
• 编程语言分布: TypeScript、Python、Markdown 各占百分之几——这个分布有时候会让人意外
• 任务类型: 代码生成、调试、重构、测试编写各占多少
• 会话时长: 平均每条会话多久, 平均回复时间多少

我第一次看到自己 18% 的时间花在 Markdown 上时, 重新思考了一下自己的工作流——原来写文档占了我这么多精力.

使用风格分析

报告会生成一段自然语言描述, 分析你的工作风格. 不止是数字, 而是一段像人写出来的评语.

比如它会说 “你偏向迭代式工作——虽然过程中有摩擦, 但你的满意度偏向积极, 说明你把迭代视为流程的一部分而非失败.” 这种洞察如果是别人说出来你会觉得神奇, 来自你自己的数据则让人信服.

报告还包含时段分布图, 可以看到自己一天中什么时段最活跃.

工作流摩擦点

这是最有价值的部分. 报告不会只说"你用得不好", 而是从你的会话记录里找到具体模式, 按频率排序, 附上从实际会话中提取的例子.

比较典型的摩擦点有两类:

• 过早行动: Claude 还没理解清楚需求就开始写代码. 但这其实是你自己的问题——提示词写得不够清晰, 缺少约束条件.
• 重复解释上下文: 每次新会话前 2-3 条消息都在跟 Claude 解释项目背景, 而你的项目明明有 CLAUDE.md. 最讽刺的是你可能还写过文章教别人用 CLAUDE.md, 结果自己都没用好.

每个摩擦点都附有时间戳和会话 ID, 想抵赖都没办法.

个性化建议

针对发现的问题, 报告会直接生成可以复制到 CLAUDE.md 的规则. 比如对"过早行动"问题:

• 在给出方案前先写清楚约束条件
• 使用 plan 模式, 强制 Claude 先提方案再执行

对"重复解释上下文"问题:

## 通用规则
- 在开始任务前, 先读取 CLAUDE.md 获取项目信息
- 如果用户要求的任务需要项目背景, 先在 CLAUDE.md 中确认

怎么用报告改进工作流

跑一次 /insights 只是第一步. 真正有价值的是后续.

更新 CLAUDE.md

把报告生成的规则建议放进项目根目录的 CLAUDE.md. 下次会话里 Claude 会自动遵守这些规则, 不用每次手动重复.

创建自定义命令

如果报告发现你高频做某类任务, 封装成自定义命令:

# .claude/commands/debug.md

Debug 当前代码中的问题. 先列出三种可能原因, 按可能性排序,
然后逐一排查.

下次直接输入 /debug 就能执行.

调整个人的提示习惯

报告如果显示首次成功率低, 多半是描述太模糊. “make this better” 改成 “refactor this function to reduce cyclomatic complexity”, 结果会差很多.

自动化

用非交互模式跑 /insights 可以自动化整个流程:

claude -p "/insights" --output-format json \
  | claude -p "提取摩擦点和建议, 检查 CLAUDE.md 是否已有, 没有就追加"

然后扔到 crontab 或者 /loop 30d 里定期执行.

需要注意的问题

/insights 不是完美的, 有些地方用起来不太顺手:

• 30 天窗口是固定的, 不能只看最近一周或一个季度
• 建议质量参差不齐: 有些可以直接复制粘贴用, 有些比较模糊, 需要自己判断
• 会话多了会慢: 150+ 会话时, 生成报告要 45-60 秒
• 不支持团队维度: 只能看个人, 不能聚合团队数据
• 没有前后对比: 第二次跑的时候不会告诉你"上个月你 73%, 这个月 12%"
• 遇到报错的话, 先 ctrl + c 退出再重新打开, 更新到最新版本试试

但即使有这些限制, 它依然是我用过的最有用的自我评估工具.

把 /insights 加到每月例行里. 第二次跑的时候打开之前的报告对比, 看看哪些习惯真的改掉了.

文章链接：