/goal とは何か
コマンドリファレンスでは、次の一行で説明されています。「条件が満たされるか、他の理由でゴールがクリアされるまで、Claude はターンをまたいで作業を継続する」。
ゴールのドキュメントでは、そのメカニズムが説明されています。「/goal は、セッションスコープのプロンプトベースの Stop フックをラップしたものである。Claude がターンを終えるたびに、Claude Code は条件とこれまでの会話を、設定された小型で高速なモデルに送信する」。
そのモデルが「エバリュエーター」です。毎ターンの後、エバリュエーターは以下の3つの判定のいずれかを返します。
- Not yet met(未達成): 「Claude は作業を継続し、その理由を次のターンのガイダンスとして受け取る」。
- Met(達成): 「Claude Code はゴールをクリアし、トランスクリプトに達成記録を書き込む」。
- Impossible(不可能): エバリュエーターが「条件は決して満たされないと判断した」場合。Claude Code はゴールをクリアし、その理由を記録する。
ドキュメントでは、これが「Claude 自身に終了タイミングを任せること」とどう違うのかを説明しています。オートモードは「単一ターン内でのツール呼び出しを承認するが、新しいターンは開始しない」のに対し、/goal は「毎ターンの後に条件をチェックする独立したエバリュエーターを追加する」という点です。
ゴールの設定、確認、クリア方法
設定する: /goal の後に条件を入力して実行します。「ゴールを設定すると、条件自体を指示として即座にターンが開始される。別途プロンプトを送信する必要はない」。1つのセッションでアクティブにできるゴールは1つだけで、新しいゴールを設定すると古いものは上書きされます。
確認する: 引数なしで /goal を実行します。ステータスには、条件、実行時間、評価されたターン数、現在のトークン消費量、およびエバリュエーターによる最新の理由が表示されます。
クリアする: /goal clear を実行します。ドキュメントには、エイリアスとして stop, off, reset, none, cancel が挙げられています。/clear を実行して新しい会話を開始した場合も、アクティブなゴールは削除されます。
ゴールを設定しても、パーミッションモード(許可モード)は変わりません。ドキュメントには「ゴールのターンを無人(自動)で実行させるには、オートモードで /goal を実行すること」とあります。マニュアルモードでは、設定で許可されていないツール呼び出しの前に、Claude は依然として確認を求めます。
エバリュエーターが参照できるもの
これが冒頭の例で起きた最初の驚きの原因です。エバリュエーターは「会話」を読みます。エバリュエーター自身があなたのターミナルやファイル、テストランナーを直接見ることはありません。
ドキュメントには明記されています。「独立してコマンドを実行したりファイルを読み取ったりすることはない」。したがって、別のターミナルウィンドウでパスしたテストや、セッション外で変更されたファイルは、エバリュエーターが利用できる証拠にはなりません。重要なのは、Claude が何を実行し、会話の中で何を報告したかです。
トランスクリプトには各判定が表示され、ドキュメントによれば Ctrl+O を押すことでその背後にある理由を確認できます。エバリュエーターが「ゴール未達成」と言い続ける場合、その理由を見ることで、どのような証拠が不足しているかを知ることができます。
機能する条件の書き方
ドキュメントには短いチェックリストが掲載されています。多くのターンを経ても有効な条件には、通常以下の要素が含まれます。
- 「1つの測定可能な終了状態」: テスト結果、ビルドの終了コード、ファイル数、空のキューなど。
- 「明示されたチェック方法」: Claude がそれをどう証明すべきか(例:テストコマンドが終了コード 0 で終了すること)。
- 「重要な制約」: 途中で変更してはならない事項。
エバリュエーターは会話しか見ることができないため、「明示されたチェック方法」が最も重要です。「インテグレーションテストに合格すること」という条件は、コマンド名を指定することで判断しやすくなります。そうすれば Claude がそれを実行し、結果がトランスクリプトに表示されるからです。
条件は最大 4,000 文字まで記述できます。ゴールの実行時間を制限するために、ドキュメントではターン数や時間の句を追加することを推奨しています(例:規定のターン数後に停止するなど)。「Claude は毎ターンその句に対する進捗を報告し、エバリュエーターは会話からそれを判断する」。
再開したセッションでゴールが復活する理由
これが冒頭の例の2番目の挙動です。ゴールはセッションに紐付いており、セッションを再開(resume)するとゴールも復元されます。
ドキュメントによると、Claude Code は「あらゆる再開ルート(continue、セッション ID または名前による resume、トランスクリプトのファイルパスによる resume を含む)」において、アクティブなゴールを復元します。
一部の項目はリセットされます。「Claude Code は条件を引き継ぐが、ターン数、タイマー、トークン消費のベースラインはリセットする。すでに達成された、またはクリアされたゴールは復元しない」。
そのため、ゴールがアクティブな状態でその日の作業を終えると、翌日再開したときにそのゴールが残っています。不要な場合は、セッションを閉じる前にクリアするか、再開後にクリアしてください。
ゴールはセッションと共に持続しますが、セッションをまたいで(別のセッションに)引き継がれることはありません。新しいセッションはゴールなしで開始され、/clear はアクティブなゴールを削除します。ゴールのドキュメントでは、これを「現在のセッションのみでアクティブな」セッションスコープのショートカットと呼んでいます。
バックグラウンド作業がゴールに与える影響
長期的なゴールにはサブエージェントやバックグラウンドコマンドが含まれることがありますが、ドキュメントにはそれらに関する特定のルールがあります。
評価の待機: 「ターンの終了時にサブエージェントやバックグラウンドのシェルコマンドがまだ実行されている場合、Claude Code はそのターンの評価をスキップする」。バックグラウンド作業がすべて終了した状態で完了した次のターンの最後に評価が行われます。
チェックイン: バックグラウンド作業によってゴールが30分間待機状態になると、チェックインが必要になります。Claude Code は実行中のタスクをリストアップし、Claude に出力を読み取らせ、進捗があれば待機を継続し、スタックしているものがあれば修正または停止するように求めます。
停滞によるループ停止: 「Claude が進捗を見せずに(数ターン連続でツールを使用せずに)エバリュエーターに応答し続ける場合、Claude Code はループを停止し、警告を表示して、ゴールを設定したままコントロールをユーザーに戻す」。
ターンが失敗したときに何が起きるか
ドキュメントでは、エラーを2つの種類に分けています。
修正が必要なエラーはゴールをクリアする: これには、Claude Code が自身の認証情報を管理している場合の認証失敗、クレジット残高不足、「自動コンパクションで解消できなかったコンテキスト(context)オーバーフロー」、およびモデルが利用不可な場合が含まれます。Claude Code は原因を明記した警告を表示し、ユーザーが修正した後に再度ゴールを設定する必要があります。
その他のエラーは設定を維持する: 「その他のエラーが発生した後も、ゴールは設定されたままとなる」。
コンテキストオーバーフローのケースは、長期的なゴールにおいて注目に値します。多くのターンを実行するゴールはコンテキストウィンドウを埋めてしまいますが、通常は自動コンパクションによって継続されます。コンパクションで十分な空き容量を確保できなくなった場合、ゴールは終了します。
/loop や Stop フックの方が適している場合
ドキュメントでは、プロンプト間でセッションを実行し続ける3つの方法を比較しています。違いは「何が次のターンを開始させるか」です。
/goal: 前のターンが終わると次のターンを開始し、モデルが条件達成を確認するか、不可能と判断したときに停止する。/loop: 「一定の時間間隔が経過したとき」に次のターンを開始し、ユーザーが停止させるか、Claude が作業完了と判断したときに停止する。- Stop フック: 前のターンが終わると次のターンを開始し、「独自のスクリプトまたはプロンプトが決定したとき」に停止する。
したがって、/loop は数分おきにデプロイを確認するなど、時間主導の作業に適しています。スケジュールされたタスクのドキュメントでは、これを「セッションを開いたままプロンプトを繰り返し実行する最短の方法」と呼んでいます。
Stop フックは、常に適用されるべきルールに適しています。ドキュメントの説明によれば、「/goal はセッションスコープのショートカットであり、入力した条件はそのセッションのみで有効である。Stop フックは設定ファイルに存在し、そのスコープ内のすべてのセッションに適用され、決定論的なチェックのためにスクリプトを実行できる」とのことです。
この「決定論的(deterministic)」という言葉が重要です。/goal のエバリュエーターは会話から判断するため、チェックを決定論的に行う必要がある場合は、スクリプトを実行する Stop フックが適しています。
夜間のテストなど、セッションを開かずに実行すべき作業については、ドキュメントはスケジューリングオプションを推奨しています。スケジュールされた実行間で何が引き継がれるかについては、Claude Code ルーチンのガイドで解説しています。
よくある間違い
エバリュエーターが見ることができない条件を書く: エバリュエーターはファイルやターミナルではなく、会話を判断材料にします。
セッション終了時にゴールも終了すると期待する: 再開するとアクティブなゴールが復元されます。
2つ目のゴールを設定しようとする: 1つのセッションでアクティブにできるゴールは1つです。新しいものは古いものを上書きします。
定期的なチェックに /goal を使う: 一定間隔で実行するには /loop を使用します。
/goal がツール呼び出しを承認すると期待する: ゴール設定によってパーミッションモードが変わることはありません。
解決策:エバリュエーターが判断できるゴールを書く
ステップ 1: 条件の中にチェック方法を明記する
ゴールの達成を証明する結果を出すコマンドを含めます。
ステップ 2: 制約と制限を追加する
変更してはいけないことと、停止すべきタイミングを記述します。
ステップ 3: 再開したくないゴールはクリアする
継続する予定のないセッションを閉じる前に、/goal clear を実行します。
ステップ 4: 長期的なゴールの成果を記録する
結果、うまくいったアプローチ、やり残したことを書き留めます。
MemoryLake でのセットアップ
ゴールは条件が満たされると終了します。そこに至るまでに学んだこと(どのテストが不安定だったか、どの修正が有効だったか、何を後回しにしたかなど)は、書き留めておかない限り、次のセッションには引き継がれないコンテキスト(context)です。トランスクリプトにはターンが残りますが、結論はそれらの中に散らばっています。
MemoryLake は、そのようなプロジェクトのコンテキスト(成果、成功したアプローチ、未完了の項目など)を1か所にまとめて管理し、ChatGPT、Claude Code、Codex などの接続されたアシスタントが利用できるようにする記憶(memory)レイヤーです。
エントリーはあなた自身の言葉で記述します。Claude Code のセッション、トランスクリプト、ゴール、設定ファイル、またはベンダーのストアから何かが読み取られたり、書き込まれたり、削除されたりすることはありません。/goal は Anthropic が説明している通りに動作します。
ステップ 1: API キーを作成する
サインインしてダッシュボードからキーを生成します。他の認証情報と同様に、リポジトリの外に保管してください。

