返回首页

Agent 工作流

让 Claude Code 以自主 Agent 模式执行复杂任务，实现端到端的自动化开发流程。

什么是 Agent 模式？

Agent 模式允许 Claude Code 自主规划和执行多步骤任务。Claude 会分析目标、制定计划、逐步执行、自我验证，直到完成整个任务。

Agent 模式的优势

减少人工干预、提高开发效率、处理复杂任务、保持上下文连贯。适合代码重构、Bug 修复、功能开发等场景。

工作模式

交互模式

默认

每个操作都需要你的确认。适合学习和敏感操作。

完全控制每一步

学习 Claude 的思路

随时修正方向

自动确认

--dangerously-skip-permissions

自动批准所有操作，Claude 可以完全自主执行任务。

端到端自动化

适合 CI/CD 集成

需要沙箱环境保护

计划模式

Plan Mode

先制定详细计划，获得你的批准后再执行。

复杂任务分解

提前审查方案

避免返工

执行流程

理解任务

分析用户需求，理解目标和约束条件

探索代码

读取相关文件，理解项目结构和代码风格

制定计划

规划实现步骤，识别依赖和风险点

逐步执行

按计划修改代码，每步验证结果

验证完成

运行测试，确保任务目标达成

子代理系统

Claude Code 可以启动专门的子代理来处理特定类型的任务，提高效率和专业性。

Explore Agent

快速探索代码库结构，查找文件和代码模式

subagent_type: Explore

Plan Agent

设计实现方案，评估技术选型和架构决策

subagent_type: Plan

Bash Agent

执行命令行操作，git 操作和构建任务

subagent_type: Bash

General Agent

通用任务处理，研究问题和多步骤工作流

subagent_type: general-purpose

常用命令

claude 交互模式

启动标准交互式会话，每个操作需要确认

claude -p "任务描述" 单次任务

执行单次任务后退出，适合脚本调用

claude --continue 继续会话

继续上一次的会话，保持上下文

claude --resume 恢复会话

选择并恢复之前的任意会话

cat file | claude -p "分析" 管道输入

通过管道传入内容进行处理

claude --dangerously-skip-permissions 自动模式

跳过所有权限确认，需要沙箱环境

CI/CD 集成

在 GitHub Actions 等 CI/CD 环境中集成 Claude Code Agent，实现自动化代码审查、Bug 修复等。

GitHub Actions 示例

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code

      - name: Run Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p "Review this PR for bugs and improvements" \
            --dangerously-skip-permissions \
            --output-format json > review.json

      - name: Post Review Comment
        uses: actions/github-script@v7
        with:
          script: |
            const review = require('./review.json');
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: review.result
            });

安全提示

在 CI/CD 中使用 --dangerously-skip-permissions 时，务必在沙箱环境中运行。可以使用 Docker 容器或 GitHub Actions 的隔离环境来保护主机系统。

最佳实践

提供清晰的 CLAUDE.md

详细的项目说明能帮助 Agent 更好地理解上下文，减少错误和返工。

设置合理的边界

使用 .claudeignore 排除敏感文件，用 Hooks 保护关键目录。

分阶段执行大任务

将复杂任务拆分为多个小任务，每个阶段验证后再继续。

使用版本控制

在 Agent 执行前创建分支，便于回滚和代码审查。

监控执行过程

关注 Agent 的执行日志，及时发现和纠正偏离方向的行为。

保存成功的提示词

将效果好的任务描述保存为模板，复用成功经验。

常见问题

Agent 执行中卡住了怎么办？

按 Ctrl+C 中断当前操作，使用 claude --continue 继续会话并提供新的指示。

如何让 Agent 更好地理解项目？

创建详细的 CLAUDE.md 文件，包含项目结构、编码规范、常用命令等信息。

Agent 做了错误的修改怎么办？

使用 git checkout 恢复文件，或者让 Claude 帮你回滚：「请撤销刚才的修改」。

如何限制 Agent 的操作范围？

配置 Hooks 来拦截特定操作，使用 .claudeignore 排除敏感文件和目录。