Sign in Subscribe
Claude Code

Claude Code /goal 完全教學：設定目標、自動執行到完成

Claude Code v2.1.139 正式推出了 /goal 指令。/goal 讓你寫下「完成條件」，Claude 就會自己一輪一輪跑，直到條件成立才停下來——你不用一直在旁邊按 yes、送「keep going」。本文深入解析 /goal 的運作機制、撰寫技巧、實戰範例，以及如何與 Auto Mode 搭配實現真正的開發自動化。

Philo

Philo

— 10 min read
Share
Claude Code /goal 完全教學：設定目標、自動執行到完成

什麼是 /goal？


Claude Code terminal
Claude Code v2.1.139 正式推出了 /goal 指令。以前 AI 每做完一件事就會停下來等你，你得反覆送「繼續」「keep going」才能讓它跑完整個任務。有了 /goal，你只需要在開始時寫下「什麼叫做完成」，Claude 就會自己持續工作，直到那個條件被確認成立為止。

這背後的機制是這樣的：每次 Claude 完成一輪（turn）之後，一個獨立的小模型（預設是 Claude Haiku）會讀取對話記錄，判斷你的完成條件是否已經達成。如果還沒達成，Haiku 會告訴 Claude「還沒完成，繼續做」，並附上理由作為下一輪的引導。如果達成了，目標就自動清除，Claude 停下來。這個設計有個聰明之處：執行的是一個模型，評估的是另一個模型，不會讓 Claude 自己判斷自己做完了沒。

為什麼需要 /goal？

在 /goal 出現之前，開發者要讓 AI 跑完一個複雜任務，有幾種不太舒服的選擇：

  • 手動陪盯：每一輪結束就送一句「繼續」，不能離開
  • --dangerously-skip-permissions：跳過所有確認，但可能造成危險操作（大量刪檔、資料外洩）
  • 手刻 Stop hook：自己在 settings.json 寫停止邏輯，複雜且需維護

/goal 是介於「完全手動」和「危險的跳過全部」之間的中間路徑，既能讓任務自動跑多輪，又保留了可驗證的停止條件。

快速開始：基本語法

/goal <完成條件>

最簡單的例子：

/goal all tests in test/auth pass and the lint step is clean

輸入這行之後，Claude 馬上就開始第一輪工作，不需要你再另外送一條指令。畫面上會顯示 ◎ /goal active 狀態列，告訴你目標跑了多久、跑了幾輪、花了多少 tokens。

怎麼寫出「能跑動的條件」

這是 /goal 最關鍵的一步。條件要寫得讓 Haiku（評估模型）光看對話就能判斷——因為評估模型不會自己去跑指令，也不會讀取你的檔案，只能看 Claude 在對話中輸出的內容。

三個要素

要素 說明 範例
一個可量測的終點 測試結果、build exit code、檔案數量 npm test exits 0
驗證方式 Claude 要怎麼證明它做完了 git status is clean
不能動的範圍 哪些東西不能被改到 no other test file is modified

✅ 有效的條件（評估模型看得懂）

/goal npm test exits 0, git status shows no uncommitted changes,
and no file in src/auth exceeds 200 lines

❌ 無效的條件（評估模型無從判斷）

/goal code is clean and refactor is done

「clean」和「done」沒有客觀標準，評估模型只能猜測，而且往往猜「完成了」——讓目標提前結束。

常用的可驗證條件寫法

  • npm test 不出錯 → npm test exits 0
  • git 狀態乾淨 → git status shows no uncommitted changes
  • lint 通過 → npm run lint exits 0
  • build 成功 → npm run build exits 0
  • e2e 測試全過 → e2e/checkout tests all pass

加上安全上限

條件字數上限是 4,000 字，非常寬裕。如果想防止無限迴圈，可以加一句：

/goal migration to v2 API complete or stop after 20 turns

Claude 每輪都會回報輪次進度，評估模型也會把這個限制納入判斷。

