跳转到内容
Claude Code Tutorial

技巧集 Tips

技巧集 Tips

Section titled “技巧集 Tips”

把散落在 best-practice 仓库、社区帖子、日常踩坑里的技巧拣出来，浓缩成 87 条。每条两个动作：一句话要点 + 一句说明。能查、能抄、能贴墙上。

社区技巧来源已在文末标注。

提示技巧

Section titled “提示技巧”

  1. 给文件名、签名、示例三要素：生成代码时说清「放哪、叫什么、输入输出长啥样」，Claude 才不会跑偏。

  2. 用 @ 引用文件而非粘贴：@src/api.ts 比把内容贴进来省 token，也避免版本错乱。

  3. 限定「不改逻辑」：让 Claude 加注释、改格式时，显式说「不要改逻辑」，否则它可能顺手重构。

  4. 拆小任务：一次让它做一件事。让它「重构+加测试+写文档」往往三件都做不好。

  5. 给失败案例：让它修 bug 时，附上「输入 X 时报错 Y」的具体复现，比描述症状更准。

  6. 让它先复述理解：复杂任务先问「你打算怎么分几步做」，确认再开工。

  7. 明确输出格式：要表格就说表格，要 JSON 就给 schema，否则它会自由发挥。

  8. 用否定边界：除了说「做什么」，还要说「不做什么」——「只改 src/api，不要动 src/utils」。

  9. 保留原始风格：让它补代码时加一句「沿用现有命名和缩进风格」，输出更贴项目。

  10. 善用 plan 模式先看方案：按 Shift+Tab 切到 Plan 模式，先审方案再执行，省得跑偏后回滚。

上下文管理

Section titled “上下文管理”

  1. 45% 红线：上下文用到 45% 左右注意力开始衰退，接近就 /compact 或开新会话。

  2. /clear 比 /compact 更彻底：换任务时直接 /clear 清空历史，比压缩更干净，也最省 token。

  3. /compact 带聚焦点：/compact 保留 auth 模块的改动意图 能定向压缩，丢掉无关细节。

  4. 用子代理隔离重活：摸代码、读大文件这种「读一堆留很少」的活，委托给 Explore 子代理。

  5. 大文件读片段：用 @file 时 Claude 会读相关片段，不必担心整文件进上下文。

  6. 日志文件用 @ 喂：报错排查时 @logs/error.log 比贴日志文本更省 token。

  7. CLAUDE.md 别写太长：它每次全量进上下文，写长了费钱。把规则放成 Skill。

  8. 会话开始先 /init：让 Claude 扫一遍项目生成 CLAUDE.md，比你手写更全。

  9. 用 /cost 看用量：随时查 token 消耗，心里有数。

  10. 任务结束及时收尾：干完一摊活就 /clear 或开新会话，别让无关上下文堆积。

会话管理

Section titled “会话管理”

  1. claude -c 续上次：刚关掉的会话用 -c 接着聊，省得重述背景。

  2. claude -r 恢复任意会话：按名字或 ID 恢复历史会话，适合跨天的大任务。

  3. 给会话起名字：/name auth-refactor 之后能 -r auth-refactor 直接唤回。

  4. /rewind 是安全绳：跑偏了用 /rewind 回退对话和代码改动，回到干净的检查点。

  5. 检查点自动建：每次工具调用前 Claude 自动建检查点，/rewind 能回到任意一个。

  6. 长任务分段保存：复杂任务每完成一阶段就 /compact 一次，固化进展。

  7. headless 跑批处理：脚本化任务用 claude -p，跑完即退，不留会话。

  8. 并行开多会话：不同任务各开一个终端，互不污染上下文。

  9. /status 看全局：查版本、模型、账号状态，排错第一步。

  10. 会话导出留档：重要会话用 claude -p ... > out.md 把结果存下来。

命令与快捷键

Section titled “命令与快捷键”

  1. Shift+Tab 切权限模式：在默认 / auto-accept / Plan 模式间循环切换。

  2. Esc 打断：跑偏时按 Esc 立即停下，比等它跑完再回滚省事。

  3. Esc Esc 回退：连按两次 Esc 触发 /rewind，回退到上一检查点。

  4. @ 引用一切：文件、目录、URL、git commit、PR 都能用 @ 喂进去。

  5. # 快速记 memory：输入 # 项目用 pnpm 不用 npm 直接写入 CLAUDE.md。

  6. / 唤出命令面板：模糊搜索所有命令，忘了名字也能找。

  7. !! 复用上一条：在输入框开头敲 !! 引用上一条消息。

  8. 拖文件进窗口：直接把文件拖到终端窗口，自动转成 @path。

  9. Ctrl+R 反向搜索历史：找之前输过的长 prompt。

  10. /vim 进 vim 模式：长 prompt 用 vim 编辑，移动更顺手。

工作流

