Claude Code 完整使用指南

2026-02-0117 min read · 6902 字Claude Code git worktree

Claude Code 完整使用指南

来源：Boris Cherny (@bcherny) - Claude Code 团队成员分享的 10 个高效技巧

1. Git Worktree 并行开发

核心理念

同时开启多个 worktree，每个运行独立的 Claude 会话，并行工作效率翻倍。

什么是 Git Worktree？

通常一个 git 仓库只有一个工作目录。Worktree 允许你从同一个仓库创建多个工作目录，每个目录可以切换到不同的分支。

普通方式：
my-project/          ← 只能同时在一个分支工作

使用 Worktree：
my-project/                    ← 主目录，在 main 分支
my-project/.claude/worktrees/
├── feature-a/                 ← 在 feature-a 分支
├── feature-b/                 ← 在 feature-b 分支
└── bugfix/                    ← 在 bugfix 分支

为什么配合 Claude Code 很强？

传统工作流：

1	让 Claude 做任务 A → 等待完成 → 再做任务 B → 等待完成 → 再做任务 C

Worktree + Claude 并行工作流：

1
2
3

终端1: cd worktree-a && claude "实现用户登录"     ← 同时进行
终端2: cd worktree-b && claude "修复支付 bug"    ← 同时进行
终端3: cd worktree-c && claude "写单元测试"      ← 同时进行

三个独立的 Claude 会话，互不干扰，同时工作。

实际操作

# 1. 创建 worktree（基于 main 分支）
git worktree add .claude/worktrees/feature-login origin/main

# 2. 进入并启动 Claude
cd .claude/worktrees/feature-login
claude

# 3. 查看所有 worktree
git worktree list

# 4. 删除 worktree（完成后清理）
git worktree remove .claude/worktrees/feature-login

设置快捷别名

在 ~/.zshrc 添加：

1
2
3

alias za='cd ~/projects/my-app/.claude/worktrees/a && claude'
alias zb='cd ~/projects/my-app/.claude/worktrees/b && claude'
alias zc='cd ~/projects/my-app/.claude/worktrees/c && claude'

2. Plan Mode 规划模式

核心理念

把精力花在计划上，让 Claude 一次性完成实现。

什么是 Plan Mode？

Claude Code 的一种工作模式。在这个模式下，Claude 只做规划，不写代码，直到你确认计划后才开始实现。

按 Shift+Tab 可以切换模式。

为什么要用 Plan Mode？

不用 Plan Mode：

1
2
3

你：重构 cli.tsx
Claude：好的，我来改...（改了一堆）...出问题了...再改...又出问题...
结果：来回折腾，浪费时间和 token

用 Plan Mode：

你：[Plan Mode] 重构 cli.tsx
Claude：这是我的计划：
  1. 先拆分 A 模块
  2. 再抽取 B 函数
  3. 最后更新 C 接口
你：确认 / 调整计划
Claude：按计划一次性完成

团队的实战技巧

技巧 1：双 Claude 审核

Claude A (Plan Mode)  →  写计划
                ↓
Claude B              →  以 Staff Engineer 身份审核计划
                ↓
Claude A              →  执行审核后的计划

技巧 2：出问题立刻回到 Plan Mode

1	执行中发现问题 → 不要硬推 → 立刻切回 Plan Mode → 重新规划

技巧 3：验证步骤也要规划

不只是规划"怎么构建"
还要规划"怎么验证"：
- 跑哪些测试
- 检查哪些边界情况
- 如何确认功能正常

3. CLAUDE.md 记忆文件

核心理念

CLAUDE.md 是你和 Claude 的共享知识库。投入时间维护它，Claude 的表现会越来越好。

什么是 CLAUDE.md？

CLAUDE.md 是 Claude Code 的「记忆文件」。每次启动时，Claude 会自动读取这个文件，了解项目背景和你的偏好。

1 2	~/.claude/CLAUDE.md ← 全局配置，所有项目生效项目目录/CLAUDE.md ← 项目配置，仅当前项目生效

核心用法：让 Claude 自己写规则

关键技巧：每次纠正 Claude 后，说：

“更新 CLAUDE.md，确保你不再犯这个错误”

Claude 非常擅长为自己写规则。让它自己总结教训，比你手写更有效。

实战技巧

技巧 1：持续迭代

