mirror of
https://github.com/claude-code-best/claude-code.git
synced 2026-06-23 00:35:51 +00:00
273 lines
10 KiB
Markdown
273 lines
10 KiB
Markdown
# 第七章：让 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 的生命周期：
|
||
|
||
```bash
|
||
# 启动 daemon supervisor（默认启动 remoteControl worker）
|
||
claude daemon start
|
||
|
||
# 查看 daemon 和后台会话的统一状态
|
||
claude daemon status
|
||
# 或者
|
||
claude daemon ps
|
||
|
||
# 停止 daemon（发送 SIGTERM，超时后 SIGKILL）
|
||
claude daemon stop
|
||
```
|
||
|
||
启动时可以指定工作目录、worker 模式、并发容量等参数：
|
||
|
||
```bash
|
||
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 是更轻量的选择。
|
||
|
||
### 启动后台会话
|
||
|
||
```bash
|
||
# 最简方式：用 -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 模式没有交互式终端。
|
||
|
||
```bash
|
||
# 安装 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.
|
||
```
|
||
|
||
### 管理后台会话
|
||
|
||
```bash
|
||
# 列出所有活跃会话
|
||
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：
|
||
|
||
```markdown
|
||
---
|
||
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.
|
||
```
|
||
|
||
```bash
|
||
# 列出所有可用模板
|
||
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 按固定间隔反复执行同一个提示词或斜杠命令，适合持续监控、定时巡检等场景。
|
||
|
||
```bash
|
||
# 每 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 天后自动过期。
|
||
|
||
管理循环任务：
|
||
|
||
```bash
|
||
# 查看当前所有定时任务
|
||
/cron-list
|
||
|
||
# 取消某个任务
|
||
/cron-delete <job-id>
|
||
```
|
||
|
||
如果 `/loop` 无法使用（cron 系统被 `CLAUDE_CODE_DISABLE_CRON=1` 环境变量禁用），可以改用系统级的 cron + pipe 模式作为替代：
|
||
|
||
```bash
|
||
# 在 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 集成](./11-ci-automation.md)
|
||
- 想让 Claude 在远程机器上被外部客户端调用，看 [第八章：跨机器与跨团队协作](./08-bridge-remote-acp.md)
|
||
- 想了解如何让 Claude 跑大任务、派子代理，看 [第六章：让 Claude 帮你跑大任务](./06-agents-plan-task.md)
|