1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

10/25 の公式ドキュメント更新:Scheduled Tasks への移行とフック・サンドボックスの挙動詳細化

1
Posted at

この日の追加は、「Routines」から「Scheduled Tasks」への名称移行に伴う作成 UI の分岐案内、フックとワークツリーの境界ケースの文書化、サンドボックスによる特定ファイル削除ルールの詳細化の三方向に集中している。運用中のタスクやプラグインの挙動を正確に把握したい開発者・管理者に直接関係する記述が多い。

Scheduled Tasks への名称移行と作成フローの分岐

routines ページでは、機能名が「Scheduled Tasks」に統一されたことを受け、作成 UI が複数パターン存在することへの案内が追加された。

"The earlier name, routines, still appears ."

(出典 [1])

(訳:旧称「routines」はまだ一部の場所に残っています。)

アカウントによっては、ボタンやサイドバーが「New routine」「Routines」と表示される場合がある。その場合もフルページフォームから同等の操作ができ、Cloud 環境・リポジトリ・モデル・トリガーをまとめて設定できる。API トリガーを選んだ場合はトークンが作成後 1 度しか表示されないため、その場でのコピーが必要になる。複数のトリガーを組み合わせることも可能で、GitHub イベントは Pull request・Release・Issue の各カテゴリに対応している。

実行結果の意味:Succeeded でも作業完了は保証されない

タスクの実行履歴に表示される Succeeded / Failed / Cancelled の意味が明文化された。

"These outcomes say how the session ended"

(出典 [1])

(訳:これらの結果はセッションがどのように終了したかを示すものです。)

Succeeded はあくまでセッションが正常終了したことを意味し、プロンプトで指示した作業が完了したかどうかは保証しない。ブロックされたネットワークリクエストや Claude が完了できなかった作業はトランスクリプトに記録されるため、結果の確認にはトランスクリプトを開く必要がある。また、Succeeded した実行のセッションをアーカイブすると、その実行の結果は Cancelled に変わる点も注意が必要だ。History に警告が表示された場合は、警告ごとに指定された対処を行うと次の実行後に警告がクリアされる。

WorktreeCreate フックが動作しない起動パターン

hooks ページでは、プラグインの WorktreeCreate フックが実行されないケースが文書化された。

"Claude Code creates the worktree before it loads plugins"

(出典 [2])

(訳:Claude Code はプラグインを読み込む前にワークツリーを作成します。)

--worktree と --tmux を同時に指定して起動した場合、プラグインのロード前にワークツリーが作られるため、プラグインが定義する WorktreeCreate フックは実行されない。この組み合わせでもフックを動作させるには、設定ファイルにフックを定義する必要がある。v2.1.300 より前は --worktree 単独でも同じ問題があった。

サンドボックスと objects / refs フォルダの削除条件

sandboxing ページでは、サンドボックスが作業ディレクトリ直下の HEAD・objects・refs エントリを削除する条件が詳細化された。

"To keep a folder, leave something in it."

(出典 [3])

(訳:フォルダを残すには、何かを中に入れておいてください。)

セッション中に新たに作成された objects や refs フォルダは、サンドボックスコマンド終了後に削除される場合がある。中に何かを入れておくことで削除を防げるが、HEAD ファイルまたはシンボリックリンクがトップレベルに存在した状態でセッションが進行していた場合は、中身があっても削除される。v2.1.307 より前はこの例外が適用されておらず、内容物があっても削除されていた。フォルダを恒久的に残したい場合は HEAD をトップレベルから移動し、すべての Claude Code セッションを再起動する必要がある。

その他の更新

  • CwdChanged 以降にフックがファイルへ書き込んだ環境変数は、次の CwdChanged イベントで Claude Code がクリアする
  • Esc でプロンプトチェックを中断した際、フックがちょうどその瞬間にブロックしていた場合はテキストが入力欄に戻らず、ブロックメッセージが残る
  • サンドボックスが failIfUnavailable に設定されており初期化後に依存関係が失われた場合、セッション継続中も Claude によるコマンドが拒否される

まとめ

この日の更新で最も運用への影響が大きいのは、Scheduled Tasks の実行結果の意味の明文化だ。Succeeded をそのまま「作業完了」と解釈して監視を省略していたチームは、トランスクリプトの確認フローを見直す必要がある。WorktreeCreate フックの適用外パターンの文書化は、プラグイン作者にとって --tmux 利用時の想定外の不動作を説明する材料になる。サンドボックスの objects / refs 削除ルールは、Git リポジトリとは別の用途でこれらのフォルダを作業ディレクトリに置いているワークフローに影響しうる。

出典

本稿の引用はすべて一次資料と逐語照合(verify_article 通過)のうえ掲載しています(2026-11-01 検証)。

[1] https://code.claude.com/docs/en/routines
[2] https://code.claude.com/docs/en/hooks
[3] https://code.claude.com/docs/en/sandboxing

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?