Effortless — 让 Claude Code 自动按需选择推理强度的顶栏插件

技能简介

Effortless 是一款为 Claude Code 设计的开源增强插件，在 Claude Code 输入框上方加一条顶栏 bar，由 Claude 自家的 Haiku 5.5（或可选 TypeSafe 的 Jev 模型）实时判断用户当前是"提个简单问题"还是"做复杂重构"，自动切换 Low / High / xHigh 推理强度。官方对四个真实编码任务各跑 3 次共 96 轮基准测试显示：搭配 Opus 5.5 时相对 Anthropic 推荐的 medium 节省 21%、相对 high 节省 29%、相对 xhigh 节省 42%，全部 12/12 答案正确，同时顶栏还会显示上下文用量、Prompt Cache 时长剩余和 Handoff 状态。

核心能力

1. 推理强度自动裁决：每个 Prompt 提交前由 Haiku 5.5 / Jev 先决定 Low / High / xHigh，并在顶栏显示 "Deciding → High" 决策过程。
2. Prompt Cache 倒计时：栏内 cache 59:00 显示距离 cache 失效的剩余时间，催促在降级前合并上下文。
3. 上下文用量可视：◔ 38% 实时反映当前 chat 占用的 token 比例，超阈值会随 ice 主题切换提醒。
4. 一键 Compact / Handoff：从 30% 上下文起，每两条消息检测一次；Haiku 判定后把 Compact 按钮升级为带理由的 Handoff，Full 模式还会写入 HANDOFF.md。
5. Haiku 5.5 廉价化 compaction：所有 compaction（手动 / 自动）默认由 Haiku 5.5 总结，约 Opus 成本的 1/10，失败时自动降级为 Claude Code 内置 compaction。
6. 限速守护：当 5 小时或周限额超过 80%，自动切到 Save 模式把上限压到 Medium，顶栏提示当前策略。
7. 可关闭模型切换：与"切到 Haiku"看似省钱，但实测显示 mid-chat 切模型需重写整段 cache 导致 5× 反向花费，默认保持实验性、关闭。

安装配置

1. 最简方式：在 Claude Code 对话框粘贴 "Install the effortless plugin for me: run claude plugin marketplace add HeyCubit/effortless ..."，由 Claude 自动完成安装后执行 /reload-plugins。
2. 命令方式：在 Claude Code 输入框逐行执行 /plugin marketplace add HeyCubit/effortless 与 /plugin install effortless@effortless，或在终端一行合并为 claude plugin marketplace add HeyCubit/effortless; claude plugin install effortless@effortless。
3. 首启设置：插件加载后会出现一个简短设置面板，保留默认 Haiku（无需 Key，走本地 Claude 登录）或添加可选 Jev Key，挑选 Lean Cheaper / Lean Smarter 等偏好。
4. Jev Key 录入：建议用 Claude Code 自带的 /plugin configure effortless@effortless 让 Key 存入 Claude Code 加密区，避免落到明文 ~/.config/jev/.env。

使用步骤

1. 完成 Setup：按弹窗设置 Haiku 默认与 Jev 可选项后进入正常聊天。
2. 观察顶栏：随每条 prompt 顶栏实时显示当前 effort（Low / Medium / High / xHigh）与上下文比例。
3. 手动改 effort：在 Claude Code 原生菜单里手动选中的 effort 会覆盖下一次自动，并自动关闭 Auto 模式。
4. 触发 Handoff：当 chat 接近容量上限（Haiku 判断后），Compact 按钮升级为 Handoff，可选 Quick 秒级总结或 Full（写 HANDOFF.md）。
5. 复测成本：在仓库的 bench/agentic/run.sh 跑 bash bench/agentic/run.sh，重新跑 4 任务 × 3 次基准，对比官方基线。
6. 更新插件：插件自动检测版本，顶部出现 Update 卡片后可一键原地升级，不打断当前会话。
7. 卸载：在 Claude Code 设置 → Plugins → Effortless → Uninstall 即可完整移除。

适用场景

1. Opus 5.5 长期订阅用户，希望把月成本降低 20~40% 而不牺牲回答质量。
2. 大上下文长对话开发者，让 Haiku 自动 compaction 防止 Prompt Cache 失效带来的成本飙升。
3. 团队 Claude Code 推广：通过统一插件降低个人对推理强度设置的认知负担。
4. 个人开发者希望在一个最小 bar 中看到上下文用量、Cache 状态与限额预警。
5. 频繁 Handoff 到新 chat 的会话管理者，靠顶栏 Compact/Handoff 切换减少人工判断。
6. 数据科学 / 编程任务并行开发者，需要在 Low/High 间自动切换以应对长短任务。

适用人群

日常重度使用 Claude Code 的开发者（订阅 Opus 5.5 / Sonnet 5.5）、希望精细控制 token 费用的 AI 重度用户、给团队批量部署 Claude Code 插件的 Tech Lead、对 AI Coding 写作风格有明确质量标准的工程师。

工作原理

插件在 Claude Code 输入框上方注入一个 React 组件 bar，使用本机 Claude 登录调用 Haiku 5.5（或 Jev Key）做轻量 Judge；当 chat token 用量达到 30% 后，每隔两条消息由 Haiku 读取当前主题、上次回复与上下文占比，决定是否值得开 Handoff；同时所有 /compact 与自动 compaction 都默认走 Haiku 完成；Prompt Cache 状态通过 ETags 字段读取并显示倒计时。

官方链接

• 仓库：https://github.com/HeyCubit/effortless
• 官网：https://heycubit.github.io/effortless/
• 许可证：MIT
• 维护者：HeyCubit 及社区贡献者