1	发现问题 → 纠正 Claude → 让它更新 CLAUDE.md → 错误率下降

技巧 2：项目笔记目录

项目/
├── CLAUDE.md              ← 指向 notes 目录
└── notes/
    ├── architecture.md    ← 架构说明
    ├── api-conventions.md ← API 规范
    └── pr-notes.md        ← 每次 PR 后更新

技巧 3：分层配置

1 2	~/.claude/CLAUDE.md → 你的通用偏好（代码风格、语言等）项目/CLAUDE.md → 项目特定规则（框架、约定等）

CLAUDE.md 示例内容

# 项目：电商后台

## 技术栈
- Next.js 14 + TypeScript
- Prisma + PostgreSQL
- TailwindCSS

## 代码规范
- 使用中文注释
- 组件用 PascalCase
- 工具函数用 camelCase
- 禁止使用 any 类型

## 常见错误（Claude 请注意）
- 不要用 moment.js，用 dayjs
- API 路由必须做权限校验
- 表单必须有 loading 状态

查看当前记忆

在 Claude Code 中输入 /memory 可以查看当前加载的记忆文件和 token 占用。

4. 自定义 Skills

核心理念

如果一件事你每天做超过一次，就把它变成 Skill。

什么是 Skills？

Skills 是 Claude Code 的自定义命令/工作流。你可以把常用操作封装成 /xxx 命令，一键执行。

1
2
3

/techdebt    → 自动查找重复代码
/sync        → 同步 Slack、GitHub 等信息
/review      → 按团队规范审查代码

Skills 存放位置

1 2	~/.claude/skills/ ← 全局 skills，所有项目可用项目/.claude/skills/ ← 项目 skills，仅当前项目可用

创建一个 Skill

示例：/techdebt 技术债务检查

创建文件 ~/.claude/skills/techdebt.md：

---
name: techdebt
description: 查找并清理技术债务
---

# 技术债务检查

请执行以下检查：

## 1. 重复代码
- 查找相似度高的代码块
- 建议抽取公共函数

## 2. 未使用代码
- 查找未使用的变量、函数、导入
- 列出可以安全删除的代码

## 3. TODO/FIXME
- 列出所有 TODO 和 FIXME 注释
- 按优先级排序

分享 Skills

把 .claude/skills/ 目录提交到 Git，团队共享：

1 2	git add .claude/skills/ git commit -m "添加团队 skills"

5. 自主修 Bug

核心理念

不要微观管理 Claude。给它目标，让它自己搞定。

方法 1：Slack MCP 集成

启用 Slack MCP 后，可以直接丢 Slack 链接给 Claude：

1 2	你：fix this https://ant.slack.com/archives/C07VBSH... Claude：（自动读取 Slack 讨论）→ 理解问题 → 定位代码 → 修复

方法 2：直接指向 CI

1 2	你：Go fix the failing CI tests Claude：（查看 CI 日志）→ 分析失败原因 → 修复代码 → 重新验证

方法 3：Docker 日志排查

1 2	你：分析这个 docker 日志，找出问题并修复 Claude：（读取日志）→ 定位错误 → 追踪到源码 → 修复

实战工作流对比

传统方式：

1. 看到 Slack 报 bug
2. 复制错误信息
3. 打开代码编辑器
4. 粘贴给 Claude
5. 解释上下文
6. 来回沟通
7. 最终修复

高效方式：

1
2
3

1. 看到 Slack 报 bug
2. 丢链接给 Claude，说 "fix"
3. 完成

关键心态

1 2	❌ "先看第 45 行，然后检查那个函数，可能是类型问题..." ✅ "fix this"

相信 Claude 的能力，给它空间自主工作。

6. 提升 Prompting 技巧

核心理念

你的 prompt 质量决定 Claude 的输出质量。

技巧 A：让 Claude 当你的审查者

1 2	你：Grill me on these changes and don't make a PR until I pass your test. （严格审查这些改动，在我通过你的测试之前不要创建 PR）

1 2	你：Prove to me this works （证明给我看这能正常工作）

技巧 B：不满意就重来

1 2	你：Knowing everything you know now, scrap this and implement the elegant solution （基于你现在掌握的所有信息，推翻这个方案，实现一个优雅的解决方案）

为什么有效：

Claude 第一次尝试时在「探索」问题
探索完成后，它对问题有了更深理解
第二次实现通常更简洁、更优雅

