跳到正文
docai.cc

DOCAI · 课程 · L3 · 23 分钟 · 基础入门

界面介绍与导航

把终端界面拆成对话区、工具块、差异区和输入行,讲清一次请求的路径、常用斜杠命令、编辑器面板差异与几个容易误读的信号。

Claude Code 程序员 · 基础使用指南

你将学会

  • 说出终端界面的四个区域各自负责什么
  • 在权限确认和差异区里判断一次改动是否可信
  • 用斜杠命令与前缀完成常用导航

这不是一个聊天框

第一次打开终端界面,很多人以为它只是把网页对话搬到了命令行。用上十分钟就会发现差别:它会把「读了哪个文件」「跑了哪条命令」「改了哪几行」逐条摊开。

界面大致分四块:

  • 对话区:你的输入和它的说明;
  • 工具块:每一次读文件、执行命令、写文件的过程;
  • 差异区:改动前后的对照;
  • 输入行:当前可以做什么,以及模式提示。

真正要练的是读工具块和差异区,而不是只读最后那段总结。总结是它对自己的描述,工具块才是实际发生的事。

一次请求的完整路径

输入一句话后,通常会经历这些步骤:

  1. 它说明打算查哪些文件、跑哪些命令;
  2. 涉及写操作或敏感命令时,界面停下来等你确认;
  3. 执行后把输出贴回对话;
  4. 改动以差异形式展示;
  5. 最后给一段总结。

第二和第四步是关键。确认提示出现时,先看清楚它要执行什么、影响哪些文件,再决定同意还是拒绝。看不懂就拒绝,让它换个做法,成本很低。

差异区要重点看三处:有没有改到任务之外的文件、有没有顺手重写无关逻辑、有没有为了让测试通过而改测试本身。

常用导航命令

会话里输入斜杠命令,可以完成大部分切换:

命令 作用 什么时候用
/help 列出可用命令 忘了某个名字
/status 看当前模型、账号与配置 行为跟预期不符
/model 换模型档位 任务难度变化
/clear 清空上下文 换一个无关任务
/init 生成项目说明草稿 第一次进仓库

记不住名字也没关系:输入 / 会列出可用命令,按 Tab 可以直接补全。

输入行里还有两个前缀值得记:@ 用来点名文件或目录,! 用来直接执行一条本地命令。前者比口头描述路径可靠,后者适合你先确认环境、再把结果交给它分析。

操作层面记三个键:Esc 打断当前生成,Ctrl+C 连按两次退出,Ctrl+L 清屏但保留上下文。不同版本可能微调,以界面提示为准。

侧栏、面板与网页版的差别

在编辑器里安装插件后,界面会多出侧栏:会话列表、改动概览、文件定位都在里面。选中一段代码再提问,选区会自动成为上下文,不需要手动贴。

桌面端更接近独立应用:多窗口、拖拽文件、系统通知。网页版则是另一套产品,左侧是会话与项目,顶部是模型切换,和终端界面不是同一张地图。网页版怎么用,可以看界面全览;这里只讲开发时真正会盯的那块屏。

不管在哪个界面,判断标准一致:工具调用是否透明、改动是否可见、权限是否由你掌握。

读懂界面里的信号

几个容易误读的信号:

权限提示不是报错。 它在等你授权,不是执行失败。看清楚内容再点。

工具块折叠不等于没执行。 展开看参数和输出,尤其是删除、移动、批量替换这类动作。

差异为空不等于没改。 可能是改了又被还原,也可能是改在未跟踪的文件里。用版本控制的状态命令再确认一次。

上下文占用会悄悄变满。 长会话里它开始重复、忘记前面的约定,往往不是变笨,而是早期内容被挤出去了。换新会话,把必要的背景重新给一遍。

网页版界面:同一套概念,不同的摆法

网页版和终端不是同一套界面,但概念能一一对上。第一次从网页转到终端、或者反过来用时,先看这张对照表:

