ClaudeCode通关手册（九）：检查点 + 沙箱 + GitHub Actions，自动化

/install-github-app

name: ClaudeCode
on:
issue_comment:
    types:[created]
pull_request_review_comment:
    types:[created]
issues:
    types:[opened,assigned]
pull_request:
    types:[opened,synchronize]

permissions:
contents:read
pull-requests:write
issues:write

jobs:
claude:
    if:|
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude')) ||
      github.event_name == 'pull_request'
    runs-on:ubuntu-latest
    steps:
      -uses:actions/checkout@v4
        with:
          fetch-depth:0
      -uses:anthropics/claude-code-action@v1
        with:
          anthropic_api_key:${{secrets.ANTHROPIC_API_KEY}}

# .github/workflows/claude-review.yml
name:ClaudePRReview

on:
pull_request:
    types:[opened,synchronize]

permissions:
contents:read
pull-requests:write

jobs:
review:
    runs-on:ubuntu-latest
    steps:
      -uses:actions/checkout@v4
        with:
          fetch-depth:0

      -uses:anthropics/claude-code-action@v1
        with:
          anthropic_api_key:${{secrets.ANTHROPIC_API_KEY}}
          prompt:|
            审查这个 PR 的代码变更。你是一个 Next.js 14 + TypeScript 项目的资深审查员。

            逐文件检查以下维度：
            1.TypeScript类型安全：有没有any、类型断言是否合理
            2.Next.js最佳实践：Server/ClientComponent划分是否正确、数据获取方式是否合适
            3.性能问题：有没有不必要的re-render、大列表是否有优化
            4.安全风险：有没有XSS隐患、敏感信息泄露

            对每个问题标注严重程度（🔴必须修复/🟡建议改进/🟢可选优化），
            并给出具体的修改建议和代码示例。

            最后给一个整体评分（1-10）和一句话总结。
          claude_args:"--max-turns 5 --model sonnet"

@claude 这个 API 路由有没有 SQL 注入风险？

@claude 帮我把这个 issue 描述的功能实现一下，完了提个 PR

# 加在 jobs 同级
concurrency:
  group: claude-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: true

/rewind

/checkpoints

/rewind checkpoint_a3f8d2

┌──────────────────────────────────────────────────────────┐
│          三种回退策略                                      │
├──────────────────┬───────────────────────────────────────┤
│ 策略              │ 效果                                   │
├──────────────────┼───────────────────────────────────────┤
│ 恢复代码和对话    │ 代码回退 + 对话回退                    │
│ (Restore code    │ = 彻底回到那个时间点                    │
│  and conversation)│ 适合：改错了，整个方向不对              │
├──────────────────┼───────────────────────────────────────┤
│ 恢复对话          │ 只回退对话，保留当前代码                │
│ (Restore         │ = 清理上下文但保留代码成果              │
│  conversation)   │ 适合：代码改对了，但对话太长想精简       │
├──────────────────┼───────────────────────────────────────┤
│ 从此处总结        │ 从这个点开始压缩后续对话                │
│ (Summarize       │ = 保留早期上下文，压缩后面的            │
│  from here)      │ 适合：调试跑偏了很久想回正轨            │
└──────────────────┴───────────────────────────────────────┘

检查点 = "本地撤销"
  → 秒级回退，会话级别
  → 适合快速试错和回退
  → 会话结束后逐渐消失

Git = "永久历史"
  → commit 级别的版本管理
  → 适合长期历史和协作
  → 永久保存

最佳实践：
1. 让 Claude 大胆改 → 检查点保底
2. 改好了确认没问题 → git commit 存档
3. 改错了 → Esc×2 回退，重新来

/sandbox

┌──────────────────────────────────────────────────────────┐
│          沙箱的两层隔离                                    │
├──────────────────────────────────────────────────────────┤
│                                                          │
│  文件系统隔离                                             │
│  ┌───────────────────────────────────────────┐           │
│  │ 可写入：当前工作目录及子目录              │ ← 默认    │
│  │ 可读取：整个系统（除显式拒绝的路径）      │           │
│  │ 被拦截：工作目录外的写入操作              │           │
│  └───────────────────────────────────────────┘           │
│                                                          │
│  Claude 可以读你的项目文件、修改项目代码，                │
│  但不能碰 ~/.bashrc、~/.ssh/、/usr/local/bin              │
│  或任何项目目录之外的东西。                                │
│                                                          │
│  网络隔离                                                 │
│  ┌───────────────────────────────────────────┐           │
│  │ 默认：限制网络访问到明确允许的域名        │           │
│  │ npm/yarn 等包管理器的域名自动允许          │           │
│  │ 其他出站请求需要显式配置                   │           │
│  └───────────────────────────────────────────┘           │
│                                                          │
│  技术实现：                                               │
│  macOS → Seatbelt（苹果的沙箱框架）                      │
│  Linux → bubblewrap（容器级隔离）                         │
│  这是操作系统内核级别的隔离，不是靠"信任"                  │
│                                                          │
└──────────────────────────────────────────────────────────┘

// .claude/settings.json 中的沙箱相关配置
{
  "permissions": {
    "deny": [
      "Read ~/.ssh/**",
      "Read ~/.aws/**",
      "Edit ~/.bashrc",
      "Edit ~/.zshrc"
    ]
  }
}

对 src/components/ 下的所有组件做一次全面审查：
代码质量、安全扫描、测试覆盖率检查，同时进行

启动 npm run dev，然后帮我修复首页的布局问题

┌──────────────────────────────────────────────────────────┐
│     无人值守安全策略                                       │
├──────────────────────────────────────────────────────────┤
│                                                          │
│  ✅ 必须开启                                              │
│  ├── /sandbox（OS 级隔离）                               │
│  ├── 检查点（自动存档，改错可回退）                       │
│  └── Git 分支（在新分支上操作，不碰 main）               │
│                                                          │
│  ✅ 建议配置                                              │
│  ├── PreToolUse Hook 拦截危险命令                        │
│  ├── 敏感文件保护 Hook                                   │
│  └── --max-turns 设上限（防止无限循环）                   │
│                                                          │
│  ✅ 监控方式                                              │
│  ├── Notification Hook → 桌面通知                        │
│  │   （Claude 需要你介入时提醒你）                        │
│  ├── Stop Hook → 记录日志                                │
│  │   （每次 Claude 完成任务时记录做了什么）                │
│  └── 回来后先 git diff 看看改了哪些文件                   │
│                                                          │
│  口诀：分支隔离 + 沙箱围栏 + 检查点兜底                   │
│        三道防线，安心放手                                  │
│                                                          │
└──────────────────────────────────────────────────────────┘