<!-- title: Claude Code 7个隐藏神技，90%用户不知道 -->
<!-- domain: tips-tricks -->

# Claude Code 7个隐藏神技，90%用户不知道

你每天都在用 Claude Code，但你知道它有一个命令可以让问题**不进入上下文窗口**吗？你知道可以同时跑多个 Claude Code 实例**并行改代码**吗？你知道 `.claude/skills/` 目录可以让你创建**自定义工作流**吗？

今天这篇，我把 Claude Code 官方文档里埋得最深、Reddit 上讨论最热的 7 个隐藏技巧全部挖出来。每个都能立刻用，用完你会发现——你之前的 Claude Code 白用了。

## 信息差概览

在深入之前，先看一张表，对比"你以为的 Claude Code"和"真正的 Claude Code"：

| 维度 | 90%用户的认知 | 高手的玩法 |
|------|-------------|-----------|
| 提问方式 | 所有问题都进上下文 | `/btw` 临时问答，不占token |
| 上下文管理 | 等自动compact | 手动 `/rewind` + 部分摘要 |
| 并行工作 | 一个终端慢慢跑 | `--bg` 后台 + 多session并行 |
| CLAUDE.md | 手写一大堆 | 用 `@path` 导入，按需加载 |
| 自定义工作流 | 每次重复输入prompt | `.claude/skills/` 创建可复用技能 |
| 模型选择 | 全程一个模型 | 快任务用 Haiku，复杂任务切 Opus |
| 脚本化 | 只能交互式使用 | `--bare -p` 管道式调用 |

## 技巧一：`/btw` — 不污染上下文的"旁白模式"

### 问题

你在改一个复杂的 bug，上下文窗口已经快满了。这时候你想快速确认一个 API 的参数顺序，如果直接问 Claude，这个问答会永久占用上下文空间，后续的推理质量下降。

### 操作步骤

```
/btw Python的datetime.strptime格式化占位符有哪些？
```

### 预期效果

Claude 会以一个**可关闭的浮层（overlay）**回答你的问题。回答**不会进入对话历史**，不消耗后续上下文空间。关掉浮层后，就像这个问题从来没发生过。

### 适用场景

- 长时间调试会话中临时查API
- 确认某个库的函数签名
- 快速查看正则表达式语法
- 任何"问完就不需要了"的一次性问题

> 这是2025-2026年新增的功能，大量Reddit用户表示"用了半年都不知道这个功能"。

## 技巧二：`/rewind` + 检查点摘要 — 精准控制上下文

### 问题

Claude Code 在上下文接近满时会自动 compact，但自动 compact 可能会丢失你关心的关键信息（比如已修改的文件列表、测试命令等）。

### 操作步骤

1. 按 **Esc + Esc** 或输入 `/rewind`
2. 选择一个历史消息作为检查点
3. 你会看到两个选项：
   - **Summarize from here**：从该点往后的内容被压缩，保留之前的完整上下文
   - **Summarize up to here**：该点之前的内容被压缩，保留之后的完整上下文

### 高级玩法

在 `CLAUDE.md` 中添加 compact 自定义指令：

```markdown
# Context Management
When compacting, always preserve:
- The full list of modified files
- Any test commands that need to be run
- The original error message being debugged
- The current branch name
```

这样即使在自动 compact 时，Claude 也会按你的规则保留关键信息。

### 适用场景

- 长时间 debug 会话（1小时以上）
- 重构多个文件的复杂任务
- 你发现 Claude 开始"忘记"之前的约定时

```mermaid
flowchart TD
    A[开始长任务] --> B{上下文是否接近满?}
    B -->|否| C[继续工作]
    B -->|是| D{哪种策略?}
    D -->|/btw| E[临时问答 不入历史]
    D -->|/rewind| F[选择检查点]
    F --> G{Summarize方向}
    G -->|From here| H[压缩后半段 保留前半段]
    G -->|Up to here| I[压缩前半段 保留后半段]
    D -->|/compact + 自定义指令| J[按规则保留关键信息]
    H --> C
    I --> C
    J --> C
    E --> C
```

## 技巧三：`.claude/skills/` — 你的私人可复用工作流库

### 问题

你每次让 Claude Code 做 code review 都要输入一长串 prompt："请检查安全性、性能、代码风格..."，重复且低效。

### 操作步骤

1. 创建技能文件：
```bash
mkdir -p .claude/skills
```

2. 在 `.claude/skills/review.md` 中写入：
```markdown
---
name: review
description: 全面代码审查工作流
---

# Code Review 工作流

按以下步骤审查代码变更：

1. 运行 `git diff HEAD~1` 获取最近一次提交的变更
2. 检查以下维度：
   - **安全性**：SQL注入、XSS、硬编码密钥
   - **性能**：N+1查询、不必要的循环、内存泄漏
   - **代码风格**：命名规范、函数长度、注释质量
3. 用表格输出结果，按严重程度排序
4. 给出具体修改建议
```