技巧 C：详细的 Spec 减少歧义

模糊：

1	你：添加一个登录功能

具体：

你：添加用户登录功能：
- 使用 email + 密码登录
- 密码至少 8 位，包含大小写和数字
- 登录失败显示具体错误
- 成功后跳转到 /dashboard
- 使用现有的 AuthContext

高效 Prompt 速查表

场景	Prompt
让 Claude 审查	“Grill me on this, don’t let me merge bad code”
要求证明	“Prove to me this works”
重做更好版本	“Knowing everything you know now, implement the elegant solution”
质疑方案	“What are 3 ways this could fail?”
要求简化	“This is too complex. Simplify.”

7. 终端与环境配置

核心理念

好的工具配置让你更高效。终端是你和 Claude 交互的界面，值得投入时间优化。

推荐终端：Ghostty

特性	说明
同步渲染	不会闪烁、撕裂
24-bit 真彩色	代码高亮更准确
完整 Unicode	支持各种符号和 emoji
高性能	GPU 加速，响应快

1	brew install --cask ghostty

状态栏配置：/statusline

使用 /statusline 命令自定义 Claude Code 状态栏：

Context 使用量 - 知道还剩多少上下文空间
当前 Git 分支 - 确认在正确的分支工作

语音输入：说比打字快 3 倍

快捷键：连按两次 fn 键（macOS）

优势：

说话速度是打字的 3 倍
更自然地表达复杂需求
prompt 会更详细、更清晰

完整环境配置清单

# 1. 安装 Ghostty
brew install --cask ghostty

# 2. 安装好看的字体
brew install --cask font-fira-code-nerd-font

# 3. 配置 Ghostty (~/.config/ghostty/config)
font-family = "FiraCode Nerd Font Mono"
font-size = 14

# 4. 开启语音输入
# 系统设置 → 键盘 → 听写 → 开启

8. 使用 Subagents

核心理念

Subagents 让你用多个 Claude 并行工作，同时保持主会话的上下文干净。

什么是 Subagents？

主 Claude 可以同时启动多个子代理，每个专注于不同任务：

主 Claude
    ├── Subagent 1: 探索入口文件
    ├── Subagent 2: 探索组件结构
    ├── Subagent 3: 探索工具实现
    ├── Subagent 4: 探索状态管理
    └── Subagent 5: 探索测试基础设施

技巧 A：加 “use subagents” 触发并行计算

1
2
3

你：explore the codebase, use subagents
你：分析这个项目的架构，use subagents
你：找出所有 API 端点，use subagents

技巧 B：卸载任务，保持主上下文干净

主 Claude                          Subagent
   │                                  │
   ├── "去分析 auth 模块" ──────────→ │
   │                                  ├── 读取文件
   │   （主上下文保持干净）              ├── 分析代码
   │                                  ├── 总结发现
   │ ←─────────── 返回分析结果 ────────┤
   │
   └── 基于结果制定重构方案

常用 Subagent 命令

任务	命令示例
探索代码库	`use 5 subagents to explore the codebase`
并行搜索	`search for all usages of AuthContext, use subagents`
批量分析	`analyze all API endpoints, use subagents`

快捷键

快捷键	功能
`Ctrl+O`	展开查看 subagent 详情
`Ctrl+B`	将 subagent 放到后台运行

9. 数据分析

核心理念

让 Claude 帮你写 SQL、跑查询、分析数据。你可以 6 个月不写一行 SQL。

工作方式

Claude Code 可以直接使用数据库 CLI 工具：

1
2
3

你：查一下过去 7 天的日活用户数
Claude：（自动用 bq 命令查询 BigQuery）
       结果：DAU 平均 12,450，周环比 +8%

支持任何有 CLI、MCP 或 API 的数据库：

BigQuery → bq CLI
PostgreSQL → psql
MySQL → mysql
MongoDB → mongosh

实战示例

1
2
3

你：查一下昨天注册转化率
Claude：执行 bq query "SELECT ..."
       结果：注册转化率 3.2%，比前天提升 0.5%

1
2
3

你：检查昨天有没有异常数据
Claude：（自动跑多个查询，发现异常点）
       发现：支付成功率在 14:00-15:00 下降到 85%

好处

