Claude Code 完全使用指南：50+ 实战技巧让你效率翻倍

---

一、核心认知：Claude Code 到底是什么？

Claude Code 不是聊天机器人，而是直接在你的终端里干活的 AI 程序员。它能读代码、改文件、跑命令、操作 Git，甚至在你离开座位时自主完成任务。

💡 关键区别：网页版 Claude = 你问它答；Claude Code = 你说任务，它直接动手做。

---

二、安装与快速启动

2.1 一键安装

# macOS / Linux（推荐）
curl -fsSL https://claude.ai/install.sh | sh
​
# Windows（PowerShell 管理员）
irm https://claude.ai/install.ps1 | iex

2.2 启动与退出

claude          # 启动
Ctrl+C          # 退出
/exit           # 优雅退出

---

三、基础操作技巧

3.1 文件操作：别再用传统命令了

Claude Code 内置了文件操作能力，不要手动用 cat、grep、sed：

❌ 不要这样做	✅ 正确做法
cat src/main.py	读取 src/main.py
grep -r "TODO" .	搜索所有 TODO 注释
sed -i 's/var/const/g' *.js	把所有 var 改成 const
find src -name "*.ts"	列出 src 目录下所有 .ts 文件

技巧：用 @ 直接引用文件，Claude 会直接加载到上下文，比让它自己搜索快得多 ：

> 看看 @src/auth.ts 和 @src/api/login.ts，登录接口在用户不存在时返回 500 而不是 401，修复错误处理

3.2 Bash 命令执行

> 运行 npm test（超时 5 分钟）
> 执行 pip install -r requirements.txt

注意：避免交互式命令（如 git rebase -i），Claude Code 不支持交互式输入。

3.3 终端快捷键

快捷键	功能
Shift+Tab	触发 Auto Accept Edits 模式，让 Claude 自动执行编辑
Shift+Tab+Tab	进入 Plan Mode（计划模式）
Esc+Esc	双 Escape：跳回对话早期节点，可 fork 新会话

---

四、核心工作流：Explore → Plan → Execute → Commit

这是 Anthropic 官方推荐的最佳实践框架，跳过任何一步都是在给 Bug 埋种子 。

4.1 Explore（探索阶段）

目标：让 Claude 理解项目结构，不要让它改任何东西。

> 通读项目代码，理解架构。只读不写，准备讨论你的发现

Claude 会：

• 读取 CLAUDE.md 了解项目规范

• 搜索相关文件

• 分析代码结构

• 准备方案讨论

关键技巧：探索阶段消耗的额度比执行阶段便宜，而且避免方向错误的实现开销 。

4.2 Plan（计划阶段）

目标：让 Claude 先出方案，你确认后再执行。

> /plan 重构用户认证模块，支持 OAuth 和 JWT

Plan Mode 会输出详细步骤：

1. 更新 auth 中间件验证 JWT token

2. 在 src/lib/auth.ts 创建 token 生成工具

3. 修改登录接口返回 JWT 而非设置 cookie

4. 更新所有受保护路由使用新中间件

5. 添加 token 验证和过期测试

数据支撑：使用 Plan Mode 的任务一次性成功率提升 60% 。

技巧：如果执行中发现方向不对，立即停止，重新进入 Plan Mode 调整，不要硬推错误方向。

4.3 Execute（执行阶段）

> 按刚才的计划执行

使用 Shift+Tab 开启 Auto Accept Edits，让 Claude 流畅执行，减少每次编辑都要你确认的打断。

4.4 Commit（提交阶段）

> 提交这些更改，写一个有意义的 commit message
> 生成当前分支的 PR 描述
> 审查我的 staged changes，标记任何问题

Claude 会分析 diff，结合 CLAUDE.md 中的项目规范，写出包含「改了什么」和「为什么改」的详细描述。PR 描述生成可节省 10-15 分钟/次 。

---

五、CLAUDE.md：你的项目「记忆系统」

CLAUDE.md 是 Claude Code 的第一接触点，每次会话启动时自动读取。写好它，Claude 的准确率能提升 3-5 倍 。

5.1 基础模板

