--bg · Claude Code 命令 · Claude Code 中文学习站

启动参数看官方文档

在后台启动会话并立即返回，打印会话 ID 和管理命令

Syntax

--bg <prompt>

示例

claude --bg "investigate the flaky test"

全网调研整理

典型场景

长时间运行任务（调查 flaky test、大规模重构）时不阻塞当前终端
并行启动多个独立 agent（前端/后端/测试分工），同步推进项目
脚本或自动化流程中以 session ID 触发并追踪 agent 执行结果
在另一终端或设备上通过 claude attach 随时接管后台任务
配合 /batch 将大规模代码库变更分拆为多个后台 subagent 同步执行

实用技巧

配合 --name <label> 给会话命名，替代难记的 hash ID，claude attach/logs/stop 均可用名称操作
用 claude agents 打开统一面板，优先响应 'needs input' 状态以免 agent 长时间阻塞等待
任务描述要精确（含目标目录、预期输出、约束条件），减少 agent 中途暂停等待人工干预
后台会话在 /resume 选择器中显示（标记 bg），可随时切回前台继续对话，或 /exit 分离不停止
用 tmux 或 screen 包裹终端会话，防止 SSH 断连导致 supervisor 进程意外退出

常见坑

会话依赖本机持续运行，关机或休眠后状态变为 stopped，需执行 claude respawn --all 恢复
多个 --bg 会话之间上下文完全隔离，一个会话的发现不会自动同步给其他 agent
多个后台 agent 并发写入相同文件会产生冲突，需事先规划各 agent 的文件边界或配合 worktrees 隔离

来源

最早记录ⓘ

≤v2.1.140

变化时间线(按版本倒序)

修复v2.1.206· 2026/07/10 · 2 天前

修复了 CLAUDE_CODE_EXTRA_BODY 环境变量被忽略的问题

修复v2.1.187· 2026/06/24 · 18 天前

修复了在 help 中未被列出的问题

修复v2.1.176· 2026/06/13 · 29 天前

修复 claude --bg -cn <name> 组合不能正确设置会话名称的问题。

修复v2.1.160· 2026/06/02 · 2026/06/02

修复使用 `--bg` 时后台守护进程冷启动偶尔因 socket 缺失而失败

新增v2.1.154· 2026/05/29 · 2026/05/29

新增启动参数用于启用后台命令执行，与 --exec 配合运行 shell 命令

修复v2.1.153· 2026/05/28 · 2026/05/28

修复了即使升级后仍在过期守护程序上运行的问题

修复v2.1.142· 2026/05/15 · 2026/05/15

修复启动后台会话时的持久化问题

修复v2.1.140· 2026/05/13 · 2026/05/13

修复后台服务即将空闲退出时连接失败的问题