Claude Code 使用技巧大全(进阶篇)

CalcGuide ≈ 18 分钟阅读 · 6.4k 字

本文汇总了 50+ 个 Claude Code 进阶技巧,涵盖 Prompt 工程、工具调用、多 Agent 协作、自定义 Skill 等高阶用法。

一、Prompt 工程进阶

1. 结构化 Prompt 模板

# Prompt 结构模板
## 背景
[项目上下文和约束]

## 目标
[要达成的具体结果]

## 约束
- [限制条件1]
- [限制条件2]

## 输出格式
[期望的输出格式]

## 示例
[输入] → [期望输出]

2. 链式思维 Prompt

claude -p "分三步解决这个问题:
Step 1:分析问题,理解输入输出
Step 2:设计解决方案
Step 3:实现并验证
问题:[你的问题]"

3. Few-shot Prompt

claude -p "按照以下示例格式生成代码:
示例输入:['a', 'b', 'a', 'c']
示例输出:{'a': 2, 'b': 1, 'c': 1}
任务:统计 ['x', 'y', 'x', 'x', 'z'] 中每个元素的出现次数"

二、工具调用进阶

1. 管道式工具调用

claude -p "找出最近修改的5个测试文件,并运行测试" \
  --allowedTools "Glob,Bash"

2. 条件执行

claude -p "检查 /src/auth.py 是否存在,存在则审查其安全性" \
  --allowedTools "Read,Glob"

3. 批量操作

claude -p "将所有 /src/**/*.ts 文件转换为使用 TypeScript strict 模式" \
  --allowedTools "Read,Write,Glob"

三、多 Agent 协作

Agent 链模式

// 创建专业化 Agent
const agents = {
  reviewer: {
    prompt: "你是一个代码审查专家,专注于发现安全漏洞",
    tools: ["Read", "Grep"]
  },
  implementer: {
    prompt: "你是一个后端开发专家,擅长 Go 语言",
    tools: ["Read", "Edit", "Bash"]
  },
  tester: {
    prompt: "你是一个测试专家,专注于边界条件和错误处理",
    tools: ["Read", "Write", "Bash"]
  }
};

协作执行

# Agent 1: 审查
claude -p "审查 /src/auth 模块,输出问题清单" --allowedTools "Read,Grep" > review.md

# Agent 2: 实现
claude -p "根据 review.md 中的问题列表,修复 /src/auth 模块" --allowedTools "Read,Edit,Bash"

# Agent 3: 测试
claude -p "为修复的问题编写测试用例,覆盖边界条件" --allowedTools "Read,Write,Bash"

四、自定义 Skill 进阶

1. 带工具的 Skill

// ~/.claude/skills/go-expert.skill.js
module.exports = {
  name: "Go Expert",
  description: "专业 Go 语言开发助手",
  instructions: `
    你是一个 Go 语言专家。
    - 优先使用 error wrapping
    - 使用 context.Context 处理超时
    - 单元测试使用 testify
    - 遵循 Uber Go 编码规范
  `,
  tools: ["Read", "Edit", "Write", "Bash", "Glob"],
  // 触发关键词
  triggers: ["go", "golang", "Go语言", "grpc", "protobuf"],
  // 优先级
  priority: 10,
  // 条件触发
  conditions: {
    filePatterns: ["*.go", "go.mod", "go.sum"],
    minContextLength: 1000
  }
};

2. 场景化 Skill

// ~/.claude/skills/refactor.skill.js
module.exports = {
  name: "Refactor Expert",
  description: "代码重构专家",
  instructions: `
    重构时遵循以下原则:
    1. 保持 API 兼容性
    2. 每次重构不超过 50 行变更
    3. 重构后必须运行测试
    4. 使用 git commit 保存检查点
    5. 优先提取函数,再简化逻辑
  `,
  tools: ["Read", "Edit", "Bash", "Glob"],
  hooks: {
    beforeEdit: ({ filePath }) => {
      if (filePath.includes('test')) {
        return "测试文件修改,确认后执行";
      }
      return "";
    }
  }
};

五、Hook 机制

1. 自动上下文注入

// ~/.claude/hooks/context-inject.js
module.exports = {
  // 每次读取文件后触发
  afterRead: ({ content, filePath }) => {
    if (filePath.endsWith('.env')) {
      return "注意:这是一个环境配置文件,包含敏感信息,请勿输出其内容。";
    }
    return "";
  }
};

2. 自动提交

// ~/.claude/hooks/auto-commit.js
module.exports = {
  afterEdit: ({ filePath, editType }) => {
    if (editType === 'major') {
      return `
        建议提交变更:
        git add ${filePath}
        git commit -m "update: ${filePath}"
      `;
    }
    return "";
  }
};

