Claude Code 基础使用手册
一、会话生命周期管理
在终端中管理 Agent 会话的核心命令：
| 场景 | 命令 | 作用原理 |
|---|---|---|
| 开启全新会话 | claude |
在当前目录下启动一个空白对话 |
| 选择并恢复旧会话 | claude --resume |
弹出列表，用方向键选择之前命名的会话 |
| 精准跳回某个会话 | claude --resume [名称] |
直接进入指定名称的会话 |
| 直接回到上一次会话 | claude -c (或 --continue) |
不选择，直接恢复最后关闭的会话 |
会话内管理指令
在 Claude > 提示符下输入：
/rename [新名字]：为当前会话命名，便于后续识别（默认为一串 ID）/resume：在对话中途切换会话，弹出列表选择，无需退出重开/clear：清除当前会话的对话历史，彻底释放 Token 空间。适合切换任务或开始全新工作时使用（注意：此操作不可逆）
二、TUI 交互与快捷键
Claude Code 终端界面提供了一套精简的折叠与交互机制：
1. 界面特有指令
| 界面提示 | 快捷键 | 作用与原理 |
|---|---|---|
Read 1 file |
Ctrl + O |
展开文件。Claude 自动读取的文件默认折叠，按此展开查看具体代码 |
accept edits on |
Shift + Tab |
安全模式切换。控制是否允许 Claude 自动修改代码文件 |
esc to interrupt |
Esc |
强行中断。当 AI 陷入死循环或疯狂输出时，随时打断并取回控制权 |
2. 常用快捷键
Ctrl + C：强制终止当前操作。AI 话太多、改错文件或陷入死循环时使用Tab：自动补全。输入/res后按 Tab 可自动补全为/resumeEsc：返回。从/status或/resume的选择列表中退出
三、核心交互指令速查
在 Claude > 提示符下输入斜杠命令，执行精准动作：
基础指令
| 指令 | 作用与原理 |
|---|---|
| 直接说话 | Agent 模式。分析代码、自动运行终端命令、修改文件 |
/ask [内容] |
只问不改模式。仅回答问题，绝不修改文件，节省 Token 且安全 |
/undo |
撤销上一步修改。如果改乱了文件，输入此命令可回退文件状态 |
/compact |
记忆压缩。对话太长导致 AI 变慢时，压缩上下文以节省 Token 并提速 |
/review |
项目审计。整体扫描当前目录，指出代码质量问题 |
/status |
查看状态。显示当前 Token 消耗、API Key 来源和 Session ID |
进阶指令（2026 官方原生）
| 指令 | 官方定义 | 实战解析 |
|---|---|---|
/btw |
Ask a quick side question without interrupting the main conversation | 阅后即焚模式。问常识、环境配置（如 Docker 指令）的首选。回答不计入对话长久记忆，翻页即失 |
/branch |
Create a branch of the current conversation at this point | 对话级“存档/读档”。克隆当前记忆到新分支，适合进行高风险的实验性重构。注意：只分支记忆，不分支物理文件 |
/agents |
Manage agent configurations | 管理子代理。在复杂项目中查看或切换具有不同预设能力的 Agent |
/buddy |
Hatch a coding companion · pet, off | 趣味功能。在右下角开启或关闭字符宠物（如猫咪 Crumpet） |
/clear |
Clear conversation history and free up context | 强力瘦身。不仅清屏，还会清除当前会话的对话历史，彻底释放 Token 空间 |
/add-dir |
Add a new working directory | 动态扩展。在不退出会话的情况下，允许 Agent 访问当前目录之外的其他文件夹 |
四、/branch 指令的“物理边界”警示
/branch 是容易产生误解的功能，请牢记以下核心逻辑：
- 记忆分身，文件唯一：
/branch创建的是对话上下文（Memory） 的分支，而不是磁盘文件（Filesystem） 的分支 - 修改即生效：无论你在哪个分支，只要 Claude 修改了代码，本地硬盘上的文件就会立即改变
- 切换不还原：切换回旧分支时，Claude 的“记忆”会回到过去，但硬盘里的代码不会自动变回去
- 黄金搭档：执行
/branch前，强烈建议手动执行git checkout -b [新分支]，实现“记忆分支”与“代码分支”同步
五、/btw 模式的生存法则
由于 /btw 具有“即时性”和“不存入历史”的特点，使用时需遵循：
- 即看即记录：
/btw的回答在终端刷新或滚动后极难找回。看到关键配置（如数据库密码、部署指令）请立即手动复制或截图 - 手动转正：如果
/btw给出的方案非常有用，可紧接着下达指令：“将刚才/btw中的配置信息写入 README.md”，从而将其物理固化 - 替代方案：若需要 AI 的回答长久留在历史记录中以便翻阅，请放弃
/btw，改用 “仅回答，不要修改文件：[你的问题]” 的话术
六、规则与过滤文件
1. .clauderules
在项目根目录创建此文件，写入开发规范。Claude Code 在进行重构和编写时会自动遵循这些规则。
2. .claudeignore
语法与 .gitignore 完全一致。强烈建议将巨大的构建产物、日志或不相关的资源（如 node_modules/）加入，这是防止上下文溢出的最强手段。
七、下一步
掌握基础操作后，可深入学习 Token 机制与上下文管理 以优化使用效率。