+ 发布产品

ccprogress Skill 技能

Claude Code 长任务实时进度条插件

查看 Skill ↗
认领产品

是什么

ccprogress 是一款专为 Claude Code 长任务设计的实时进度条插件（mod），在 Terminal 与 Desktop 客户端中给 AI 编程会话补上「当前走到哪一步、还剩几步」的视觉反馈。它由 V2EX 程序员社区的 Claude Code 重度用户（自述月 150 亿 token 消耗）开发，针对 Claude Opus 长任务场景下「spinner 只显示用时和 token、不知道进度、不敢暂停」的核心痛点。

核心能力

  1. 实时进度条：在 spinner 旁边（Terminal）或输入框上方（Desktop）显示当前步骤、分段进度条、步数；每一步开始 / 完成时自动更新。
  2. 步骤清单展开：通过 /progress 命令可一键展开完整步骤列表（Terminal 打开侧边面板，Desktop 原地展开）。
  3. 自动折叠摘要：进度上报在 transcript 里只占一行灰色摘要（如 ◦ 3/5 运行测试），不刷屏。
  4. 多源步骤读取：自动按优先级从三个来源读取步骤——TodoWrite 工具、内置 TaskCreate/TaskUpdate 任务列表、或插件自带的 update_progress 工具。
  5. 颜色编码：绿色已完成、橙色进行中、灰色未开始；完成后整个进度条变绿。
  6. 会话恢复：每个会话的计划单独保存，/resume 后自动恢复，只保留最近 50 个会话。

安装配置

claude plugin marketplace add amigoer/ccprogress
claude plugin install ccprogress@ccprogress

或者在 Claude 会话内执行：

/plugin marketplace add amigoer/ccprogress
/plugin install ccprogress@ccprogress
/reload-plugins

要求 Claude Code v2.1.287 或更高（该版本起 mods 默认开启），用户级安装后 Terminal 与 Desktop 同时生效。

使用步骤

  1. 通过 marketplace 安装 ccprogress 插件；
  2. 重载已开会话（/reload-plugins）；
  3. 给 Claude 一个 ≥3 步的任务，列出计划后进度条自动出现；
  4. 通过 /progress 查看完整清单，/progress clear 清空当前计划。

适用场景

  • 让 Claude Opus 跑长任务时，能直观看到「走到哪一步」；
  • 多步复杂任务（重构 / 测试 / 部署链）中随时确认进度，不必担心它跑偏；
  • 不敢暂停的长时间任务有了可视进度，敢于随时中断；
  • 会话恢复后自动回到之前的进度位置；
  • 适合需要长时间委托 AI 的批处理脚本和持续性开发工作。

适用人群

  • Claude Code 重度个人用户（月 token 消耗亿级以上）；
  • 用 Claude Opus 处理长任务（重构、测试套件执行、数据迁移）的工程师；
  • 需要在 Desktop / Terminal 两种环境下保持进度的开发者；
  • 任何不愿每次盯 spinner 推算进度的 Claude Code 用户。

工作原理

ccprogress 是一个 Claude Code mod：代码在 Claude Code 进程内运行、拥有权限在界面上绘制内容。步骤来源按优先级从 TodoWrite → TaskCreate/TaskUpdate → 插件自带的 update_progress 工具三级回退；终端画在 spinner 上方，Desktop 始终画在输入框上方，其他环境（VS Code、claude -p、Agent SDK）不绘制界面但 /progress 输出文字摘要。

开销与隐私

每次更新是一次非常小的工具调用，单个任务多消耗约几百 token；系统提示里那段说明约 80 个英文单词，只在 update_progress 工具可用时加入。插件不发起任何网络请求、不调用额外模型，所有计划数据保存在 ~/.claude/plugins/store/ 下，仅在任务列表工具运行时读取 ~/.claude/tasks/ 文件。MIT 许可证，社区项目，与 Anthropic 没有关联。

官方链接

ccprogress 网站预览

团队信息

AI产品库 官方
由 AI 猎手自动发现

评论与建议

0 条评论