网页版的位置 你熟悉的功能 终端里的对应物
左侧栏 历史对话、项目 会话列表与恢复命令;项目背景靠说明文件
顶部栏 模型选择、设置 /model、/status、配置文件
输入框旁 上传文件、语音输入 直接给路径,或用 @ 点名
回答下方 复制、重新生成、编辑提问 复制回答、重新发问、回退会话
编辑旧消息 产生新分支 新开会话,或从历史节点继续
设置页 语言、记忆、密钥 本地配置与环境变量

网页版适合整理思路、写长文、看图片;终端适合在项目里连续操作文件。两边都遵守同一条规则:先看清它读了什么、改了什么,再决定下一步。

网页版还有两个容易被忽略的入口。一是对话分支:修改前面的提问后,旧回答不会消失,而是在旁边长出一个新版本,适合比较两种问法。二是项目:把常用资料放进同一个项目,之后每次对话都能引用,省去反复上传;但项目里的内容同样会占用上下文,资料越多,留给当前任务的余量越少。

常见误读:现象、原因与处理

现象:在网页版里输入 /clear,没有任何反应。 为什么:斜杠命令是终端产品的功能,网页版没有这套命令系统。 怎么办:网页版用新建对话来达到同样目的;终端里再用 /clear,两者不要混用。命令清单见斜杠命令帮助。

现象:按了一次 Ctrl+C,程序还在跑。 为什么:第一次通常是打断当前生成或取消当前动作,连按两次才会退出。 怎么办:先看界面有没有停下;要彻底退出就再按一次,或输入退出命令。不同版本的按键可能调整,以界面提示为准;更多按键见快捷键参考。

现象:权限提示一闪而过,你没看清就点了同意。 为什么:提示会列出命令或文件路径,内容一长就滚出视野;连续操作时容易条件反射。 怎么办:把提示展开,先看动词(删除、覆盖、移动)再看对象;看不懂就拒绝,让它改成分步执行。拒绝的成本远低于误删。

现象:差异区里几乎没内容,你以为这次没改文件。 为什么:差异区主要展开已跟踪文本文件的行级改动;新建文件、二进制文件、纯重命名或移动往往只给一行摘要,看起来接近空白。 怎么办:在项目里跑 git status --short,重点看 ??(未跟踪新文件)、R(重命名)、D(删除)三类标记;再跑 git diff --stat 核对改动行数。两条命令都没有输出,才说明工作区确实没变。非 git 项目就用文件修改时间与备份副本对比确认。

现象:在编辑器侧栏选中一段代码提问,它却分析了整个文件。 为什么:选区是否自动成为上下文,取决于插件版本和当前面板状态。 怎么办:在问题里明确写行号范围,或用 @ 指定文件后再说「只看第几行到第几行」;回答偏离时先纠正范围,不要顺着它的错误前提追问。

把界面用顺,再练问法

先做到三件事:知道在哪里看改动、在哪里打断、在哪里换模型。然后练对话本身——同样一个工具,问法不同,产出的质量差很远。继续看基本对话交互。

自测

先自己回答,再展开对照;答不上来就回到对应小节。
  1. 01为什么不能只看最后的总结?看答案

    总结是工具对自己的描述,可能漏掉顺手改的无关文件,也可能把失败说成完成。实际发生的动作藏在工具块和差异里。

  2. 02权限提示出现时,应该按什么顺序判断?看答案

    先看要执行什么命令或改哪些文件,再看影响范围是否超出任务,最后决定同意还是拒绝。看不懂就拒绝,换个做法成本很低。

  3. 03长会话里它开始重复、忘记约定,通常是什么原因?看答案

    多半不是能力下降,而是早期内容被挤出上下文。换新会话,把必要背景重新给一遍,比继续追问更有效。

查看 Markdown

涉及的概念

在知识树上

相关动态

全部新闻 →