Claude Code 学习站

v2.1.207 GitHub ↗

命令字典

Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。

--exec

启动参数看官方文档

把一条 shell 命令作为 PTY 支持的后台作业运行，而非启动 Claude 会话。须与 --bg 配合从 shell 启动。

Syntax

claude --bg --exec '<command>'

示例

claude --bg --exec 'pytest -x'

全网调研整理

典型场景

需要在 Agent View 中以 PTY 模式运行测试（如 pytest -x），保留颜色输出和交互式进度条
并行启动多条长跑 shell 命令（build、lint、测试），通过 Agent View 统一监控所有作业状态
执行耗时命令时随时 attach/detach，不阻塞当前与 Claude 的对话
从 shell 外部将命令作为 background job 提交，等同于在 Agent View 内用 ! 触发
CI 风格流水线中需要完整 PTY 环境（颜色、进度条、raw 模式）的命令，不能用简单 & 后台化

实用技巧

在 Agent View dispatch 框中以 ! 开头输入命令，是 --bg --exec 的交互式快捷方式，无需回到 shell
在 peek 面板（Space 键弹出）回复时以 ! 前缀可直接向该作业发送 Bash 命令
按 Space 键可在不 attach 的情况下 peek 最新一行输出，快速确认命令是否还在运行
用 claude logs <id> 在普通 shell 查看作业输出，无需进入 Agent View 界面
多个 --bg --exec 作业可并行运行，Agent View 每行实时滚动显示各作业最后一行输出，便于横向对比

常见坑

输出仅驻留内存，命令退出约 5 分钟后自动清除，未及时读取将永久丢失，不写入任何磁盘文件
--exec 必须与 --bg 一起使用（claude --bg --exec '...'），单独使用 --exec 无效
v2.1.139 起 $CLAUDE_JOB_DIR 被注入所有会话，可能错误触发 worktree 隔离守卫；如遇提示 EnterWorktree 错误，可在 settings.json 设置 "worktree": {"bgIsolation": "none"} 规避

来源

创建于

v2.1.154

最近更新

v2.1.154

变化次数

1

新增 1

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

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

新增参数指定要在后台执行的命令，与 --bg 配合使用