Claude Code五月四大更新：Agent View到/goal全实战

# 检查当前版本
claude --version

# 如果版本低于2.1.139，执行升级
npm install -g @anthropic-ai/claude-code@latest

# 或使用Homebrew（macOS）
brew upgrade claude-code

$ claude --version
2.1.147

# 方法一：直接命令
claude agents

# 方法二：在交互会话中使用斜杠命令
# 先启动 claude，然后输入：
/agents

┌─ Claude Code Agent View ──────────────────────────────┐
│                                                        │
│  #  Session ID    Status      Duration    Tokens       │
│  ──────────────────────────────────────────────────── │
│  1  a3f8c2d1     Running     4m 23s      12,847       │
│  2  b7e4a902     Waiting     2m 11s      8,234        │
│  3  c1d5f678     Completed   6m 45s      23,191       │
│                                                        │
│  [r] Refresh  [k] Kill  [Enter] Switch  [q] Quit      │
└────────────────────────────────────────────────────────┘

# 终端1：启动前端任务（后台模式）
claude --print "构建React组件库，包含Button、Input、Modal三个组件" &
SESSION_PID=$!

# 终端2：启动后端任务
claude "创建Express.js REST API，包含/users和/posts两个端点"

# 在另一个终端查看所有会话
claude agents

# 启动会话
claude

# 设置目标
/goal 所有单元测试通过，测试覆盖率不低于80%

# 进入项目目录
cd ~/projects/my-express-app

# 启动Claude Code
claude

# 设定明确的目标
/goal 将src/目录下所有回调风格的异步函数重构为async/await，所有现有测试必须通过

[Goal Set] 将src/目录下所有回调风格异步函数重构为async/await
├── [Step 1] 扫描src/目录，识别6个文件中的14个回调函数
├── [Step 2] 重构 routes/users.js (3个函数)
├── [Step 3] 重构 routes/posts.js (4个函数)
├── [Step 4] 重构 services/auth.js (3个函数)
├── [Step 5] 重构 utils/helpers.js (4个函数)
├── [Step 6] 运行测试 → 2个测试失败
├── [Step 7] 分析失败原因：error handler未适配Promise rejection
├── [Step 8] 修复error handler
├── [Step 9] 重新运行测试 → 全部通过
└── [Goal Achieved] ✓ 14个函数已重构，12/12测试通过

# 好的目标 —— 可量化、可验证
/goal ESLint零error零warning，Prettier格式化通过

# 不好的目标 —— 模糊、无法验证
/goal 让代码质量变好

/goal 完成所有TODO注释标记的功能实现。约束：不修改现有公共API签名，不引入新依赖

## Goal Constraints
- Maximum iterations: 20
- Stop if token usage exceeds 500K
- Always run tests after each code change

# 启动Claude Code会话
claude

# 开启广播模式
/radio

# 系统会生成一个分享链接
📡 Radio session active
   Share URL: https://claude.radio/s/xK9m2p
   Viewers can watch in real-time (read-only)

{
  "radio": {
    "enabled": true,
    "redactPatterns": [
      "sk-[a-zA-Z0-9]{32,}",
      "password\\s*[=:]\\s*\\S+",
      "token\\s*[=:]\\s*\\S+"
    ],
    "maxViewers": 10,
    "autoExpireMinutes": 30
  }
}

# 在Claude Code会话中搜索插件
/install:search frontend

# 或浏览官方市场目录
/install:browse

# 查看已安装插件
/install:list

# 在Claude Code会话中
/install:skill frontend-design

# 系统输出
✓ Skill 'frontend-design' installed
  Location: ~/.claude/skills/frontend-design/
  Activate: The skill will auto-activate when frontend tasks are detected

/install:skill memory

/install:skill plan-mode

/install:skill git-workflow

/install:skill code-review

/install:skill debug-helper

# 更新单个插件
/install:update frontend-design

# 更新所有插件
/install:update --all

# 卸载插件
/install:remove frontend-design

# 查看插件详情
/install:info frontend-design

原始上下文 → Compaction引擎 → 压缩后上下文
  (200K tokens)                  (~60K tokens)

{
  "compaction": {
    "autoCompact": true,
    "compactThreshold": 0.85,
    "preserveRecentTurns": 5,
    "strategy": "smart"
  }
}

# 在会话中手动触发压缩
/compact

# 使用自定义压缩提示
/compact 请保留所有关于数据库schema的讨论

# 创建项目目录
mkdir notecli && cd notecli

# 初始化Git仓库
git init

# 启动Claude Code
claude

> 请帮我初始化一个Node.js CLI项目，使用TypeScript，项目名为notecli。
> 要求：
> 1. 使用 Commander.js 作为CLI框架
> 2. 使用 Chalk 进行终端着色
> 3. 使用 Gray-matter 解析Markdown front matter
> 4. 笔记存储在 ~/.notecli/notes/ 目录下

# 在Claude Code会话中
/install:skill debug-helper

