第一次会话：初始化项目、基本交互、权限模式怎么选

从一条命令开始

装好后，进入你的项目目录，敲 claude，回车：

cd /path/to/your/project
claude

欢迎界面上会显示版本号、当前模型和工作目录。首次使用会引导你在浏览器完成登录（上一章讲过五种账号方式）。登录完直接就是输入框，没有向导、没有教程弹窗——它默认你是会干活的人。

你也可以带着任务启动：claude "fix the build error"，进来第一句话就是任务描述。

五个保命快捷键

先把这几个刻进肌肉记忆：

按键 作用
Esc 立刻打断正在执行的操作，等你的下一句话
Esc 按两次 输入框有字时清空（草稿进历史，按上箭头可召回）；输入框为空时打开回退菜单
Shift+Tab 循环切换权限模式
Ctrl+R 反向搜索历史输入
Ctrl+O 打开完整转录视图，看每次工具调用的细节
Ctrl+B 把正在跑的命令或代理转入后台
Ctrl+C / Ctrl+D 中断 / 退出（Ctrl+D 按两次退出）

多行输入有三种方式：行尾加 \ 再回车（所有终端通用）、Shift+Enter（iTerm2、WezTerm、Ghostty、Kitty、Warp、Windows Terminal 等原生支持）、Ctrl+J（任何终端免配置）。贴大段代码或日志直接粘贴即可，自动按多行处理。

还有一个关键交互模式：排队发言。Claude 正在干活时你直接打字回车，消息不会打断它，而是排队等当前这批工具调用结束后被它读到。所以看到它跑偏了，你既可以 Esc 急刹，也可以直接把纠正打进去让它"边跑边听"。

第一步永远是 /init

拿到一个新项目（不管是你自己的还是接手的），我的固定动作是先跑：

/init

这个命令会让 Claude 通读项目结构，然后生成一份 CLAUDE.md 放在项目根目录，内容是项目概览、构建命令、代码约定等。这份文件每次会话开始都会被自动读入，相当于给 Agent 的一份入职简报。生成的初稿质量不错，但强烈建议你人工过一遍，补充文档里没有的"隐性知识"：哪些目录不能动、测试怎么跑、有什么历史包袱。

顺手跑一下 /doctor，它会对安装和配置做一次体检，有问题当场修复。CLAUDE.md 不需要现在研究透，第二章记忆体系专门讲。这里只需要记住：新项目第一件事 /init。

第一轮对话怎么聊

不用学什么提示词咒语，直接像派活给同事一样说话。官方 Quickstart 的几个例子就很典型：

这个项目是做什么的？
主入口在哪个文件？
解释一下目录结构

先摸底再干活。修 bug 时把报错原样贴进去，比你自己转述"大概是哪里挂了"有效得多。越具体的描述越省来回——"修 bug"不如"修登录页输错密码后白屏的 bug"。

再给几个可以直接抄的摸底提问：

这个项目用什么测试框架，测试命令是什么？
配置文件加载的优先级顺序是怎样的？
如果我要加一个新的 API 端点，需要动哪些文件？

这类问题答一次你受益一周，而且答案本身就适合整理进 CLAUDE.md（下一章讲）。另外提醒一句：它读项目文件不需要你手动喂上下文，不用把文件内容粘贴给它，直接说文件名或问题描述即可。

几个新手必知的会话命令：/help 看所有命令；/clear 清空对话开新任务；/exit 退出。问到一半发现方向不对，直接说"不对，问题在会话处理这块"，它会在现有对话基础上调整——这是对话式交互和搜索引擎式交互最大的区别，不用推倒重来。

权限模式：四种档位怎么选

这是第一次会话里最重要的概念。权限模式决定了 Claude 哪些动作可以不问你。按 Shift+Tab 循环切换，四种模式：

模式 行为 适合场景
Auto（自动） 后台分类器审查大部分动作，放行安全的，拦下危险的，基本不打扰你 日常开发默认档
Manual（手动，配置值 default） 改文件、跑命令都要问你 敏感代码库、不熟悉的操作
Accept edits（接受编辑） 文件编辑和 mkdir、touch、rm、mv、cp、sed 等常见文件系统命令自动放行，其他命令仍要问 信任它的改动但想把关命令
Plan（计划） 只读探索 + 出计划，不改你的源码 动手前先看方案

