mirror of https://github.com/claude-code-best/claude-code.git synced 2026-06-22 00:05:51 +00:00

Files

claude-code-best 178868175e docs: 添加文档大纲及 superpowers/outline 目录

Co-Authored-By: deepseek-v4-pro <deepseek-ai@claude-code-best.win>

2026-06-15 16:51:29 +08:00

10 KiB

Raw Blame History

第七章：让 Claude 长时间帮你干活 -- Daemon、Background Sessions、Schedule

任务跑太久、需要定时执行、想让 Claude 在后台默默干活 -- 这章讲三种长时间运行的方式。

Daemon 是什么？跟普通对话的区别

你在终端里敲 claude 启动的是一个交互式 REPL 会话：你打字、Claude 回复、你继续问。关掉终端，会话就没了。Daemon 是一种不同的运行模式 -- 它在后台启动一个常驻进程（supervisor），由 supervisor 管理若干 worker 子进程，每个 worker 负责一种长时间任务。

目前 daemon 内置的 worker 类型是 remoteControl，它运行一个 headless bridge 循环，用于接受远程会话连接。supervisor 会监控 worker 的存活状态：如果 worker 崩溃了，supervisor 会自动重启它，使用指数退避策略（从 2 秒开始，每次翻倍，上限 120 秒）。如果 worker 在 10 秒内连续崩溃 5 次，supervisor 会把 worker "停泊"（park），不再尝试重启，避免无限重启循环。

Daemon 需要启用 DAEMON feature flag。启动 daemon 后，它会在 ~/.claude/daemon/ 下写一个状态文件（remote-control.json），记录 PID、工作目录、启动时间和 worker 类型，方便其他 CLI 进程查询状态或发送停止信号。

启停 Daemon

在终端中用 claude daemon 命令管理 daemon 的生命周期：

# 启动 daemon supervisor（默认启动 remoteControl worker）
claude daemon start

# 查看 daemon 和后台会话的统一状态
claude daemon status
# 或者
claude daemon ps

# 停止 daemon（发送 SIGTERM，超时后 SIGKILL）
claude daemon stop

启动时可以指定工作目录、worker 模式、并发容量等参数：

claude daemon start --dir /path/to/project --spawn-mode worktree --capacity 4 --permission-mode auto-accept --sandbox

也可以在 REPL 里用 /daemon 斜杠命令执行同样的操作：

/daemon status
/daemon start
/daemon stop
/daemon bg -p "run the test suite"

注意，/daemon attach 不能在 REPL 内使用 -- attach 是一个阻塞交互操作，需要在外部终端执行。

Background Sessions：让 Claude 在后台跑

Daemon 管的是 supervisor + worker 的架构，如果你只是想让 Claude 在后台跑一个任务、不想折腾 supervisor，background sessions 是更轻量的选择。

启动后台会话

# 最简方式：用 -p 参数传入提示词
claude daemon bg -p "run the full test suite and report results"

# 也可以用 --bg 快捷标志
claude --bg -p "check for lint errors and fix them"

# 带命名参数
claude daemon bg --name nightly-audit -p "audit all TODO comments in src/"

后台会话支持两种引擎：

tmux 引擎（macOS/Linux，需要安装 tmux）：启动一个 tmux session 来运行 Claude，你可以随时 attach 进去看到交互界面。
detached 引擎（Windows 或没有 tmux 的环境）：进程脱离终端运行，日志写到文件，attach 时查看日志。

引擎选择是自动的：在 macOS/Linux 上优先用 tmux，如果 tmux 不可用则回退到 detached；Windows 上直接用 detached。如果使用 detached 引擎，必须带 -p 或 --pipe 参数，因为 detached 模式没有交互式终端。

# 安装 tmux（macOS）
brew install tmux

# 安装 tmux（Linux）
sudo apt install tmux

启动成功后会输出会话信息：

Background session started: claude-bg-a1b2c3d4
  Engine: tmux
  Log: ~/.claude/sessions/logs/claude-bg-a1b2c3d4.log

Use `claude daemon attach claude-bg-a1b2c3d4` to reconnect.
Use `claude daemon status` to check status.
Use `claude daemon kill claude-bg-a1b2c3d4` to stop.

管理后台会话

# 列出所有活跃会话
claude daemon status

# 输出示例：
# 2 active sessions:
#
#   PID: 12345
#   Kind: bg
#   Engine: tmux
#   Session: claude-bg-a1b2c3d4
#   CWD: /home/user/myproject
#   Name: nightly-audit
#   Started: 6/14/2026, 9:00:00 AM
#
#   PID: 12346
#   Kind: daemon-worker
#   Engine: tmux
#   Session: claude-bg-e5f6g7h8
#   CWD: /home/user/myproject
#   Started: 6/14/2026, 9:00:05 AM

# 重新连接到会话（tmux 引擎直接进入交互界面）
claude daemon attach claude-bg-a1b2c3d4

# 查看会话日志
claude daemon logs claude-bg-a1b2c3d4

# 终止会话（SIGTERM -> 2秒等待 -> SIGKILL）
claude daemon kill claude-bg-a1b2c3d4

如果没有指定目标名称，attach 和 kill 会列出可用的会话让你选择。会话的元数据（PID、session ID、名称、启动时间等）保存在 ~/.claude/sessions/ 目录下的 JSON 文件中，进程退出后对应的 JSON 文件会被自动清理。

Template Jobs：模板化任务

