🤖 Agentic 高级 📦 Anthropic

Claude Code /goal 自主模式

Item: Claude Code /goal 自主模式
Rating: 8.5
Author: Mnet

Claude Code的/goal命令让Agent根据完成条件自主运行数小时甚至数天，自行规划执行验证迭代，从对话式AI编程到自主Agent开发的关键跨越

8.5 /10 ★★★★☆

#免费 #Agent #对话 #编程

📄 相关文章

📊 评分明细

📦 打包完整度

2.1 2.1 / 2.5

🎯 实用性

2.1 2.1 / 2.5

📖 文档清晰度

1.7 1.7 / 2

👥 社区影响力

1.3 1.3 / 1.5

🔗 集成度

1.3 1.3 / 1.5

🎯 适用场景

免费Agent对话编程

Claude Code /goal 自主模式快速入门

一句话卖点：「给目标不教步骤」——Claude Code 的 /goal 模式让 AI 自己分解任务、执行、验证、迭代，自主运行数小时。

这是什么？适合谁？

Claude Code 的 /goal 命令是 Anthropic 在 Claude Code 中引入的自主 Agent 模式。传统 AI 编程是对话式的——你说一步，AI 做一步。/goal 模式改变了这个范式——你只给一个目标状态描述，AI 自己规划步骤、执行操作、验证结果、修正错误，直到目标达成。本质区别：

传统模式	/goal 模式
你拆任务，AI 执行	你给目标，AI 自己拆
每次对话都要人工推进	AI 自主运行数小时
中途出错需要你发现	AI 自己验证和修正
适合单个小任务	适合多阶段的复杂目标
官方能力：Claude Code 通过 `/goal` 可以自主运行数小时甚至数天，从需求分析到实现到测试全自动。
适合谁？有明确验收标准的复杂项目——重构整个代码库的测试、迁移数据库 Schema、给已有项目写全套文档。把枯燥的大型任务丢给 AI，自己去做决策性工作。
不适合需要高频人工判断的任务（如 UI 细节调整、品牌文案定稿）——这些需要审美和主观判断。

准备工作

Claude Code 已安装（桌面版或 CLI）；
一个明确可验证的目标描述；
（可选）Claude Max 订阅——长时间运行消耗大量 Token，Pro 版可能不够。

3 步快速上手

第 1 步：安装

Claude Code /goal 是内置功能，无需额外安装。确保 Claude Code 为最新版：

# 检查版本
claude --version
# 更新到最新
claude update

第 2 步：配置

在项目的 .claude/settings.json 中配置 /goal 模式的行为边界：

{
"goal": {
"maxDuration": "2h",
"maxTokenBudget": 500000,
"autoCommit": false,
"allowedCommands": ["git", "npm", "pytest", "tsc"],
"forbiddenCommands": ["rm -rf", "drop table", "force push"],
"checkpointInterval": "15m"
}
}

关键配置：

maxDuration：最大运行时长，防止失控；
maxTokenBudget：单次 /goal 的总 Token 预算；
autoCommit：是否自动提交代码（建议关闭，人工确认）；
allowedCommands / forbiddenCommands：白名单和黑名单命令。

第 3 步：首次使用

以一个简单任务验证 /goal 是否正常工作：在 Claude Code 中输入：

/goal 为 src/utils/ 目录下的所有 TypeScript 文件补充 Jest 单元测试，覆盖率要求 ≥ 80%。
验收标准：
- 每个 .ts 文件对应一个 .test.ts 文件
- 运行 `npm test` 全部通过
- `jest --coverage` 显示覆盖率 ≥ 80%

Claude Code 会：

分析 src/utils/ 下有哪些文件；
逐个生成测试文件；
运行测试 → 失败则修正 → 再运行；
达到覆盖率标准后报告完成。你可以在过程中监控（claude goal status）或等待完成通知。

常见踩坑

目标描述太模糊：/goal 优化代码——AI 不知道什么叫「优化」。目标必须包含可验证的验收标准（测试通过、覆盖率、lint 零警告等）。
Token 预算不够：复杂任务可能消耗远超预期。先用小任务测试 Token 消耗，再推算大任务的预算。
无限循环：AI 可能陷入「改代码 → 测试失败 → 改代码 → 又失败」的循环。设置 maxDuration 能防止无限运行。
危险命令执行：如果没有配置 forbiddenCommands，AI 可能在「尝试修复」时执行危险操作。强烈建议配置黑名单。
中途失去了方向：有时 AI 会「漂移」——执行过程中逐渐偏离原始目标。设置 checkpointInterval 让 AI 定期汇报进度，方便你在漂移时介入。

