阅读原文：Claude Code 快速上手核心指南

一、本章核心学习目标

• 理解 Claude Code 的核心定位，掌握它和传统编码工具的差异
• 掌握基础快捷键和操作技巧，比如双击 Esc 回退、@引用文件、! 执行命令
• 学会用内置命令（/plan、/init、/compact 等）提升开发效率
• 了解进阶的规则目录配置，实现模块化的项目规范管理
• 掌握 Claude Code 的完整工作流，从任务规划到代码提交的全流程

---

二、什么是 Claude Code？

Claude Code 是 Anthropic 官方出品的 AI 原生编码工具，它将大型语言模型的能力直接集成到终端中，让你可以用自然语言与 AI 协作完成编程任务。

不同于传统的代码补全工具，Claude Code 能够理解整个项目的上下文，执行复杂的开发任务，从代码生成到重构、从调试到文档编写，它都能胜任。

---

三、核心操作技巧

3.1 快捷键：双击 Esc 快速回退

这是 Claude Code 中最常用、最重要的快捷键，用来快速撤销误操作：

• 按一次 Esc：清除当前正在输入的内容（类似 Ctrl+C）
• 按两次 Esc：回退到上一次对话状态（撤销上一轮对话）
• 按三次 Esc：清除所有对话历史（重新开始）

使用场景：

• 不小心发了错误指令，快速回退
• AI 的回复不符合预期，重新组织语言提问
• 对话轮次太多上下文混乱，清空重来

⚠️ 重要注意：双击 Esc 回退的是对话状态，不是代码修改。如果 Claude 已经修改了你的文件，这些修改不会被自动撤销，需要手动用 git 恢复。建议修改前先提交代码。

3.2 @ 引用文件：精准指定上下文

Claude Code 虽然能自动读取项目文件，但显式引用文件能让 AI 更准确，也能节省 Token：

基本用法：

• 单个文件：@src/utils.ts 解释这个文件
• 多文件对比：@src/app.tsx @src/components/Header.tsx 这两个文件的关系是什么？
• 目录引用：@src/components/ 总结一下这个目录下的所有组件
• 特定行：@src/utils.ts:45-60 解释这段代码的作用

使用技巧：

• Tab 补全：输入 @ 后按 Tab，会显示文件列表
• 支持相对路径：@./config.json 或 @../shared/types.ts
• 模糊匹配：输入部分文件名就能匹配

3.3 ! 执行命令：终端集成

Claude Code 内置了终端命令执行能力，无需切换终端窗口：

基本用法：

!npm test           # 运行测试
!git status         # 查看 Git 状态
!ls -la             # 列出文件

应用场景：

• 运行测试后，让 AI 分析失败原因并修复
• 查看 git diff，让 AI 总结变更内容
• 构建项目，报错后让 AI 自动修复

⚠️ 安全提示：敏感命令（如 rm -rf、sudo）Claude 会询问确认，请注意验证。

---

四、内置命令：效率倍增器

4.1 /plan：先规划后编码

对于复杂任务，先规划再编码效率更高：

使用方式：

/plan
我想添加用户认证功能，请帮我制定实施计划

Claude 会：

1. 分析需求

2. 评估项目现状

3. 制定分阶段的实施计划

4. 与你确认方案

最佳实践：超过 30 分钟的任务，先用 /plan 拆分，逐阶段执行。

4.2 /init：自动初始化项目

自动扫描项目，生成 CLAUDE.md配置文件，告诉 AI 你的项目信息：

它会自动识别：

• 技术栈（框架、语言、样式工具）

• 常用命令

• 代码规范

生成的 CLAUDE.md就是 Claude 的「项目记忆」，每次启动都会自动读取，不用每次都解释项目用什么框架。

4.3 /compact：压缩上下文

长对话会消耗大量 Token，/compact 会压缩对话历史，提取关键信息：

什么时候用：

• 对话进行了 5-6 轮后

• 感觉 AI 开始遗忘之前的内容

• 要切换子任务，但想保留背景

4.4 /commit：自动 Git 提交

自动分析代码变更，生成符合 Conventional Commits 规范的提交信息：

它会：

1. 查看 git diff

2. 分析变更内容

3. 生成规范的提交信息

4. 执行 git commit

进阶用法：

# 自动提交不询问
/commit --yes
# 只生成信息不执行
/commit --dry-run

4.5 其他实用命令

命令	作用
/context	查看上下文 Token 使用情况，优化成本
/resume	恢复之前的会话，多任务切换
Shift+Tab	开启自动接受模式，不用每次确认修改
Ctrl+C	紧急取消当前正在执行的操作

---

五、进阶：规则目录（Rules）

对于大型项目，单个CLAUDE.md 太臃肿，可以用规则目录做模块化管理：

5.1 目录结构

.claude/
├── settings.json          # 主配置
├── CLAUDE.md              # 项目概述
└── rules/                 # 规则目录
    ├── 00-security.md     # 安全规则
    ├── 01-coding-style.md # 编码风格
    ├── 10-api.md          # API 开发规范
    ├── 11-frontend.md     # 前端开发规范
    └── 20-testing.md      # 测试规范

5.2 规则文件格式

规则文件支持 frontmatter 控制适用范围：

---
# 指定适用的文件路径
globs:
- "src/api/**/*.ts"
- "src/services/**/*.ts"
# 指定适用的命令
commands:
- "generate api"
- "create endpoint"
# 优先级
priority: 10
---

# API 开发规范
## 路由设计
- RESTful 风格，使用名词复数
- 版本控制：/api/v1/users

5.3 规则继承

• 全局规则适用于所有文件

• 特定路径规则只匹配对应文件

• 优先级高的规则可以覆盖低优先级的

---

本章总结

Claude Code 把 AI 编码能力直接带到了终端，让你用自然语言就能完成复杂的开发任务：

1. 基础操作：掌握双击 Esc、@引用、! 执行这些核心操作，就能大幅提升效率

2. 内置命令：用 /plan 规划任务、/init 初始化项目、/commit 自动提交，把繁琐工作交给 AI

3. 上下文管理：用 /compact 压缩对话、/context 查看消耗，优化 Token 成本

4. 项目规范：通过规则目录，实现模块化的项目规范，让团队协作更高效

掌握了这些，你就能把 Claude Code 从一个简单的聊天工具，变成你的专属 AI 编程合伙人，开发效率提升一个档次。