# 命令行技巧

本文整理了 34 条 Claude Code 实用技巧，从基础操作到高级用法，帮助你充分发挥 Claude Code 的能力。

## 基础操作

### 1. Tab 自动补全文件路径

输入 `@` 后按 `Tab` 键可以自动补全文件路径，无需记住完整路径。

### 2. 使用 @ 精确引用文件

```
> 分析 @src/utils/auth.ts 的安全性
> 对比 @v1/api.js 和 @v2/api.js 的区别
```

直接引用文件比描述文件位置更准确，AI 不会猜错。

### 3. 管道输入分析数据

```bash
git diff | claude "解释这些更改"
cat error.log | claude "分析错误原因"
npm test 2>&1 | claude "分析测试失败原因"
```

### 4. 键盘快捷键

| 快捷键 | 功能 |
|--------|------|
| `Tab` | 文件路径自动补全 |
| `Esc` | 中断当前输出 |
| `Ctrl+C` | 取消当前操作 |
| `↑` / `↓` | 浏览历史命令 |
| `Shift+Tab` (两次) | 进入规划模式 |
| `Alt+Tab` / `Option+Tab` | 切换思考模式 |

### 5. 使用 ! 快速执行命令

在提示中使用 `!` 前缀可以直接执行 shell 命令：

```
> !git status
> !npm run build
```

## 斜杠命令

### 6. /help 查看所有命令

```
> /help
```

显示所有可用的斜杠命令和快捷键。

### 7. /clear 清空对话

```
> /clear
```

开始新任务前清空上下文，避免之前对话干扰。

### 8. /compact 压缩对话历史

```
> /compact
```

当上下文过长时使用，压缩历史以节省 token，保持核心信息。

### 9. /context 查看上下文使用量

```
> /context
```

显示当前上下文使用百分比。建议在达到 60% 时考虑压缩或开始新会话。

### 10. /model 切换模型

```
> /model opus
> /model sonnet
```

- **Opus 4.7 / 4.6**：复杂任务、架构设计、疑难问题(4.7 当前旗舰)

- **Sonnet 4.6**：日常编码、快速迭代（性价比高）

### 11. /memory 编辑项目记忆

```
> /memory
```

打开 CLAUDE.md 文件进行编辑，定义项目规范和偏好。

### 12. /init 初始化项目配置

```
> /init
```

让 Claude 自动分析项目并生成 CLAUDE.md 配置文件。

### 13. /commit 智能提交

```
> /commit
```

自动分析更改、生成规范的 commit message 并提交。

### 14. /review 代码审查

```
> /review
```

对当前更改进行代码审查，检查潜在问题。

### 15. /resume 恢复会话

```
> /resume
```

恢复之前的对话会话，继续未完成的工作。

## 上下文管理

Claude Code 有约 200K token 的上下文限制。建议一个会话专注于一个任务，并使用 `/context` 监控使用量、`/compact` 压缩历史、`/clear` 开始新会话。

详细的上下文管理策略（含长会话溢出处理）→ [上下文管理](/docs/usage/context-management)

## 规划模式 (Plan Mode)

### 19. 进入规划模式

按 `Shift+Tab` 两次进入规划模式。Claude 会先分析研究，再制定实施方案，不会直接修改代码。

### 20. 先规划后执行

对于复杂任务，先让 Claude 制定计划：

```
> 先分析这个功能需求，制定实施方案，不要写代码
```

计划确认后再让它执行，减少返工。

### 21. 分步执行复杂任务

大任务拆分成小步骤：

```
> 第一步：分析现有认证系统
> 第二步：设计新的 JWT 方案
> 第三步：实现核心功能
> 第四步：添加测试
```

## 子代理 (Subagents)

### 22. 使用 Explore 代理快速搜索

Explore 代理专门用于快速搜索代码库，比手动搜索更高效：

```
> 使用 Explore 代理找到所有处理支付的代码
```

### 23. 使用 Plan 代理设计方案

Plan 代理专门用于设计实施计划：

```
> 使用 Plan 代理设计用户权限系统的实现方案
```

### 24. 后台代理并行处理

可以启动多个后台代理并行处理任务，提升效率。

## CLAUDE.md 配置

`CLAUDE.md` 是项目级配置文件，Claude 每次启动自动读取。可用 `/init` 自动生成，或手动创建。在其中定义代码规范、常用命令、项目架构等信息，省去每次重复说明。

完整配置指南与示例 → [CLAUDE.md 配置](/docs/usage/claude-md)

## Git 工作流

### 28. 智能生成 commit message

```
> /commit
```

Claude 会分析所有更改，生成符合规范的 commit message。

### 29. 创建 PR 描述

```
> 为当前分支创建 PR 描述
```

自动生成包含变更摘要和测试计划的 PR 描述。

### 30. 分析 PR 变更

```bash
gh pr diff 123 | claude "审查这个 PR"
```

## 测试与调试

### 31. 让 Claude 写测试

```
> 为 @src/services/UserService.ts 编写单元测试
```

让 Claude 自己写测试，然后通过测试来验证代码正确性。

### 32. 分析测试失败

```bash
npm test 2>&1 | claude "分析失败原因并修复"
```

### 33. 调试错误

```
> 分析这个错误：[粘贴错误信息]
> 在 @src/pages/Login.tsx 中排查问题
```

## 高级技巧

### 34. 使用截图/图片

Claude Code 支持图片理解：

```
> 查看这个截图 @screenshot.png，分析 UI 问题
```

## 效率对比

| 场景 | 传统方式 | Claude Code |
|------|----------|-------------|
| 找代码 | grep + 手动翻阅 | `@文件` 或 Explore 代理 |
| 写测试 | 手写 + 调试 | `/review` + 自动生成 |
| Git 提交 | 想 message + 手写 | `/commit` 一键完成 |
| 代码审查 | 逐行查看 | `/review` 智能分析 |
| 理解代码 | 读文档 + 读代码 | 直接问 Claude |

## 最佳实践总结

1. **明确意图**：清楚描述需求，包括约束条件

2. **善用引用**：用 `@` 指定文件，避免猜测

3. **分步执行**：复杂任务拆分成小步骤

4. **及时中断**：输出不对立即按 `Esc`

5. **保持上下文**：一个会话专注一个任务

6. **定期压缩**：上下文过长时使用 `/compact`

7. **先规划后执行**：复杂任务先制定计划

8. **让 AI 测试**：让 Claude 写测试验证自己的代码

## 下一步

- 学习 [工作流技巧](/docs/usage/workflow-tips) 掌握高效开发流程

- 了解 [上下文管理](/docs/usage/context-management) 应对长会话和 token 溢出

- 了解 [CLAUDE.md 配置](/docs/usage/claude-md) 为项目定制 Claude 行为

- 探索 [Codex 集成](/docs/ide/codex) 使用另一个 AI 工具