一位每日使用者整理的35个Claude Code实用技巧,涵盖规划模式、多模型切换等超越基础用法的进阶方法。
AI translation, not an official translation. Refer to the original for technical details.
Adapted from @eng_khairallah1# 35个大多数用户不知道的Claude Code命令、技巧与工作流——完整清单 我每天使用Claude Code已经好几个月了。以下这35种技巧让它感觉像是作弊神器。 收藏备用 :) 大多数开发者安装了Claude Code,用它做一些基础的代码生成,便以为已经见识过它的全部能力。 他们顶多看到了20%。 另外那80%——那些能让Claude Code从"有用的助手"变成"我有史以来生产力最高状态"的技巧——深埋在文档里,需要通过实验去发现,或者在小圈子里口耳相传。 我整理了所有真正对我产生影响的技巧。每天实测。零理论。 收藏这篇文章。每次打开终端时你都会用到它。 # 核心命令(01 至 08) 01. 规划模式(Shift + Tab) 在任何实现之前,切换到规划模式。Claude Code会分析你的代码库并创建一份架构计划,而不会编写任何代码。审查计划,批准后再切换回实现模式。这个单一习惯能比本清单上任何其他技巧都更有效地预防bug。 02. 压缩(/compact) 经过30到45分钟的对话后,上下文会变得臃肿。输入/compact可将整个对话历史压缩为一份聚焦于关键决策和当前状态的摘要。Claude Code会保持敏锐,而不是逐渐忘记你们讨论的内容。 03. 清除(/clear) 要开始新任务了?彻底清空状态。把数据库重构的上下文带入前端重设计,只会产生混乱、相互矛盾的代码。每个功能对应一段对话。始终如此。 04. 初始化(/init) 在任何新项目开始时运行此命令。Claude Code会扫描你的代码库并生成一个CLAUDE.md文件——这是一份持久化的上下文文档,它会在每次未来的会话中自动读取。内容包括项目结构、技术栈、编码规范和关键架构决策。(http://claude.md/) 05. 费用查询(/cost) 显示当前会话的token用量。在长时间会话中每小时检查一次。AI辅助开发是要花钱的,意外账单从来都不好受。为每次会话设定一个心理预算,并对照检查。 06. 记忆(/memory) 添加Claude Code在所有会话中都会记住的持久化指令。例如:"始终使用TypeScript严格模式。""始终为公共函数添加JSDoc注释。""修改/src/core中任何文件后始终运行测试。"这些规则会在每次未来的对话中自动生效,无需重复说明。 07. 终端集成(! 前缀) 在任何消息前加上!前缀,即可将其作为终端命令执行,而不是发送给Claude。这是在不离开Claude Code界面的情况下运行测试、检查git状态或浏览目录的快捷方式。 08. 多模型切换 用Opus进行规划和架构决策,切换到Sonnet进行实现和执行。Opus思考更深入但成本更高;Sonnet执行更快且更便宜。用思考者来规划,用执行者来构建。 # 生产力技巧(09 至 18) 09. 参考文件技巧 与其描述你想要的代码风格,不如直接指向一个现有文件:"看看src/auth/login.ts中认证是如何实现的。按照完全相同的模式实现密码重置。"Claude Code会读取参考文件并精确复制其模式。产出的代码比口头描述要一致得多。 10. 截图调试 UI出现问题?不要写一段文字描述。截图。用Ctrl+V粘贴。然后说:"按钮与输入框未对齐。卡片之间的间距不一致。请修复这两处问题。"视觉反馈比文字描述更快、更准确。 **11. 测试优先工作流** "为一个计算折扣价格的函数编写测试。覆盖以下情况:正常折扣、零折扣、100%折扣、负数价格以及字符串输入。然后实现该函数以通过所有测试。"测试在代码存在之前就定义了行为。实现结果自动是正确的,因为它必须通过预先定义的测试。 **12. 增量构建法** 永远不要说"构建整个功能"。将其拆分为步骤:"创建数据库结构。"测试。"构建API端点。"测试。"添加验证。"测试。"构建前端表单。"测试。五个小步骤、每步之间进行测试,所产生的代码质量,远比一次性完成的庞大实现提示要好得多。 **13. 代码库探查法** 在对不熟悉的代码库部分进行任何实现之前:"阅读src/services/目录,解释数据如何从API路由流向数据库。使用了哪些模式?在修改这里之前我需要了解什么?"先理解再构建,可以避免架构层面的错误。 **14. 差异审查法** 在Claude Code完成修改后:"向我展示你修改的每个文件的差异对比。用一句话解释每处改动。"这能发现无意间的修改——Claude Code有时会"好心"地修改你并未要求它触碰的文件。 **15. 错误粘贴法** 当出现问题时,复制完整的错误信息和堆栈跟踪。不是摘要,而是完整输出。"我遇到了这个错误:[粘贴完整错误信息]。在提出修复建议之前,请逐步诊断根本原因。"逐步分析的约束防止Claude跳到错误的修复方案。 **16. 撤销检查点法** 在每次重大修改之前执行:git add . && git commit -m "checkpoint before [change]"。如果Claude Code破坏了某些功能,你可以在几秒内回滚,而不是花三十分钟调试原本正常运行的内容。 **17. 并行会话法** 对于大型功能,打开两个终端窗口。一个运行Claude Code处理后端实现,另一个运行Claude Code处理前端。每个会话在其领域内拥有简洁、专注的上下文。最后再将各部分连接起来。 **18. 文档生成法** 在完成一个功能后:"阅读你为此功能创建或修改的每个文件。生成全面的文档:每个函数的作用、它们之间的连接方式、预期的输入和输出,以及任何不明显的设计决策。"在构建完成后立即生成的文档,比数天后凭记忆编写的文档更加准确。 # 架构技巧(第19至26条) **19. 架构审查法** 在启动新项目之前:"分析我的项目需求:[列出需求]。提出2种不同的架构方案。对于每种方案:组件图、优点、缺点、预估复杂度,以及可能出现的问题。并给出有明确理由的推荐方案。"借助AI分析做出架构决策,可以避免后续代价高昂的重构。 **20. 依赖检查法** 在添加任何新依赖包之前:"我想添加[package]来处理[用例]。请检查:它是否仍在积极维护?是否存在已知的安全问题?对包体积的影响有多大?是否有更轻量的替代方案能满足我的具体需求?"防止用不必要或存在风险的依赖项使项目臃肿。 21. 模式执行者 在你的 CLAUDE.md 中添加:"创建新文件时,请遵循以下模式:API 路由遵循 src/api/example-route.ts 中的结构。数据库查询使用 src/repositories/example-repo.ts 中的仓库模式。React 组件遵循 src/components/ExampleComponent.tsx 中的结构。" Claude Code 读取此内容后,会在每个新文件中自动匹配你的模式。(http://claude.md/) 22. 迁移构建者 "我需要更改用户表 schema:添加一个 'role' 列(枚举值:admin、editor、viewer,默认值:viewer),并将 'name' 重命名为 'display_name'。生成迁移文件,更新仓库层,更新所有引用旧 schema 的 API 路由,并更新 TypeScript 类型。在做任何修改之前,先向我展示每一个需要更改的文件。" 涉及多个层级的 schema 变更正是 Claude Code 的强项——它能追踪所有连锁影响。 23. API 设计评审 "评审我的 API 设计:[粘贴路由定义]。检查以下内容:命名不一致、缺少错误响应、应该分页的端点、受保护路由缺少身份验证,以及任何违反 REST 规范的情况。提出具体的改进建议。" 24. 安全扫描 "扫描此代码库中的安全漏洞:SQL 注入、XSS、代码或配置文件中暴露的密钥、缺少输入验证、不安全的直接对象引用,以及缺少速率限制。对于每个发现:严重程度、确切位置、为何危险,以及修复方案。" 25. 性能分析器 "分析此代码库中的性能问题:N+1 数据库查询、基于查询模式缺失的索引、React 组件中不必要的重新渲染、可以懒加载的大型包导入,以及应该缓存的 API 端点。按预估影响程度排列优先级。" 26. 重构规划者 "阅读 src/services/user-service.ts。这个文件已增长到 800 行,承担了过多职责。提出一个将其拆分为专注模块的重构计划。展示建议的文件结构、各部分的移动目标,并验证不会破坏任何外部导入。请勿开始重构——只需向我展示计划。" # 工作流自动化(第 27 至 31 条) 27. Git 钩子编写者 "创建一个 pre-commit 钩子,功能包括:对暂存文件运行 linter、运行类型检查、检查生产代码中的 console.log 语句,并阻止任何未通过检查的提交。将其安装到 .husky/pre-commit。" 自动化质量门禁,在每次提交时运行。 28. CI 流水线构建者 "创建一个 GitHub Actions 工作流,功能包括:在每个 PR 上运行、安装依赖、运行完整测试套件、运行 linter、构建项目,并在 PR 上发布包含结果的评论。为 node_modules 使用缓存。" 29. 环境配置脚本 "创建一个 setup.sh 脚本,供新开发人员运行一次即可完成整个开发环境的搭建:安装依赖、从 .env.example 创建 .env、搭建本地数据库、运行迁移、填充测试数据,并通过运行测试套件验证一切正常。" (http://setup.sh/) 30. 发布说明生成器 "读取自上次标签以来的 git 日志。生成按以下类别组织的发布说明:新功能、错误修复、性能改进和破坏性变更。用用户友好的语言撰写每条记录,而非开发者术语。格式化为 markdown 变更日志条目。" 31. 数据库种子构建者 "为开发数据库创建一个全面的种子文件。包含:5个用户(1个管理员、2个编辑者、2个查看者)、20个包含真实数据的示例项目、实体之间的关联关系,以及边界情况(已归档的项目、已删除的用户、没有成员的项目)。数据要真实,不要用'test123'这类内容。" # 调试与恢复(第32至35条) 32. 问题复现提示词 "用户报告了这个Bug:[粘贴Bug报告]。请创建一个最小复现方案:包括精确的操作步骤、预期行为和实际行为。然后编写一个能捕获此Bug的失败测试用例,再修复代码使测试通过。" 33. 责任追溯调查器 "这个函数从昨天开始出现异常。请读取该文件过去一周的git日志,找出最可能引入问题的提交并解释发生了哪些变更,然后给出修复建议。" 34. 依赖冲突解决器 "我遇到了这个依赖冲突:[粘贴报错信息]。请分析冲突,找出哪些包对共享依赖项要求了相互冲突的版本,并建议一个改动最少的解决方案,同时说明其中的权衡取舍。" 35. 恢复模式 当Claude Code产出了有问题的实现,而你已经来回折腾太久时,使用这个提示词:"停下来。从git中读取该文件最初可用的版本:[粘贴git show命令的输出]。现在看看我们一直想实现的目标:[用简单的语言重新描述目标]。用一种不同的思路从头开始。之前的方案显然行不通。" 有时候,从干净的状态重新开始比修复层层叠加的错误更快。要懂得何时该用这一招。 # 将一切串联起来的初始设置 开启一个新项目时,按以下顺序执行: 1. /init —— 生成CLAUDE.md文件(http://claude.md/) 1. 将你的编码规范和模式添加到CLAUDE.md中(http://claude.md/) 1. /memory —— 添加你希望在每次会话中都生效的持久化规则 1. 规划模式 —— 在编写任何代码之前先完成架构设计 1. 增量构建 —— 每次只开发一个功能,并在每个步骤完成后进行测试 这五分钟的初始设置,能让后续每一小时的开发效率都大幅提升。 # 内容摘要 35个技巧,经过日常实测,每一条都解决了真实的开发问题。 会话管理的核心命令、加速构建的效率技巧、优化设计的架构方法、保障质量的工作流自动化,以及应对问题时的调试与恢复手段。 Claude Code是目前最强大的开发工具,这35个技巧能充分释放它的全部潜力。 整理这份内容耗费了数月的每日实践。如果它为你节省了时间,你懂的。 关注我 @eng_khairallah1,获取更多开发者工具、工作流和实用技巧。没有废话,只分享真正有用的内容。 希望这对你有帮助,Khairallah ❤️