会话界面与工具调用过程解读

第一次进入 Claude Code 交互会话，很多新手会被满屏的工具调用、确认提示和状态栏信息绕晕。本节不要求你写代码，只解决一个问题：把会话界面的每一块看明白，读懂一条指令从输入到完成的完整过程，记住最常用的会话内命令。看懂界面，你才知道代理"正在做什么、有没有越界、什么时候该你点头确认"。

一、界面的四个基本分区

Claude Code 在终端里运行，没有复杂的图形窗口，界面由四个部分构成，理解它们就掌握了全部交互位置：

分区	位置与作用	你主要做什么
对话记录区	屏幕上方持续滚动，记录你发出的每条指令、代理的说明、每次工具调用与返回结果	向上滚动回看历史、核对代理做过的改动
输入框	底部用于输入自然语言指令；以 / 开头会弹出斜杠命令候选菜单	输入任务描述，或输入斜杠命令切换功能
状态栏	通常位于输入框附近，显示当前模型、当前权限模式、工作目录、用量等关键状态	一眼确认"现在是什么模式、在哪个目录工作"
权限确认提示	代理要执行需要批准的动作（写文件、跑命令、联网等）时弹出，列出具体动作供你选择	逐条阅读动作内容后再选择批准或拒绝

二、一条指令的完整生命周期：代理循环

你每发出一条消息，代理并不会直接甩出答案，而是反复执行"理解 → 行动 → 观察 → 继续"的循环，直到任务完成或需要你决策：

• 理解与计划：先结合当前对话和代码库，判断任务目标、需要看哪些文件；在计划模式下它只出方案、不动源码。
• 调用工具：通过内置工具读取文件、检索代码、执行终端命令、编辑或新建文件、必要时联网。
• 读取结果：每次工具返回的内容都会回到代理的工作上下文里，作为下一步判断依据。
• 继续多轮动作：一个复杂任务通常由多次工具调用串成，而不是一次问答。
• 汇报与请示：阶段性结论、改动说明，或遇到必须由你决定的确认点时，等待你回应。

三、如何读懂工具调用块

界面中每一次工具调用都会以结构化块呈现，重点看三处：

• 工具名：例如 Read、Grep、Bash、Edit、Write，分别对应读、搜、执行命令、改文件、建文件。
• 关键参数：读改类工具会给出具体文件路径；命令类工具会给出完整命令行；联网工具会给出目标 URL。参数比工具名更重要——同样是 Bash，跑测试和推送代码的风险完全不同。
• 确认与结果：需要批准的动作会先征求同意；执行后的输出可能较长并被折叠，可按需展开查看。只读类动作在工作目录内通常直接进行，不打断你。

四、输入操作：发送、换行与历史

• 发送消息：在输入框写完后按 Enter 提交。
• 输入多行：多数终端用 Shift+Enter 换行；若你的终端没有绑定换行快捷键，可运行 /terminal-setup 按提示为常用编辑器终端安装换行键位。
• 斜杠命令：输入 / 即出现命令菜单，继续输入字母会过滤候选，方向键选择后回车执行。
• 回看历史：在输入框调出上一条输入，便于修改后重发；跨会话恢复见后文启动参数说明。

五、会话内常用斜杠命令速查

斜杠命令在会话内部输入，用于控制当前会话；注意不要把它们和启动时的命令行参数混为一谈。下表只收录入门阶段最常用、且与官方文档一致的命令：

命令	作用	典型使用时机
/help	列出当前可用的全部命令	忘记命令名时先查它
/init	探索当前代码库，生成一份起始 CLAUDE.md 项目记忆文件	第一次接手一个新项目时
/clear	清空对话历史、重新开始；项目记忆 CLAUDE.md 仍然保留	换一个不相关子任务、上下文变乱时
/compact [说明]	压缩早期对话以释放上下文空间，可附带聚焦说明	会话变长、接近上下文上限时
/config	打开设置界面（配置页）	调整模型、外观与偏好设置
/permissions	交互式管理 allow / ask / deny 权限规则（别名 /allowed-tools）	反复为同类命令点确认时，固化规则
/model	切换当前使用的模型	需要更强推理或更省用量时
/diff	查看当前工作区中代理已产生的改动	接受改动前做整体审查
/doctor	对安装、设置、扩展与 CLAUDE.md 做体检并给出修复建议（别名 /checkup）	出现"用不了、行为异常"时先排查
/cd <path>	把当前会话切换到新的工作目录并保留对话	需要在同一会话中换目录工作
/add-dir	为当前会话追加额外的可访问目录	任务涉及多个并列仓库或目录
/plan [描述]	直接进入计划模式，可附带任务描述	想先出方案、暂不动代码时
/mcp	管理已连接的 MCP 服务器（重连、启用、禁用）	外部工具连接异常时
/bug [说明]	上报问题或分享本次会话内容（发送前会让你选择包含多少历史）	发现产品缺陷时反馈
/status	查看版本、模型、账号与连接状态	确认登录态与版本

六、启动参数与会话内命令的区别（易混点）

下面两个是在终端启动 Claude Code 时使用的命令行参数，不是会话内斜杠命令：

# 继续最近一次会话
claude --continue

# 按会话 ID 恢复指定历史会话
claude --resume <sessionId>

简单记忆：/xxx 是"已经进入会话后"敲的；--xxx 是"还没进入会话、在终端命令行"敲的。

七、新手常见界面疑问

• 界面长时间"在思考"：复杂任务会先检索多个文件再动作，属正常现象；可观察日志区是否有工具调用产生。
• 输出一大段被折叠：工具结果过长会折叠展示，需要核对细节时展开即可，不必担心内容丢失。
• 反复弹出确认框：说明当前处于较严格的权限模式；同类动作可通过 /permissions 固化规则，而不是无脑全部放行。
• 状态栏模式看不懂：下一节讲上下文，再下一节专门讲权限模式与内置工具，届时对照状态栏逐项理解。