読み込み中

スケジュールタスクとヘッドレス

レッスン 67 分
読み込み中

スケジュールタスクとヘッドレス

Claudeにタスクを任せられると信頼できるようになったら、次のステップはそれを手作業で行うのをやめることです。同じプロンプトを繰り返しトリガーで実行するのであれば、毎回自分でそこに座って起動する必要はないはずです。このレッスンでは、その作業を手放す2つの方法を扱います。何も構築する必要のないクラウドスケジュールタスク(以前はルーティンと呼ばれていました)と、自分のスクリプトから完全な制御を得られるヘッドレスモードです。

これをスペクトルとして考えてみてください。一方の端には、Anthropicのマネージドインフラストラクチャ上で実行されるクラウドスケジュールタスクがあります。もう一方の端には、自分のコードからClaude Codeを実行するヘッドレスモードとAgent SDKがあります。構築量が最も少ない端から始めましょう。

スケジュールタスク: クラウドで実行される保存済みプロンプト

クラウドスケジュールタスクは、繰り返し発生する作業を自動化する最も直接的な方法です。スクリプトもサーバーも必要ありません。プロンプト、作業対象のリポジトリ、必要なコネクタという3つの要素をひとまとめにし、トリガーされるたびにクラウド上でそのまとまりを実行します。

重要なのは、インフラストラクチャがAnthropicのものであるという点です。自分のマシンを一晩中起動しておく必要もなく、維持管理すべきワークフローファイルもありません。作業内容を一度記述すれば、あとは勝手に実行されます。

スケジュールタスクにスケジュールは必須ではありません。いくつかの種類のトリガーで発火させることができます。

  • 毎朝9時のようなcronスケジュール
  • APIエンドポイントへのHTTP POST(自分のコードから起動できる)
  • 新しいプルリクエストの作成のようなGitHubイベント

繰り返しトリガーで同じプロンプトを実行するものであれば、何でも適しています。朝の依存関係監査、新しいプルリクエストが来たときに発火するPRトリアージャー、最も緊急性の高いものを把握するためのSentryチケットの毎日のスキャンなどです。

スケジュールタスクが結びつけるものについてのメンタルモデルは次のとおりです。プロンプト、リポジトリ、コネクタ、そしてトリガーです。

作成する2つの方法

スケジュールタスクは、Web上のclaude.ai/code/routinesから作成できます。名前を付け、各セッションでClaudeに何をしてほしいかを説明する指示を書き、リポジトリを選び、トリガーを選択します。

Claude Codeの内部から、ターミナルを離れずに作成することもできます。/scheduleコマンドを実行し、次の例のように平易な言葉で希望する内容を記述するだけです。

/schedule daily dependency audit at 9am

どちらの入り口でも考え方は同じです。自分のワークフローに合う方を選んでください。

クラウドスケジュールタスクに頼る前に知っておくべき3つのこと

重要な用途でクラウドスケジュールタスクに頼る前に、次の3つの制限を覚えておいてください。

  • クラウドスケジュールタスクはリサーチプレビューです。 動作や制限は今後も変化し続けるため、変更があっても驚かないでください。
  • 繰り返しスケジュールは最短でも1時間に1回です。 それより頻繁な実行が必要な場合、クラウドスケジュールタスクは適したツールではありません。
  • 実行はデフォルトブランチの新しいクローンから開始され、プロンプトで別のブランチを指定しない限りclaude/ブランチにプッシュされます。 GitHubのプルリクエストイベントが実行をトリガーした場合、そのリポジトリがスケジュールタスク内の最初のリポジトリである限り、代わりにプルリクエストのヘッドコミットから開始されます。実行がプッシュできるブランチを制御するには、GitHubのブランチ保護ルールまたはルールセットを使用してください。GitHubはこれらを接続したGitHubアクセスに適用するため、そのアクセス権限で回避できるルールはプッシュをブロックしません。

ヘッドレスモード: 自分の環境が必要な場合