實戰範例

範例一：修 auth 測試

/goal test/auth 全部通過，npm run lint 乾淨，不要改其他測試檔

範例二：API 遷移

/goal all imports updated, npm test exits 0, no references to oldClient remain

範例三：切分大型檔案

/goal src/billing.ts split so no file exceeds 300 lines, tests pass

範例四：實作設計文件

/goal all endpoints from docs/spec.md respond with expected status, integration tests pass

範例五：處理 issue 待辦清單

/goal every open issue with label "good-first" has either a PR or a justification comment

以上範例均符合「光看輸出就能判斷做完了沒」的原則。

三種模式的接力關係

/goal 是 Claude Code 整個自動化工作流程的一塊拼圖，要和 Plan Mode 與 Auto Mode 搭配才能發揮最大效果。

Plan Mode：動工前想清楚

Plan Mode 是唯讀模式——Claude 讀你的程式碼、規劃步驟，但不做任何修改。適合：[^8]

  • 碰到陌生 codebase 時
  • 大型多檔案重構前
  • 涉及 auth、付款、資料庫等高風險改動前

啟用方式：Shift+Tab 切換，或指令前加 /plan。

/goal：動工中跑到完成

Plan 確認沒問題之後，切換到一般模式，下 /goal，Claude 就開始執行並持續跑到條件成立。

Auto Mode：省掉每個工具確認

Auto Mode 的作用是讓 Claude 在單輪工作中不必為每個工具呼叫請求確認。一個分類器會在每次工具呼叫前判斷是否危險，安全的操作自動放行，危險的才會攔截。

這三者的差別一目了然：

模式 解決的問題 適合時機
Plan Mode 避免 Claude 誤解任務範圍 動工前，陌生 codebase
/goal 省去輪次之間的手動推進 動工中，目標明確
Auto Mode 省去輪次內的工具確認 搭配 /goal 使用

最強組合：/goal + Auto Mode

  • 只開 Auto Mode：工具自動放行，但 Claude 一輪做完就停，不接著跑下一輪
  • 只開 /goal：會自動跑多輪，但每個工具呼叫還是要你確認
  • 兩個一起開：工具自動放行、輪次自動推進，條件達成才停——這才是真正的「設好就走」

啟用方式：claude --enable-auto-mode，再用 Shift+Tab 切換到 Auto Mode，然後下 /goal。

Codex CLI 的 /goal：OpenAI 版本


OpenAI Codex CLI terminal
Claude Code 並不是唯一一個有 /goal 功能的工具。OpenAI 的 Codex CLI 在 v0.128.0 版也加入了 /goal。
Codex 版的 /goal 屬於實驗性功能，需要手動啟用：

# 方法一：在 Codex 內部啟用
/experimental
# 找到 goals 選項並開啟

# 方法二：指令直接啟用
codex features enable goals

啟用後就可以和 Claude Code 一樣使用 /goal <目標描述>。

Claude Code vs Codex /goal 比較

功能 Claude Code Codex CLI
/goal 狀態 內建，正式功能 實驗性，需手動啟用[^9]
評估模型 Claude Haiku（可配置） 類似機制[^12]
管理指令 /goal clear, /goal pause, /goal resume /goal pause, /goal resume, /goal clear[^10]
非互動模式 ✅ 支援 claude -p "/goal ..." ✅ 支援[^10]
與 Auto Mode 搭配 ✅ 官方推薦組合[^6] 需另外設定

Codex 社群已有人成功讓它跑了 14 小時不停處理一個 device driver 專案——/goal 的長期任務潛力不容小覷。[^13]

/goal、/loop、Stop hook 的差異

搞清楚這三個有助於選對工具：

工具 下一輪觸發條件 停止條件 適合情境
/goal 上一輪結束 模型確認條件成立 有明確驗證條件的任務
/loop 固定時間間隔 手動停止或 Claude 自決 等待外部狀態（CI 跑完、API 回應）
Stop hook 上一輪結束 你自己的腳本或 prompt 跨 session 的固定規則

