47条 Claude Code 使用技巧（含命令示例与工作流模板）

一口气把 Claude Code 玩明白：从“像用 CLI 一样用它”，到“把它塞进 CI 里跑无头自动化”，再到“claude.md/斜杠命令把团队工作流模板化”。下面 47 条都是能落地的招，带命令/片段，直接抄作业。

注：以下命令均以 claude 为命令行示例；如你的可执行名不同（如 cursor-cli、cc），自行替换。

一、命令行（CLI）技巧（7 条）

1. 将其视为 CLI：把 Claude Code 当成一等命令行工具用，所有 Unix 基本功都可套用。

   claude --help | sed -n '1,60p'

2. 传递启动参数：启动时直接下达任务，减少交互往返。

   claude -p "给出对 repo 的架构小结，输出成 markdown" > SUMMARY.md

3. 非交互模式运行：使用 -p/--print 输出后退出，适合脚本/CI。

   npm test 2>&1 | claude -p "基于以下测试输出，定位失败用例并给出 10 行内结论"

4. 与其他工具串联：和 bash/CLI 工具拼装工作流。

   git diff -U0 | claude -p "阅读以下补丁并生成符合 Conventional Commits 的提交信息"

5. 使用管道输入：把任意文本/日志喂进去。

   tail -n 500 logs/app.log | claude -p "定位最近 5 次报错的共同成因与修复建议"

6. 运行多实例：并行跑多个任务，互不阻塞。

   claude -p "审阅后端 PR #421" &
   claude -p "为前端 PR #422 生成可执行测试用例" &
   wait

7. 让它启动自己：在一次会话里派生新实例，拆分子任务（审查/生成/测试并行）。

   claude -p "并行开展：A 写代码，B 写测试，C 审阅；完成后各自输出到 report.md"

二、图像处理技巧（6 条）

8. 拖拽得到路径：在大多数终端中将图片文件拖入终端，会粘贴出文件路径字符串。将该路径作为上下文引用（并非直接上传图片）。

9. macOS 截图到文件：使用 Shift+Command+4 保存到文件，或用命令行生成文件。

   screencapture -i ~/Desktop/shot.png   # 交互选择区域并保存

10. 用“路径+文字描述”代替原图：向 claude 提供图像路径、问题点与预期修改，或先用 OCR/标注工具把要点转成文字再粘贴给它。

11. 从设计稿生成代码（需视觉/OCR 工具配合）：

    # 前提：你已配置 OCR/视觉 MCP 工具
    claude -p "根据设计稿 screenshots/landing-wireframe.png 的布局要点，生成 React 组件骨架（Tailwind），输出文件路径建议"

12. 视觉反馈循环（文本化）：每次迭代用截图文件路径+具体问题描述来驱动修改建议。

    screencapture -x -R 0,0,1440,900 /tmp/shot.png && \
      echo "请基于 /tmp/shot.png 的导航区，提出提高对比度与可达性的 CSS 变更（含选择器）" | claude -p

13. 自动化截图：用 Puppeteer MCP 服务器批量截图做回归视觉测试。

    # 前提：你已配置 Puppeteer MCP 服务器
    claude -p "调用已配置的 Puppeteer MCP，对 /about /pricing /blog 批量截图，比较与上次基线差异并生成报告"

三、集成与外部数据技巧（5 条）

14. 充当 MCP 服务器/客户端：它既能提供工具，也能消费外部工具。

15. 连接数据库：接 Postgres MCP，直接问表结构/写查询。

    # 前提：你已配置 Postgres MCP 服务器
    claude -p "连接 postgres://...，为过去 30 天活跃用户按地区生成留存对比，并输出 CSV"

16. 获取最新 API 文档：连 Cloudflare/自建文档 MCP，保证依据实时。

17. 抓取链接内容：一贴 URL 即抓取并纳入上下文。

    curl -s https://example.com/api#errors | claude -p "总结错误码并生成 TypeScript 枚举，输出到 src/errors.ts 的代码片段"

18. 获取外部知识：把规则/手册/规范作为即时知识注入到当前任务。

四、claude.md 配置技巧（7 条）

19. 理解核心作用：claude.md 是每次请求都会加载的“系统提示”，定义项目边界/约束/风格。

20. /init 自动生成：在项目根运行 /init，按目录结构生成首版 claude.md。

21. 用 # 动态更新：在对话里用 # 开头的指令追加到 claude.md，随做随调。

22. 全局配置：在 ~/.claude/claude.md 放团队共识（术语、代码风格、约定）。