クラウドスケジュールタスクは、作業をAnthropicのインフラストラクチャ上で実行できる場合に最適です。しかし、作業に自分の環境が必要な場合や、実行の前後にロジックを組み込む必要がある場合もあります。そうしたときは、ドキュメントでは現在「非対話モード」と呼ばれているヘッドレスモードに切り替えます。

ヘッドレスモードの中核は-pフラグ(--printの短縮形)です。これはClaude Codeを対話型UIなしのワンショットコマンドとして実行します。標準入力を読み取り標準出力に書き込むため、他のシェルツールと同様にパイプ処理できます。

claude -p "summarize the changes in this diff"

知っておく価値のあることが一つあります。-p単体では、hook、Skills、プラグイン、MCPサーバー、CLAUDE.mdファイルなど、対話型セッションと同じコンテキストが読み込まれます。これらすべてをスキップするには、後述する--bareを追加してください。

構造化された出力を取得する

ヘッドレスモードは他のシェルツールと同様にパイプ処理できるため、文章ではなく構造化データを返してほしい場面がよくあります。JSONスキーマをJSON出力フォーマットと組み合わせることで、Claudeはそのスキーマに一致するよう出力を制約します。

スキーマに一致するオブジェクトは、JSONレスポンスのstructured_outputフィールドに格納されます。そのため、jqコマンドで取り出し、データベースや別のスクリプトにパイプすることができます。

bash
claude -p "Extract the exported function names from src/core/style.js" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}' \
  | jq '.structured_output.functions'

これにより、次の処理に渡せるきれいな配列が得られます。

セッションを使った複数ステップの自動化

複数のステップにわたる作業の場合、すべてを1つのコマンドに詰め込む必要はありません。JSON出力からセッションIDを取得し、後で再開できます。

claude --resume "$(jq -r .session_id /tmp/plan.json)"

1つ目のスクリプトが作業を開始し、別のスクリプトが完全なコンテキストを保ったまま後で再開します。最初のパスで計画が作られ、2番目のパスでそれを実行する場合に便利です。

CIのための一貫した実行

CIがどのマシンでも同じセットアップを必要とする場合、そのために作られたモードがあります。

--bareフラグは、hook、Skills、プラグイン、MCPサーバー、CLAUDE.mdファイルの自動検出をスキップします。得られるのは、Bash、ファイル読み取り、ファイル編集ツールを備えたClaudeに、--settingsや--mcp-configのようなフラグで渡したものを加えたものです。そのため、どのマシンも同じセットアップから開始でき、起動も高速になります。bareモードはサブスクリプションのログインを使用しないため、事前にANTHROPIC_API_KEYを設定してください。

Agent SDK: 自分のアプリ内にあるClaude Code

スペクトルの最後のステップはAgent SDKです。これにより、自分のTypeScriptまたはPythonアプリケーション内にClaude Codeを組み込むライブラリが手に入ります。

どちらの言語もquery関数と、CLIと同じプリミティブを公開しています。プロンプトに加えて、次のようなオプションを渡します。

  • Claudeができることを制御するallowedTools
  • システムプロンプト
  • そして権限モード

そして、Claudeがストリーミングで返してくるメッセージを順に処理し、アプリが必要とする方法で扱います。これはCLIと同じエンジンであり、自分のプロダクト内から呼び出せるだけの違いです。

どれを使うべきか?

簡単な判断基準は次のとおりです。

  • クラウドスケジュールタスクは、繰り返し作業のデフォルトの選択肢です。ホスティングの必要なく、Anthropicのインフラストラクチャ上で実行されます。
  • -pを使ったヘッドレスモードは、作業に自分のパイプラインが必要で、データをスクリプトでパイプしたい場合に向いています。
  • --bareは、CIがどのマシンでも同じセットアップを必要とする場合に向いています。
  • Agent SDKは、作業を自分のプロダクト内に組み込みたい場合に向いています。

まずはクラウドスケジュールタスクから始めてください。作業により高度な制御が必要な場合にのみ、スペクトルを下っていきましょう。