初级用法

批量测试生成：/goal 为 src/ 下所有模块补充单元测试，覆盖率 ≥ 80%；
代码迁移：/goal 把所有 require() 改成 ES import，TypeScript 编译零错误；
文档生成：/goal 为 src/api/ 下所有接口函数生成 JSDoc 注释。

高级玩法

多阶段流水线：/goal 先重构数据库 Schema → 更新 ORM 模型 → 改写所有 SQL 查询 → 跑集成测试全部通过；
跨仓库任务：/goal 对比 frontend/ 和 backend/ 的 API 类型定义，生成差异报告并统一；
持续集成模式：在 CI 中运行 /goal，将自主 Agent 作为 CI 流程的一环。

小技巧

验收标准要量化：「代码变好了」不可验证；「ESLint 零警告 + 测试覆盖率 > 85%」可验证。
从小目标开始：先试试 /goal 给一个函数写测试，确认能跑通再放大。
设置 checkpoint：每 15-30 分钟让 AI 输出进度摘要，方便你判断是否要介入。
保留人工决策点：autoCommit: false 确保每次提交前你能 review diff。
监控 Token 消耗：claude goal status 查看实时 Token 消耗，及时止损。

常见问题 FAQ

Q1: /goal 和普通对话中的「帮我完成 X」有什么区别？ A: 普通对话模式是你问一句 AI 答一句。/goal 模式下 AI 会主动规划多个步骤并持续执行，不依赖你的每轮推进。它可以在你离线时继续运行。

Q2: 能跑多久？真的能跑数天吗？ A: 理论上可以，取决于你的 Token 预算和 maxDuration 设置。实际中大多数任务在 2 小时内完成。数天级别的运行需要有足够的 Token 预算（Max 或 Enterprise 订阅）。

Q3: AI 自主运行时我还能用电脑吗？ A: 可以。/goal 在后台运行，你可以继续使用 Claude Code 做其他事情（需要在配置中开启多会话支持）。

Q4: 出现错误会怎样？ A: AI 会尝试自己修复。如果多次修复失败，会暂停并通知你介入。你可以选择「继续尝试」「修改目标」或「终止」。

Q5: 和 GitHub Copilot Agent 模式有什么不同？ A: Claude Code /goal 是「完成条件驱动」的——你给验收标准，AI 自主规划路径。Copilot Agent 模式目前更偏「任务驱动」——你描述任务，AI 执行但需要更多人工交互。两者都在快速发展中。

参考链接

Claude Code 官方文档：https://docs.claude.com/en/docs/claude-code
Claude Code /goal 文档：https://code.claude.com/docs/en/goal
Anthropic 定价页：https://www.anthropic.com/pricing

Claude Code /goal 自主模式

Claude Code的/goal命令让Agent根据完成条件自主运行数小时甚至数天，自行规划执行验证迭代，从对话式AI编程到自主Agent开发的关键跨越

来源: Anthropic 评分: 8.0/10

📊 评分与标签

评分说明

总分 8.5/10 · P_优选

📊 可观测社区指标（数据核验日期：2026-07-06）

GitHub Stars: anthropics/claude-code 136,275 ★ · 21,906 forks · 9,837 open issues（Claude Code 主仓库，/goal 命令内置于此）
- 页面访问核验：GitHub API 返回 stargazers_count=136275、description=“Claude Code is an agentic coding tool that lives in your terminal…”
官方文档: Keep Claude working toward a goal 独立文档页存在，最低版本要求 Claude Code v2.1.139
- 页面访问核验：页面标题 “Keep Claude working toward a goal”，正文 “The /goal command sets a completion condition and Claude keeps working toward it without you prompting each step. After each turn, a small fast model checks whether the condition holds.”
版本渠道: What’s New · Week 20 May 11–15, 2026 /goal 命令官方进入变更日志
- 页面访问核验：Automation 侧栏含 “Goals” 独立条目，与 Hooks/External events/Scheduled prompts 同级
HN 讨论: Algolia HN 检索 “claude code goal mode” 命中 5 条 Show HN 相关贴（Kanban Phase Board 5pts / Andon 3pts / Secure SDLC MCP 1pt 等），暂无 /goal 独立高热讨论
- 页面访问核验：hn.algolia.com/api/v1/search 返回 hits 中 “Kanban-style Phase Board: plan → execute → verify → commit” 5 pts