ステップ 2: 最初の記憶をアップロードする
解決策のステップ 4 で書いた内容、つまり各ゴールが何を生み出したかから始めましょう。1つのゴールにつき1つのエントリーを作成します。

ステップ 3: AI とエージェントを接続する
Claude Code、Codex、および使用している他のアシスタントを接続します。次のセッションは、同じ成果から開始できます。

実践で何が変わるか
第一の違いは、より良い「次のゴール」を設定できることです。前のゴールで見つかった内容に基づいた条件を書くことができます。
第二に、失敗の繰り返しが減ります。不安定なテストや行き止まりの記録が残ります。
第三に、ツール間での一貫性です。Claude Code でも他のアシスタントでも、同じ成果を利用できます。
Claude Code における /goal のベストプラクティス
チェックを可視化する: エバリュエーターは会話しか見ることができません。
終了状態を1つに絞る: 測定可能な条件が最も効果的です。
長期的なゴールに制限を設ける: ターン数や時間の句を追加します。
無人実行にはオートモードを使う: ゴールを設定しても権限は変わりません。
意図的にゴールをクリアする: 再開するとアクティブなゴールが復活します。
適切なツールを選ぶ: 一定間隔なら /loop、決定論的なチェックなら Stop フックを使います。
結論
/goal は、条件が満たされるまで Claude Code をターンをまたいで動作させ続けます。これはセッションスコープのプロンプトベースの Stop フックです。各ターンの後、小型で高速なモデルが条件と会話を読み取り、ゴールが達成されたか、未達成か、あるいは不可能かを判断します。エバリュエーターはコマンドを実行したりファイルを読み取ったりしないため、条件には結果が会話に表示されるようなチェック方法を指定する必要があります。
セッション終了時にアクティブだったゴールは、あらゆる再開ルートで復元され、ターン数、タイマー、トークンベースラインがリセットされます。バックグラウンド作業は評価を遅らせ、修正が必要なエラーはゴールをクリアし、その他のエラーは設定を維持します。時間間隔ベースの作業には /loop を、すべてのセッションに適用すべき決定論的なチェックには Stop フックを使用してください。