Claude Code Agent Team 落地使用操作手册

# 使用 npm 安装
npm install -g @anthropic-ai/claude-code

# 或使用 yarn
yarn global add @anthropic-ai/claude-code

# 验证安装
claude --version

# 启动 Claude Code
claude

# 配置 API 密钥
claude config set apiKey sk-ant-xxxxx

# 配置默认编辑器
claude config set editor vscode

# 查看当前配置
claude config list

# 使用 Task Agent 执行代码修改任务
/Task 修复用户认证模块的内存泄漏问题

# 使用 Search Agent 查找代码
/Search 查找所有使用 JWT 认证的地方

# 使用 Review Agent 审查代码
/Review 审查最近的提交是否有安全问题

# 在项目目录中启动
claude

# 指定工作目录启动
claude /path/to/project

# 非交互模式执行单个命令
claude --command "解释这个项目的架构"

# 读取文件内容
/read src/utils/auth.js

# 读取特定行范围
/read src/utils/auth.js --lines 1-50

# 使用 SearchReplace 编辑文件
/edit src/utils/auth.js
"old_function_name()" -> "new_function_name()"

# 写入新文件
/write src/config/new-config.js
"const config = { ... }"

# 全局搜索
/grep "function authenticate"

# 使用 SearchCodebase 进行语义搜索
/search 用户登录验证逻辑

/todo
1. 分析现有认证系统
2. 识别内存泄漏点
3. 实现修复方案
4. 编写测试用例
5. 验证修复效果

/todo update 1 completed
/todo update 2 in_progress

# 步骤1：创建任务计划
/todo
1. 分析现有模块结构
2. 设计新的模块架构
3. 迁移核心功能
4. 更新单元测试
5. 验证功能完整性

# 步骤2：启动多个 Agent 并行工作
/Task 分析 src/modules/payment 目录的代码结构
/Task 查找所有依赖 payment 模块的代码
/Task 检查现有的 payment 模块测试覆盖率

# 步骤3：汇总结果并继续

# 1. 获取变更文件
/git diff --name-only HEAD~1

# 2. 启动 Review Agent 审查每个文件
/Review 审查 src/auth.js 的安全性问题
/Review 检查 src/api/routes.js 的输入验证

# 3. 汇总审查结果
/Task 汇总所有审查意见并创建修复任务

# 问题：系统性能突然下降

# Agent 1：分析日志
/Task 分析过去24小时的错误日志，找出异常模式

# Agent 2：检查代码变更
/Task 查找最近一周与性能相关的代码变更

# Agent 3：分析数据库查询
/Task 检查慢查询日志，识别性能瓶颈

# 汇总分析结果
/Task 综合以上分析结果，确定性能下降的根本原因

# 定义前端专用 Agent
/agent create frontend-expert
"专注于 React/Vue 前端开发，熟悉现代前端工程化"

# 定义后端专用 Agent
/agent create backend-expert
"专注于 Node.js/Python 后端开发，熟悉微服务架构"

# 1. 需求分析
/Task 分析需求并设计实现方案

# 2. 代码实现
/Task 实现核心功能代码

# 3. 代码审查
/Review 审查实现代码

# 4. 测试验证
/Task 编写并运行测试用例

# 1. 问题定位
/Task 复现并定位 Bug 原因

# 2. 方案设计
/Task 设计修复方案并评估影响范围

# 3. 代码修复
/Task 实现修复代码

# 4. 回归测试
/Task 验证修复并检查是否引入新问题

# .github/workflows/claude-review.yml
name: Claude Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Run Claude Code Review
        run: |
          claude --command "/Review 审查本次 PR 的代码变更"

# VS Code 扩展配置
# 安装 Claude Code 扩展后配置快捷键
{
  "key": "ctrl+shift+c",
  "command": "claude-code.open",
  "when": "editorTextFocus"
}

# 不良分解（过于笼统）
/Task 重构整个系统

# 良好分解（具体明确）
/Task 重构用户认证模块的密码验证逻辑
/Task 重构用户认证模块的会话管理逻辑
/Task 重构用户认证模块的权限检查逻辑

# 在任务描述中包含必要背景
/Task 基于刚才的分析结果，实现第3点提到的缓存优化方案

# 使用引用传递大段上下文
/Task 参考 /read src/config.js 中的配置，更新文档

# 1. 限制搜索范围
/search --path src/components 组件渲染逻辑

# 2. 使用更具体的提示
/Task 只修改 src/utils/auth.js 中的 login 函数

# 3. 分批次处理大任务
/Task 先处理前10个文件
/Task 处理后10个文件

# 1. 启用详细日志
claude --verbose

# 2. 分步执行任务
/Task 只分析问题，不要执行修复

# 3. 验证中间结果
/Task 输出当前分析进度和发现

# 4. 使用检查点
/checkpoint 保存当前状态
/restore 恢复到检查点

project/
├── .claude/              # Claude Code 配置目录
│   ├── agents/           # 自定义 Agent 定义
│   ├── templates/        # 任务模板
│   └── rules/            # 项目规则
├── src/                  # 源代码
├── docs/                 # 文档
└── README.md

# 创建项目规则文件
/write .claude/rules/project-rules.md
"""
# 项目规则

## 代码风格
- 使用 2 空格缩进
- 函数名使用 camelCase
- 类名使用 PascalCase

## 架构约定
- 业务逻辑放在 services 目录
- 数据访问放在 repositories 目录
- 控制器只处理 HTTP 相关逻辑
"""

# 阶段1：系统分析（1周）
/Search 分析整体架构和依赖关系
/Task 生成系统组件图
/Task 识别高风险模块

# 阶段2：制定计划（3天）
/Task 制定分阶段重构计划
/Review 审查重构方案可行性

# 阶段3：逐步重构（4周）
# 每周迭代
/Task 重构模块X
/Task 更新相关测试
/Review 代码审查

# 阶段4：验证上线（1周）
/Task 执行回归测试
/Task 性能对比测试

# 并行调查
/Task 分析错误日志中的异常模式
/Task 检查最近部署的变更
/Task 分析系统资源使用情况

# 快速修复
/Task 基于分析结果实现临时修复
/Review 审查修复方案安全性

# 长期解决
/Task 设计根本性解决方案
/Task 编写预防性测试

{
  "apiKey": "sk-ant-...",
  "defaultModel": "claude-3-opus-20240229",
  "editor": "vscode",
  "theme": "dark",
  "autoSave": true,
  "maxTokens": 4096
}

{
  "projectName": "my-project",
  "defaultAgents": ["frontend", "backend"],
  "ignorePatterns": ["node_modules", "dist", ".git"],
  "customRules": ".claude/rules/project-rules.md"
}