传统方式	Claude 方式
打开数据库客户端	直接在终端问
手写 SQL	用自然语言描述
复制结果到表格分析	Claude 直接分析

10. 用 Claude 学习

核心理念

Claude 不只是工具，还是你的学习伙伴。让它解释代码、画图、帮你理解新概念。

技巧 A：开启解释模式

在 /config 中设置输出风格为 Explanatory 或 Learning：

Claude：我要修改这个函数...

       **为什么这样改：**
       原来的实现有 N+1 查询问题，每次循环都会请求数据库。
       改用批量查询可以减少 99% 的数据库调用。

技巧 B：生成 HTML 演示文稿

1	你：生成一个 HTML 演示文稿，解释这个模块的工作原理

Claude 会创建带有清晰章节、代码高亮、流程图的专业演示。

技巧 C：用 ASCII 图理解架构

1	你：画一个 ASCII 图解释这个系统的数据流

输出：

┌─────────┐    ┌─────────┐    ┌─────────┐
│  Client │───→│   API   │───→│   DB    │
└─────────┘    └────┬────┘    └─────────┘
                    │
                    ▼
              ┌─────────┐
              │  Cache  │
              └─────────┘

技巧 D：间隔重复学习

你：/learn React 的 fiber 架构

Claude：请先解释你目前对 fiber 的理解。

你：fiber 是一种新的调度算法...

Claude：基本正确，但有几点需要补充...
       问题：fiber 如何处理优先级中断？

学习场景速查

场景	命令
理解代码	“解释这个函数，假设我是新手”
学习架构	“画 ASCII 图解释这个系统”
深入原理	“为什么要这样设计？有什么替代方案？”
制作分享	“生成 HTML 演示文稿解释这个模块”

总结

#	技巧	核心要点
1	Git Worktree	多个 worktree 并行开发
2	Plan Mode	先规划再执行，一次到位
3	CLAUDE.md	让 Claude 记住你的偏好
4	Skills	封装常用工作流
5	自主修 Bug	给目标，不微观管理
6	Prompting	挑战、重做、写清 spec
7	终端配置	Ghostty + 语音输入
8	Subagents	并行计算，保持上下文干净
9	数据分析	自然语言查数据库
10	学习	解释、画图、巩固理解

最重要的一点：Claude 能力很强，给它空间自主发挥。你的时间应该花在思考和决策上，把执行交给 Claude。

Claude Code 完整使用指南

Claude Code 完整使用指南

目录

1. Git Worktree 并行开发

核心理念

什么是 Git Worktree？

为什么配合 Claude Code 很强？

实际操作

设置快捷别名

2. Plan Mode 规划模式

核心理念

什么是 Plan Mode？

为什么要用 Plan Mode？

团队的实战技巧

技巧 1：双 Claude 审核

技巧 2：出问题立刻回到 Plan Mode

技巧 3：验证步骤也要规划

3. CLAUDE.md 记忆文件

核心理念

什么是 CLAUDE.md？

核心用法：让 Claude 自己写规则

实战技巧

技巧 1：持续迭代

技巧 2：项目笔记目录

技巧 3：分层配置

CLAUDE.md 示例内容

查看当前记忆

4. 自定义 Skills

核心理念

什么是 Skills？

Skills 存放位置

创建一个 Skill

分享 Skills

5. 自主修 Bug

核心理念

方法 1：Slack MCP 集成

方法 2：直接指向 CI

方法 3：Docker 日志排查

实战工作流对比

关键心态

6. 提升 Prompting 技巧

核心理念

技巧 A：让 Claude 当你的审查者

技巧 B：不满意就重来

技巧 C：详细的 Spec 减少歧义

高效 Prompt 速查表

7. 终端与环境配置

核心理念

推荐终端：Ghostty

状态栏配置：/statusline

语音输入：说比打字快 3 倍

完整环境配置清单

8. 使用 Subagents

核心理念

什么是 Subagents？

技巧 A：加 “use subagents” 触发并行计算

技巧 B：卸载任务，保持主上下文干净

常用 Subagent 命令

快捷键

9. 数据分析

核心理念

工作方式

实战示例

好处

10. 用 Claude 学习

核心理念

技巧 A：开启解释模式

技巧 B：生成 HTML 演示文稿

技巧 C：用 ASCII 图理解架构

技巧 D：间隔重复学习

学习场景速查

总结

Tweaks×

Tweaks