从 v2.1.283 起，Auto 是交互式终端和 VS Code 会话的内置默认模式。任何模式都有不自动放行的动作清单（某些高危操作任何模式都不放行），细节到权限模型那一章展开。

我的建议路径：新项目或敏感项目用 Plan 起步 → 看完计划批准时切 Auto 或 Accept edits。批准计划的选项里就带着模式切换，比如"批准并使用 auto 模式"。模式选择会按目录记住——你在某个项目选过的模式，下次进这个项目还是它（Plan 例外，只对当次会话生效）。

第一天该认识的会话内命令

除了上面提到的，这几个命令在头一周就会用到：

命令 干什么 什么时候用
/init 生成项目 CLAUDE.md 新项目第一件事
/doctor 安装与配置体检 装完跑一次，出怪事再跑
/status 查看账号、模型、版本等状态 不确定自己用哪个账号/模型时
/clear 清空对话 换一个不相关的新任务
/model 切换模型 任务变难或想省钱时
/context 查看上下文占用 会话很长、感觉它变笨时
/help 列出全部命令 忘记命令名时

不用刻意背，输入 / 会弹出补全列表，Tab 补全，上箭头翻历史。头一周靠 /help 混过来完全正常。

第一次改代码

随便挑个小任务试试水：

给用户注册表单加上输入校验

如果当前是 Manual 模式，它会先展示改动内容等你点头。批准时可以按 Tab 附一句备注（比如"这里别用正则，用校验库"），它会带着你的批注继续。改完文件不满意？按两次 Esc 打开回退菜单，文件和对话都能回滚到之前的检查点——改文件前的快照机制保证你永远有后悔药。

再试个 Git 流：

哪些文件被我改过了？
用描述性的提交信息提交
看最近 5 次提交

你会发现 Git 操作变成对话了。不用记 git log --oneline -5，直接说要什么。

一个完整的第一次：从空会话到提交

把本章内容串成一个完整流程，照着走一遍胜过读十遍：

1  cd my-project && claude          # 启动，完成登录
2  /init                            # 生成项目简报 CLAUDE.md
3  "这个项目的入口和构建方式是什么？"  # 摸底，纯提问不改代码
4  "注册接口缺少邮箱格式校验，补上，写个测试"   # 第一个真实任务
5  （Manual 模式下审阅每个改动；Auto 模式下看最终汇报）
6  "跑一下测试确认没问题"            # 让它自己验证
7  "用规范的提交信息提交这次改动"     # Git 收尾
8  Ctrl+D 退出

走完这一圈，你就完成了别人文档里叫 "quickstart" 的全部内容。之后的所有进阶——记忆、权限、hooks、子代理——都只是让这条流水线的某一段变得更快、更稳、更自动化。

新手常见的三个第一次

第一次觉得它慢：它在跑工具调用，终端会显示当前在做什么。如果只是想快速问个问题（不涉及改代码），直接问就行，它不会没事找活。真正嫌慢的场景，往往是你没给路径让它满库找线索——主动说"退款逻辑在 src/payments/refund/"能砍掉大半探索时间。

第一次权限弹窗刷屏：说明你在 Manual 模式下干大活。切到 Accept edits 或 Auto，或者在 settings.json 的 permissions.allow 里把 npm test 这类可信命令加白名单（后面章节讲）。

第一次想让它教你：它可以直接回答关于自身的问题，比如"hooks 怎么配置""CLAUDE.md 怎么组织""能不能处理 Docker"，问就行。把它当成一个读过全部官方文档的同事来用。

第一次遇到权限弹窗看不懂：弹窗里列的是即将执行的具体命令。看不懂就选 No 再问它"你为什么要跑这条命令"，它会解释意图——这也是一种让 Agent 暴露计划的方式，比盲目批准或盲目拒绝都有营养。

本章由 WorkBuddy 原创整理，事实性内容参考 Claude Code 官方文档。