3. 使用技能：
```
/review
```

### 进阶：带参数的技能

你还可以创建带副作用的技能，设置 `disable-model-invocation: true` 来确保它只在手动触发时运行：

```markdown
---
name: fix-issue
description: 根据GitHub issue自动修复
disable-model-invocation: true
---

# Fix Issue 工作流

1. 运行 `gh issue view {{arg1}}` 获取issue详情
2. 分析问题根因
3. 实现修复
4. 运行相关测试
5. 创建PR并关联issue
```

使用：`/fix-issue 1234`

### 适用场景

- 团队共享的 code review 流程
- 标准化的部署前检查
- Issue 自动修复流程
- 任何你发现自己反复输入的 prompt

> Skills 与 CLAUDE.md 的关键区别：CLAUDE.md **每次会话都加载**，Skills **按需加载**。把只偶尔需要的知识放在 Skills 里，避免 CLAUDE.md 臃肿。

## 技巧四：`--bg` 后台模式 + 多 Session 并行

### 问题

你需要同时修改前端、后端和测试三个模块，串行改太慢。

### 操作步骤

**后台会话**：
```bash
# 启动后台任务
claude --bg "优化 src/api/ 下所有接口的错误处理"
```

**多 Session 并行**（更强大的方式）：
```bash
# 终端1：改前端
claude --session frontend "重构登录页面的表单验证"

# 终端2：改后端
claude --session backend "给所有API添加请求限流"

# 终端3：改测试
claude --session tests "为新增的接口编写单元测试"
```

**恢复会话**：
```bash
# 恢复之前的会话
claude --continue              # 继续最近的会话
claude --resume frontend       # 恢复指定名称的会话
```

**管道式调用**（纯脚本化）：
```bash
# --bare 跳过所有自动发现，启动最快
claude --bare -p "解释这个函数的作用" < src/utils/helper.ts
```

### 适用场景

- Monorepo 多模块并行开发
- CI/CD 中自动化代码审查
- 批量重构（每个文件/目录一个 session）
- 你需要"Set it and forget it"的场景

## 技巧五：CLAUDE.md 的 `@path` 导入 — 模块化配置

### 问题

你的项目有多个子模块，每个模块有自己的规范。如果把所有规范写在一个 CLAUDE.md 里，文件会变得很长，Claude 反而容易忽略重要规则。

### 操作步骤

**项目根目录的 CLAUDE.md**：
```markdown
# 项目概览

See @README.md for project overview and @package.json for available npm commands.

# Git 工作流
@docs/git-instructions.md

# API 规范
@docs/api-conventions.md

# 通用规则
- 使用 TypeScript strict mode
- 所有函数必须有返回类型注解
```

**子目录的 CLAUDE.md（自动按需加载）**：

Claude Code 支持**多层级 CLAUDE.md**：

| 位置 | 加载时机 | 用途 |
|------|---------|------|
| `~/.claude/CLAUDE.md` | 每次会话 | 个人全局偏好 |
| `./CLAUDE.md` | 每次会话 | 项目级规则 |
| 父目录 `CLAUDE.md` | 每次会话 | Monorepo共享规则 |
| 子目录 `CLAUDE.md` | 访问该目录文件时 | 模块级规则 |

### 关键洞察

官方文档明确指出：**CLAUDE.md 不是越长越好**。如果你发现 Claude 不断违反某条规则，很可能是因为文件太长，规则被"淹没"了。

> "Treat CLAUDE.md like code: review it when things go wrong, prune it regularly, and test changes by observing whether Claude's behavior actually shifts." — Claude Code 官方文档

对每一条规则问自己：**"删掉这条会导致 Claude 犯错吗？"** 如果不会，就删掉。

## 技巧六：Hooks — 确定性自动化，不受 LLM 幻觉影响

### 问题

你希望 Claude Code 每次提交代码前都自动运行 lint，但 CLAUDE.md 里的指令只是"建议性的"，Claude 有时会忘记。

### 操作步骤

Hooks 是 Claude Code 的**确定性自动化机制**。与 CLAUDE.md 的指令不同（LLM 可能忽略），Hooks **保证执行**。

在 `CLAUDE.md` 或项目设置中配置：

```json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash(git commit*)",
        "command": "npm run lint && npm run test"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write",
        "command": "npx prettier --write $FILE"
      }
    ]
  }
}
```

### Hook 触发点

| Hook 类型 | 触发时机 | 典型用途 |
|-----------|---------|---------|
| `PreToolUse` | 工具执行前 | 代码检查、权限验证 |
| `PostToolUse` | 工具执行后 | 自动格式化、通知 |
| `Notification` | Claude 通知时 | 发送到Slack/钉钉 |
| `Stop` | 会话结束时 | 生成工作摘要 |

