CC逆引きリファレンス

PTY付きバックグラウンドジョブとしてコマンドを実行したい

12. CI/CD・自動化

コマンド / 機能

claude --bg --exec 'command'

Claudeセッションを介さないシェル実行

概要

--exec フラグは、Claude セッションとしてではなく、PTY(擬似端末)付きのバックグラウンドジョブとして直接シェルコマンドを実行します。--bg と組み合わせて使い、claude agents や claude logs で進捗を監視できます。

設定例

# バックグラウンドでテストを実行
claude --bg --exec 'pytest -x'

# 実行中のジョブを一覧確認
claude agents

# ログを確認
claude logs <id>

# 停止する
claude stop <id>
公式ドキュメントを見る

こんな時に使う

  • 長時間かかるテストやビルドをバックグラウンドで走らせたい時
  • Claudeのエージェントループを介さず素のコマンドだけ実行したい時
  • claude agents / claude logs で複数ジョブを一元管理したい時

使い方

  1. 1claude --bg --exec '<コマンド>' でバックグラウンドジョブとして起動
  2. 2claude agents --json で一覧・状態を確認
  3. 3claude logs <id> で出力を確認、claude stop <id> で停止

Tips

  • Claude自体は介さないので、モデルの推論コストはかからない
  • PTYが割り当てられるため対話的な出力(プログレスバー等)も扱える
  • claude attach <id> でジョブにアタッチして対話も可能