Claude Code上线/checkup,一键清理臃肿配置省上下文!

你这是违法行为 2026-07-09 17:54 1

Claude Code 新增 /checkup 命令,用来检查和清理本地开发环境。


/checkup 会检查未使用的 Skills、MCP 和插件,减少无效上下文占用。它还能去重本地 CLAUDE.md,并把根目录 CLAUDE.md 拆成更细的嵌套文件或 Skills。


新命令还会检查慢 Hook、版本更新和权限设置。它可以建议开启默认 Auto Mode,并把常被拦截的只读命令加入预批准。


/checkup 在修改前会先向用户确认,用户可以选择全部清理、手动挑选,或只查看报告。


最新回复 (2)
  • 逮虾户 07-09 18:02
    1



    是这个 doctor 指令吗?

  • 猫南北 07-09 20:52
    2

    我发一下我的诊断记录吧


    Thought for 1m 16s, searched for 2 patterns, listed 1 directory, searched memories (ctrl+o to expand)


    ● 现在我已经收集了所有数据,开始编译完整的健康检查报告。




    ^-^ Claude Code 健康检查报告


    扫描概览


    覆盖了 52 个对话记录(约 38 天的使用期,19 次启动),检查了你的安装、配置、技能、MCP 服务、插件、钩子等所有方面。




    检查 0 — 安装健康 ^-^(基本健康)


    ┌──────────────┬─────────────────────────────────────────────────────────────────────────────┐

    │ 项目 │ 状态 │

    ├──────────────┼─────────────────────────────────────────────────────────────────────────────┤

    │ 安装方式 │ native — 与配置匹配 ^-^ │

    ├──────────────┼─────────────────────────────────────────────────────────────────────────────┤

    │ 路径 │ ~/.local/bin/claude 在 PATH 中 ^-^ │

    ├──────────────┼─────────────────────────────────────────────────────────────────────────────┤

    │ 重复安装 │ 无 npm 全局残留,无 ~/.claude/local 残留 ^-^ │

    ├──────────────┼─────────────────────────────────────────────────────────────────────────────┤

    │ 设置文件解析 │ ~/.claude.json ^-^ ~/.claude/settings.json ^-^ .claude/settings.local.json ^-^ │

    ├──────────────┼─────────────────────────────────────────────────────────────────────────────┤

    │ Agent 定义 │ 无用户级或项目级 agent 定义文件 ^-^ │

    ├──────────────┼─────────────────────────────────────────────────────────────────────────────┤

    │ .mcp.json │ 不存在(无项目级 MCP 配置)^-^ │

    └──────────────┴─────────────────────────────────────────────────────────────────────────────┘


    注意: ~/.claude/settings.json 中还有两个备份设置文件(settings-disable.json、settings-linuxdo.json),可能是不再使用的旧配置。建议手动清理。




    检查 1 — 未使用的技能、MCP 服务和插件


    ┌─────────────────────┬──────┬──────┬────────────────┬──────────────────────┬──────────────┬──────────┐

    │ 组件 │ 类型 │ 范围 │ 使用次数(累计) │ 窗口期内使用? │ 预估上下文 │ 判定 │

    ├─────────────────────┼──────┼──────┼────────────────┼──────────────────────┼──────────────┼──────────┤

    │ code-review-expert │ 技能 │ 用户 │ 10 │ ^-^ 是(最近: 6月11日) │ 稀疏(列表项) │ 保留 │

    ├─────────────────────┼──────┼──────┼────────────────┼──────────────────────┼──────────────┼──────────┤

    │ find-skills │ 技能 │ 用户 │ 0 │ ^-^ 否 │ 稀疏(列表项) │ 建议移除 │

    ├─────────────────────┼──────┼──────┼────────────────┼──────────────────────┼──────────────┼──────────┤

    │ gencom │ 技能 │ 用户 │ 37 │ ^-^ 是(今天) │ 稀疏(列表项) │ 保留 │

    ├─────────────────────┼──────┼──────┼────────────────┼──────────────────────┼──────────────┼──────────┤

    │ grill-me │ 技能 │ 用户 │ 0 │ ^-^ 否 │ 稀疏(列表项) │ 建议移除 │

    ├─────────────────────┼──────┼──────┼────────────────┼──────────────────────┼──────────────┼──────────┤

    │ naming │ 技能 │ 用户 │ 3 │ ^-^ 是(今天) │ 稀疏(列表项) │ 保留 │

    ├─────────────────────┼──────┼──────┼────────────────┼──────────────────────┼──────────────┼──────────┤

    │ planning-with-files │ 技能 │ 用户 │ 6 │ ^-^ 是(6月24日) │ 稀疏(列表项) │ 保留 │

    ├─────────────────────┼──────┼──────┼────────────────┼──────────────────────┼──────────────┼──────────┤

    │ skill-creator@… │ 插件 │ 用户 │ 1 │ ^-^ 是(6月7日) │ 小 │ 保留 │

    ├─────────────────────┼──────┼──────┼────────────────┼──────────────────────┼──────────────┼──────────┤

    │ typescript-lsp@… │ 插件 │ 用户 │ 0 │ ^-^ 从未使用 │ 小 │ 建议禁用 │

    ├─────────────────────┼──────┼──────┼────────────────┼──────────────────────┼──────────────┼──────────┤

    │ tavily-remote-mcp │ MCP │ 用户 │ n/a(无计数器) │ ^-^ 转录命中1次 │ 延迟加载~0 │ 保留 │

    ├─────────────────────┼──────┼──────┼────────────────┼──────────────────────┼──────────────┼──────────┤

    │ chrome-devtools │ MCP │ 用户 │ n/a(无计数器) │ ^-^ 转录命中~9次 │ 延迟加载~0 │ 保留 │

    └─────────────────────┴──────┴──────┴────────────────┴──────────────────────┴──────────────┴──────────┘


    窗口期: 2026-06-01 至 2026-07-09(约 38 天)


    “remove” 推荐详情:



    • find-skills(~/.claude/skills/find-skills/SKILL.md,5588 字节)— 累计使用 0 次。这是一个"查找技能"的技能,你已经有 /doctor 和直接提问的能力,建议移除。

    • grill-me(~/.claude/skills/grill-me/SKILL.md,560 字节)— 累计使用 0 次。用于反复追问设计细节,你从未用过。很小但无用,建议移除。

    • typescript-lsp@claude-plugins-official — 累计使用 0 次,从未调用过 LSP 功能。建议禁用。




    检查 2 — LOCAL CLAUDE.md 去重


    对比了以下文件:



    • ~/.claude/CLAUDE.md(3916 字节,全局,所有项目加载)

    • CLAUDE.md(5800 字节,本项目根目录)

    • .claude/rules/code-style.md(1866 字节)

    • .claude/rules/tool-usage.md(4636 字节)


    未发现重复内容或矛盾。 全局 CLAUDE.md 聚焦于开发习惯、工作流和工具策略;项目 CLAUDE.md 描述项目架构和模块细节。两者职责分离清晰,互相补充。




    检查 3 — 迁移到懒加载


    本项目 CLAUDE.md(5800 字节 ≈ ~1450 est. tokens)内容组织良好,涵盖:



    • 常用命令(随时需要)

    • 项目架构概览(随时需要)

    • 模块结构(随时需要)

    • 认证/个人中心流程(可迁移)

    • JWT 约定(重要,应保持加载)

    • 代码约定(重要,应保持加载)


    结论: 该文件较小,节约空间有限。详细的认证和患者中心流程可提取为技能,但迁移的收益不大。建议保持现状。




    检查 4 — 慢钩子


    配置了两个钩子(在 ~/.claude/settings.json 中):


    ┌──────────────┬────────────────────────────────┬───────┬────────────┐

    │ 事件 │ 命令 │ async │ 数据 │

    ├──────────────┼────────────────────────────────┼───────┼────────────┤

    │ Notification │ powershell … vscode-notify.ps1 │ false │ 无慢速记录 │

    ├──────────────┼────────────────────────────────┼───────┼────────────┤

    │ Stop │ powershell … vscode-notify.ps1 │ false │ 无慢速记录 │

    └──────────────┴────────────────────────────────┴───────┴────────────┘


    发现: 钩子日志显示 vscode-notify.ps1 快速完成(所有条目在~1 秒内显示"通知发送成功")。钩子在 Stop/Notification 时触发(非每个工具调用),对交互无影响。


    ^-^ 注意: 转录中发现 hook_non_blocking_error 条目指向 focus-vscode-notify.ps1(不含焦点前缀的文件),该文件不存在。这似乎是旧配置的残留——当前设置指向

    vscode-notify.ps1,该文件存在且正常运行。无需操作。




    检查 5 — 上下文分布


    ┌──────────────────────────────────┬────────────────────────┐

    │ 组件 │ 预估常驻 tokens │

    ├──────────────────────────────────┼────────────────────────┤

    │ ~/.claude/CLAUDE.md │ ~979 │

    ├──────────────────────────────────┼────────────────────────┤

    │ CLAUDE.md (项目) │ ~1450 │

    ├──────────────────────────────────┼────────────────────────┤

    │ .claude/rules/code-style.md │ ~467 │

    ├──────────────────────────────────┼────────────────────────┤

    │ .claude/rules/tool-usage.md │ ~1159 │

    ├──────────────────────────────────┼────────────────────────┤

    │ 技能列表(20+ 条目,~1% 预算内) │ ~600-800 │

    ├──────────────────────────────────┼────────────────────────┤

    │ MCP 工具(均为延迟加载) │ ~0 │

    ├──────────────────────────────────┼────────────────────────┤

    │ 钩子配置 │ ~50 │

    ├──────────────────────────────────┼────────────────────────┤

    │ 其他设置 │ ~100 │

    ├──────────────────────────────────┼────────────────────────┤

    │ 总计 │ ~4800-5000 est. tokens │

    └──────────────────────────────────┴────────────────────────┘


    这对于大多数上下文窗口(200K+)来说是合理的。建议运行 /context 获取精确的实时测量值。




    检查 6 — Claude Code 版本


    ┌────────────┬─────────────────────────────────────────────────────────────────────────────────┐

    │ 项目 │ 值 │

    ├────────────┼─────────────────────────────────────────────────────────────────────────────────┤

    │ 已安装版本 │ 2.1.205 │

    ├────────────┼─────────────────────────────────────────────────────────────────────────────────┤

    │ 安装方式 │ native │

    ├────────────┼─────────────────────────────────────────────────────────────────────────────────┤

    │ 自动更新 │ false(用户设置 autoUpdates: false + DISABLE_AUTOUPDATER: “1”) │

    ├────────────┼─────────────────────────────────────────────────────────────────────────────────┤

    │ 网络查找 │ ^-^ 已跳过 — CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 已设置,必要流量模式已开启 │

    └────────────┴─────────────────────────────────────────────────────────────────────────────────┘


    由于必要流量模式已启用,无法联网检查最新版本。你已禁用自动更新和必要流量。


    建议: 如果你在使用旧版本,可以偶尔手动运行 claude update——但最终决定权在你。autoUpdates: false 是你的主动选择,不是故障。




    检查 7 — 自动模式(默认权限模式)


    当前状态: permissions.defaultMode 未在任何设置文件中设置。你一直使用默认权限模式(每个工具调用都会询问你)。


    建议: 将自动模式设为默认值,即安全分类器在安全操作时自动批准,不再弹窗询问每个调用。


    注意事项:



    • 在任何项目中均可生效(无覆盖项目/本地 defaultMode)

    • 不会将你锁定——如果自动模式不可用,将自动回退为默认模式

    • 可通过 permissions.deny 规则阻止特定操作




    检查 8 — 预批准频繁被拒的只读命令


    发现: 在 52 个转录文件中未找到明确的 toolDenialKind 拒绝记录,无法可靠识别被拒调用模式。你现有的允许规则已在 ~/.claude/settings.json 和 .claude/settings.local.json

    中覆盖了常见的只读命令。


    无需新增预批准规则。 现有允许规则集(Bash(npx tsc/vue-tsc)、Read、git diff、pnpm check/exec、claude --version 等)已覆盖主要模式。




    操作与建议总结


    建议移除



    1. find-skills 技能 — 从未使用,可移除

    2. grill-me 技能 — 从未使用,可移除

    3. typescript-lsp 插件 — 从未使用(0 次 LSP 调用),可禁用


    建议设置更改



    1. 默认权限模式 → 设为 auto

    2. 更新 Claude Code — 可选:claude update



* 帖子来源Linux.do
返回