# 确认安装
/install:list

# 设定开发目标
/goal 完成notecli的四个核心命令实现：notecli add、notecli list、notecli search、notecli export。
> 每个命令必须包含完整的单元测试。
> 测试覆盖率≥85%。
> TypeScript编译零错误。

# 后台启动文档生成任务
claude --print "为notecli项目生成完整的README.md，包含安装说明、使用示例和API文档" &

claude agents

# TypeScript编译
npx tsc --noEmit

# 运行测试
npm test

# 尝试使用CLI
npx ts-node src/index.ts add "我的第一篇笔记" --tags "test,hello"
npx ts-node src/index.ts list
npx ts-node src/index.ts search "笔记"

notecli/
├── src/
│   ├── index.ts          # CLI入口
│   ├── commands/
│   │   ├── add.ts        # 创建笔记
│   │   ├── list.ts       # 列出笔记
│   │   ├── search.ts     # 搜索笔记
│   │   └── export.ts     # 导出HTML
│   ├── services/
│   │   ├── noteService.ts    # 笔记CRUD
│   │   └── searchService.ts  # 搜索引擎
│   └── utils/
│       ├── config.ts     # 配置管理
│       └── formatter.ts  # 格式化输出
├── tests/
│   ├── commands/
│   │   ├── add.test.ts
│   │   ├── list.test.ts
│   │   ├── search.test.ts
│   │   └── export.test.ts
│   └── services/
│       ├── noteService.test.ts
│       └── searchService.test.ts
├── CLAUDE.md
├── package.json
├── tsconfig.json
└── README.md

flowchart TB
    Start([启动Claude Code]) --> Auth{认证方式}
    Auth -->|API Key| Session1[交互会话]
    Auth -->|OAuth| Session2[交互会话]

    Session1 --> Mode{选择模式}
    Mode -->|传统对话| Chat[逐步引导开发]
    Mode -->|/goal| Goal[设定自主目标]
    Mode -->|/radio| Radio[开启广播模式]

    Goal --> Plan[AI制定执行计划]
    Plan --> Execute[自动执行代码修改]
    Execute --> Test{测试通过?}
    Test -->|是| Done([目标达成])
    Test -->|否| Analyze[分析失败原因]
    Analyze --> Execute

    Radio --> Share[生成分享链接]
    Share --> Viewers[团队成员实时观看]

    Chat --> Plugin{需要增强功能?}
    Plugin -->|是| Market[Plugin Marketplace]
    Market --> Install[/install:skill 名称]
    Install --> Use[使用增强后的能力]
    Plugin -->|否| Dev[继续开发]

    Dev --> Agents[claude agents]
    Use --> Agents
    Done --> Agents
    Agents --> Monitor[Agent View监控所有会话]

    Monitor --> Compact{上下文过大?}
    Compact -->|自动压缩| AutoComp[系统提示词压缩]
    Compact -->|手动压缩| ManualComp[/compact]

    AutoComp --> Continue[继续工作]
    ManualComp --> Continue

sequenceDiagram
    participant Dev as 开发者
    participant CC as Claude Code
    participant AV as Agent View
    participant PM as Plugin Marketplace
    participant Goal as /goal引擎

    Dev->>CC: claude
    activate CC
    Dev->>CC: /install:skill debug-helper
    CC->>PM: 搜索插件
    PM-->>CC: 返回插件信息
    CC-->>Dev: ✓ 插件已安装

    Dev->>CC: /goal 所有测试通过，覆盖率≥85%
    CC->>Goal: 注册目标条件
    Goal->>CC: 制定执行计划
    loop 自主迭代
        CC->>CC: 修改代码
        CC->>CC: 运行测试
        CC->>Goal: 检查目标条件
        Goal-->>CC: 未满足，继续迭代
    end
    Goal-->>CC: 目标达成！
    CC-->>Dev: ✓ Goal achieved

    Dev->>AV: claude agents
    AV-->>Dev: 显示所有会话状态
    deactivate CC

{
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": ["Bash(npm test)", "Bash(npx tsc)", "Read", "Glob", "Grep"],
    "deny": ["Bash(rm -rf *)"]
  },
  "compaction": {
    "autoCompact": true,
    "compactThreshold": 0.85,
    "preserveRecentTurns": 5,
    "strategy": "smart"
  },
  "radio": {
    "enabled": true,
    "redactPatterns": ["sk-[a-zA-Z0-9]{32,}"],
    "maxViewers": 10
  },
  "goal": {
    "maxIterations": 20,
    "requireCommitBeforeGoal": true,
    "notifyOnCompletion": true
  }
}

flowchart LR
    A[检查版本号] --> B[更新settings.json格式]
    B --> C[迁移旧Skills目录]
    C --> D[更新CLAUDE.md]
    D --> E[测试MCP连接]
    E --> F[验证插件兼容性]

    A -->|≥ 2.1.139| G[✓ 无需迁移]
    A -->|< 2.1.139| H[执行升级]
    H --> B