23. 子目录覆盖：在子包/模块放专属 claude.md，覆盖局部行为。

24. 定期重构：删空话与过期约束，保留“可执行的、可验证的”规则。

25. 用提示优化工具：借助官方优化器/评估基准，迭代 claude.md 的可读性与可测性。

示例 claude.md 片段：

# 代码风格
- TypeScript 必写显式导出类型；禁止 any；函数用动词短语命名。

# PR 审查标准
- 所有变更需包含测试；覆盖到关键分支；提供风险与回滚方案。

五、自定义斜杠命令（6 条）

26. 在指定文件夹定义：在 .claude/slash_commands 下放 md/txt，即成一个命令。

27. 为 GitHub 问题创建命令：/solve_github_issue 拉取 issue 描述+复现，产出修复 PR 草案。

28. 为重构创建命令：/refactor 针对异味清单自动开分支、改、测、提 PR。

29. 为代码检查创建命令：/lint 汇总 ESLint/Prettier/TS/Stylelint 输出并自动修复可修复项。

30. 为 PR 审查创建命令：/review_pr 给出整体结论+逐行意见+打分+阻断项。

31. 向命令传参：模板里用占位符接参数，增强复用性。

示例：.claude/slash_commands/refactor.md

输入：{{path}} 可选：{{rule}}
目标：
- 对 {{path}} 下的组件进行无破坏重构，优先拆分职责与去除重复逻辑。
- 保持对外 API 不变，补足测试。
输出：
- 变更列表、理由、风险、回滚策略。

六、UI 与工作流技巧（3 条）

32. Tab 补全上下文：用 Tab 自动补全文件/目录，减少“指错对象”的概率。

33. 果断 Esc 中断：一旦跑偏立即打断，缩短无效 token 消耗。

34. 用 undo 撤销：中断后立刻要求撤销到上一步，再换策略继续。

七、工程化与自动化（13 条）

35. 指令结构化：明确“输入→约束→输出格式”，可复制到 CI 复用。

    claude -p "输入：src/**.ts；约束：遵循 Clean Code；输出：表格列[文件, 问题, 修复]" > audits.csv

36. 最小可行变更（MVP 迭代）：让它先给最小改动，再渐进增强，控制风险。

37. 强制输出格式：CSV/JSON/Markdown 三选一，便于脚本消费。

    claude -p "将测试失败总结输出为 JSON 数组，键为 file,test,error"

38. 分块处理大文件：提示里要求“按 200 行一批”，降低长文本漂移。

39. 预提交钩子集成：在 .husky/pre-commit 里无头跑检查。

    # .husky/pre-commit
    npx --yes lint-staged || true
    git diff --cached | claude -p "阅读以下暂存区补丁，进行安全/合规扫描，标出高危点"

40. CI 中的自动审阅：PR 打开即跑 /review_pr，把意见回写成评论。

41. 自动生成发布说明：从标签差异生成变更日志并润色成发布说明。

    git log v1.2.0..HEAD --pretty=format:'- %s' | claude -p "整理成人类可读的发布说明，分 breaking/feat/fix"

42. “双人”协作：一个实例产出实现，另一个只做破坏性审查，最后合并观点。

43. 规范驱动开发：把 API 合同/规则放进 claude.md，让实现与审查都以之为裁判。

44. 失败优先排障：要求先给“最可能的 3 个根因→最小实验→预期现象”，再动手。

45. 安全与隐私红线：在 claude.md 明示“不得上传密钥/PII、默认打码日志中的敏感字段”。

46. 变更可回滚：每次输出同时附“回滚步骤与影响面”，强制形成安全网。

47. 多 Claude 协作流水线：生成→自测→审阅→合并→发布各用一实例，跑完自动汇总报告。

---

附：示例工作流清单（可复制）

- [ ] 读取 PR 改动并按安全/性能/可维护性打分（阻断项需解释）
- [ ] 自动补足测试，目标分支覆盖率不降
- [ ] 生成变更日志（遵循 Conventional Commits）
- [ ] 产出回滚方案与 smoke checklist

参考

• Bilibili：https://www.bilibili.com/video/BV1HEt4ZAEqe
• Anthropic 提示工程与 Code 工作流文档（建议结合你的版本阅读）

如果你想把这套清单固化到项目里：

• 在根目录放 claude.md（团队共识）+ .claude/slash_commands（标准动作）
• 在 CI 里用 -p 或重定向保存输出为工件（审阅/安全/发布说明）