Claude Code 基础操作
课程导读
这节课先不急着写复杂项目，而是把 Claude Code 的“工作现场”看清楚：Python 环境怎么准备、第一次需求如何发送、工具调用和权限确认各代表什么，以及文字、文件、图片怎样更高效地交给它。
一、安装 Python
1. 选择 Python 版本
Python 有很多版本，课程统一使用 Python 3.12 演示。
Python 3.12 下载页面
2. Windows 安装注意事项
Windows 安装 Python 时，需要勾选：
Add to PATH勾选后，后续才能在终端里直接使用 python 命令。
3. 验证是否安装成功
| 系统 | 验证命令 |
|---|---|
| macOS | python3 --version |
| Windows | python --version |
如果能正确返回 Python 版本号，就说明安装成功。
二、进入项目并启动 Claude Code
使用 Claude Code 前，需要先切换到项目文件夹，再启动 Claude Code。
| 操作 | 命令 |
|---|---|
| 进入项目文件夹 | cd 项目文件夹路径 |
| 启动 Claude Code | claude |
三、看懂 Claude Code 的运行过程
1. 开头的动画和随机词
发送需求后，界面上会先出现 Claude 图标动画，后面跟着一个随机单词。
这个单词没有实际含义，只是表示 Claude Code 正在运行，不需要特别关注。
2. Thinking 状态
过一会儿，界面上会显示运行时间和 thinking 字样。
这表示 Claude Code 正在分析你的需求，判断接下来需要读取什么信息、写什么文件、执行什么命令。
3. Token 消耗
Claude Code 运行过程中还会显示 Token 消耗。
Token 中文常叫“词元”，可以简单理解为 AI 处理文字时使用的计量单位。你发送给 Claude Code 的内容、Claude Code 回复给你的内容，以及它读取的上下文，都会消耗 Token。
一般来说，对话内容越多、引用文件越多、输出越长，Token 消耗也会越多。
四、理解 Claude Code 的工具调用
Claude Code 底层是语言大模型，本质上只能处理文字输入和文字输出。它要想真正读取文件、写入文件、执行命令，就需要调用外部工具。
可以把 Claude Code 理解成负责思考的大脑，而工具就像它的手和脚，负责实际操作电脑。
常见工具包括：
| 工具名 | 作用 |
|---|---|
Read | 读取文件内容，比如 .py、.md、图片等 |
Write | 创建新文件，或覆盖写入文件 |
Edit | 修改已有文件中的某一部分内容 |
Bash | 执行终端命令，比如运行脚本、安装依赖、执行测试 |
Grep | 在文件内容中搜索关键词 |
WebFetch | 读取某个网页链接的内容 |
WebSearch | 联网搜索资料 |
五、工具状态和权限申请
1. 工具执行状态
在工具名称前面通常会有一个圆点，用来表示工具当前状态。可以把它理解成下面这种界面提示：
2. 写入文件的确认
当 Claude Code 准备创建脚本文件时，界面可能会弹出确认申请。
常见选项包括：
| 选项 | 含义 |
|---|---|
| 本次同意 | 只允许当前这一次操作 |
| 全部同意 | 当前对话中后续同类操作不再重复确认 |
| 不同意 | 拒绝本次操作 |
3. 展开工具详情
| 快捷键 | 作用 |
|---|---|
Ctrl + O | 展开或折叠工具执行详情 |
六、文本输入技巧
| 场景 | 快捷键 | 作用 |
|---|---|---|
| 换行输入 | Shift + 回车 | 输入多段需求或较长提示词 |
| 逐字删除 | 退格键 | 删除光标前一个字符 |
| 删除整行内容 | Ctrl + U | 删除从光标位置到行首的内容 |
| 撤销删除 | Ctrl + Y | 撤销刚才的删除 |
| 清空输入框 | Esc + Esc | 清空输入框里的全部内容 |
| 中断执行 | Esc | 打断正在执行任务的 Claude Code |
七、引用项目文件
如果刚把新文件放入项目文件夹，Claude Code 可能不会实时识别到这些文件，可以先重启 Claude Code。
| 场景 | 快捷键 / 输入方式 | 作用 |
|---|---|---|
| 退出 Claude Code | Ctrl + C 两次 | 结束当前 Claude Code 会话 |
| 重新启动 Claude Code | claude | 退出后，在当前项目目录重新进入 Claude Code |
| 搜索文件 | @ + 文件名关键词 | 在项目文件中搜索可引用内容 |
| 选中文件 | 回车 或 Tab | 选中搜索结果中的文件 ，回车是选中并直接发送，Tab是选中插入到输入框，继续编辑 |
| 引用多个文件 | 每个文件引用之间加空格 | 避免后一个 @ 无法生效 |
八、发送图片给 Claude Code
常见发送方式包括：
| 方式 | 操作 |
|---|---|
使用 @ 引用 | 输入 @ 后搜索图片文件 |
| 拖拽图片 | 直接把图片拖到输入框 |
| 复制图片文件 | 选中图片后使用 Command/Ctrl + C，再回到输入框使用 Command/Ctrl + V |
| 粘贴截图 | 截图后回到输入框使用 Ctrl + V |
九、使用 Warp 富文本输入
富文本输入框更适合编辑长文本、移动光标、局部选择内容和添加文件。
富文本输入框中可以用鼠标点击任意位置移动光标，也可以拖动选择一段文本并删除。
| 场景 | 快捷键 / 操作 | 作用 |
|---|---|---|
| 打开或退出富文本输入 | Ctrl + G | 切换 Warp 富文本输入框 |
| 全选内容 | Command/Ctrl + A | 选中富文本输入框中的全部内容 |
| 引用文件 | @ + 文件名关键词 | 在富文本输入框中引用项目文件 |
| 拖拽文件 | 直接拖入输入框 | 把项目目录里的文件添加到输入内容中 |
| 发送内容 | 回车 | 将富文本输入框里的内容发送给 Claude Code |
十、Warp 操作
| 场景 | 快捷键 / 操作 | 作用 |
|---|---|---|
| 新建标签页 | Command + T / Ctrl + Shift + T | 打开一个新的 Warp 标签页 |
Warp 生成的命令旁边通常会有一个图标，点击后命令会自动填入命令行。