3. 安全警告

// ~/.claude/hooks/security-warn.js
module.exports = {
  beforeBash: ({ command }) => {
    const dangerous = ['rm -rf /', 'drop database', ':(){:|:&};:'];
    for (const cmd of dangerous) {
      if (command.includes(cmd)) {
        return `⚠️ 危险命令检测:${cmd},是否继续?`;
      }
    }
    return "";
  }
};

六、CLAUDE.md 进阶用法

1. 动态内容

<!-- 使用 Git 动态注入信息 -->
# 最近变更
<!-- {{git log -1 --oneline}} -->

# 当前分支
<!-- {{git branch --show-current}} -->

# 未解决的问题
<!-- {{grep -r "TODO" src/ | wc -l}} -->

2. 条件配置

# 项目配置

<!-- IF project_type = "api" -->
## API 规范
- RESTful 风格
- 错误码规范:1000-9999
<!-- ENDIF -->

<!-- IF project_type = "cli" -->
## CLI 规范
- 使用 cobra 框架
- 支持 --help 和 -h
<!-- ENDIF -->

3. 团队协作

# 团队 CLAUDE.md

## 团队成员
- @张三:后端 Lead
- @李四:前端 Lead
- @王五:DevOps

## 代码 Owner
- /backend → @张三
- /frontend → @李四
- /infra → @王五

## 合并规范
- 所有 PR 需要至少 2 人 review
- 敏感路径修改需要 @张三 确认

七、性能优化

1. 增量处理大文件

# 分块处理大文件
claude -p "处理大型日志文件 /var/log/app.log:
1. 先分析文件大小和行数
2. 提取最近 1000 行的错误信息
3. 统计错误类型分布
4. 生成摘要报告"

2. 智能缓存

# 使用 Glob 避免重复读取
claude -p "处理所有 /src/components/*.tsx:
1. 先列出所有文件
2. 然后批量处理
使用 Glob 模式减少重复读取"

3. 流式输出

# 使用流式模式(如果可用)
claude -p "生成代码" --stream

八、调试技巧

1. 分步调试

claude -p "分步执行:
Step 1:读取并理解 auth.py
Step 2:找出登录逻辑
Step 3:标记潜在问题
Step 4:生成修复建议
暂停在每一步,等待确认后再继续"

2. 调试输出分析

claude -p "分析以下调试输出,找出根本原因:
[粘贴调试输出]
请:
1. 识别错误类型
2. 定位错误位置
3. 分析调用栈
4. 给出修复方案"

3. 回归测试生成

claude -p "为以下修复生成回归测试:
修复内容:[描述修复]
原有测试:[列表]
要求:
1. 确保修复有效
2. 确保不引入新问题
3. 覆盖边界条件"

九、集成技巧

1. Git 集成

# 自动生成 Commit Message
claude -p "根据 git diff 生成符合 Conventional Commits 规范的提交信息" \
  --allowedTools "Bash"

# Code Review
claude -p "审查 git diff 中的变更,关注代码质量和潜在问题" \
  --allowedTools "Bash,Read"

2. Docker 集成

# 开发容器中使用
docker exec -it my-container claude -p "运行测试"

# Dockerfile 分析
claude -p "分析 Dockerfile 优化点,减少镜像大小" \
  --allowedTools "Read"

3. CI/CD 集成

# GitHub Actions 中使用
claude -p "运行测试并生成报告" --allowedTools "Bash"

十、50+ 技巧速查表

类别技巧效果
Prompt使用结构化模板提升准确性
PromptFew-shot 示例减少误解
工具Glob 限制范围提升速度
工具管道式调用减少上下文
Skill场景化配置精准触发
Hook自动提交防止丢失
Hook安全警告防止破坏
协作多 Agent 链复杂任务分解
性能分块处理支持大文件
调试分步执行精确控制

Claude Code 的高阶用法在于根据具体场景灵活组合这些技巧,而非机械地使用单一功能。

相关外部链接

资源链接说明
Claude Code Skill 文档https://docs.anthropic.com/zh-CN/claude-code/skills自定义 Skill 编写指南
Claude Code Hookshttps://docs.anthropic.com/zh-CN/claude-code/hooksHook 机制详解
Claude Code 配置https://docs.anthropic.com/zh-CN/claude-code/configurationsettings.json 配置说明
Anthropic API 文档https://docs.anthropic.com/zh-CN/api/referenceAPI 参考文档
Claude Code GitHubhttps://github.com/anthropics/claude-code开源项目和社区

相关阅读