Claude Code 基础命令与操作

概述

Claude Code 提供了丰富的命令系统，让你能够高效地完成各种开发任务。本教程将介绍最常用的基础命令和操作。

三类前缀触发器

Claude Code 提供了三种强大的前缀触发器，让你能以不同方式与系统交互：

前缀	名称	用途	示例
`/`	Slash 命令	执行 Claude Code 内置功能	`/help` 查看帮助 `/plan` 进入规划模式 `/model` 切换模型 `/clear` 清除对话
`@`	文件引用	精准定位文件、目录或代码符号	`@src/App.tsx` 引用文件 `@src/components/` 引用目录 `@src/utils/api.ts:fetchData` 引用函数
`!`	Shell 命令	执行终端/系统命令	`!npm install` 安装依赖 `!ls -la` 列出文件 `!git status` 查看 Git 状态

使用技巧：

/ - 快捷操作：执行内置操作
@ - 精准定位：让 Claude 知道你要操作哪个具体文件，避免歧义
! - 系统集成：直接在 Claude Code 中执行终端命令，无需切换窗口

组合使用示例：

先运行测试，然后帮我修复失败的用例：
!npm test

审查这个文件的代码质量：
@src/components/Button.tsx

创建提交并推送到远程：
先创建提交，然后 !git push

内置命令

`/help` - 获取帮助

显示所有可用命令和功能的帮助信息：

/help

提示：当你不确定如何使用某个功能时，随时可以使用 /help 查看帮助。

`/clear` - 清除对话历史

清除当前的对话历史：

/clear

使用场景：

开始新的任务时
对话变得冗长时
想要重新开始讨论某个话题时

`/exit` - 退出程序

退出 Claude Code：

/exit

或者使用快捷键 Ctrl + D（Mac/Linux）或 Ctrl + Z（Windows）

`/plan` - 进入规划模式

进入规划模式，制定详细的实现计划：

/plan

使用场景：

需要实现复杂功能时
想要预先规划架构和步骤
多人协作前的方案讨论

进入规划模式后，Claude Code 会：

分析需求
探索代码库
制定实现计划
等待你的批准

`/model` - 切换 AI 模型

切换使用的 AI 模型：

/model

显示可用模型列表并让你选择。

`/context` - 管理上下文

查看和管理当前的上下文设置：

/context

功能：

查看当前包含的文件
管理项目上下文
调整上下文大小

`/tasks` - 查看任务列表

查看当前的任务列表和进度：

/tasks

显示所有待办、进行中和已完成的任务。

查看所有命令

输入 / 后按 Tab 键可以查看所有可用的 Slash 命令：

/ [按 Tab 键]

CLI 命令（终端运行）

Claude Code 也可以作为终端命令使用，方便脚本和自动化：

`claude` - 启动交互模式

claude

启动 Claude Code 交互式 REPL。

`claude "query"` - 带初始提示启动

claude "解释这个项目的结构"

启动 REPL 并自动执行初始提示。

`claude -p "query"` - 查询模式

claude -p "这个函数是做什么的？"

通过 SDK 执行查询，然后退出（适合脚本使用）。

`claude -c` - 继续最近对话

claude -c

在当前目录继续最近的对话。

`claude -r "<session>"` - 恢复会话

claude -r "auth-refactor"

按 ID 或名称恢复之前的会话。

`claude update` - 更新版本

claude update

更新 Claude Code 到最新版本。

`claude mcp` - 配置 MCP

claude mcp

配置 Model Context Protocol (MCP) 服务器。

CLI 启动参数（Flags）

在启动 Claude Code 时可以使用各种参数自定义行为：

`--model` - 指定模型

claude --model claude-sonnet-4-5-20250929

或使用简写：

claude --model sonnet

可用选项：sonnet、opus、haiku

`--chrome` - 启用浏览器集成

claude --chrome

启用 Chrome 浏览器集成，用于 Web 自动化和测试。

`--verbose` - 详细日志

claude --verbose

启用详细日志模式，显示完整的轮次输出。

`--print` - 打印模式

claude -p "查询" --print

打印响应而不进入交互模式（适合脚本）。