/goal 是 session 層級的一次性命令，適合「我知道做完是什麼樣子，但不確定要幾輪」的任務。Stop hook 是永久設定，適合「每個 session 都要遵守的規則」。

常見問題

Q：/goal 同時只能有一個嗎？

是的，每個 session 只能有一個 active goal。新的 /goal 會直接覆蓋舊的，不會詢問。

Q：session 關掉再開，goal 還在嗎？

用 --resume 或 --continue 重開 session，goal 的條件會保留，但輪次計數和 timer 會重置。已達成或已清除的 goal 不會復原。

Q：/goal 在什麼情況下無法使用？

workspace 必須先通過信任對話框，且 disableAllHooks 未啟用。因為 /goal 的底層就是一個 Stop hook。

Q：非互動模式怎麼用？

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

直接在 CLI 呼叫，跑完為止。Ctrl+C 可以中斷。

核心概念整理

用一個比喻來總結三種模式的角色：

Plan Mode 是建築師畫設計圖（想清楚再動手）
/goal 是工頭設定驗收標準（告訴工人什麼叫蓋完）
Auto Mode 是讓工人不用每顆釘子都問你（工具自動放行）

三個一起用，才能真正放下 terminal、去做別的事，等 Claude 把任務跑完。

本文資訊來源：Anthropic Claude Code 官方文件、Claude Code v2.1.139 更新日誌、OpenAI Codex CLI GitHub、Jakub Kontra 技術分析

References

  1. Claude Code just shipped a "run until done" mode. Upgrade to v2 ... - The new /goal command lets you set a completion condition ("all tests pass and the PR is ready"), th...
  2. Keep Claude working toward a goal - Claude Code Docs - The /goal command sets a completion condition and Claude keeps working toward it without you prompti...
  3. Anthropic Just Solved The Biggest Claude Code Problem! /goals safes the day! - Claude Code's new /goal slash command sets a completion condition once and keeps Claude working, t...
  4. /goal in Claude Code: keep a session running until the condition holds - Anthropic shipped the /goal slash command. A session-scoped wrapper over a prompt-based Stop hook: y...
  5. Claude's Built-in Goal Feature Simplifies Looping and Evaluation - Did you try the new /goal? The new /goal in Codex/Claude Code is essentially a built-in Ralph loop w...
  6. Auto mode for Claude Code - Auto mode lets Claude Code make permission decisions with built-in safeguards — fewer interruptions ...
  7. /goal is the best command in Claude Code right now. And most ... - The key difference from /goal and /loop: /goal and /loop require an open session. If you close Claud...
  8. Claude Code Plan Mode: The One Workflow That Prevents 90% of ... - Claude Code's plan mode shows you every action before it runs. Here's how it works, when to use it, ...
  9. Goal Mode Changes Everything for AI Coding - daily.dev - Claude Code and Codex CLI have both added a /goal feature that enables autonomous looping agents — y...
  10. Document the /goal CLI command and Goals lifecycle in slash ... - A local codex-cli 0.128.0 install contains goal-related command/help strings, including Usage: /goal...
  11. Codex v0.128.0 加入了一個/goal 功能，是OpenAI 的Ralph Wiggum ... - Codex v0.128.0 加入了一個/goal 功能，是OpenAI 的 Ralph Wiggum loop 實作，這次真的可以讓你在Codex CLI 跑上三天三夜不停歇，這有多厲害就不用我說了...
  12. Goal Mode Changes Everything for AI Coding - YouTube - ... claude code, cursor, and LLMs to code? Checkout ny course teaching ... NEW Self-Improving Memory...
  13. Codex /goal: OpenAI's 'Ralph Loop' Feature That Ran a Device ... - Codex's /goal feature keeps a task alive across turns until complete — one user ran it on a device d...

Read more