### 适用场景

- 代码提交前强制 lint + test
- 文件保存后自动格式化
- 会话结束时自动生成 changelog
- 任何你"不希望 Claude 忘记"的步骤

## 技巧七：Subagents — 独立上下文的"分身术"

### 问题

你需要让 Claude 审查它自己写的代码。但让同一个 LLM 审查自己的输出，认知偏差不可避免——它会倾向于认为自己的代码没问题。

### 操作步骤

Claude Code 支持创建**自定义 Subagent**，每个 Subagent 运行在**独立的上下文窗口**中：

**通过命令行动态定义**：
```bash
claude --agents '{
  "reviewer": {
    "description": "Reviews code for bugs and security issues",
    "prompt": "You are a strict code reviewer. Focus on security vulnerabilities, performance issues, and code quality. Be harsh."
  }
}'
```

**通过 Skills 定义**（在 `.claude/skills/` 中）：

```markdown
---
name: security-review
description: 安全审查专用Agent
---

你是一个严格的安全审查专家。独立审查代码变更，重点关注：
- OWASP Top 10 漏洞
- 硬编码密钥和敏感信息泄露
- 不安全的依赖项
- 输入验证缺失
```

**在对话中调用**：
```
请使用 security-review agent 审查最近的代码变更
```

### 核心优势

```mermaid
flowchart LR
    A[主会话] --> B[Subagent 1: 代码实现]
    A --> C[Subagent 2: 安全审查]
    A --> D[Subagent 3: 性能分析]

    B --> E[独立上下文窗口]
    C --> F[独立上下文窗口]
    D --> G[独立上下文窗口]

    E --> H[结果返回主会话]
    F --> H
    G --> H

    style A fill:#4A90D9,color:#fff
    style B fill:#7B68EE,color:#fff
    style C fill:#FF6B6B,color:#fff
    style D fill:#FFA500,color:#fff
    style H fill:#2ECC71,color:#fff
```

每个 Subagent：
- 有**独立的上下文窗口**（不会污染主会话）
- 有**独立的工具权限**（可以限制它能做什么）
- 结果返回主会话后，Subagent 的上下文被释放

### 适用场景

- 代码审查（独立的审查者视角）
- 大型代码库调研（避免主会话上下文爆炸）
- 对抗性测试（让一个 agent 专门挑另一个的错）
- 多维度分析（安全 + 性能 + 可维护性 同时进行）

## 行动指南

按以下优先级排序，今天就能用起来：

| 优先级 | 技巧 | 耗时 | 立即收益 |
|--------|------|------|---------|
| P0 | `/btw` 临时问答 | 0分钟（直接用） | 立省30%上下文空间 |
| P0 | `/rewind` + 部分摘要 | 5分钟学习 | 长会话质量提升显著 |
| P1 | 创建第一个 Skill | 15分钟 | 消除重复prompt |
| P1 | CLAUDE.md 模块化 | 20分钟 | 规则遵循度提升 |
| P2 | 配置 Hooks | 30分钟 | 确定性自动化 |
| P2 | 配置 Subagent | 30分钟 | 代码审查质量飞跃 |
| P3 | 多 Session 并行 | 需要场景 | 大型重构效率翻倍 |

**具体第一步**：打开你当前的 Claude Code 项目，试试在对话中输入 `/btw 今天是几号`，感受一下不污染上下文的快感。

## 信息差总结

| 信息差类型 | 你不知道的 | 知道后的收益 |
|-----------|-----------|------------|
| 认知差 | `/btw` 不进上下文 | 长会话不再"变笨" |
| 方法差 | Skills 可创建可复用工作流 | 重复工作从5分钟变5秒 |
| 方法差 | Subagent 独立上下文审查 | 代码审查质量接近人类 |
| 时间差 | `--bare -p` 管道式调用 | CI/CD自动化的关键拼图 |
| 认知差 | CLAUDE.md 不是越长越好 | 规则精简 = 遵循度提升 |
| 方法差 | Hooks 确定性自动化 | LLM幻觉不再影响工作流 |
| 视角差 | 上下文窗口是最重要的资源 | 所有优化围绕它展开 |

## 参考来源

- [Claude Code Best Practices 官方文档](https://code.claude.com/docs/en/best-practices) — 所有技巧的官方出处
- [Claude Code CLI Reference](https://code.claude.com/docs/en/cli-usage) — 完整的命令行参数列表
- [Claude Code Settings 文档](https://code.claude.com/docs/en/settings) — Hooks、权限、配置详解
- [Claude Code GitHub Repository](https://github.com/anthropics/claude-code) — README 和 issue 中的社区技巧
- [Reddit r/ClaudeAI 社区](https://reddit.com/r/ClaudeAI) — 大量用户分享的实战经验

---

> 本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵**爱卫生**（微信ID: gprshome201101）维护。
> 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。

> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)
