Claude Code 常用命令及作用

本文档详细整理了 Claude Code 中所有可用的命令、语法和功能，帮助你快速查找和使用。

---

目录

1. 斜杠命令 (Slash Commands)
2. 文件引用语法
3. 内置工具命令
4. Agent 相关命令
5. Git 相关命令
6. 快捷操作
7. 命令速查表

---

斜杠命令 (Slash Commands)

斜杠命令以 / 开头，用于执行特定功能。

基础命令

命令	作用	示例
/help	显示帮助信息	/help
/clear	清除当前对话历史	/clear
/cost	查看本次会话的 API 费用估算	/cost
/exit	退出 Claude Code	/exit

模式切换

命令	作用	说明
/fast	切换快速模式	使用 Claude Haiku 模型，响应更快
/enter-plan-mode	进入计划模式	复杂任务先规划再执行

Git 相关

命令	作用	示例
/commit	智能生成并提交 git commit	/commit 或 /commit -m "提交信息"
/review-pr	审查 Pull Request	/review-pr 123

其他技能

命令	作用	说明
/simplify	代码简化检查	审查代码质量、复用性
/model	切换模型	选择不同 Claude 模型

---

文件引用语法

@ 符号引用

使用 @ 符号快速引用文件，支持自动补全。

@文件名              # 引用当前目录下的文件
@path/to/file.js    # 引用指定路径的文件
@文件名:行号         # 引用文件特定行
@文件名:10-20       # 引用文件的行号范围

示例：

请修改 @src/utils/helper.js 中的配置
解释 @main.py:45 这行的作用
检查 @App.vue:10-50 的代码逻辑

多文件引用

可以同时引用多个文件：

请对比 @config.dev.js 和 @config.prod.js 的差异
检查 @User.java 和 @UserService.java 的关联

---

内置工具命令

Claude Code 提供了多种内置工具，可以直接通过自然语言调用。

文件操作工具

Read - 读取文件

读取 @config.json
显示 @README.md 的内容
读取 @data.csv 从第 10 行开始

Edit - 编辑文件

将 @file.js 中的 "var" 替换为 "let"
在 @main.py 第 20 行后面添加打印语句
修改 @config.yaml 中的端口号为 8080

Write - 写入文件

创建一个新文件 config.json，内容为 {...}
在 src/ 目录下创建 utils.js 并写入工具函数

搜索工具

Glob - 文件匹配查找

找出所有 .test.js 文件
列出 src/components 下的所有 .vue 文件
查找 config.*.json 文件

Grep - 内容搜索

搜索所有使用了 axios 的地方
查找包含 "TODO" 的注释
找出所有调用 getUser 的代码行

Grep 高级用法：

搜索 pattern -i             # 忽略大小写
搜索 pattern -C 3          # 显示前后 3 行上下文
搜索 pattern --type js     # 只在 .js 文件中搜索

系统命令

Bash - 执行命令

运行 npm install
执行 git status
查看当前目录下的文件列表

注意： 优先使用专用工具（Glob/Grep/Read/Edit）代替 Bash。

---

Agent 相关命令

启动 Agent

可以直接要求 Claude 启动 Agent 执行特定任务：

启动一个 Agent 来检查所有的 API 路由
请用 Agent 并行处理：
1. 检查数据库模型
2. 检查控制器代码
3. 生成测试用例

Agent 类型

类型	用途	示例
Explore	代码库探索	用 Explore Agent 了解项目结构
Plan	方案设计	用 Plan Agent 设计实现方案
test-runner	运行测试	启动 test-runner Agent 运行所有测试
claude-code-guide	获取 Claude Code 帮助	用 claude-code-guide 了解功能

后台运行

可以让 Agent 在后台运行：

在后台启动 Agent 来生成项目文档
运行一个后台任务分析代码复杂度

---

Git 相关命令

基础操作

显示当前的 git 状态
查看最近的提交历史
对比 HEAD 和上一个 commit 的差异

分支操作

创建一个新分支 feature/login
切换到 main 分支
合并 feature/user 到当前分支

PR 操作

为这个功能创建一个 PR
查看 PR #123 的详细信息
审查 PR 456 并给出意见

Commit 操作

提交当前修改，信息为 "修复登录 bug"
生成有意义的 commit 信息并提交
将修改追加到上一次 commit

---

快捷操作

键盘快捷键

快捷键	作用
Ctrl+C	中断当前操作
Ctrl+D	退出 Claude Code
Tab	自动补全文件名/命令
↑ / ↓	浏览历史命令
Ctrl+L	清屏

图片输入

直接粘贴图片（支持截图、设计稿等）：

根据这个设计图实现对应样式 [粘贴图片]
分析这张错误截图 [粘贴图片]

长文件处理

对于大文件，可以指定偏移量读取：

读取 @large-file.js 从第 500 行开始
显示 @data.log 第 100-150 行

---

命令速查表

按场景分类

探索代码库

命令	说明
列出项目结构	查看目录和文件组织
找出所有组件	使用 Glob 查找
搜索所有 API 调用	使用 Grep 搜索

代码编辑

命令	说明
修改 @file:10	编辑特定行
将函数 A 重命名为 B	批量替换
添加注释到 @file:20-30	行范围编辑

调试排查

命令	说明
解释这段代码的作用	代码解释
找出潜在的 bug	代码审查
运行测试	执行测试用例

项目管理

命令	说明
/commit	提交代码
/review-pr	审查 PR
生成项目文档	文档生成

常用组合

# 日常开发流程
1. claude                          # 启动
2. 查看当前 git 状态                # 了解工作区状态
3. @file.js                        # 编辑文件
4. 运行测试                         # 验证修改
5. /commit                          # 提交

# 代码审查流程
1. /review-pr 123                   # 审查 PR
2. 根据意见修改代码                  # 编辑文件
3. 运行测试验证                     # 测试
4. /commit -m "修复审查意见"         # 提交

# 新功能开发流程
1. /enter-plan-mode                 # 计划模式
2. 设计实现方案                     # 获得确认
3. 实现代码                         # 编辑文件
4. 添加测试                         # 测试文件
5. /commit                          # 提交

---

最佳实践

1. 优先使用专用工具：用 Glob/Grep 代替 Bash 的文件查找
2. 精准引用：使用 @ 符号明确指定文件
3. 复杂任务先规划：使用 /enter-plan-mode
4. 定期压缩对话：使用 /compact 减少 token 消耗
5. 善用 Tab 补全：快速输入文件名和命令

---

参考资源

• Claude Code 官方文档
• GitHub Issues
• 使用 /help 查看内置帮助