# 项目规范
​
## 技术栈
- TypeScript 严格模式
- React 18 + Vite
- Tailwind CSS
- Prisma ORM + PostgreSQL
​
## 代码风格
- 组件必须使用函数式组件 + Hooks
- 禁止使用 `any` 类型
- 每个函数必须有 JSDoc 注释
- 使用 `date-fns` 替代 `moment.js`
​
## 常见错误（不要做的事）
- ❌ 不要直接修改 state，使用 setState
- ❌ API 调用必须包含错误处理
- ❌ 不要在循环中使用 async/await，使用 Promise.all
- ❌ 不要修改 `schema.prisma` 直接，使用 migration
​
## 测试要求
- 每个新功能必须包含单元测试
- 测试覆盖率不低于 80%
- 使用 Jest + React Testing Library
​
## 常用命令
npm run dev      # 启动开发服务器
npm test         # 运行测试
npm run build    # 构建生产版本

5.2 进阶技巧

技巧 1：保持精简（<200 行）

CLAUDE.md 应该只包含 Claude 不知道的业务上下文和领域知识（如你的数据模型、命名约定、内部规则）。通用知识不要写 。

技巧 2：包含明确的禁止项

最好的 CLAUDE.md 不仅列出「用什么」，还列出「绝对不要用」：

- 不要使用 default exports
- 永远不要直接修改 schema.prisma
- 不要添加 any 类型

负面约束能在错误发生前就阻止整个类别的失误 。

技巧 3：持续维护

每次 Claude 犯错时，添加一条规则：

> 把这条规则更新到 CLAUDE.md：禁止在循环中使用 async/await，应该使用 Promise.all

数据：维护 2-3 周后，Claude 的出错率会下降 70% 以上 。

技巧 4：加入 Git 管理

CLAUDE.md 是团队资产，提交到 Git：

• 团队共享最佳实践

• 新成员第一天就能高效使用

• 项目规范随代码库演进

技巧 5：兼容多 Agent

社区正在形成 AGENTS.md 标准（Copilot、Codex 都读）。最佳实践：

<!-- CLAUDE.md -->
@AGENTS.md
​
<!-- 额外的 Claude 专属配置 -->
- Claude 特定的规则...

把通用内容放在 AGENTS.md，Claude 专属内容放在 CLAUDE.md，实现跨工具复用 。

---

六、上下文管理技巧

6.1 短会话 > 长会话

这是老手们的第 1 号建议：每个任务开一个新会话。

长会话会降低输出质量。配合以下命令保持上下文干净：

命令	作用	使用场景
/clear	清空当前对话历史	切换不相关任务前
/compact	压缩对话历史，释放 token	长会话后上下文快满了
/resume	恢复之前的会话	继续之前的工作

技巧：每次新会话从 CLAUDE.md 加载项目知识，而不是从一堆历史对话的噪音中猜你要做什么 。

6.2 用 /add 预加载关键文件

复杂任务前，先用 /add 加载所有相关文件：

> /add src/auth.ts src/api/login.ts src/middleware/jwt.ts
> 现在帮我重构认证流程...

Claude 预先加载完整上下文后推理效果更好，而不是执行中途才发现文件 。

6.3 分离探索 Session 和执行 Session

# Session A（探索）：只读，讨论方案
> 只读模式，分析当前认证架构的问题，准备讨论
​
# Session B（执行）：完整权限，按方案执行
> 参考 Session A 的方案，执行重构

探索阶段更便宜，且避免方向错误的实现开销 。

---

七、并行与多会话技巧

7.1 Git Worktree 多开

同时处理多个任务时，频繁切换分支会打断 Claude 的上下文。用 Git Worktree 创建独立工作目录：

# 创建多个 worktree
git worktree add ../project-feature-a feature-a
git worktree add ../project-bugfix-b bugfix-b
git worktree add ../project-logs logs-analysis
​
# 每个目录启动独立 Claude Code 会话
cd ../project-feature-a && claude
cd ../project-bugfix-b && claude
cd ../project-logs && claude

效果：上下文切换时间减少 80%，可同时推进 3-4 个任务 。

7.2 快捷切换配置

在 .zshrc 或 .bashrc 中配置：

alias za='cd ~/projects/project-feature-a && claude'
alias zb='cd ~/projects/project-bugfix-b && claude'
alias zc='cd ~/projects/project-logs && claude'

7.3 子代理（Subagents）

复杂任务让 Claude 启动子代理并行处理：

> 重构整个 API 层，包括错误处理、日志记录和测试。use subagents

Claude 会：

1. 将任务拆分成独立模块

2. 启动多个子代理并行处理

3. 主代理整合结果

4. 保持主上下文干净

7.4 对话分支做 A/B 测试