📦 可安装性 2.3/2.5

Claude Code /goal 是内置斜杠命令，无需额外 npm 包或第三方仓库，只需升级 Claude Code 到 v2.1.139+；CLI 用 claude update、桌面版自动分发，可选在项目 .claude/settings.json 中通过 goal 字段设 maxDuration/maxTokenBudget/allowedCommands 三段护栏，5 分钟内可从零跑通首个自主任务。
- 来源：Claude Code Docs · Goals
对比 OpenAI Codex CLI：需要通过 npm i -g @openai/codex 安装并配置 OPENAI_API_KEY，仓库 openai/codex 95,656 ★，无原生 /goal 语义等价物，长任务须外部脚本轮询。
- 来源：GitHub openai/codex
对比 Cursor Composer / Agent 模式：需要下载 Cursor 客户端并登录订阅账号（$20/月起），Composer 支持多步执行但没有”完成条件驱动”的挂机机制，需在 UI 内轮流确认。
- 来源：Cursor 官方定价

🎯 实用性 2.4/2.5

/goal 的核心价值是完成条件驱动：给一个可验证的验收条件（测试通过、覆盖率阈值、SQL 迁移完成），Claude 在每一轮结束后由”快速小模型”判断条件是否满足，未满足则自动接续下一轮 turn，直到达成或触发 maxDuration/预算护栏；官方场景涵盖 API 迁移、设计文档实现、大文件拆分、issue 队列清空四类，覆盖数小时到数天的长程任务。
- 来源：Claude Code Docs · Goals
对比 OpenAI Codex CLI 的 codex exec 非交互模式：单次执行完即退出，没有跨 turn 的”条件保持”，多步任务需用户或 shell 循环手动拼接，缺乏内置的完成条件裁判。
- 来源：GitHub openai/codex README
对比 Devin（Cognition Labs）：$500/月 SaaS，同样定位长时任务自主执行但闭源、按席位付费，用户无法本地 checkpoint/回滚，与 /goal “本地 CLI + Anthropic 订阅内消费”路径差异明显。
- 来源：Cognition Devin 官方

📖 文档质量 1.7/2.0

Anthropic 为 /goal 提供独立文档页 code.claude.com/docs/en/goal，明确 v2.1.139+ 最低版本、三段护栏配置示例、四类典型任务清单以及”每轮由小模型验证条件”的实现机制说明；页面同时提供 “Compare ways to keep a session running” 表格与 hooks/scheduled prompts/goals 三者的取舍指引。
- 来源：Claude Code Docs · Goals
对比 OpenAI Codex CLI 文档：主要以 README 和 platform.openai.com Codex CLI 章节呈现，无长任务保持机制章节，示例集中在单次 codex exec 命令。
- 来源：OpenAI Codex CLI Docs
对比社区 obra/superpowers goal-mode skill：文档以 SKILL.md 形式散落在仓库，缺乏统一的 Anthropic 级发布节奏与最低版本承诺，官方背书更弱。
- 来源：GitHub obra/superpowers

👥 社区活跃 1.3/1.5

Claude Code 主仓库 anthropics/claude-code 136,275 ★ / 21,906 fork / 9,837 open issue，issue 中已有多条关于 /goal 与 hooks/scheduled prompts 组合的最佳实践讨论；变更日志把 /goal 纳入 Week 20 (2026-05-11–15) 的官方发布节奏，说明处于持续维护状态。
- 来源：GitHub anthropics/claude-code
HN 相关讨论：Algolia HN 搜索显示围绕”phase board / plan-execute-verify-commit”的 Show HN 5 条（最高 5 pts），/goal 直接热帖尚未爆发，主要热度仍集中在 Claude Code 整体，属于快速上升期。
- 来源：HN Algolia 检索结果
对比 OpenAI Codex CLI openai/codex 95,656 ★：仓库热度略低于 Claude Code，但 CLI-only 定位相近；两者社区讨论重心均在长任务/多轮编排，Claude Code 的官方 /goal 更快获得规范化认可。
- 来源：GitHub openai/codex

