Claude Code 核心操作指令

8 阅读6分钟

核心操作指令

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