如果你经常重复执行某种结构的任务 -- 比如每天写日报、每周做代码审查 -- 可以用模板把任务的结构固定下来，之后只需 claude job new <template> 就能快速创建。

模板是放在 .claude/templates/ 或 ~/.claude/templates/ 目录下的 Markdown 文件，支持 frontmatter：

---
description: Generate a daily standup summary from git log
author: team-lead
---

Read the git log from the last 24 hours and write a concise standup summary.
Include: commits made, PRs opened/closed, blockers encountered.
Format the output as a bullet list.

# 列出所有可用模板
claude job list

# 用模板创建一个新任务
claude job new daily-standup

# 带参数
claude job new daily-standup --since yesterday

# 查看任务状态
claude job status abc12345

# 向已有任务追加回复
claude job reply abc12345 please also include deployment notes

模板查找顺序：先在项目的 .claude/templates/ 目录下找，再在用户级的 ~/.claude/templates/ 目录下找，同名模板项目级优先。每个任务创建后会在 ~/.claude/jobs/<job-id>/ 下生成 state.json、template.md 和 input.txt，记录任务的状态和上下文。

定时调度：用 `/loop` 让 Claude 反复跑

/loop 是一种本地定时机制 -- 让 Claude 按固定间隔反复执行同一个提示词或斜杠命令，适合持续监控、定时巡检等场景。

# 每 5 分钟跑一次 /babysit-prs
/loop 5m /babysit-prs

# 每 30 分钟检查一次部署状态（默认 10 分钟间隔）
/loop 30m check the deploy status

# 每 2 小时做一次 standup
/loop 2h /standup 1

# 每天一次（午夜本地时间）
/loop 1d run the nightly full test suite

# 也可以用自然语言描述间隔
/loop check the deploy every 20m

/loop 底层通过 CronCreate 工具创建 cron 调度，所以它遵循 cron 系统的运行规则：任务只在 REPL 空闲时触发（不会打断正在进行的查询），调度器会在你指定的时间上自动加一个小的随机偏移来错峰。循环任务最长运行 7 天后自动过期。

管理循环任务：

# 查看当前所有定时任务
/cron-list

# 取消某个任务
/cron-delete <job-id>

如果 /loop 无法使用（cron 系统被 CLAUDE_CODE_DISABLE_CRON=1 环境变量禁用），可以改用系统级的 cron + pipe 模式作为替代：

# 在 crontab 里配置
*/30 * * * * cd /path/to/project && echo "check the deploy status" | claude -p

远程定时触发器：`/schedule` 与 `/triggers`

/loop 和本地 cron 任务有一个限制：它们只在你的本地机器上运行，关了终端就停了。如果你需要任务在云端定时执行 -- 不依赖你的电脑是否开机 -- 可以使用远程触发器。

/schedule

这个命令（也叫 /triggers 或 /cron）会引导你创建一个远程调度触发器。远程触发器的特点：

任务在 Anthropic 的云端基础设施中运行，不在你的本地机器上
每个 trigger 在指定时间创建一个完全隔离的远程会话（CCR）
最小调度间隔为 1 小时（本地 cron 没有这个限制）
需要 Claude Pro/Max/Team 订阅和 /login 登录

创建一个远程触发器的交互流程大致如下：

你: /schedule

Claude: What would you like to do with scheduled remote agents?
  1. Create a new trigger
  2. List existing triggers
  3. Update a trigger
  4. Run a trigger now

你: 我想创建一个每周一早上 9 点检查主分支 CI 状态的触发器

Claude: 好的，让我帮你设置。9am 你的本地时间（Asia/Shanghai）= 1am UTC。
触发器的 cron 表达式将是 `0 1 * * 1`。
我会使用默认模型 claude-sonnet-4-6。你确认吗？...

远程触发器也可以通过命令参数直接操作：

/schedule list
/schedule get <trigger-id>
/schedule update <trigger-id> enabled false
/schedule run <trigger-id>
/schedule delete <trigger-id>
/schedule enable <trigger-id>
/schedule disable <trigger-id>

创建触发器时可以关联 MCP connector（比如 Datadog、Slack），让远程 agent 能访问外部服务。connector 在 https://claude.ai/settings/connectors 管理。删除触发器需要到网页端操作：https://claude.ai/code/scheduled

该用哪种方式？

三种长时间运行的方式各有适用场景：

方式	适用场景	是否需要本地机器在线	最小间隔
Background Session	一次性后台任务，跑完就结束	是	无（一次性）
`/loop` + 本地 cron	周期性本地监控、巡检、自动修复	是（终端不能关）	1 分钟
`/schedule` 远程触发器	云端定时任务，不依赖本地机器	否	1 小时

简单判断标准：

如果是"跑完一个任务就行"，用 background session。
如果是"每隔几分钟帮我检查一下"，用 /loop。
如果是"我不在线的时候也要跑"，用 /schedule 远程触发器。

如果你需要 tmux 引擎但机器上没有安装 tmux，系统会自动回退到 detached 引擎。detached 引擎没有交互界面，所有输出只能通过日志文件查看，所以一定要带 -p 参数明确告诉 Claude 该做什么。

下一步

想了解如何把 Claude 嵌入 CI 流水线做自动化，看第十一章：自动化与 CI 集成
想让 Claude 在远程机器上被外部客户端调用，看第八章：跨机器与跨团队协作
想了解如何让 Claude 跑大任务、派子代理，看第六章：让 Claude 帮你跑大任务

10 KiB Raw Blame History Unescape Escape