CC逆引きリファレンス

シェルコマンドをPTY付きバックグラウンドジョブとして走らせたい

1. 基本操作

コマンド / 機能

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

Claudeセッションではなくシェルコマンドを直接バックグラウンド実行

概要

--exec フラグを --bg と組み合わせると、Claude セッションではなく指定したシェルコマンドをPTY(疑似端末)付きのバックグラウンドジョブとして実行します。長時間かかるテストやビルドをバックグラウンドで走らせたい時に使えます。

設定例

# pytest をバックグラウンドジョブとして実行
claude --bg --exec 'pytest -x'

# 実行状況を確認
claude agents

# ログを確認
claude logs <id>
公式ドキュメントを見る

こんな時に使う

  • 長時間かかるテストやビルドをバックグラウンドで走らせたい時
  • Claudeの対話を介さずシェルコマンドだけをバックグラウンド実行したい時

使い方

  1. 1claude --bg --exec '<コマンド>' で実行
  2. 2claude agents や claude logs <id> で進捗・出力を確認
  3. 3claude stop <id> で停止

Tips

  • PTY付きで実行されるため、対話的な出力(プログレスバーなど)も正しく扱える
  • Claudeセッションとしては扱われないため、コード変更やコミットは行われない

関連コマンド

/background