核心操作指令
Claude Code 提供了一套丰富的操作指令,让你能够高效地与 AI 协作。这些指令分为几类:Slash 命令(内置功能)、符号系统(快捷操作)、以及自然语言指令(日常开发)。
Slash 命令速查
Slash 命令是 Claude Code 的内置功能,以 / 开头。它们提供标准化的操作,如初始化项目、管理配置、查看状态等。
| 命令 | 功能 | 使用场景 |
|---|---|---|
/help | 显示所有命令 | 忘记命令时快速查看 |
/init | 初始化项目,生成 CLAUDE.md | 新项目或添加配置 |
/plan | 进入规划模式 | 复杂任务前先制定计划 |
/clear | 清除对话历史 | 上下文混乱时重新开始 |
/compact | 压缩上下文 | 长对话后节省 Token |
/commit | 创建 Git 提交 | 快速提交变更 |
/review | 审查未提交的变更 | 提交前检查代码 |
/context | 查看上下文使用 | 优化 Token 消耗 |
/cost | 查看本次会话费用 | 关注使用成本 |
/config | 打开配置面板 | 修改设置 |
/permissions | 权限管理 | 调整操作权限 |
/model | 切换 AI 模型 | 选择不同模型 |
命令组合示例:
# 完整开发工作流
/plan # 1. 制定计划
# ... 执行开发 ...
/review # 2. 审查变更
/commit # 3. 提交代码
/cost # 4. 查看成本
符号系统
符号系统是 Claude Code 的快捷操作方式,通过特殊符号快速触发特定功能。
| 符号 | 名称 | 用途 | 示例 |
|---|---|---|---|
/ | Slash 命令 | 执行内置操作 | /help, /plan |
@ | At 引用 | 引用文件/目录 | @src/app.tsx |
! | Bang 模式 | 执行终端命令 | !npm test |
& | 后台运行 | 后台执行任务 | &npm run dev |
符号组合技巧:
# 组合使用多个符号
@src/utils.ts !npm test
# 解释:读取 utils.ts,然后运行测试
@src/components/ @src/pages/ 比较这两个目录的结构
# 解释:同时引用两个目录进行对比
!git diff @src/app.tsx 解释这些变更
# 解释:查看 Git 差异,然后让 Claude 解释特定文件的变更
文件操作
文件操作是日常开发中最常用的功能。Claude Code 支持读取、编辑、创建、删除等各种文件操作。
读取文件:
# 基本读取
@src/app.tsx 解释这个文件
# 读取并分析
@src/utils/helpers.ts 找出潜在的性能问题
# 对比读取
@src/components/OldButton.tsx @src/components/NewButton.tsx 对比这两个组件的差异
编辑文件:
# 简单编辑
将 src/utils/date.ts 的 formatDate 函数改为支持中文格式
# 复杂编辑
@src/api/users.ts 重构这个文件:
1. 将重复的错误处理逻辑抽取到统一的 handleError 函数
2. 使用 async/await 替代 Promise 链
3. 添加 JSDoc 注释
# 批量编辑
将 src/components/ 下所有类组件转换为函数组件
创建文件:
# 创建单个文件
创建 src/components/UserCard.tsx,实现一个展示用户信息的卡片组件
# 创建多个相关文件
创建用户模块:
1. src/types/user.ts - 定义 User 接口
2. src/api/users.ts - 用户相关 API 调用
3. src/components/UserCard.tsx - 用户卡片组件
4. src/hooks/useUser.ts - 获取用户数据的 Hook
删除文件:
# 删除前确认
删除 src/old-component.tsx(这个组件已经不再使用)
# Claude 会询问确认,并可能建议你检查是否有其他文件引用它
Git 操作
Claude Code 深度集成了 Git,让你可以在不离开终端的情况下完成完整的版本控制工作流。
查看状态:
# 查看 Git 状态
显示 Git 状态和未提交的变更
# 查看详细变更
!git diff
解释 src/api/users.ts 的变更内容
创建提交:
# 自动提交
/commit
# 提交前审查
/review
/commit
分支操作:
# 创建功能分支
!git checkout -b feature/user-authentication
# 完成开发后
/commit
!git push -u origin feature/user-authentication
完整 Git 工作流示例:
# 1. 开始新功能
!git checkout -b feature/payment-integration
# 2. 开发功能(Claude 协助编码)
创建支付模块,包含支付宝和微信支付
# 3. 运行测试
!npm test
# 4. 审查变更
/review
# 5. 提交代码
/commit
# 6. 推送到远程
!git push -u origin feature/payment-integration
# 7. 创建 PR(可选,配合 GitHub CLI)
!gh pr create --title "feat: add payment integration" --body "支持支付宝和微信支付"
代码操作
代码操作是 Claude Code 的核心能力,包括生成、解释、重构、优化等。
生成代码:
# 生成组件
创建一个 React Hook 管理用户认证状态,包含登录、登出、权限检查功能
# 生成工具函数
创建一个日期格式化工具函数,支持相对时间(如"2小时前")
# 生成完整模块
创建订单模块,包含:
- 订单列表页面
- 订单详情页面
- 创建订单 API
- 订单状态管理
解释代码:
# 逐行解释
逐行解释 src/algorithms/quicksort.ts
# 高层次解释
@src/services/payment.ts 解释这个模块的架构设计
# 解释复杂逻辑
解释 src/utils/dataTransformer.ts 中的 reduce 操作在做什么
重构代码:
# 架构重构
将 src/components/ 的类组件转换为函数组件
# 性能重构
优化 src/App.tsx 的渲染性能,减少不必要的重渲染
# 代码清理
@src/utils/helpers.ts 重构这个文件:
1. 删除未使用的函数
2. 将重复逻辑抽取为通用函数
3. 添加类型定义
4. 优化函数命名
调试代码:
# 分析错误
运行 npm test 失败了,分析错误原因并修复
# 性能分析
@src/components/DataTable.tsx 这个组件渲染很慢,找出性能瓶颈
# 日志分析
!cat logs/error.log
分析这些错误日志,找出根本原因
测试操作
测试是保证代码质量的重要手段。Claude Code 可以协助你生成测试、运行测试、分析测试结果。
生成测试:
# 生成单元测试
为 src/utils/math.ts 生成单元测试,覆盖所有边界情况
# 生成组件测试
为 src/components/UserForm.tsx 生成 React Testing Library 测试
# 生成集成测试
创建用户注册流程的集成测试,覆盖从表单提交到数据库写入的完整流程
运行和调试测试:
# 运行测试
!npm test
# 调试失败测试
分析测试失败原因并修复
@tests/auth.test.ts
# 查看测试覆盖率
!npm run test:coverage
哪些代码没有被测试覆盖?
测试策略建议:
# 为新功能添加测试
我添加了用户认证功能,请:
1. 为 auth.service.ts 生成单元测试
2. 为 LoginForm 组件生成组件测试
3. 运行所有测试确保通过
指令组合与链式操作
高效的 Claude Code 使用方式是将多个指令组合起来,形成完整的工作流。
场景 1:Bug 修复工作流
# 1. 查看问题
!npm test
测试报错了,分析一下
# 2. 定位问题
@src/utils/validation.ts 问题出在这个文件吗?
# 3. 修复问题
修复 validation.ts 中的 isEmail 函数,使其正确处理包含 + 的邮箱地址
# 4. 验证修复
!npm test
# 5. 提交修复
/commit
场景 2:代码审查工作流
# 1. 查看变更
!git diff --stat
有哪些文件被修改了?
# 2. 详细审查
@src/components/ 审查这些组件的变更
# 3. 提出改进建议
基于审查结果,有哪些可以改进的地方?
# 4. 实施改进
优化 UserList 组件的性能
# 5. 最终审查
/review
场景 3:新功能开发工作流
# 1. 制定计划
/plan
我要添加购物车功能
# 2. 创建分支
!git checkout -b feature/shopping-cart
# 3. 开发功能
按照计划逐步实现
# 4. 添加测试
为购物车模块生成测试
# 5. 运行测试
!npm test
# 6. 代码审查
/review
# 7. 提交代码
/commit
!git push