# Worktree 分支探索方案 A
cd ../project-feature-a && claude
> 按方案 A 实现：使用 Redux 管理状态
​
# 主 Session 探索方案 B
cd ../project-main && claude
> 按方案 B 实现：使用 Zustand 管理状态
​
# 对比后合并更好的方案

---

八、Skills 技能包：把重复工作封装成命令

8.1 什么时候创建 Skill？

如果你发现自己在给 Claude 重复相同的指令超过两次，就该封装成 Skill 了 。

8.2 创建 Skill

方式一：使用 Skill Creator

1. 进入 Claude 界面，点击左侧「Customize（客制化）」

2. 开启「skill-creator」

3. 新建对话，说「帮我做技能包」

4. 回答 Claude 的问题（做什么？什么格式？输出规则？）

5. 生成 .skill 文件，点击「Copy to your skills」安装

方式二：手动创建

# .claude/skills/techdebt/SKILL.md
​
name: techdebt
description: 清理技术债务，包括重复代码、未使用的导入、TODO 注释
​
## 执行步骤
1. 扫描所有 .ts 和 .tsx 文件
2. 查找重复代码块（相似度 > 80%）
3. 移除未使用的导入
4. 列出所有 TODO 和 FIXME 注释
5. 生成技术债务报告

8.3 调用 Skill 的三种方式

方式	示例	场景
直接指令	/ig文案	最快，记住指令名
描述需求	我想写一篇防晒乳的 IG 贴文	Claude 自动侦测匹配
带参数	/写作 主题: AI SEO, 语气: 轻松	需要定制化输出

8.4 Skill 设计原则

• 窄小精悍：一个明确触发条件的窄 Skill，远好过一个大而全的泛用 Skill

• 跨项目复用：用 Git 管理 Skills 目录，在多个项目间共享

• 自动触发：给 Skill 写精确的 description，Claude 会自动判断何时调用

---

九、高级提示词技巧

9.1 四要素公式

让 Claude 给出精准回答的秘诀 ：

要素	示例
给角色	「你是一位有 10 年经验的 Python 架构师」
给格式	「请用条列式，分三个段落呈现」
给限制	「字数控制在 500 字以内，不要使用专业术语」
给背景	提供完整的上下文信息

完整示例：

> 你是一位有 8 年经验的美妆品牌社群编辑。
> 帮我写一篇推广新品防晒乳的 IG 贴文。
> 格式：第一行开场句，3-4 行产品亮点，最后 CTA + 5 个 hashtag。
> 字数 150 字以内，语气轻松有活力，目标受众 20-35 岁上班族女性。
> 不要使用「完美」、「神奇」等夸大用词。
> 产品信息：SPF50+、轻薄不泛白、添加玻尿酸、售价 $680，本周 85 折。

9.2 创意提示词

让 Claude 当考官（提交 PR 前）：

> 先考考我这些改动理解对不对，我答对了再提 PR

要求证明（关键功能）：

> 证明给我看这个认证逻辑是安全的，对比 main 分支和当前分支的差异

推翻重来（优化方案）：

> 根据你现在掌握的所有信息，推翻当前方案，给我一个更优雅的实现

苏格拉底式学习：

> 我来说说我对这个 React Hooks 的理解，你来追问我，帮我查漏补缺

9.3 使用 ! 快速执行命令

需要运行测试或类型检查时，直接打命令比让 Claude 代劳更快 ：

!npm test        # 直接运行测试
!npm run build   # 直接构建

---

十、2026 新功能深度技巧

10.1 Dynamic Workflows（动态工作流）

2026 年 5 月新增，适合大型任务 ：

/batch 把 src/ 下所有 React class 组件迁移成函数组件

AI 会在独立的 git worktree 里并行跑子任务，自动开 PR。

注意：token 消耗更高，建议先从范围明确的小任务开始。

10.2 多智能体命令速查

命令	功能	使用场景
/batch	大任务拆并行小队	批量重构、迁移代码
/agents	管理子智能体	预定义测试、安全、重构等专项 agent
/tasks	查看后台任务	监控并行/后台任务状态
/background	会话后台运行	腾出终端干别的
/loop	定时循环任务	每 5 分钟检查部署状态
/schedule	云端例行任务	每周一扫依赖、每晚安全审计

10.3 远程控制

命令	功能
/teleport (/tp)	把网页版 claude.ai 的会话拉进终端
/remote-control (/rc)	把本地会话开放给网页版远程接管

出门后用手机查看家里电脑正在跑的 Claude Code 任务进度 。

10.4 语音输入（macOS）

按两下 fn 键启用语音输入：

