为什么你只用了 Claude Code 20% 的能力？
Claude Code 是目前最强大的 AI 编程助手之一。但大多数开发者安装后，只用来做基本的代码生成，然后就以为自己已经见识了它的全部。
实际上，你看到的可能只有 20%。
另外 80% 的技巧藏在文档里、社区里、或者是靠日复一日的使用摸索出来的。本文整理了 35 个经过实战验证的命令和工作流，每一个都能让你的开发效率再上一个台阶。
一、基础命令篇（01-08）
01. Plan Mode — 规划模式（Shift + Tab）
在做任何实现之前，切换到 Plan Mode。Claude Code 会分析你的代码库并创建架构计划，但不写任何代码。
先审查计划，确认没问题，再切换回实现模式。这个习惯能避免的 bug 比任何技巧都多。
02. /compact — 压缩上下文
对话 30-45 分钟后，上下文会变得臃肿。输入 /compact 将整个对话历史压缩为关键决策和当前状态的精简摘要。
Claude Code 会保持敏锐，而不是逐渐忘记之前讨论了什么。
03. /clear — 清空上下文
开始一个新任务？彻底清空上下文。把数据库重构的上下文带到前端重设计中，只会产生混乱和冲突的代码。
一个功能一个对话，永远如此。
04. /init — 初始化项目配置
在任何新项目开始时运行这个命令。Claude Code 会扫描你的代码库，生成一个 CLAUDE.md 文件——一个持久化的上下文文档，以后每次会话都会自动读取。
内容包括：项目结构、技术栈、编码模式、关键架构决策。
05. /cost — 检查花费
显示当前会话的 token 使用量。长时间会话中每小时检查一次。AI 辅助开发是花钱的，意外的账单从来都不好玩。
给自己设一个心理预算，定期对照检查。
06. /memory — 持久化指令
添加 Claude Code 在所有会话中都记住的持久指令：
- "始终使用 TypeScript 严格模式"
- "公共函数必须添加 JSDoc 注释"
- "修改 /src/core 下任何文件后都要运行测试"
这些规则在以后的所有对话中自动生效，不需要重复声明。
07. 终端集成（! 前缀）
在消息前加 ! 前缀，直接作为终端命令运行，而不是发给 Claude。快速运行测试、查看 git 状态或导航目录，都不用离开 Claude Code 界面。
# 示例：直接在Claude Code中运行终端命令
!git status
!npm test
!ls -la src/
08. 多模型切换
用 Opus 做规划和架构决策，切换到 Sonnet 做实现和执行。
- Opus 思考更深但更贵
- Sonnet 执行更快更便宜
规划用思考者，实现用执行者。
二、效率技巧篇（09-18）
09. 参考文件技巧
与其描述你想要的代码风格，不如指向一个现有文件：
"看一下 src/auth/login.ts 的认证实现方式。按照完全相同的模式实现密码重置功能。"
Claude Code 会读取参考文件并精确复制其中的模式，比口头描述产生更一致的代码。
10. 截图调试
UI 有问题？别写一段文字描述。截图它。用 Ctrl+V 粘贴。
"按钮和输入框没对齐。卡片之间的间距不一致。两个都修一下。"
视觉反馈比文字描述更快更准确。
11. 测试优先工作流
"写一个计算折扣价格的函数的测试。覆盖：正常折扣、零折扣、100%折扣、负价格、字符串输入。然后实现函数让所有测试通过。"
测试在代码存在之前就定义了行为。实现自动正确，因为它必须通过预定义的测试。
12. 增量构建
永远不要说"构建整个功能"。把它拆成步骤：
- "创建数据库 schema" → 测试
- "构建 API 端点" → 测试
- "添加验证" → 测试
- "构建前端表单" → 测试
五个小步骤，每步之间都测试，比一个巨大的实现提示产生的代码质量高得多。
13. 代码库提问
在不熟悉的代码区域实现功能之前：
"读一下 src/services/，解释数据从 API 路由到数据库的流向。用了什么模式？修改之前我应该知道什么？"
先理解后构建，防止架构级错误。
14. Diff 审查
Claude Code 做完修改后：
"展示你修改的每个文件的 diff。用一句话解释每个变更。"
这能抓住意外的修改——Claude Code 有时会"热心地"改动你没要求它动的文件。
15. 完整错误粘贴
出问题时，复制完整的错误信息和堆栈跟踪。不是摘要。完整输出。
"我得到这个错误：[粘贴完整错误]。在建议修复之前，一步一步诊断根本原因。"
"一步一步"这个约束能防止 Claude 跳到错误的修复。
16. Undo 检查点
每次重大修改之前：
git add . && git commit -m "checkpoint before [change]"
如果 Claude Code 搞坏了什么，你可以在几秒内回滚，而不是花三十分钟调试以前能正常工作的东西。
17. 并行会话
大型功能开发时，开两个终端窗口。一个跑 Claude Code 做后端实现，另一个做前端。
每个会话都有干净的、聚焦的上下文。最后把两块拼起来。
18. 文档生成
完成一个功能后：
"读一下你为这个功能创建或修改的每个文件。生成完整文档：每个函数做什么、它们怎么连接、预期的输入输出、以及任何非显而易见的设计决策。"
构建后立即生成的文档比几天后凭记忆写的准确得多。
三、架构技巧篇（19-26）
19. 架构审计
开始新项目前：
"分析我的项目需求：[列出它们]。提出 2 种不同的架构方案。每种都要有：组件图、优缺点、预估复杂度、以及可能出错的地方。推荐一种并给出清晰的推理。"
20. 依赖检查
添加新包之前：
"我想添加 [package] 来处理 [use case]。检查：是否积极维护？有无已知安全问题？包体积影响多大？有没有更轻量的替代方案？"
21. 模式执行器
在 CLAUDE.md 中添加：
"创建新文件时，遵循以下模式：API 路由遵循 src/api/example-route.ts 的结构。数据库查询使用 src/repositories/example-repo.ts 的仓库模式。React 组件遵循 src/components/ExampleComponent.tsx 的结构。"
Claude Code 会自动在每个新文件中匹配你的模式。
22. 迁移构建器
"我需要修改用户表 schema：添加 'role' 列（枚举：admin, editor, viewer，默认 viewer）并将 'name' 改名为 'display_name'。生成迁移文件，更新仓库层，更新所有引用旧 schema 的 API 路由，更新 TypeScript 类型。修改之前先展示每个需要变更的文件。"
23. API 设计审查
"审查我的 API 设计：[粘贴路由定义]。检查：不一致的命名、缺失的错误响应、需要分页的端点、受保护路由缺少认证、REST 约定违规。提出具体改进建议。"
24. 安全扫描
"扫描此代码库的安全漏洞：SQL 注入、XSS、代码或配置文件中暴露的密钥、缺少输入验证、不安全的直接对象引用、缺少速率限制。每个发现要包含：严重程度、确切位置、为什么危险、以及修复方案。"
25. 性能分析
"分析此代码库的性能问题：N+1 数据库查询、基于查询模式缺失的索引、React 组件不必要的重新渲染、可以懒加载的大体积导入、应该缓存的 API 端点。按预估影响排序。"
26. 重构规划器
"读一下 src/services/user-service.ts。这个文件已经增长到 800 行并且承担了太多职责。提出一个重构方案，将其拆分为专注的服务。展示新的文件结构、每个文件的职责、以及迁移步骤。"
四、高级工作流篇（27-35）
27. 批量文件操作
"在 src/components/ 下的所有 React 组件中，将 class 组件转换为函数组件，添加 TypeScript 类型，并更新导入语句。先展示将要修改的文件列表，确认后再执行。"
28. 环境配置模板
"分析我的项目依赖和环境变量使用情况。生成：.env.example 文件（含注释说明每个变量）、docker-compose.yml（本地开发用）、README.md 中的环境配置章节。"
29. 自动化测试套件
"为 src/utils/ 下的每个工具函数编写单元测试。使用 Jest。每个测试覆盖：正常输入、边界情况、空输入、类型错误的输入。生成完整的测试报告。"
30. 代码质量门禁
"设置 pre-commit 钩子，在每次提交前运行：ESLint（修复模式）、Prettier 格式化、TypeScript 类型检查、受影响文件的单元测试。如果任何步骤失败，阻止提交。"
31. 文档站点生成
"扫描项目中的所有公共 API 端点和 TypeScript 接口。生成 API 文档，包含：端点描述、请求/响应示例、认证要求、错误代码、速率限制信息。使用 OpenAPI 格式。"
32. 数据库优化
"分析所有数据库查询模式。识别：缺失的索引、可以合并的查询、N+1 问题、可以缓存的频繁查询。生成迁移文件添加索引，并提供查询优化建议。"
33. CI/CD 流水线
"创建 GitHub Actions 工作流：PR 时运行 lint + 测试 + 类型检查；main 分支合并时自动部署到生产环境；包含环境变量管理、密钥管理和部署回滚策略。"
34. 监控告警设置
"设计一个监控方案：应用健康检查、API 响应时间追踪、错误率告警、数据库连接池监控。推荐工具并提供配置示例。"
35. 知识库维护
"扫描项目中所有 TODO 注释、FIXME 标记和临时的 workaround 代码。生成报告：每个标记的位置、上下文、优先级建议、以及修复方案。"
总结与建议
这 35 个技巧不需要一次性全部掌握。建议按照以下优先级逐步实践：
- 第一周：掌握基础命令篇（01-08），特别是 Plan Mode 和 /compact
- 第二周：实践效率技巧（09-18），重点是增量构建和测试优先
- 第三周：尝试架构技巧（19-26），从安全扫描和性能分析开始
- 持续应用：将高级工作流融入日常开发
记住，Claude Code 的能力远超简单的代码生成。当你掌握了这些技巧，你会发现它更像是一个经验丰富的高级工程师搭档，而不是一个简单的代码补全工具。
常见问题 FAQ
Q: 这些技巧适用于哪些模型？ A: 所有技巧都适用于 Claude Code 支持的模型。不过建议规划用 Opus，实现用 Sonnet。
Q: Plan Mode 会消耗很多 token 吗？ A: 会消耗一些，但它能避免后续返工浪费更多 token。长期来看是省钱的。
Q: /memory 和 CLAUDE.md 有什么区别？ A: /memory 是全局设置，适用于所有项目。CLAUDE.md 是项目级别的，只对当前项目生效。
Q: 如何选择使用 /compact 还是 /clear？ A: 如果只是上下文太长但还在同一任务中，用 /compact。如果要开始全新的功能，用 /clear。