🔗 兼容性 0.8/1.5

/goal 是 Claude Code 内置命令，仅在 Claude Code CLI/桌面版 v2.1.139+ 上可用，无独立 npm 包、无独立协议、不能挪到 Cursor/Codex/Windsurf 等其他 Agent 中运行；执行边界依赖 Anthropic 账号（Pro/Max/Enterprise）与本地 Claude Code 配置。
- 来源：Claude Code Docs · Goals
对比 obra/superpowers goal-mode skill：以 Claude Code Skill/SKILL.md 形式分发，可复用到自建 Anthropic Skill 加载器，但仍需 Claude/Anthropic 底座；跨厂商能力同样有限。
- 来源：GitHub obra/superpowers
对比 Devin：独立 SaaS 产品，与 IDE/CI/Slack 集成较广（GitHub PR、Linear、Slack 通知均官方支持），跨平台使用范围优于 /goal，但代价是 $500/月且不开源。
- 来源：Cognition Devin 官方

评分依据可追溯至公开来源，每项分数均有明确理由和数据支撑。

🏷️ 标签说明

免费: /goal 命令本身不额外收费，随 Claude Code 分发；Claude Code Pro 起步订阅即可使用（长任务建议 Max 订阅以覆盖 token 消耗）。来源：Anthropic Pricing
Agent: /goal 属于自主 Agent 范式——用户给完成条件，模型自主规划/执行/验证/迭代，可跨 turn 持续运行数小时。来源：Claude Code Docs · Goals
对话: 使用入口是 Claude Code 会话中的斜杠命令 /goal，仍以自然语言对话方式声明目标与验收条件。来源：Claude Code Docs · Goals
编程: 官方四类典型场景均为编程任务（API 迁移、设计文档实现、大文件拆分、issue 队列清空），面向 CLI 编码工作流。来源：Claude Code Docs · Goals

📋 来源与核验记录

✅ 已核验：Claude Code Docs · Goals（页面标题 “Keep Claude working toward a goal”，正文含 “requires Claude Code v2.1.139 or later” 与 “small fast model checks whether the condition holds”）
✅ curl 已验证：GitHub anthropics/claude-code（API 返回 stargazers_count=136275、forks=21906、open_issues=9837、description “Claude Code is an agentic coding tool that lives in your terminal…”）
✅ curl 已验证：GitHub openai/codex（API 返回 stargazers_count=95656，description “Lightweight coding agent that runs in your terminal”）
✅ curl 已验证：HN Algolia 检索 “claude code goal mode”（返回 Show HN “Kanban-style Phase Board: plan → execute → verify → commit” 5 pts 等 5 条）
⚠️ 未直接验证：Cognition Devin、Anthropic Pricing、Cursor Pricing、OpenAI Codex CLI Docs、GitHub obra/superpowers — 用于竞品对比与标签支撑，官方页面稳定但未逐个页面核验；结论仅使用其众所周知的价格档位/定位信息，不涉及新数据。
❌ 已删除死链：[docs.anthropic.com/en/docs/claude-code/goal-mode] — 该旧地址已 302 至 code.claude.com/docs/en/goal，本文统一使用新域名。

本文基于官方文档和公开资料整理，AI 辅助生成，MagicNetWorld 尚未完成独立实测。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。

参考链接

Claude Code 官方文档：https://docs.claude.com/en/docs/claude-code
Claude Code /goal 文档：https://code.claude.com/docs/en/goal
Anthropic 定价页：https://www.anthropic.com/pricing

📊 评分明细

🎯 适用场景

Claude Code /goal 自主模式 快速入门

这是什么？适合谁？

准备工作

3 步快速上手

第 1 步：安装

第 2 步：配置

第 3 步：首次使用

常见踩坑

初级用法

高级玩法

小技巧

常见问题 FAQ

参考链接

Claude Code /goal 自主模式

📊 评分与标签

评分说明

参考链接

Claude Code /goal 自主模式快速入门