• 说话速度是打字的 3 倍

• 提示词会更详细（因为不用打字）

• 特别适合描述复杂需求

---

十一、MCP 与外部工具集成

11.1 什么是 MCP？

MCP（Model Context Protocol）是 Claude Code 连接外部工具的标准接口，类似手机的转接头。目前已支持 100+ 种外部服务 。

11.2 推荐 MCP 服务

MCP 服务	功能	使用场景
Context7	索引库文档精确版本	避免 Claude hallucinate 过时的 API 签名
GitHub CLI (gh)	直接操作 GitHub	开 PR、评论 Issue、读 CI 日志
Firecrawl	网页抓取与解析	抓取文档、分析网页内容
Snyk	安全扫描	检查代码安全和依赖漏洞
数据库 MCP	连接 PostgreSQL/MongoDB	用自然语言查库、改数据

11.3 数据库查询示例

> 查询最近 7 天注册用户的地域分布，生成可视化图表

Claude 会自动：

1. 编写 SQL 查询

2. 执行查询

3. 分析数据

4. 生成图表（matplotlib / D3.js）

案例：某团队创始人使用 Claude + BigQuery 技能后，半年没手写过一行 SQL 。

---

十二、成本优化技巧

12.1 模型选择策略

任务类型	推荐模型	原因
快速问答	Haiku	成本最低
标准编码	Sonnet	性价比最高
复杂架构决策	Opus	推理能力最强

12.2 额度管理命令

> /cost          # 查看当前消耗
> /compact       # 压缩对话历史，减少 token

12.3 省钱技巧

• 用 Plan Mode 先审方案，避免昂贵的错误执行

• 大任务拆成小任务，而不是一个巨大 prompt

• 定期 /compact 释放上下文

• 探索阶段用只读模式，比执行阶段便宜

---

十三、安全与最佳实践

13.1 权限管理

• 只安装信任的 MCP 服务

• 文件系统 MCP 只指向项目目录，不要指向根目录

• 删除文件、修改数据库等高风险操作前，Claude 会提示确认，务必仔细检查

13.2 安全审查

> /security      # 启动安全审查（Pro/Max 含 3 次免费配额）
> /ultrareview   # 多 agent 深度评审

注意：不要完全依赖 AI 审查，关键安全逻辑仍需人工把关 。

13.3 审计日志

用 Hooks 构建自定义审计日志 ：

{
  "hooks": {
    "PostToolUse": [{
      "type": "command",
      "command": "echo \"[$(date -u +%Y-%m-%dT%H:%M:%SZ)] $CLAUDE_TOOL_NAME: $CLAUDE_TOOL_INPUT\" >> .claude/audit.log"
    }]
  }
}

13.4 Hooks 自动化质量门禁

在 CLAUDE.md 或 Skill 中配置 PreToolUse/PostToolUse 钩子，自动跑 lint 和测试 ：

# .claude/hooks.yml
permission_request:
  handler: opus-4.5
  auto_approve: safe_operations

---

十四、持续进化你的工作流

Claude Code 每周都有新功能。每月花 30 分钟 ：

1. 看最新的 What's New

2. 跑 /powerup 发现你错过的功能

3. 更新 CLAUDE.md 里的最佳实践

4. 浏览 MCP/Skill 仓库找新工具

---

十五、快速参考：核心命令速查表

命令	功能
claude	启动 Claude Code
/plan	进入计划模式
/clear	清空对话
/compact	压缩对话历史
/resume	恢复之前会话
/add <file>	预加载文件到上下文
/cost	查看消耗
/security	安全审查
/batch	批量并行任务
/background	后台运行
/loop	定时循环
/schedule	云端定时任务
/teleport	网页版会话拉进终端
/remote-control	开放远程控制
/powerup	发现新功能
!command	直接执行 shell 命令
@file	直接引用文件

---

总结：从新手到高手的 5 个关键跃迁

阶段	做法	效果
新手	直接让 Claude 改代码	容易出错，反复修正
进阶	先 Explore 再 Plan 再 Execute	成功率提升 60%
熟练	维护 CLAUDE.md + 短会话	出错率下降 70%
高手	Git Worktree 多开 + Skills 封装	效率提升 3-5 倍
专家	MCP 集成 + 子代理 + 自动化 Hooks	形成完整 AI 开发工作流

核心心法：Claude Code 的上限，不是靠更长的 prompt 撑出来的。真正有效的做法是把它变成一个有记忆、有约束、有分工、可回退的执行环境 。

---

**