适合人群
本文适合以下读者：
- 已经在使用 Claude Code 但只用到基础功能的开发者
- 刚接触 Claude Code、希望快速上手的 AI 编程新手
- 希望提升开发效率、减少无效 Token 消耗的程序员
- 对 AI 辅助编程感兴趣的技术爱好者
前置要求：已安装 Claude Code CLI，具备基本的终端操作和 Git 知识。
准备清单
在开始之前，请确保以下准备就绪：
- ✅ Claude Code 已安装并配置（详见 Claude Code 完整配置教程）
- ✅ 一个实际开发项目目录（建议新建练习项目）
- ✅ GitHub 或 GitLab 仓库已初始化
- ✅ Node.js / Python 等运行环境已配置（根据项目类型）
- ✅ 了解基本的 Git 命令
操作步骤
一、核心命令篇：掌握会话管理命脉（01-08）
这 8 个命令是 Claude Code 日常使用最基础也最重要的核心操作。几乎所有高级工作流都建立在它们之上。
1. 计划模式（Plan Mode）— Shift + Tab 组合键
这是本清单中最能减少 Bug 的技巧，没有之一。
在任何编码开始之前，按下 Shift + Tab 进入计划模式。在此模式下，Claude Code 只分析与规划，不会写任何代码。它会审视你的代码库，制定架构方案，然后等待你审核批准。
# 操作流程
1. 在终端打开 Claude Code
2. 描述你的需求后按 Shift + Tab
3. Claude Code 输出架构分析计划
4. 审查计划，确认正确
5. 退出计划模式（再按 Shift + Tab）
6. 开始编码实现
为什么这么做有效？ 大部分开发中的 Bug 不是写出来的，而是「想错了方向就开干」造成的。计划模式强制你在动手前先想清楚。
2. 紧凑模式 — /compact 命令
AI 对话 30-45 分钟后，上下文窗口会越来越臃肿。Claude Code 的 compact 命令会将整个对话历史压缩为一份聚焦关键决策和当前状态的摘要。
# 当你感觉 Claude Code 反应变慢或失去上下文时
/compact
使用场景：长时间调试会话中，每 30 分钟执行一次。
3. 清除上下文 — /clear 命令
开始新任务时，务必使用此命令清空整个对话上下文。不要把数据库重构的上下文带到前端界面设计中。
# 每次开始新功能前
/clear
黄金法则：一个对话只做一件事。
4. 初始化项目 — /init 命令
在新项目开始运行时执行。Claude Code 会自动扫描你的代码库，生成一份 CLAUDE.md 文件——这是一份持久化上下文文档，每次新会话都会自动读取。
# 在新项目根目录运行
cd /path/to/your/project
/init
生成的 CLAUDE.md 会包含：项目结构、技术栈、编码模式、关键架构决策等信息。可以手动编辑添加更多规则。
5. 查看成本 — /cost 命令
实时显示当前会话的 Token 使用量。建议在长会话中每小时检查一次。
/cost
# 输出示例：
# Session Cost: $0.85
# Tokens Used: 185,432
AI 辅助开发不是免费的。每个会话设定心理预算并定期检查。
6. 持久化记忆 — /memory 命令
添加跨所有会话的持久化指令。Claude Code 会记住这些规则并自动应用。
/memory add Always use strict mode in TypeScript
/memory add Add JSDoc comments to all public functions
/memory add Run tests after modifying files in /src/core
这些规则会在未来每一条对话中自动生效，无需重复说明。
7. 终端集成 — ! 前缀
在消息前加 !，可以直接执行终端命令，无需离开 Claude Code 界面。
!git status
!npm test
!ls -la src/
快速查看 Git 状态、运行测试、导航目录，都在同一个界面完成。
8. 多模型切换
Opus 用于规划和架构决策，Sonnet 用于实现和执行。Opus 思考更深但更贵，Sonnet 执行更快更省钱。
# 规划阶段：使用 Opus
claude -m opus "设计一个分布式缓存架构..."
# 实现阶段：切换到 Sonnet
claude -m sonnet "根据架构设计实现缓存层..."
用思考者做规划，用建设者做执行。
二、效率提升篇：让生产力翻倍（09-18）
9. 参考文件技术
与其用语言描述代码风格，不如直接指定一个参考文件。
# 示例提示词
"查看 src/auth/login.ts 中的认证实现方式。请按照完全相同的模式实现密码重置功能。"
Claude Code 会读取参考文件并精确复制其模式。这比口头描述产生的一致性好得多。
10. 截图调试法
UI 显示异常？不要写长篇描述。直接截图，Ctrl+V 粘贴，说：
"按钮和输入框没有对齐。卡片之间的间距不一致。修复这两个问题。"
视觉反馈比文字描述更快更准确。
11. 测试先行工作流
"为计算折扣价格的函数编写测试。覆盖：正常折扣、零折扣、100%折扣、负数价格和字符串输入。
然后用实现代码让所有测试通过。"
测试在代码之前定义行为。实现必须通过预定义的测试，因此自动正确。
12. 渐进式构建
永远不要一次说「构建整个功能」。拆分为小步骤：
"创建数据库表结构。" → 测试
"构建 API 端点。" → 测试
"添加输入验证。" → 测试
"编写前端表单。" → 测试
五步小步骤配合每步之间的测试，产出远比一个巨大提示词好得多。
13. 代码库提问法
在修改不熟悉的代码部分前，先问清楚：
"读取 src/services/ 并解释数据如何从 API 路由流向数据库。
使用了什么模式？在修改这里之前我需要知道什么？"
**
先理解再构建，防止架构性错误。
#### 14. Diff 审查法
Claude Code 完成修改后：
```bash
"显示你修改的每个文件的 diff。用一句话解释每个改动。"
这能捕捉到「顺手」改了你没要求改的文件。
15. 完整错误粘贴法
出问题时，复制完整错误消息和堆栈跟踪。
"我遇到了这个错误：[粘贴完整错误]。在提出修复方案之前，逐步诊断根因。"
"
逐步诊断约束阻止了 Claude 跳到错误的修复方案。
#### 16. 检查点提交
每次重大修改前：
```bash
git add . && git commit -m "checkpoint before [修改内容]"
如果 Claude Code 搞坏了什么，几秒钟就能回滚，而不是花 30 分钟调试原本能用的东西。
17. 并行会话
对于大型功能，开两个终端窗口。一个跑 Claude Code 处理后端，另一个处理前端。每个会话有干净的领域上下文，最后连接在一起。
18. 文档整理环节
功能完成后：
"读取你为此功能创建或修改的每个文件。生成全面文档：
每个函数的作用、它们如何连接、预期输入输出、以及任何非显而易见的设计决策。"
**
完成后立即生成的文档比数天后凭记忆写的更准确。
---
### 三、架构设计篇：写出高质量代码（19-26）
#### 19. 架构审计
新项目开始前：
```bash
"分析我的项目需求：[列出需求]。提出 2 种不同架构方案。
每种给出：组件图、优缺点、预估复杂度、可能出问题的地方。
推荐一个并提供清晰理由。"
**
用 AI 分析做架构决策，防止日后昂贵重写。
#### 20. 依赖检查
添加新包前：
```bash
"我想添加 [包名] 来处理 [用例]。检查：
这个包是否维护活跃？有已知安全问题吗？
包体积影响多大？有没有更轻量的替代方案？"
**
防止项目膨胀，避免引入不必要或有风险的依赖。
#### 21. 模式强化器
在 `CLAUDE.md` 中添加：
```markdown
创建新文件时遵循以下模式：
- API 路由遵循 src/api/example-route.ts 的结构
- 数据库查询使用 src/repositories/example-repo.ts 的仓库模式
- React 组件遵循 src/components/ExampleComponent.tsx 的结构
Claude Code 会在每个新文件中自动匹配你的模式。更多详情可参考 CLAUDE.md 配置优化指南。
22. 数据库迁移构建器
"我需要修改用户表：添加 'role' 列（枚举值：admin, editor, viewer,
默认值：viewer），将 'name' 重命名为 'display_name'。
生成迁移文件、更新仓库层、更新所有引用旧 schema 的 API 路由、
更新 TypeScript 类型。修改前列出所有需要改的文件。"
**
跨多层 Schema 修改是 Claude Code 的强项——它能追踪所有连锁影响。
#### 23. API 设计审查
```bash
"审核我的 API 设计：[粘贴路由定义]。
检查：命名一致性、缺失错误响应、应分页的端点、
缺少认证的保护路由、REST 规范违反。提出具体改进建议。"
**
#### 24. 安全扫描
```bash
"扫描此代码库的安全漏洞：SQL 注入、XSS、代码或配置文件中的密钥泄露、
缺少输入验证、不安全的直接对象引用、缺少速率限制。
每个发现需要：严重程度、精确位置、危害描述、修复方案。"
**
#### 25. 性能分析器
```bash
"分析此代码库的性能问题：N+1 数据库查询、基于查询模式的缺失索引、
React 组件不必要重渲染、可懒加载的大包导入、应缓存但未缓存的 API 端点。
按预估影响优先级排序。"
**
#### 26. 重构规划
```bash
"读取 src/services/user-service.ts。此文件已 800 行，职责过多。
提出将其拆分为聚焦模块的重构方案。展示提议的文件结构、
什么移到哪里、验证没有外部导入会出问题。
**不要开始重构**——只给我方案。"
**
---
### 四、工作流自动化篇（27-31）
#### 27. Git Hook 编写器
```bash
"创建 pre-commit hook：
- 对暂存文件运行 lint
- 运行类型检查
- 检查生产代码中是否有 console.log
- 阻止未通过检查的提交
安装到 .husky/pre-commit"
**
每次提交时自动运行的质量门控。
#### 28. CI 流水线构建器
```bash
"创建 GitHub Actions 工作流：
- 每次 PR 触发
- 安装依赖
- 运行完整测试套件
- 运行 linter
- 构建项目
- 在 PR 上发布评论显示结果
对 node_modules 使用缓存"
**
#### 29. 环境配置脚本
```bash
"创建 setup.sh 脚本：
新开发者运行一次即可配置完整开发环境：
安装依赖、从 .env.example 创建 .env、设置本地数据库、
运行迁移、填充测试数据、运行测试套件验证一切正常。"
**
#### 30. 发布说明生成器
```bash
"读取自上个标签以来的 Git 提交日志。按以下分类组织发布说明：
新功能、Bug 修复、性能改进、破坏性变更。
用非开发者的用户友好语言编写。格式化为 Markdown 变更日志。"
**
#### 31. 数据库种子构建器
```bash
"创建开发数据库的全面种子文件。包含：
5 个用户（1 个管理员、2 个编辑、2 个查看者）、
20 个带真实数据的示例项目、
实体间关系、边界情况（已归档项目、已删除用户、无成员项目）。
数据要真实，不要 'test123'。"
**
---
### 五、调试与恢复篇（32-35）
#### 32. 复现提示法
```bash
"用户报告了这个 Bug：[粘贴报告]。
创建最小化复现步骤：精确步骤、预期行为、实际行为。
然后编写一个捕获此 Bug 的失败测试。
然后修复代码让测试通过。"
**
#### 33. Git Blame 调查
```bash
"这个函数昨天开始失败。读取此文件过去一周的 Git 日志。
识别哪个提交可能引入了问题，解释发生了什么变化，然后提出修复方案。"
**
#### 34. 依赖冲突解决
```bash
"我遇到了这个依赖冲突：[粘贴错误]。
分析冲突。识别哪些包需要冲突版本的共享依赖。
提出改动最少的解决方案并解释权衡。"
**
#### 35. 恢复模式
当 Claude Code 产生了有问题的实现且来回多次都无法解决时：
```bash
"停止。读取此文件的原始工作版本：[粘贴 git show 命令输出]。
回顾我们试图实现的目标：[简洁重申目标]。
用不同方法重新开始。之前的方法显然行不通。"
**
有时候从干净状态重新开始比修复累积的错误更快。知道何时使用这个技巧。
---
### 串联起来：新项目启动流程
每个新项目按此顺序执行，只需 5 分钟：
```bash
# 1. 初始化，生成 CLAUDE.md
/init
# 2. 编辑 CLAUDE.md 添加编码标准和模式
# （参考 CLAUDE.md 配置指南）
# 3. 添加跨会话持久化规则
/memory add ...
# 4. 进入计划模式，设计架构
# Shift + Tab
# 5. 渐进式构建，逐个功能测试
这个 5 分钟设置会让后续每小时的开发体验发生质的改变。
常见问题
Q: Claude Code 价格贵吗？如何控制成本？
A: Claude Code 按 Token 计费。控制成本的关键是：
- 使用
/cost命令每 30-60 分钟检查用量 - 善用
/compact压缩长对话上下文 - 规划阶段用 Opus（深度思考），实现阶段换 Sonnet（快速执行）
- 每个对话只处理一个任务，完成后
/clear - 更多成本优化方案请参考 降低 Claude Code 成本
Q: CLAUDE.md 和 /memory 有什么区别？
A: 两者用途不同：
CLAUDE.md是项目级规则，存放在项目根目录，适用于该项目所有会话。包含技术栈、编码模式、架构决策等。/memory是全局级规则，跨项目持久化。适用于你在所有项目中的个人偏好，如「总是使用 TypeScript 严格模式」。- 建议：项目相关规则放 CLAUDE.md，个人习惯放 /memory。
Q: 如何避免 Claude Code 修改我不希望它改的文件？
A: 三个策略组合使用：
- 在 CLAUDE.md 中明确指定「不得修改的目录/文件」
- 每次修改后用 Diff 审查法（技巧#14）检查所有改动
- 修改前用
git add && git commit创建检查点（技巧#16），出问题秒级回滚 - 使用「渐进式构建」方法（技巧#12），每步只改一个模块
Q: 本文提到的是 Claude Code 终端版本还是桌面版？
A: 本文所有技巧都针对 Claude Code CLI 终端版本。Claude Code 是一个终端工具，通过命令行与 AI 协作编码。桌面版 Claude 应用（Claude Desktop 或 Claude Code 桌面客户端）的功能范围不同，建议结合使用。
参考来源
下一步建议
掌握了这 35 个技巧后，推荐继续学习：
- CLAUDE.md 配置优化指南 — 学习用 CLAUDE.md 让 Claude Code 行为更智能
- Claude Code MCP 配置教程 — 扩展 Claude Code 的 MCP 工具集成能力
- AI Agent 团队协作指南 — 从单智能体到多智能体系统
- 降低 Claude Code 成本实战 — 通过上下文工程减少 Token 消耗