Section titled “工作流”

  1. Plan First 原则：动手前先让 Claude 出方案，审过再执行，避免返工。

  2. 9 步循环：探索→规划→实现→测试→审查→提交，每步有检查点。

  3. 小步提交：每完成一个独立改动就 commit，配合 /rewind 容易回退。

  4. 跑测试再提交：让 Claude 在 commit 前自动跑 npm test，挂了就别提交。

  5. 写完就审：实现完用 code-reviewer 子代理审一遍，比自查更狠。

  6. 探索用 Explore 彻底档：陌生代码库先跑一遍 very thorough，省得后面反复试错。

  7. 改造串行、审查并行：执行类任务串行保依赖，检查类任务并行加速。

  8. 大重构先开 worktree：git worktree 隔离改动，主分支随时能用。

  9. 文档和代码同改：改了 API 就让它同步改文档，别攒着。

  10. 结束做 ultrareview：交付前跑一遍超级审查，捕捉遗漏。

安全

Section titled “安全”

  1. 最小权限：permissions.deny 把生产配置、密钥文件锁死，Claude 碰不到。

  2. 沙箱里跑未验证代码：/sandbox 或 devcontainer 隔离，避免误删文件。

  3. 审查类只给读权限：子代理 tools: Read, Grep, Glob，审查员不该能改代码。

  4. exit 2 阻止危险：Hook 里非零退出码能拦下工具调用，比事后回滚强。

  5. 别把密钥写进 CLAUDE.md：它进上下文会被记进对话历史，用环境变量。

成本

Section titled “成本”

  1. /model 切模型：日常用 sonnet，难题切 opus，省钱又快。

  2. /clear 是最省钱的操作：清空历史比压缩更彻底，token 立刻归零。

  3. headless 模式省交互：脚本任务用 -p，不进交互，省往返 token。

  4. Skills 按需加载：把规则写成 Skill 而非塞 CLAUDE.md，平时只占 ~100 token。

  5. /compact 而非续聊：长会话别硬撑，及时压缩比重开更省上下文。

自动化

Section titled “自动化”

  1. claude -p 入 CI：在 GitHub Actions 里跑审查、生成 changelog，无人值守。

  2. 管道哲学：git diff | claude -p "审查" 把 Claude 当 Unix 工具接进流水线。

  3. 结构化输出：--output-format json 让结果机器可读，便于下游处理。

  4. --resume 接管会话：CI 里用 session-id 续跑，跨步骤共享上下文。

  5. Hooks 自动化：保存后自动格式化、提交前自动 lint，规则硬编码不靠记忆。

  6. 定时任务：用 cron 或 GitHub Actions 定时跑 Claude 做巡检。

  7. Agent SDK 编排：复杂流水线用 SDK 写多代理，比手敲命令更可控。

  8. .mcp.json 共享配置：团队 MCP 配置进 git，人人一致。

  9. /agents 管理子代理：交互式增删子代理，比手改文件直观。

  10. gh pr diff | claude：把 PR diff 喂给 Claude 自动审查，PR 一开就跑。

团队协作

Section titled “团队协作”

  1. .claude/ 进 git：commands、settings、agents、skills 全提交，团队共享规范。

  2. settings.local.json 不进 git：个人偏好放本地，默认在 .gitignore。

  3. CLAUDE.md 写团队约定：命名、依赖、测试命令这些「每次都要提醒」的规矩写进去。

  4. managed-settings.json 推企业策略：IT 锁定权限边界，员工改不了。

  5. code-review Skill 团队共用：审查标准固化成技能，新人也按老规矩审。

调试

Section titled “调试”

  1. 先给报错全文：让 Claude 修 bug，把完整 traceback 贴进去，别只给一句「报错了」。

  2. 让它复现再修：先让 Claude 跑一次复现，确认能稳定触发，再动手修。

  3. 最小复现案例：让 Claude 把问题压到最小可复现的 snippet，根因更清楚。

  4. 二分定位：不确定哪改坏的，让 Claude 用 git log 二分查找引入提交。

  5. /debug 技能：系统化调试，按「复现→隔离→假设→验证→修复」走。

  6. 读日志用 headless：claude -p "分析 logs/app.log 里 ERROR" 批量过日志。

  7. 隔离变量：怀疑某段是元凶，让 Claude 临时注释掉看是否复现。

  8. 看 git blame：让 Claude 结合 git blame 理解某行为为什么这么写。

  9. /cost 看是否超量：调试跑久了 token 会爆，定期看用量。

  10. 修完加回归测试：bug 修完立刻让 Claude 补一个会失败的测试，防止复发。

综合速记

Section titled “综合速记”

  1. 能用 Skill 别塞 CLAUDE.md：场景化能力写 Skill，常驻规矩才进 CLAUDE.md。

  2. 先 Command 验证再沉淀 Skill：流程没跑通别急着做技能，先用命令跑顺。

来源：本集综合 best-practice 仓库（shanraisshan，社区整理）、社区 27 条精选、50 条日常技巧，以及官方 docs.claude.com 的 best-practices 页。具体命令以官方文档为准。要查完整示例看 代码示例库，要解疑看 FAQ 大全。🚀