怎么在后台运行 Claude Code agent

让 Claude Code 在后台运行的五种方式

区别在于什么东西必须一直开着，以及由谁来启动工作。

会话里的后台任务

Claude 正在运行 Bash 命令或 subagent 时按 Ctrl+B（在 tmux 里按两次），就能把它放到后台，你可以继续和 Claude 对话。Claude 也可以自己在后台启动命令。Claude 派生的 subagent 默认就在后台运行。

输入 /tasks 可以列出正在运行的 shell 和 subagent，查看它们的状态。在本地终端会话里，后台命令没有时间限制，但 Claude Code 退出时它也会停止。想让几个 agent 并排干活，看怎么同时运行多个 Claude Code agent。

Agent view：比终端活得更久的会话

claude --bg "<prompt>" 在后台启动一个会话并立即返回；/bg 把你当前所在的会话移到后台。它们由一个监督进程运行，所以关掉终端不会让它们停下，但关机或重启电脑会；没有连接的空闲会话大约一小时后会被停止。

claude agents 打开 agent view；claude attach <id>、claude logs <id> 和 claude stop <id> 用来管理单个会话。Agent view 还是研究预览版，命令可能会变。

用 claude -p 以 headless 模式运行 Claude Code

1. 跑一个提示词，然后退出

   -p（或 --print）不打开交互界面直接运行 Claude Code，做完就退出，成功时退出码为 0。也可以用管道把内容传进去。

   claude -p "List the failing tests and why they fail"
   cat error.log | claude -p "Explain this error"

2. 拿到脚本能读的输出

   --output-format json 返回结果，以及会话 ID 和元数据，其中包括 total_cost_usd，这是在你本机算出的估计值。stream-json（配合 --verbose）会在事件发生时实时输出。

   claude -p "Summarize this repo" --output-format json | jq -r '.result'

3. 只放行它需要的工具

   headless 模式下没人来批准权限提示。从 v2.1.302 起，没有指定模式的运行会以 Manual 模式启动，拒绝一切需要批准的操作。用 --allowedTools 列出它可以做的事，用 --permission-mode dontAsk 直接拒绝其余操作，而不是一直等着。

   claude -p "Run the test suite and summarize failures" \
     --permission-mode dontAsk --allowedTools "Read,Bash(npm test)"

4. 给运行设上限

   --max-turns 在达到一定的 agent 轮数后停止，--max-budget-usd 在达到估算费用时停止（可能会略微超出）。两者都只能和 -p 一起用。

   claude -p "Fix the lint errors" --max-turns 15 --max-budget-usd 3

5. 之后接着同一个对话

   从 JSON 输出里保存会话 ID，传给 --resume；或者用 --continue 接着当前目录下最近的一个会话。

   id=$(claude -p "Start a code review of src/" --output-format json | jq -r '.session_id')
   claude -p "Now check the tests too" --resume "$id"

6. 用 cron 定时运行

   Anthropic 的文档没有 cron 示例，下面这个只用了文档里写到的参数。cron 的 PATH 很精简，所以要用 which claude 给出的完整路径，并先建好日志文件夹。这里不要加 --bare：它会跳过你的订阅登录，需要 API key。

   # crontab -e：工作日 9:00
   0 9 * * 1-5  cd /path/to/repo && /path/to/claude -p "Summarize yesterday's commits and list new TODO comments. Do not edit files." --permission-mode dontAsk --allowedTools "Read,Bash(git log *),Bash(git diff *)" --max-turns 10 --output-format json >> "$HOME/logs/claude-daily.log" 2>&1

来源：Anthropic 的 headless 模式文档（英文）

无人值守运行的权限

• dontAsk 加一个 --allowedTools 列表是最严格的选择：不在列表里的一律拒绝。
• auto 让一个分类器代替你审查每个操作。Anthropic 指出它并不能保证安全。
• acceptEdits 放行文件修改和简单的文件命令，但不放行其他 shell 命令。
• bypassPermissions 跳过权限提示和安全检查。Anthropic 说只应在没有网络的隔离容器或虚拟机里用，因为它对提示词注入毫无防护。
• 要给一个项目里的每次运行都定规则，就把 permissions.allow 和 permissions.deny 写进 .claude/settings.json。deny 规则永远优先。

云端方案：电脑关着的时候

• 云端会话：claude --cloud "<task>" 基于你的 GitHub 分支在 Anthropic 的基础设施上运行，合上笔记本也会继续。用 claude -p "..." --cloud <session-id> 发送后续消息。
• 云端定时任务：用 /schedule 或在 claude.ai/code 上创建，可以按时间表（最多每小时一次）、通过 API 调用或由 GitHub 事件触发运行。支持 Pro、Max、Ultra、Team 和 Enterprise；目前是研究预览版。
• GitHub Actions：anthropics/claude-code-action@v1 配 schedule 触发。用 claude setup-token 生成的 OAuth token 走你的订阅；用 API key 则按 token 计费。

给后台 agent 一份长期的工作

后台任务、agent view 和 cron 启动的都是你已经想好的工作。Crewmark 则给 Claude Code 会话一个长期的岗位：工作时间内按心跳醒来，从看板上领下一个 issue，卡住了就给你发消息。

1. 把一个会话变成员工

   选一个岗位和一个用数字写的目标，在 Claude Code 里运行 Crewmark 给你的设置命令。这个对话就成了这名员工。

2. 让心跳来启动工作

   Crewmark daemon 在工作时间内每 15、30 或 60 分钟唤醒这个会话，用的是你已经付费的订阅；下班时间不打扰它。

3. 派 issue，回消息

   把工作作为 issue 加到看板上；员工会接手，边做边评论，需要审核时来问你。看看什么是 AI 员工。

Claude Code 后台 agent 常见问题