Claude Code 如何后台运行长任务并用 /task 查看进度与输出claude-howto 的后台任务管理【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto在 Claude Code 里让 Claude 跑一个完整测试套件、构建镜像或执行数据库迁移时这些操作会长时间占用会话——任务没跑完你就没法继续提其他需求。claude-howto 仓库的 09-advanced-features/README.md 中Background Tasks后台任务专门解决这个问题让长耗时操作异步执行、不阻塞对话再用/task系列命令查看进度、输出并取消任务。适用场景包括长测试套件、构建过程、数据库迁移、部署脚本和分析工具。启动后台任务文档中的启动方式是用自然语言明确要求 Claude 在后台运行例如User: Run the full test suite in the backgroundClaude 接受后会在回复中给出任务 ID文档示例中的 ID 是bg-1234并说明任务已在后台启动Claude: Starting tests in background (task-id: bg-1234) You can continue working while tests run.拿到任务 ID 后会话即可继续做别的事——文档示例中用户在测试运行的同时让 Claude 重构了 auth 模块。任务完成后 Claude 会主动通知结果文档示例的通知内容如下示例输出实际任务的结果数字不同 Background task bg-1234 completed: ✅ 245 tests passed ❌ 3 tests failed View results: /task show bg-1234用 /task 命令管理任务四个核心命令覆盖任务的查看、跟踪、输出和取消均需要在 Claude Code 的交互式会话中输入命令用途/task list列出所有后台任务/task status id查看指定任务的进度/task show id查看任务输出/task cancel id取消指定任务其中id替换为 Claude 启动任务时返回的任务 ID如bg-1234。列出所有任务输入/task list文档示例返回如下示例输出实际任务、进度与剩余时间以你的会话为准Active background tasks: 1. [bg-1234] Running tests (50% complete, 2min remaining) 2. [bg-1235] Building Docker image (25% complete, 8min remaining) 3. [bg-1236] Deploying to staging (90% complete, 30sec remaining)这份列表能直接回答“有哪些任务还在跑、各自跑到哪一步”。查看单个任务的进度User: /task status bg-1234文档示例的状态输出如下示例输出Task bg-1234: Running tests Status: In progress Progress: 120/245 tests (49%) Started: 2025-11-08 10:30:15 Estimated completion: 2025-11-08 10:34:22Status与Progress用于判断任务是否还在正常推进Estimated completion给出预估完成时间。查看任务输出User: /task show bg-1234该命令展示任务运行的实时输出——文档示例中展示的是测试运行的 live output。测试失败或构建报错时从这里读取具体的错误信息。取消任务User: /task cancel bg-1234 Cancelled background task bg-1234文档确认取消后返回Cancelled background task id的提示。可选并行运行多个后台任务后台任务可以并行。文档给出一个“边构建边写代码”的示例User: Run the build in the background Claude: Starting build... (task-id: bg-5001) User: Also run the linter in background Claude: Starting linter... (task-id: bg-5002) User: While those run, lets implement the new API endpoint稍后 Claude 汇总两个任务的结果文档示例 Build completed successfully (bg-5001)和 Linter found 12 issues (bg-5002)之后用/task show bg-5002查看 linter 的具体问题。如果并行任务较多可以在配置文件中用backgroundTasks控制行为。文档给出的示例配置如下其中的数值是文档示例值{ backgroundTasks: { enabled: true, maxConcurrentTasks: 5, notifyOnCompletion: true, autoCleanup: true, logOutput: true } }maxConcurrentTasks限制并发任务数enabled控制是否启用后台任务仓库中的 09-advanced-features/config-examples.json 以及 QUICK_REFERENCE.md 也把 Background Tasks 列为内置功能“Run in background”。文档没有逐项解释notifyOnCompletion、autoCleanup、logOutput的含义使用时可只保留你确认需要的键。可选进阶用 Monitor 让 Claude 对后台命令的输出做出反应如果你希望 Claude 不只是被动地等你查/task show而是在后台命令出现特定输出行时立刻醒来处理09-advanced-features/README.md 中的 Monitor 工具v2.1.98 新增可以把监听挂到任何写 stdout 的 shell 命令上。典型过滤命令tail -f /var/log/app.log | grep --line-buffered ERROR文档特别警告管道接grep时必须带--line-buffered否则 grep 按 4KB 块缓冲 stdout事件可能被延迟数分钟——这是 Monitor 实践中最常见的失效原因如果过滤“该响不响”先检查这个参数。该路径适合作为后台任务的补充手段不替代/task系列命令本身。验证方式与限制判断后台任务流程是否按预期工作的依据来自文档展示的现象启动后 Claude 的回复中包含task-id说明任务已进入后台/task list能看到任务条目及其进度/task status id返回状态、进度与预估完成时间/task show id能看到任务输出任务结束时 Claude 主动播报结果并提示用/task show id查看。需要注意文中所有bg-1234、120/245 tests、245 tests passed等内容均为文档示例输出不代表你实际任务会得到相同数值/task命令需在交互式会话中使用。更完整的概念说明可参考 claude_concepts_guide.md 的 Background Tasks 一节。【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考