本教程面向已经装好 Claude Code、却不知如何"开车"的零基础用户。安装只是点火,真正决定效率的是 REPL(交互式命令行)里那一套斜杠命令、键盘快捷键和四种权限模式。读完本文,你将掌握 30+ 个核心命令、5 个高频快捷键、4 种模式的切换时机,并能用一个真实重构案例把它们串起来,告别"只会打字聊天"的初级阶段。
claude 并完成登录认证CLAUDE.md 的作用本文不涉及安装与登录步骤,相关内容已有专门教程覆盖。我们聚焦"装好之后怎么开"。
很多新手装完 Claude Code 后,会直接在 REPL 里打自然语言问题,像用网页版聊天一样。这能用,但极其低效——你会遇到三大典型困境:
Context length exceeded,前面的成果全废。这三个困境的解药,全在斜杠命令和权限模式里。Claude Code 把"会话管理、成本控制、文件引用、模式切换"全部做成了命令和快捷键,这是它与网页版最大的区别,也是新手最快能拉开差距的地方。
下面这张总览图,先帮你建立全局认知:
graph TD
A[Claude Code REPL] --> B[斜杠命令 /xxx]
A --> C[键盘快捷键]
A --> D[权限模式]
B --> B1[会话管理<br/>/clear /compact /rewind /resume]
B --> B2[上下文与记忆<br/>/init /memory /context /add-dir]
B --> B3[配置与诊断<br/>/config /model /cost /doctor /status]
B --> B4[扩展能力<br/>/agents /hooks /mcp /tasks]
C --> C1[Esc 中断]
C --> C2[Esc Esc 回退]
C --> C3[Shift+Tab 切模式]
C --> C4[@ 引用文件 # 写入记忆]
D --> D1[default 逐项确认]
D --> D2[plan 只读规划]
D --> D3[acceptEdits 自动改文件]
D --> D4[bypassPermissions 全自动]
style A fill:#fff3e0,stroke:#e65100,stroke-width:2px
style B fill:#e3f2fd,stroke:#1565c0
style C fill:#f3e5f5,stroke:#6a1b9a
style D fill:#e8f5e9,stroke:#2e7d32
打开终端,启动 claude,在光标处输入 /,会弹出命令补全列表。2026 年 6 月版本(2.1.x)内置命令可归为四类。我们逐一拆解高频项。
| 类别 | 代表命令 | 一句话作用 |
|---|---|---|
| 会话管理 | /clear /compact /rewind /resume /export |
控制对话上下文的生死与回退 |
| 上下文与记忆 | /init /memory /context /add-dir |
决定 Claude 看到什么、记住什么 |
| 配置与诊断 | /config /model /cost /status /doctor /login /fast |
调参、查账、体检 |
| 扩展能力 | /agents /hooks /mcp /tasks /review /security-review |
子代理、钩子、外部工具 |
新手第一步:在 REPL 里输入 /help,看到所有命令的简短说明。这是你的"仪表盘说明书",记不住命令时就 /help。
/clear /compact /rewind这是新手最该优先掌握的三条命令,直接关系到你能不能顺利完成长任务。
/clear —— 彻底清空,从头开始作用:清空当前会话的全部上下文,回到"刚启动"的空白状态。
何时用: - 切换到完全无关的新任务时(比如从"修 bug"切到"写文档") - 上下文被无关信息污染,Claude 开始胡说八道时 - 想要一个干净的低 token 起点
命令:
/clear
预期结果:REPL 显示一条分隔线,上下文计数归零,之前的对话历史不再被模型读取。
常见坑:很多人在 /clear 之前忘了让 Claude 把结论写进文件,结果一清空,刚分析好的方案全没了。对策:清空前先让 Claude 把成果落到 CLAUDE.md 或一个 .md 文件里,下次 /resume 还能找回。
2.1.191 新特性(2026-06-25 更新):
/rewind现在可以恢复/clear之前的上下文了,不再只是普通检查点。也就是说,误清空也能救回来。但这不意味着可以随便/clear——养成"清空前留痕"的习惯永远没错。
/compact —— 压缩而非清空作用:把当前长上下文摘要压缩成一个总结,保留关键信息,腾出 token 空间继续工作。
何时用: - 上下文用到 60%~80%,还没完成任务,但不想丢失进度 - 任务本身连续性强,前面的决策后面还要引用
命令:
/compact
也可以带自定义指令,告诉它压缩时重点保留什么:
/compact 重点保留接口设计决策和已完成的函数列表
预期结果:REPL 显示压缩前后 token 数,比如 Context: 142000 → 31000 tokens,对话继续。
/clear vs /compact 的核心区别:
| 维度 | /clear |
/compact |
|---|---|---|
| 上下文 | 全部丢弃 | 摘要保留 |
| 适用场景 | 换任务 | 续任务 |
| Token 占用 | 归零 | 大幅降低但不归零 |
| 风险 | 丢失细节 | 可能压缩掉细节 |
经验法则:换任务 /clear,续任务 /compact。
/rewind —— 时光倒流作用:回退到对话中的某个检查点,撤销之后 Claude 产生的修改。
命令:
/rewind
系统会列出可回退的检查点(通常是每轮交互后自动保存的快照),你选一个时间点即可回退。
何时用: - Claude 走错方向,连续改了几轮文件,想回到岔路口 - 手滑批准了不该批准的修改
配合快捷键:双击 Esc(Esc Esc)可以快速回退到上一条用户消息,比 /rewind 更轻量,适合"就回退一步"。
/init —— 生成项目记忆文件作用:让 Claude 扫描项目,自动生成 CLAUDE.md,记录项目结构、构建命令、代码风格。
命令:
/init
预期结果:项目根目录出现 CLAUDE.md,之后每次启动 Claude Code 都会自动加载它作为持久记忆。
新手误区:以为 /init 是一次性命令。实际上它生成的文件可以反复编辑,建议手动补充"测试怎么跑、提交规范、禁忌事项",效果远超纯自动生成。
/memory 与快捷 # —— 写入记忆作用:/memory 打开记忆文件进行编辑;在输入框直接打 # 开头的一行,可快速写入记忆。
命令:
/memory
或快速记一笔(在输入框):
# 本项目用 pnpm,不要用 npm install
预期结果:这条规则被追加到 CLAUDE.md,今后 Claude 自动遵守。
/context —— 看清当前上下文作用:列出当前会话占用了哪些上下文(文件、命令输出、记忆),帮你判断为什么会爆 token。
命令:
/context
何时用:上下文莫名变大时,用它找出"罪魁祸首"——通常是某个被全量读入的大文件。
/add-dir —— 加入工作目录作用:让 Claude 访问启动目录之外的其他目录。
命令:
/add-dir /path/to/another/project
何时用:需要跨项目引用代码(比如前端项目要参考后端 API 定义)。
Shift+Tab 切换这是新手进阶的关键。Claude Code 有四种权限模式,决定了它在多大程度上"自己动手"。按 Shift+Tab 在 REPL 里循环切换,无需退出。
flowchart LR
M1[default<br/>逐项确认] -->|Shift+Tab| M2[plan<br/>只读规划]
M2 -->|Shift+Tab| M3[acceptEdits<br/>自动改文件]
M3 -->|Shift+Tab| M4[bypassPermissions<br/>全自动]
M4 -->|Shift+Tab| M1
style M1 fill:#fff9c4
style M2 fill:#bbdefb
style M3 fill:#c8e6c9
style M4 fill:#ffcdd2
| 模式 | 文件编辑 | 命令执行 | 适用场景 | 风险 |
|---|---|---|---|---|
| default | 每次问 | 每次问 | 新手默认、不熟悉的项目 | 低 |
| plan | 禁止 | 禁止 | 让 Claude 先出方案不动手 | 最低 |
| acceptEdits | 自动 | 仍问 | 批量重构、可信任务 | 中 |
| bypassPermissions | 自动 | 自动 | 沙箱、一次性环境 | 高 |
新手黄金法则:
- 刚接触一个陌生代码库 → 用 plan:让 Claude 先读、先规划,你审完方案再切回 default 或 acceptEdits 动手。这能避免它一上来就乱改。
- 方案已定、要批量改文件 → 切 acceptEdits:免去几十次回车确认,但命令执行仍要你点头,安全垫还在。
- bypassPermissions 慎用:仅在 Docker 容器、临时虚拟机等可丢弃环境里用。别在生产目录、别在有未推送提交的仓库里用。
/config 也能改默认模式:不想每次 Shift+Tab,可用 /config 把启动默认模式设为 acceptEdits。
斜杠命令之外,快捷键是高频操作的"肌肉记忆"。
| 快捷键 | 作用 | 使用频率 |
|---|---|---|
Esc |
中断 Claude 当前操作 | ★★★★★ |
Esc Esc |
回退到上一条用户消息 | ★★★★ |
Shift+Tab |
循环切换权限模式 | ★★★★ |
↑ / ↓ |
翻历史输入 | ★★★ |
Ctrl+C |
取消当前输入行 | ★★★ |
Ctrl+D |
退出 Claude Code | ★★ |
Ctrl+R |
切换详细输出(verbose) | ★★ |
@ |
输入框引用文件/目录 | ★★★★★ |
# |
输入框快速写入记忆 | ★★★ |
Tab |
命令/文件名补全 | ★★★★ |
最该先练的三招:
1. @ 引用文件:输入 帮我看下 @src/utils/auth.ts 的登录逻辑,Claude 会精准读取该文件,而不是猜路径。这比"帮我看看认证代码"精确得多。
2. Esc 及时刹车:发现 Claude 跑偏,立刻 Esc 中断,比等它改完一通再 Esc Esc 回退省事。
3. Esc Esc 兜底回退:手滑批准了错误操作,双击 Esc 回到上一步。
/cost —— 查花费/cost
显示当前会话累计消耗的 token 和美元。长任务中途看一眼,避免不知不觉烧超预算。
/model —— 切模型/model
弹出可选模型(Opus / Sonnet / Haiku)。新手建议:复杂重构用 Opus,日常问答用 Sonnet 省 token,简单任务用 Haiku 最便宜。/fast 可开启 Opus 的快速输出模式(不会降级到小模型)。
/doctor 与 /status —— 体检/doctor:检查安装是否正常、配置有无问题。装完第一天跑一次,排除隐患。/status:查看当前登录账号、订阅类型、版本号。/config —— 全局配置面板/config
打开设置,可改默认模型、主题、编辑器、权限默认值等。新手不必一次全懂,先记住"入口在这里"即可。
新手只需"知道有这些",进阶教程会专章讲解:
/agents:管理子代理(subagents),把大任务拆给专职代理并行处理。/hooks:配置钩子,在特定事件(如编辑前、命令前)自动触发脚本。/mcp:管理 MCP 服务器,接入外部工具与数据源。/tasks:查看后台任务(如后台运行的 agent)。/review:对当前代码改动做审查。/security-review:安全专项审查。/install-github-app + /pr-comments:与 GitHub 集成,处理 PR 评论。场景:你要给一个 Express 项目添加请求日志中间件,并重构现有路由文件。
第 1 步——只读规划(plan 模式)
按 Shift+Tab 切到 plan 模式,输入:
请阅读 @src/routes 和 @app.ts,规划如何统一加请求日志中间件,先不要改任何文件
Claude 会输出方案但不动文件。你审阅方案,觉得可行。
第 2 步——切回动手(acceptEdits)
按 Shift+Tab 切到 acceptEdits,输入:
按方案实施,新建 src/middleware/logger.ts,并在 app.ts 中挂载
Claude 自动创建和编辑文件,无需逐次确认。但若它要 npm install 依赖,仍会问你(命令执行仍受控)。
第 3 步——跑测试验证
运行测试,确认没破坏现有功能
Claude 执行测试命令(会先请求权限),你批准后看结果。
第 4 步——压缩上下文续任务
任务完成一半,发现 /cost 显示 token 已用到 70%。输入:
/compact 保留 logger 中间件的设计决策和已修改文件清单
压缩后继续下一步。
第 5 步——把成果写进记忆
输入框打:
# 请求日志中间件位于 src/middleware/logger.ts,通过 app.ts 全局挂载
下次新会话也能自动知道这个约定。
第 6 步——切换任务前清理
下一个任务是写文档,与重构无关。先让 Claude 把改动总结写入 CHANGELOG.md,然后:
/clear
干净开始新任务。
这个案例把 plan → acceptEdits → /compact → # → /clear 串成了完整工作流,正是高效用户每天在用的节奏。
sequenceDiagram
participant U as 用户
participant C as Claude Code
U->>C: Shift+Tab 切 plan 模式
U->>C: 读 @routes 规划方案(不动文件)
C-->>U: 输出方案
U->>C: Shift+Tab 切 acceptEdits
U->>C: 实施重构(自动改文件)
C-->>U: 完成 logger.ts + 挂载
U->>C: 运行测试(请求权限)
C-->>U: 测试通过
U->>C: /compact 压缩上下文
C-->>U: 142k→31k tokens
U->>C: # 写入记忆
U->>C: /clear 切换任务
/clear,上下文撑爆报错 → 换任务必清,续任务用 /compact。default,点确认点到崩溃 → 可信批量任务切 acceptEdits。plan 模式只读规划,审完再改。@ 引用 → Claude 容易读错文件,养成 @路径 习惯。/clear 前不留痕 → 重要结论先写进 CLAUDE.md 或文件,配合 2.1.191 的 /rewind 双保险。code.claude.com/docs/en/commands —— 权威的内置命令清单。code.claude.com/docs/en/cli-reference —— 所有命令行启动参数。claude.com/blog/using-claude-code-session-management-and-1m-context —— /clear//compact//rewind 的官方最佳实践,配合 1M 上下文窗口。/xxx 命令(后续教程覆盖)。| 评估维度 | 说明 |
|---|---|
| 适用训练营类型 | AI 编程入门营、开发者效率提升营、Claude Code 专项训练营(第 1 天) |
| 学员基础 | 零基础,仅需会基本终端操作 |
| 建议时长 | 2~3 小时(含动手实操) |
| 教学形式 | 讲授 30% + 跟练 70%,每个命令当场敲一遍 |
| 考核点 | 能独立完成第九节实战案例的完整工作流 |
| 前置衔接 | 安装/登录/CLAUDE.md 教程之后,权限围栏教程之前 |
| 后续衔接 | 自定义命令、Hooks、子代理等进阶主题 |
本教程是入门系列的"驾驶课"——装好车(安装)之后,教你换挡(模式)、踩刹车(中断)、看仪表(/cost//context)、规划路线(/init/plan)。掌握它,你才算真正"会上路"。
/clear、/compact、/rewind 官方最佳实践与 1M 上下文窗口使用策略。Context length exceeded 报错排查。[!tip] 51学通信知识星球 星主:爱卫生(微信:gprshome201101)——公众号「51学通信」创办者,19 年通信行业运维与讲师经验,著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书(各大电商平台有售)。 星球定位:深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域,主打运维岗位与信令分析。 当前规模:5200 篇主题 / 990 个回答,198 元/年。 加入福利:加入星球后请加爱卫生微信,拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题,另有群内分享。 AI 加持:51学通信知识星球已作为 skill 接入 WorkBuddy,使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例,做总结、找文档和 PPT 等场景全覆盖。