`--system-prompt` - 自定义系统提示

claude --system-prompt "你是一个 Python 专家"

替换整个系统提示。

`--append-system-prompt` - 追加系统提示

claude --append-system-prompt "始终使用 TypeScript"

在默认系统提示后追加自定义指令。

`--tools` - 限制可用工具

claude --tools "Bash,Edit,Read"

限制 Claude 可以使用的内置工具。

`--permission-mode` - 权限模式

claude --permission-mode plan

以指定权限模式启动。

常用组合示例

快速代码审查

claude -p "审查 @src/App.tsx 的代码质量"

启用浏览器自动化

claude --chrome

使用特定模型和详细日志

claude --model opus --verbose

自定义专家角色

claude --append-system-prompt "你是一个专注于性能优化的 React 专家"

文件操作

读取文件

直接告诉 Claude 你想查看哪个文件：

读取 src/App.tsx 文件

或者：

查看 package.json 的内容

编辑文件

Claude Code 会智能地编辑文件，你只需描述你的需求：

修改 src/App.tsx，将标题颜色改为蓝色

在 utils/helpers.ts 中添加一个新的函数 calculateDiscount，
接收 price 和 discountPercentage 作为参数，返回折扣后的价格

创建新文件

创建 src/components/Button.tsx 文件，
实现一个可复用的按钮组件，支持多种尺寸和样式变体

搜索文件

搜索项目中所有包含 'useState' 的文件

查找所有 .test.tsx 文件

找到所有的 CSS 文件

代码编辑操作

代码生成

创建一个 React 组件 UserCard，显示用户头像、姓名和简介
使用 TypeScript，添加类型定义

代码重构

将 src/utils/api.ts 中的重复代码抽取为独立函数

重构 src/components/Form.tsx，使用 React Hook Form 替代受控组件

代码解释

解释 src/hooks/useAuth.ts 这个文件的作用

说明这个函数的工作原理：
[粘贴代码]

Bug 修复

我的应用报错 "Cannot read property 'map' of undefined"，
帮我找出问题所在并修复

src/pages/Dashboard.tsx 中的状态更新有问题，
用户点击后没有反应，请帮我调试

Git 操作

查看状态

查看当前 Git 状态

有哪些文件被修改了？

创建提交

帮我创建一个提交，使用这些更改

Claude Code 会：

显示所有更改的文件
分析修改内容
生成合适的提交信息
创建提交

你也可以指定提交信息：

创建提交，信息是："feat: 添加用户认证功能"

查看提交历史

查看最近的提交记录

创建分支

创建新分支 feature/user-profile

切换分支

切换到 develop 分支

高级操作

代码审查

审查我的代码，检查：
1. 性能问题
2. 安全漏洞
3. 代码风格
4. 最佳实践

性能优化

分析 src/App.tsx 的性能问题并提供优化建议

优化这个查询语句的性能：
[粘贴代码]

文档生成

为这个函数生成 JSDoc 注释：
[粘贴代码]

为我的组件库生成使用文档

代码迁移

将这个项目从 JavaScript 迁移到 TypeScript

将样式从 CSS Modules 迁移到 Tailwind CSS

实用技巧

上下文感知

Claude Code 会自动感知你的项目环境：

[在 React 项目中]
创建一个新的页面组件

Claude 会自动：

使用你的项目的技术栈
遵循你的项目结构
匹配你的代码风格

批量操作

将所有 .jsx 文件重命名为 .tsx

在所有组件文件中添加 PropTypes 或 TypeScript 类型

交互式确认

对于重要操作，Claude 会先征求你的同意：

删除所有 node_modules 文件夹

Claude 会：

列出将要删除的文件
等待你的确认
执行操作

错误处理

遇到错误时，直接描述或粘贴错误信息：

我遇到了这个错误，帮我解决：
[粘贴错误信息]

总结

总之，有啥不懂的，有啥想要Claude Code去做的，问它就对了。Claude Code 最大的优势在于它的自然语言交互能力。不要害怕提问，大胆尝试不同的表达方式，没有最佳实践，只有最适合你的工作方式！

Happy Coding!