/goal

各ターンの後にモデルが条件を満たしたかを判定し、まだ満たしていないと判断した場合は、操作をユーザーに戻さずに次のターンを始めます。完了の判定は、作業しているモデルとは別の評価役が行います。

/goal は、セッション単位のプロンプトベースの Stop hook を包む仕組みです。Claude がターンを終えるたびに、Claude Code は条件とそれまでの会話を、設定済みの small fast model に送ります。

• ゴールはセッション単位で、有効なのは現在のセッションの間だけです。1 つのセッションで有効にできるゴールは 1 つで、同じコマンドが引数に応じて設定・確認・解除を行います。
• ゴールは、条件が満たされたとき、条件を満たせないとモデルが判断したとき、ユーザーが対処する必要のあるエラーでターンが失敗したときに自動で解除されます。認証の失効、クレジット残高の枯渇、コンテキスト超過など回復不能なエラーでは、通知とともに解除されます。
• Claude がツールを使わないまま評価役への応答を数ターン続けるなど進展が無い場合、Claude Code はループを止めて警告を出し、ゴールを残したまま操作をユーザーに戻します。

評価役は、Claude が会話の中で示した内容をもとに条件を判定し、自らコマンドを実行したりファイルを読んだりはしません。そのため条件は、Claude 自身の出力で示せる形で書きます。

• 条件は最大 4,000 文字です。
• 実行の長さを区切るには、or stop after 20 turns のように、ターン数や時間の区切りを条件に含めます。
• ゴールは permission mode を変更しません。ゴールのターンを無人で進めるには、auto mode で /goal を実行します。
• 判定に別のモデルを使うには ANTHROPIC_DEFAULT_HAIKU_MODEL を設定します。

/goal は対話モード、-p、Remote Control で動作します。-p でゴールを設定すると、1 回の呼び出しでループを完了まで実行します。

claude -p "/goal CHANGELOG.md has an entry for every PR merged this week"

ループの進行に合わせて各メッセージを出力するには --output-format stream-json --verbose を追加します。解決前に非対話のゴールを止めるには、Ctrl+C でプロセスを中断します。

セッションを再開すると、終了時に有効だったゴールが復元されます。claude --resume のピッカーから再開した場合も同様です。条件は引き継がれますが、ターン数、タイマー、トークン消費量の基準はリセットされます。達成済みまたは解除済みのゴールは復元されません。

ターンの終了時にサブエージェントやバックグラウンドのシェルコマンドがまだ実行中の場合、Claude Code はそのターンの判定をとばします。

バックグラウンドの作業でゴールが 30 分以上待たされると、Claude はその作業にチェックインします。アイドル状態のセッションでは 30 分後、その後 1 時間、2 時間と間隔を空けて自動でチェックインし、1 つのゴールで始めるチェックインは最大 3 回です。次のメッセージを送ると、さらに 3 回まで許可されます。

最初のチェックインの間隔は CLAUDE_CODE_GOAL_CHECKIN_MINUTES で変更でき、0 にするとチェックインと自動の再試行が無効になります。

対話モードでゴールを設定し、確認し、解除する流れは次のとおりです。

1. /goal の後に満たしたい条件を続けて実行します (例: /goal all tests in test/auth pass and the lint step is clean)。すでに有効なゴールがある場合は、新しいゴールに置き換わります。
2. 引数なしで /goal を実行すると、現在の状態を確認できます。有効なゴールがあれば、条件、経過時間、判定済みのターン数、現在のトークン消費量、評価役の直近の理由が表示されます。
3. 条件が満たされる前にゴールを外すには /goal clear を実行します。stop、off、reset、none、cancel も clear の別名として使え、/clear で新しい会話を始めた場合も有効なゴールは解除されます。