Claude Code 基础使用完整指南:从启动到精通的实战手册
课程信息
-
作者:老金
-
GitHub:https://github.com/KimYx0207
-
公众号:老金带你玩AI
-
X(Twitter):老金带你玩AI
-
个人博客:https://aiking.dev
-
预计学时:4-6小时
-
难度等级:⭐ 零基础入门
-
更新日期:2026年10月3日
-
适用版本:Claude Code v2.1.270 为 2026-09-14 的历史参考;截至 2026-10-03 的新增行为按正文标注版本与官方文档
-
信息来源:官方文档 | GitHub
-
前置要求:已完成Claude Code安装
先修一个小 Bug:空任务列表为什么显示 NaN
项目看板里,完成 2 项、共 4 项,应显示 50%。可新建项目还没有任务时,页面却显示 NaN%。先用这个小问题练一遍:把错误交给 Claude,检查它改了哪里,再亲眼看到测试通过。
已装好并登录 Claude Code 后,给自己留一小段练习时间。这个样例只需要 Node.js,不需要安装 npm 依赖;先在终端运行 node --version 确认环境可用。还没有 Node.js,可以先做下一节的项目只读分析,等运行环境备好再回来。
准备两份练习文件
用编辑器新建一个空目录 course-progress-lab,把下面两份文件保存在里面。也可以从本仓库的 练习目录 复制文件。它们是本课程的虚构样例,原始代码刻意保留了 Bug。
progress.cjs:
// 教学样例:故意保留空列表时的 Bug,请按课程修复。
function progressPercent(completed, total) {
return Math.round((completed / total) * 100);
}
module.exports = { progressPercent };
progress.test.cjs:
const assert = require('node:assert/strict');
const { progressPercent } = require('./progress.cjs');
assert.equal(progressPercent(2, 4), 50, '完成一半时应为 50');
assert.equal(progressPercent(0, 0), 0, '空列表时应为 0');
assert.equal(progressPercent(4, 4), 100, '全部完成时应为 100');
assert.equal(progressPercent(1, 3), 33, '百分比应四舍五入到整数');
console.log('progress checks passed');
先看到失败,再让 Claude 修
在这个练习目录打开终端,先运行:
node progress.test.cjs
第一次出现 AssertionError 是预期现象:空列表得到 NaN,测试要求的是 0。报错中的路径和行号随你的保存位置变化。
仍在这个目录中运行 claude,把下面的任务交给它:
这个练习里,空任务列表的进度会变成 NaN。
请先读 progress.cjs 和 progress.test.cjs,运行 node progress.test.cjs 复现问题,
解释原因,再只修改 progress.cjs,把空列表的结果修成 0。
输入都是非负整数,已完成数不超过总数。
保留正常百分比和四舍五入规则,不删除测试、不加依赖、不改其他目录。
修完运行同一条命令,告诉我实际输出、改动位置和原因。
看它给出的改动和命令输出。正常情况下,空列表已经返回 0,2/4、4/4、1/3 仍分别返回 50、100、33,最后看到 progress checks passed。你也可以自己再运行一次,确认文件确实已经改好。
结果不对时,具体指出哪一步
你看见什么
接着怎么做
提示找不到 node
先处理运行环境;这是命令没能启动,还没有运行到练习代码
提示找不到 progress.test.cjs
检查终端当前目录和文件扩展名,避免保存成 .cjs.txt
Claude 说改好了,却没有测试输出
让它执行 node progress.test.cjs,报告退出结果和实际输出
空列表好了,正常进度却全变成 0
指出 2/4 必须仍为 50,要求修复正常分支后重跑测试
它删掉了空列表检查
按上面的原始测试补回这一行,继续修源码;这条检查正是问题的复现方式
现在合上任务模板,自己补一个例子:“完成 3 项、共 8 项”。先算出应该是 38,再添加检查并运行。换回真实项目时,也照这个顺序提供错误、复现方法、正确结果和允许修改的范围。
做到这里,你已经完成一次可检查的小改动。想让 Claude 下次继续遵守项目规则,再做下面的 CLAUDE.md 练习;命令表留到需要时查。工作方法参考 官方常见工作流程 和 最佳实践,样例代码由本课程编写。
本课学习目标
本章从一处小 Bug 开始,再把项目规则写进 CLAUDE.md。你可以先完成这两项,遇到具体操作问题时再查后面的命令和快捷键。
2026-06-18 操作口径:本章继续讲交互、单次执行和打印模式三条主线。v2.1.181 后,交互态、-p 和 Remote Control 都可以使用 /config key=value 这类配置入口;配置是否生效仍以本机会话里的 /status、/config 和 claude --version 为准。Fable 5 / Mythos 5 相关变化只作为可关注项,不作为本教程默认模型推荐。
2026-09-14 当前基线(v2.1.270):日常操作有几处变化。v2.1.261 起,keybindingFlavor 不再生效,词级编辑统一为 Bash 风格:Ctrl+W 删到空白,Alt+F / Alt+D 停在词尾,标点也分隔单词。已有的 /diff 在 v2.1.260 增加全屏侧栏;/output-style [name] 可列出和切换输出风格,远程与无头会话也能用。/skill-doctor 可查看哪些 Skill 没被使用及其上下文占用。在 /effort 选择器里按 s 只改本次会话;这不是输入 /effort s。待办工具自 v2.1.233 起已对部分新模型默认关闭,v2.1.268 又明确了默认提供的模型范围;需要时设 CLAUDE_CODE_ENABLE_TODO_TOOLS=1。全屏下 Ctrl+L / Cmd+K 曾用于清除转录视图,但 v2.1.280 已撤回这一行为;当前按键只重绘屏幕,保留输入和会话历史。v2.1.270 修复了长会话里只读 Git 命令意外请求权限的问题。来源:官方 changelog。
完成本课学习后,你将能够:
-
理解三种启动形式:掌握空白交互会话、带初始问题的交互会话和非交互打印模式
-
熟练使用交互模式:掌握REPL对话窗口的完整操作技巧
-
按任务查找 Slash 命令:知道何时查看状态、继续会话、调整权限和检查改动
-
掌握快捷键操作:提升工作效率的键盘技巧
-
配置个性化环境:根据项目需求定制Claude Code
-
独立排查问题:使用诊断命令解决大多数常见问题
先做一个15分钟实操:写出第一份 CLAUDE.md
这章很长,但新手不需要先背命令表。先做一件最有价值的事:让 Claude Code 读懂你的项目规则。
CLAUDE.md 是 Claude Code 的项目说明书。它不只是备注文件,而是你告诉 Claude “这个项目怎么工作、怎么验证、哪些地方不要乱动”的地方。
如果仓库已经有 AGENTS.md,先检查现有规则,不必立刻再建一份重复文件。v2.1.277 起,当前目录及其上级没有 CLAUDE.md 或 CLAUDE.local.md 时,Claude Code 默认改读 AGENTS.md;v2.1.281 又补齐了第三方部署和关闭遥测时的支持。有两类文件同时存在时,默认只读 CLAUDE 系列;要读两者,可在 /config 的 Project instructions 中选择,或由 CLAUDE.md 显式导入 AGENTS.md。详见官方项目规则。
规则多了以后,旧命令、失效路径和互相矛盾的要求容易留下来。v2.1.283 起,可以在会话中运行 /doctor prompt-audit,让 Claude 检查项目指令以及 rules、Skills、commands、子代理和输出风格;也可以加具体路径,例如 /doctor prompt-audit .claude/skills/deploy。它先给问题与修改建议,只有你要求应用才会改文件;关闭捆绑的 /claude-api Skill 时,这个入口不可用。详见官方指令审计说明。
第一步:进入你的项目目录并启动 Claude Code
cd 你的项目目录
claude
如果你只是想在当前仓库练习,也可以直接在本教程仓库里启动。
第二步:让 Claude 先只读分析项目
在 Claude Code 里输入:
阅读这个项目,告诉我:
1. 这个项目是做什么的
2. 常用安装、启动、测试命令是什么
3. 哪些目录或文件最重要
4. 你建议写进 CLAUDE.md 的项目规则是什么
不要修改文件。
这一步的目的不是让 Claude 写代码,而是让它先建立项目地图。
第三步:创建最小可用的 CLAUDE.md
在项目根目录创建 CLAUDE.md,先写成这样:
# CLAUDE.md
这份文件约束 Claude Code 在本项目里的工作方式,用来减少常见的 AI 编程失误。你可以在此基础上继续补充项目专属规则。
参考来源:https://github.com/forrestchang/andrej-karpathy-skills/blob/main/CLAUDE.md
取舍说明:这些规则更偏向谨慎和可验证,而不是最快完成。遇到很小的简单任务时,可以按实际情况简化流程。
## 项目背景
开始修改前,先阅读 README、配置文件和目录结构,确认项目目标、技术栈和关键目录;不要凭经验猜。
## 常用命令
只使用本项目已经声明的命令。优先从 README、`package.json` scripts、Makefile、`pyproject.toml`、`Cargo.toml`、CI 配置中确认。
不要把示例命令写成项目事实;没有确认过的命令不要写进本文件,也不要留下占位文本。
## 1. 写代码前先想清楚
不要假装已经理解,也不要把不确定性藏起来。该说清楚的地方先说清楚。
开始实现前:
- 明确写出你的假设;不确定就问。
- 如果需求存在多种理解,把几种理解列出来,不要悄悄选一个。
- 如果有更简单的做法,要主动说明。
- 该反对时要反对;发现需求不清楚,就停下来指出哪里不清楚。
## 2. 简单优先
只写解决当前问题所需的最少代码,不做猜测式扩展。
- 不添加用户没有要求的功能。
- 不为只用一次的代码设计抽象层。
- 不加入没有被要求的灵活性、配置项或扩展点。
- 不为不可能出现的场景堆错误处理。
- 如果 200 行能改成 50 行,就回头简化。
自检问题:资深工程师看到这段实现,会不会觉得过度设计?如果会,就删减。
## 3. 外科手术式修改
只碰必须修改的地方。只清理自己造成的问题。
编辑已有代码时:
- 不顺手“优化”旁边的代码、注释或格式。
- 不重构没有坏的部分。
- 匹配项目现有风格,即使你个人会用另一种写法。
- 发现无关的废代码可以提一句,不要直接删除。
如果你的改动制造了无用内容:
- 删除由本次改动造成的无用 import、变量、函数。
- 不删除本来就存在的死代码,除非任务明确要求。
检查标准:每一行改动都应该能追溯到用户这次请求。
## 4. 目标驱动执行
把任务转成可验证的目标,然后循环到验证完成。
示例:
- “加校验” -> “先写非法输入测试,再让测试通过”
- “修 bug” -> “先写复现 bug 的测试,再修到测试通过”
- “重构 X” -> “重构前后都确认测试通过”
多步骤任务先写简短计划:
```text
1. [步骤] -> 验证:[检查方式]
2. [步骤] -> 验证:[检查方式]
3. [步骤] -> 验证:[检查方式]
清晰的成功标准能让你独立推进;含糊的标准,比如“让它能用”,会导致反复追问。
安全边界
- 不读取、打印或提交
.env*、密钥、Token、证书等敏感信息。 - 不编辑生成文件、构建产物或锁文件,除非任务明确要求。
- 不新增依赖,除非已经说明理由并获得确认。
验收标准
- 每一处改动都能对应到本次需求。
- 没有新增无关依赖、无关文件或无关重构。
- 修改源码后运行相关测试、lint 或 build。
- 如果验证命令不存在、失败或耗时过长,要说明原因和替代检查方式。
- 最终回复说明:改了什么、验证了什么、还剩什么风险。
这些规则生效时应该看到
- diff 里无关改动更少。
- 因为过度复杂而返工的次数更少。
- 澄清问题发生在动手前,而不是出错之后。
- 每次修改都有明确验证方式。
创建正式 CLAUDE.md 前,先让 Claude 根据第二步的分析输出完整版本。命令必须来自项目文件或你亲自确认;没有确认的命令整行删除,不要留空、不要写占位。
### 第四步:验证 CLAUDE.md 是否生效
开启一个新会话,输入:
请根据 CLAUDE.md 总结这个项目的工作规则。不要修改文件。
如果 Claude 能说出项目用途、常用命令和工作规则,就说明这份 CLAUDE.md 已经开始发挥作用。
### 你刚完成了什么
- 让 Claude Code 先读项目,而不是直接乱改。
- 写出第一份项目级指令文件。
- 建立了“先读规则、再动手、最后验证”的基本工作流。
后面的命令、快捷键、会话管理都建立在这个基础上。没有 CLAUDE.md,Claude Code 很容易变成一次性问答工具;有了它,才更像一个能长期协作的项目助手。
---
## 学习路径导航(先看这里!)
根据你的情况选择学习路径:这是一篇长教程,不用全看!根据你的目标选择路径。
### 路径A:先完成一次小改动
适合人群:急着体验Claude Code,想快速跑起来
只看这些章节(其他跳过):
✅ 先修一个小 Bug:复现空列表错误,修复后重跑测试
✅ 再写第一份 CLAUDE.md:把真实项目的运行方式和约束留下来
完成后你能带走:一份修好的练习代码、一条能重复运行的检查命令,以及自己的项目规则。安装和登录时间另计。
---
### 路径B:完整学习(4-6小时)
适合人群:想系统掌握所有功能,成为Claude Code高手
学习顺序:从头到尾所有章节
建议分段学习:
- 第1天(2小时):第1-3部分(简介+快速开始+交互模式)
- 第2天(1.5小时):第4部分(Slash命令大全)
- 第3天(1小时):第5-6部分(快捷键+最佳实践)
- 第4天(0.5小时):第7部分(FAQ)
---
### 路径C:问题速查(5分钟)
适合人群:使用中遇到问题,需要快速解决
直接跳到:
🔧 第七部分:FAQ - 20个常见问题解答
🔧 /doctor命令 - 系统诊断(第4.8节)
使用方法:
1. 按 Ctrl + F 搜索你的问题关键词
1. 找到对应的Q&A
1. 按步骤解决
---
### 路径D:专项学习(30-60分钟/主题)
适合人群:已经会基础命令,想深入某个功能
想学什么
看哪几节
预计时间
Checkpoint回退
第4.4节
30分钟
Extended Thinking
第4.3节
30分钟
会话管理
第4.5节
20分钟
快捷键速查
第五部分
15分钟
省钱技巧
FAQ Q10
10分钟
---
## 术语表(小白必读)
在开始之前,先了解这些关键术语。用生活类比帮助理解:
术语
英文全称
通俗解释
生活类比
CLI
Command Line Interface
命令行界面,通过打字操作电脑
发短信指挥别人干活
交互模式
Interactive Mode
可以连续对话的模式,AI记住上下文
打电话聊天(可以连续说很多轮)
REPL
Read-Eval-Print-Loop
交互模式的技术称呼,读取-执行-打印-循环
你说一句AI回一句,不停循环
打印模式
Print Mode
非交互运行,默认输出文本,也支持 JSON 等格式
把结果交给脚本继续处理
Slash命令
Slash Commands
以"/"开头的特殊命令
微信的"@某人",快速触发功能
Token
-
AI处理文字的计费单位
打的士按公里计费,AI按Token计费
Checkpoint
-
检查点,代码和对话的存档点
游戏存档,随时可以读档重来
Rewind
-
回退到之前的检查点
游戏读档
Compact
-
压缩对话历史,节省Token
整理房间,扔掉不重要的东西
Extended Thinking
-
扩展思考模式,让AI深度分析
让AI写解题过程,不只是答案
MCP
Model Context Protocol
让Claude连接外部工具的插件系统
手机安装App,扩展功能
---
## 第一部分:基础使用简介
### 1.1 什么是Claude Code
一句话理解:Claude Code是Anthropic公司开发的AI编程助手命令行工具,让你在终端里直接和AI对话写代码。
生活类比:
- 传统编程:你一个人在厨房做菜,从买菜到炒菜全得自己来
- 用Claude Code:请了一个厨师助手,你说"做宫保鸡丁",他帮你查菜谱、准备食材、甚至直接帮你炒
### 1.2 三种使用模式对比
Claude Code提供三种使用模式,适合不同场景:
模式
启动方式
特点
适用场景
生活类比
交互模式
claude
连续对话,保持上下文
日常开发、复杂任务
打电话聊天
带初始问题的交互会话
claude "prompt"
先发送问题,随后仍可继续对话
带明确任务进入项目
接通后先说明来意
打印模式
claude -p "prompt"
非交互运行并退出;默认文本,可选 JSON / stream-json
管道处理、脚本任务
输出交给下一步处理
选择决策树:
你要做什么?
│
├── 需要多轮对话?
│ ├── 是 → 交互模式 (claude)
│ └── 否 ↓
│
├── 需要在脚本中使用?
│ ├── 是 → 非交互打印模式 (claude -p "prompt")
│ └── 否 ↓
│
└── 需要把输出传给其他命令?
├── 是 → 打印模式 (claude -p "prompt")
└── 否 → 交互模式 (claude)
### 1.3 为什么要学CLI版本
很多人问:"不是有VS Code插件吗?为什么学命令行?"
CLI 适合把任务写进脚本、管道和 CI,也能在服务器终端中运行。IDE 扩展适合在编辑器里查看上下文、diff 和权限提示;VS Code 扩展还支持远程开发场景,不能简单写成“必须在服务器上有图形界面”。
学习 CLI 的价值是掌握命令、输入输出和执行目录,便于组合自动化。需要编辑器界面时再选扩展,两种入口可以结合使用,具体功能和前置条件见官方 VS Code 指南。
先核对编辑器送出的上下文:VS Code 会把选中的文本加入消息,还会显示当前打开的文件。只想附上选中文本时,在 VS Code 设置中搜索 Claude Code: Attach Open File 并关闭;选中文本仍会附上,所以发送前也要检查选区。想让 Claude 排查编辑器报错,可以先打开 Problems 面板,再在聊天中说“读取当前 Problems,说明错误原因,先不要修改文件”。v2.1.285 起,面板里的 Claude 能按需读取当前诊断,不必等它先编辑文件。
重载窗口也可能继续执行:如果窗口重载中断了某一步,会话恢复后可能自动继续,并在聊天中显示提示。需要自己决定何时继续时,在 VS Code 设置中搜索 Claude Code: Continue After Reload 并关闭。中断已超过一小时,或会话正在别处打开时,恢复后会保持空闲。详见官方上下文与恢复说明。
在 VS Code 中查看和停止后台任务:扩展里的 Stop 按钮或 Esc 从 v2.1.286 起只结束当前轮,已经在后台运行的 Agent 会继续工作。如果要停止它们,在聊天输入框输入 /tasks 打开 Agent Map,再逐个打开任务卡片并点 Stop;这个任务入口从 v2.1.277 起可用。
从 v2.1.287 起,正在执行的命令或子代理下方还会出现 Run in background:命令运行约两秒后出现,子代理一启动就可用。点击后 Claude 会继续当前轮,任务在后台运行,完成时会通知 Claude。再输入 /tasks,点击后台命令或 Monitor 的卡片,可以查看持续刷新的最新输出并停止任务。这里讲的是 VS Code 扩展的操作;其他入口的停止行为要按各自说明核对。详见官方后台任务操作。
---
## 第二部分:5分钟快速开始
本节目的:用最快速度完成第一次对话,让你立即看到效果!
⏱️ 预计时间:5分钟
### 2.1 第一次启动Claude Code
#### 步骤1:打开终端
Windows系统:
- 按 Win + R,输入 cmd 或 powershell,回车
- 或:在开始菜单搜索"终端"或"PowerShell"
macOS系统:
- 按 Cmd + Space,输入 Terminal,回车
- 或:打开"应用程序" → "实用工具" → "终端"
Linux系统:
- 按 Ctrl + Alt + T(大多数发行版)
- 或:从应用菜单找到"终端"
#### 步骤2:进入项目目录
Windows
cd C:\你的项目路径
macOS/Linux
cd ~/你的项目路径
如果没有项目,先用编辑器创建空目录 test-claude,再在该目录打开终端。Windows PowerShell 5.1 不支持 Bash 示例中的 &&,跟练时分别执行创建和进入目录的命令。
#### 步骤3:启动Claude Code
claude
检查启动结果:客户端应显示可输入任务的提示区。用 /status 核对当前工作目录、模型和认证,再发一条任务;版号、提示符和排版随版本变化,不必寻找旧示意里的 You: 光标。能打开界面不等于模型请求已经成功。
### 2.2 第一次对话
试着输入:
You: 你好,介绍一下你自己
下面是教学用回复示意;实际措辞以你的会话为准:
你好!我是Claude Code,Anthropic开发的AI编程助手。
我可以帮你:
- 编写和修改代码
- 解释代码逻辑
- 修复Bug
- 重构项目
- 搜索文件
- 运行命令
...
有什么我可以帮助你的吗?
完成第一次对话后,进入下一步。
### 2.3 验证Claude Code正常工作
运行这个测试:
You: 创建一个hello.py文件,内容是打印"Hello Claude Code"
检查结果:
1. 当前模式或已有规则可能允许直接写入,也可能出现权限提示;需要提示时先核对路径和内容,再处理。
1. 在编辑器中确认 hello.py 实际存在,内容与任务相符。
1. 如果只返回了代码而未创建文件,让 Claude 说明是否执行了文件工具以及遇到了什么限制。
验证文件已创建:
在终端中查看
cat hello.py
预期输出:
print("Hello Claude Code")
### 2.4 退出Claude Code
输入以下任一命令退出:
You: /exit
或在输入框为空时用 Ctrl+D,按提示再次按键确认退出;Ctrl+C 在空闲时先清空输入,再按一次退出。Windows 不需要使用 Ctrl+Z 加回车。
---
## 第三部分:交互模式详解
本节目的:深入掌握交互模式(REPL)的所有技巧
⏱️ 预计时间:45分钟
### 3.1 交互模式是什么
交互模式(Interactive Mode)是Claude Code的核心使用方式,也叫REPL模式。
REPL是什么意思:
R = Read 读取你输入的内容
E = Eval 处理你的请求
P = Print 打印AI的回答
L = Loop 循环等待下一个输入
类比:就像微信聊天,你说一句,对方回一句,可以一直聊下去。
### 3.2 启动选项详解
#### 基本启动
最简单的启动
claude
先进入要操作的项目目录,再启动
cd /path/to/your/project
claude
#### 常用选项
选项
简写
作用
适用场景
--dangerously-skip-permissions
无
跳过大多数权限确认
已做好隔离的受控环境
--verbose
无
显示详细日志
调试问题
--model <name>
无
指定AI模型
需要特定模型
--continue
-c
恢复最近会话
继续昨天的工作
--resume <id>
-r
恢复指定会话
恢复特定对话
实用组合:
希望跟练时手动查看权限提示,从 Manual 开始
claude --permission-mode default
调试模式(看到所有细节)
claude --verbose
恢复最近的会话
claude -c
使用Opus模型(更强但更贵)
claude --model claude-opus-4-8
在独立工作树中启动(并行任务互不干扰)
claude --worktree
或简写
claude -w
💡 Worktree 模式(v2.1.49+ 新增):--worktree(-w)是 2026年2月新增的重要参数。它会自动创建一个独立的 Git Worktree,让你可以同时运行多个 Claude Code 实例,每个实例在自己的工作目录中独立工作,互不干扰。适合并行开发多个功能、边修 bug 边开发新特性等场景。使用前需要将 .claude/worktrees/ 添加到 .gitignore。
#### 用于脚本的裸模式:--bare
如果一次脚本调用只需要给定文件和提示,不想加载机器上或项目里的 Hooks、Skills、插件、子代理、MCP、自动记忆与 CLAUDE.md,可以使用裸模式。先进入有 README.md 的项目,并准备好 API 或提供商认证,再运行:
claude --bare -p "只读取 README.md,用三句话概括项目用途。" --allowedTools Read --permission-mode default
裸模式不读取订阅登录的 OAuth 凭据或系统钥匙串。Anthropic API 需要启动环境中的 ANTHROPIC_API_KEY,或在 --settings 中提供 apiKeyHelper;Bedrock、Google Cloud Agent Platform 和 Foundry 仍按自己的认证方式工作。它走相应 API 计费,不是复用订阅登录。
需要的资源必须明确给出,例如 --mcp-config、--plugin-dir、--agents 或系统提示参数。--add-dir 有一个例外:其 .claude/skills/ 仍会加载,但 commands 和 agents 不会因此加载。
从 v2.1.286 起,裸模式只连接命令行明确传入的 MCP,不添加通常的系统提醒,也不运行后台任务;shell 达到超时会停止,不能自动转到后台。--bare 减少自动加载,不提供操作系统隔离;认证、工具权限和工作目录仍要明确。详见官方裸模式说明。
### 3.3 快速输入技巧
#### 快捷输入符号
Claude Code支持两个特殊的输入前缀:
前缀
作用
示例
@
文件路径自动补全
@src/app.js
!
直接执行bash命令
! npm test
💡 关于记忆管理:如需将项目规范写入记忆(CLAUDE.md),请使用 /memory 命令,它会打开 CLAUDE.md 供你编辑。
示例:
引用文件让Claude分析
You: 分析 @src/components/Button.tsx 的代码结构
直接运行命令(不用Claude执行)
You: ! git status
添加项目规范到记忆(使用 /memory 命令)
You: /memory
#### 多行输入
有时候需要输入多行内容(比如粘贴代码块):
方法
快捷键
说明
反斜杠换行
\ + Enter
所有终端通用
macOS默认
Option + Enter
macOS默认
终端设置后
Shift + Enter
运行 /terminal-setup 配置
控制序列
Ctrl + J
换行符
直接粘贴
粘贴代码块
自动识别多行
示例:
You: 帮我分析这段代码:
function add(a, b) {
return a + b;
}
### 3.4 对话管理技巧
#### 何时清空对话
用 /clear 的场景:
- 完成一个任务,要开始完全不同的新任务
- 对话太长,影响响应速度
- 想要"干净"的起点
不要用 /clear 的场景:
- 还在解决同一个问题
- 需要参考之前的讨论
- 任务还没完成
#### 何时压缩对话
用 /compact 的场景:
- Token使用接近上限(用 /context 查看)
- 响应变慢但还需要上下文
- 想省钱但保留关键信息
对比:
命令
效果
保留内容
Token节省
/clear
开一个空对话;旧会话仍可恢复
项目指令等启动上下文仍会加载
没有固定节省比例
/compact
总结较早历史,继续当前任务
摘要和保留的上下文
取决于已有历史与摘要
---
## 第四部分:Slash命令大全
本节目的:掌握30+个Slash命令的使用
⏱️ 预计时间:60分钟
📌 使用位置:本章默认在交互会话里输入 slash 命令。部分命令也支持 -p 或 Remote Control,部分功能依赖账号和平台;不能把它们一律当作交互专属。
### 4.1 基础控制命令
#### /help - 显示帮助
作用:显示所有可用命令列表
You: /help
预期输出:
Available Commands:
/help Show this help
/exit Exit interactive mode
/clear Clear conversation history
/compact Compact conversation
...
什么时候用:
- 忘记命令名称时
- 想知道有哪些可用命令
- 学习新功能
---
#### /exit - 退出交互模式
作用:退出Claude Code,回到命令行
You: /exit
输入框为空时,可用 Ctrl+D 并按提示确认退出
或在空闲时按 Ctrl+C 清空输入,再按一次退出
退出前记得保存重要对话(用 /export 命令)!
---
#### /clear - 清空对话历史
作用:启动一个新的空对话,方便切换到无关任务。项目指令等启动上下文仍会加载;旧会话保留,可以用 /resume 恢复。
/clear
这不是删除磁盘上所有对话的命令,也不代表后续任务不消耗 Token。
---
#### /compact - 压缩对话历史
作用:压缩对话,保留关键信息,节省Token
/compact
压缩后的摘要和上下文占用以实际会话为准。本教程没有测得固定45%的减少比例;重要约束仍需要检查是否保留。
带指令压缩:
告诉Claude保留什么
You: /compact 保留所有关于数据库设计的讨论
---
### 4.2 上下文管理命令
#### /context - 可视化上下文使用
作用:用彩色网格显示Token使用情况
You: /context
预期输出:
Context Usage Visualization:
████████████░░░░░░░░ 60% (120K / 200K tokens)
Breakdown:
- User messages: 45K
- Claude responses: 60K
- Code context: 15K
Recommendation: Context usage healthy
什么时候用:
- 想知道还能聊多少轮
- 对话很长时检查是否需要压缩
- 了解Token主要用在哪里
---
#### /cost - 显示会话成本
作用:查看当前会话的费用与用量相关信息。
历史说明:v2.1.92 曾增补订阅用户的模型与缓存拆分。当前官方命令参考已将 /cost 和 /stats 列为 /usage 的别名;用量界面随版本、认证和计划变化,不要照旧菜单推算固定配额。详情见官方命令参考。
You: /cost
---
#### /model - 切换AI模型
作用:在会话中切换不同的AI模型
You: /model
预期输出:
Available Models:
- claude-sonnet-5 (current)
- claude-opus-4-8
- claude-haiku-4-5-20251001
Select model (1-3):
直接指定模型:
You: /model claude-opus-4-8
快捷键切换:
- macOS:Option + P
- Windows/Linux:Alt + P
模型怎么选:
模型家族
通常适合的任务
选择前检查
Haiku
简单查询、快速处理
当前可用型号与供应商价格
Sonnet
日常开发、代码审查
具体版本的能力、上下文和输出限制
Opus
复杂调试、架构分析
成本、延迟以及当前会话的上下文窗口
上下文和最大输出取决于具体型号、供应商与客户端版本,不能给整个家族写一个固定上限。当前 Sonnet 5 / 5.5 具有原生 1M 上下文;sonnet[1m] 对已经使用这些型号的会话不会再扩大窗口。其他部署的别名可能仍指向较早版本。用 /model 确认实际模型、/context 查看会话,再对照官方模型配置与具体型号说明。窗口大也不代表仓库会自动全部读入,应先给出相关文件与任务范围。
#### /autocompact:设置自动压缩窗口
窗口够大,但你的网关只接受200K输入时,先核对网关能力,再缩小自动压缩窗口;不要等到每次请求都报“Prompt is too long”。
/autocompact 200k
/autocompact
/autocompact auto
第一条设置当前模型的窗口,第二条查看,第三条回到该模型的自动值。v2.1.288 起,设置会按模型保存到用户配置,切换模型后各自保留;更高优先级的组织设置仍可能覆盖实际生效值。这里调的是何时压缩,不会把模型本身的上下文扩大。
v2.1.285 起,自定义 ANTHROPIC_BASE_URL 后面的已识别大窗口模型也可能使用1M窗口;v2.1.287 又让第三方部署的 Opus 4.7+ 和 Fable 默认使用1M,不再要求 [1m] 后缀。是否适合仍以具体模型和网关为准;需要保留200K行为时,核对 CLAUDE_CODE_DISABLE_1M_CONTEXT=1。详见官方窗口设置。
---
#### /voice - 语音输入
语音输入把你的话转成提示框里的文字,可以和打字一起使用。先确认当前使用 claude.ai 账号认证,并有本地麦克风;直接 API key、Bedrock、Google Cloud Agent Platform、Foundry、云会话和 SSH 会话不支持这个转写服务。WSL 需要 WSLg。录音会发送到 Anthropic 服务器转写,不是在本机离线识别。
先用默认的按住录音模式:
/voice hold
1. 按住空格,等界面显示正在收音后说话。
1. 松开空格,转写文字会插到当前光标处。默认不会发送,先检查、修改,再按 Enter 提交。
1. 需要追加一句时,再按住空格录音。Esc 或 Ctrl+C 取消当前录音并还原录音前的提示内容。
1. 完成后用 /voice off 关闭语音输入;说出“exit”不是关闭模式的专用指令。
需要点按录音时:执行 /voice tap。提示框为空时点一下空格开始,再点一下停止;转写达到至少三个词时自动提交,较短内容只插入提示框。hold 模式也能在 settings 的 voice 对象中设 autoSubmit: true,转写达到至少三个词时自动提交,但初次练习建议先检查文字再发送。
改录音按键:在 ~/.claude/keybindings.json 的 Chat 绑定中设置 voice:pushToTalk,例如:
{
"bindings": [{
"context": "Chat",
"bindings": {
"meta+k": "voice:pushToTalk",
"space": null
}
}]
}
如果已有按键配置,合并这项绑定,不要覆盖整个文件。这里不是 settings.json 的 voice.pushToTalk 字段。具体按键能否被终端传入,也要看当前终端与操作系统。
语音语言随 language 设置,在 /config 中选择。当前官方支持列表列了英语、日语等20种语言,未列中文;设置不在列表中的语言时会提示并回退到英语。不要把中文文本回复可用等同于中文语音转写受支持。首次使用还可能需要给终端授权麦克风。完整条件见官方语音输入指南。
---
#### /effort - 推理深度控制 🆕
作用:调整Claude的"思考深度",在速度和质量之间取舍
一句话理解:就像考试答题——low是快速选择题模式,xhigh是深度论述题模式。
常用设置方式:
方式1:交互式斜杠命令(支持交互式滑块)
/effort
方式2:直接指定级别
/effort xhigh
方式3:CLI 参数
claude --effort xhigh
方式4:环境变量
CLAUDE_CODE_EFFORT_LEVEL=xhigh claude
方式5:重置为自动判断
/effort auto
Ultracode 是独立开关。 v2.1.284 起,它不再强制把 effort 设为 xhigh,可以在当前强度下开启或关闭:
/effort ultracode on
/effort ultracode off
在 /effort 的界面中也可以按 Tab 切换。它让 Claude 自行决定是否使用动态工作流,不是第六个推理强度;这两条命令保留当前 effort。没有权限、模型或功能支持时,以当前界面和官方命令参考为准。
五级对比(v2.1.105-113 起新增 xhigh 和 max):
级别
符号
速度
Token消耗
适用场景
low
○
最快
最少
简单问答、格式转换、快速查询
medium
◐
中等
中等
日常开发、代码修改
high
●
较慢
较多
架构设计、复杂调试
xhigh
◉
较高推理投入
按任务与实际模型用量判断
深度推理任务,模型须支持
max
⬤
最慢
最多
极限推理,关键决策
💡 选择前先看模型:当前官方默认 effort 随模型而不同,支持等级也不同。用 /effort 查看实际选择,用 /effort auto 清除这个模型的已保存选择;不要把旧版本的 xhigh 推荐当所有模型的默认。当前等级可在会话标题或提示中查看。
💡 Hook 联动:从 v2.1.121 起,Hook 脚本可以通过 $CLAUDE_EFFORT 环境变量感知当前 effort 等级,据此调整检查策略(如 xhigh 时跳过轻量检查)。
---
#### Auto Memories - 自动记忆 🆕
作用:Claude Code自动记录和回忆跨会话的重要信息
一句话理解:就像一个"自动笔记本"——Claude会把重要发现自动记下来,下次对话时自动翻阅。
工作原理:
1. Claude在工作中发现重要信息(如项目偏好、常见问题解法)时,自动写入memory文件
1. 新会话开始时,自动加载相关记忆到上下文
1. 新会话加载 MEMORY.md 的前200行或前25KB,以先达到的限制为准;其他主题文件按需读取
配置方式:
默认每个仓库有独立的自动记忆目录。只有需要自定义存放位置时才设置 autoMemoryDirectory;多个项目使用同一固定目录会共享这些记忆,不能照抄而以为仍按项目隔离。
{
"autoMemoryDirectory": "~/.claude/memory/"
}
记忆文件格式:
- MEMORY.md 是索引,其他文件保存具体记忆,名称由内容和当前实现决定
- Markdown 内容可能含 frontmatter;时间戳可以写在元数据里,不保证出现在文件名中
- 可手动编辑或通过 /memory 命令管理
要改变自动记忆的开关,在前台会话打开 /memory 后按界面选择。v2.1.285 起,后台会话或 Claude 自己的工具启动的会话不能把 Auto-memory 打开;在这些会话里仍可以关闭。遇到无法开启时,回到自己从终端直接启动的前台会话操作,不要反复让后台代理改开关。
💡 怎么理解这两个名称:/memory 是查看、编辑记忆及管理自动记忆开关的入口;Auto Memories 是 Claude 自动记录的机制。你可以从同一个入口查看它记下了什么,再决定要不要保留或继续自动记录。
---
### 4.3 Extended Thinking(扩展思考)
Extended Thinking 是模型回答前的推理过程。需要多少推理取决于模型、任务和 effort 设置,不能从一组提示词推算固定的 token 数或耗时。
怎么调整:
- 在支持切换的模型上,macOS 用 Option+T,Windows / Linux 用 Alt+T;Tab 用于补全或权限提示中的评论入口。
- 用 /effort 选择当前模型支持的等级;始终启用推理的模型不受上述开关影响。
- 偶尔需要更深入分析,可以在提示词里写 ultrathink。当前实现会增加本轮的推理指令,不会改变发往 API 的 effort 等级。
- think、think hard 等普通表达可以说明你的需求,但没有固定的“1,500 / 3,000 / 8,000 tokens”预算映射。
遇到复杂问题时,先写清约束和验收条件,再调整 effort。模型输出的解释也不能替代运行测试和检查结果。
---
### 4.4 Rewind/Checkpoint(回退功能)
Claude Code 2.0 的重要功能,让你大胆实验!
#### 什么是Checkpoint
一句话理解:Checkpoint(检查点)就像游戏存档,Rewind(回退)就是读档。
类比:
- 没有Checkpoint:打游戏不存档,失败从头开始
- 有Checkpoint:随时存档,失败了读档重来
核心价值:
- 大胆尝试重构,随时可以回退
- 不仅回退代码,还能清理"被污染"的AI对话状态
- 和 Git 配合:Checkpoint 处理对话与文件工具改动,Git 保存你决定保留的版本
#### 如何使用Rewind
方法1:双击Escape键(最快)
在交互模式中快速按两次Escape键
[按 Esc + Esc]
会弹出Rewind菜单:
╭─────────────────────────────────────────╮
│ Rewind Menu │
├─────────────────────────────────────────┤
│ Select a checkpoint to rewind to: │
│ │
│ [1] 10:30:15 - Initial state │
│ [2] 10:32:45 - Added auth module │
│ [3] 10:35:20 - Modified database.py │
│ [4] 10:38:10 - Created new tests │
│ │
│ [c] Cancel │
╰─────────────────────────────────────────╯
方法2:/rewind命令
You: /rewind
显示可用的检查点列表,选择要回退到的点
#### 恢复选项与对话摘要
选择检查点后,可以恢复代码、对话或两者;当前菜单还支持对较早内容做摘要。具体选项见官方 Checkpoint 文档,先核对影响范围再确认。
选项
效果
适用场景
仅恢复对话
保留代码改动,重置AI上下文
AI理解错了,但代码改对了
仅恢复代码
保留对话历史,回退文件修改
代码改错了,但讨论有价值
同时恢复
代码和对话都回到之前状态
完全走错方向,从头来
快速决策表:
代码对吗?
对话有用吗?
选哪个?
对
不对
仅恢复对话
不对
有用
仅恢复代码
不对
没用
同时恢复
都对
都对
按Cancel
#### 重要限制
Critical:Checkpoint只追踪Claude的文件编辑工具(Write、Edit),不追踪bash命令修改!
会被追踪:
You: 修改src/app.py文件
Claude用Edit工具修改 → ✅ 会创建checkpoint
不会被追踪:
You: ! mv src/old.py src/new.py
bash命令修改 → ❌ 不创建checkpoint
最佳实践:
- 重要操作让Claude用文件工具修改
- 配合Git使用保护bash命令的修改
---
### 4.5 会话管理命令
#### /resume - 恢复会话
作用:恢复之前的对话会话
命令行快速恢复最近会话
$ claude -c
$ claude --continue
恢复指定会话
$ claude -r ses_abc123
$ claude --resume ses_abc123
交互模式中恢复
You: /resume
显示最近会话列表:
Recent Sessions:
─────────────────────────────────────────────────────
ID Date Project Summary
─────────────────────────────────────────────────────
ses_abc123 Today 10:30 my-app Auth module
ses_def456 Today 09:15 my-app Bug fixes
ses_ghi789 Yesterday other-project API design
─────────────────────────────────────────────────────
什么时候用:
- 每天早上恢复昨天的工作
- 电脑重启后继续
- 在多个项目间切换
后台会话也可以接着处理:先用终端中的 claude agents 取得实际会话 ID,再执行 claude --resume <实际ID> 打开它;不要照抄上面的示意 ID。v2.1.285 起,这会打开仍在后台运行的会话,而不再直接拒绝;如果同时给出 claude --resume <实际ID> "补充要求",这条消息会作为它的下一轮输入,不会中断正在执行的这一轮。
---
#### /export - 导出对话
作用:把当前对话导出为纯文本文件
打开导出对话框:复制到剪贴板或保存到文件
You: /export
直接保存到指定文件
You: /export ./notes/auth-session.txt
版本校准(2026-04):官方命令参考当前写法是 /export [filename],用途是导出当前对话为 plain text。会话内的 /export --format json、/export --format html 不是当前支持的 slash 参数;在 Claude Code 2.1.92 / 2.1.107 这类版本里输入这些参数,通常仍会按普通文件名/文本导出处理。
需要结构化输出时:
非交互 print 模式支持 JSON / stream-json 输出
claude -p "总结当前项目结构" --output-format json
claude -p "检查代码并输出流式事件" --output-format stream-json --verbose
--output-format 是 CLI print 模式参数,不是会话内 /export 的格式参数。
---
#### /rename - 重命名会话
作用:给当前会话起个好名字,方便以后查找
You: /rename auth-module-implementation
预期输出:
✓ Conversation renamed
命名建议:[项目]-[功能]-[版本],如 my-app-login-api
---
### 4.6 项目配置命令
#### /init - 初始化项目配置
作用:创建CLAUDE.md配置文件,告诉Claude项目信息
You: /init
Claude会分析项目并创建CLAUDE.md
Analyzing project structure...
Creating CLAUDE.md...
CLAUDE.md created with:
- Project type: React + TypeScript
- Key files identified
- Coding conventions detected
---
#### /memory - 编辑记忆文件
作用:打开CLAUDE.md进行编辑
You: /memory
会打开编辑器让你修改CLAUDE.md
添加项目规则:
直接编辑相应 CLAUDE.md,或让 Claude 把已经确认的规则写入该文件,再检查 diff。# 快速记忆前缀已不是当前支持的输入入口,不能把以 # 开头的一句话当成自动保存命令。
---
#### /permissions - 管理权限
作用:查看和修改Claude的权限设置
You: /permissions
显示当前权限设置
Current Permissions:
File Operations:
✓ Read files in project
✓ Write files (with confirmation)
✗ Delete files
Bash Commands:
✓ Safe commands (git status, npm test)
⚠ Dangerous commands (require confirmation)
权限模式切换(Shift + Tab):
常用模式包括下表。CLI 中 Shift+Tab 从 Manual(配置值 default)经过 acceptEdits、plan;可用时还会加入 auto。bypass 只有被显式启用后才进入循环,不能把它当成默认可选项。
Windows 用户还要留意整工具禁用:如果 deny 规则禁用的是整个 Bash 工具,PowerShell 工具也会关闭,Claude 就没有 shell 工具了。v2.1.287 起,启动时会对此显示警告。看到警告时先用 /permissions 检查是哪条规则造成的,再按组织策略处理;不要为了恢复 shell 直接清空 deny 规则。禁用整个工具和只限制某些命令是不同范围。官方依据见该版本的 Windows 启动警告。
模式
行为
适用场景
default / Manual
按权限规则询问未获准的操作,不是每次读取都询问
需要手动检查操作时
acceptEdits
自动接受常规文件编辑,命令和受保护路径仍受规则约束
明确范围的本地修改
plan
以分析和规划为主,工具仍按相应权限策略处理
先确认方案
auto
分类器检查多类操作,仍可阻止或要求确认
支持该模式的常规任务
bypassPermissions
跳过权限流程中的大多数检查;不建立 OS 隔离
已建立隔离边界的受控任务
v2.1.283 起,符合条件的交互终端和 VS Code 会话在没有显式模式设置时默认从 auto 开始。-p / Agent SDK 要另看启动条件:会拉取功能开关的会话通常从 Manual 开始;第三方提供商或关闭遥测等不拉取功能开关的会话,从 v2.1.285 起通常从 auto 开始,组织策略也可能取消这个默认。要让跟练从 Manual 开始,显式使用 --permission-mode default,或在 SDK 中设 permission_mode="default"。模型、提供商、配置和组织策略会改变是否可用,先看实际模式,详见官方启动模式说明。
在 auto 模式里,拒绝通常针对操作的结果,不能通过换一种命令写法绕开。服务端分类器也会审查只读和沙箱内的 shell 命令;“只读”不保证自动放行。读取工作目录外的内容时,如果出现 Yes, but ask again next time,选择它只允许这一次读取,以后仍会再问。配合沙箱使用网络命令时,调用里的 allowed_domains 只为本条命令开放已经审查的目标主机,其他主机仍被拒绝,不是修改全局网络允许名单。
auto 分类器会不会额外计费? 从 v2.1.278 起,符合条件的连接默认使用服务端分类器,分类器检查本身不额外计费;这不代表模型执行任务免费。直接连接 Anthropic API 的行为在 v2.1.281–282 又有调整,不能仅凭“关闭遥测”推定一定在本地检查。先运行 /status,看 Auto mode server 一行:Enabled 表示服务端检查,Disabled 表示退回本地分类器,本地分类器请求会计入用量。
如果出现“此会话不符合免分类器费用条件”的提示,在交互终端中按 Enter 是同意本地分类器计费用量后继续;按 Esc 或 Ctrl+C 会取消待检查的操作并结束当前轮,权限模式仍然是 auto。VS Code 和 JetBrains 面板从 v2.1.281 起显示 Continue / Stop:Continue 接受分类器计费用量并继续,Stop 取消待检查的操作并结束当前轮,仍保留 auto 模式。需要改用 Manual 时,退出提示后再用当前入口的模式选择器切换;终端可按 Shift+Tab。非交互 -p 没有这个问答,会在 stderr 或 stream-json 警告中说明并继续 auto。网关管理员应检查 safeguards 和 safeguard_results 是否原样传递;CLAUDE_CODE_AUTO_MODE_SERVER=0 会主动改用可能计费用量的本地分类器,不能拿它当免费开关。详见官方分类器计费说明。
2026-08-06 权限模式口径:v2.1.200 起,原 "Default" 权限模式在 CLI、VS Code、JetBrains 中已统一改名 "Manual"(行为不变,只是名字)。教程里只要看到"Default 模式"或"默认权限模式",按"Manual 模式"理解即可。此外 /doctor 已升级为完整诊断入口(原 /checkup 别名),/commit-push-pr 可在配置好远端后自动允许 git push,/fork 现在把会话拷到后台新 session、原会话内的 subagent 改叫 /subtask,/code-review 的运行方式取决于模型和 effort;v2.1.274 起,对没有专用调参的模型使用更精简的内联审查提示词,不能再把后台子代理当成所有审查的固定实现。
v2.1.90(release):在 acceptEdits 模式下,官方将 .husky 目录纳入 protected directories(原文:Added .husky to protected directories (acceptEdits mode))。是否影响你仓库里的 Hook 脚本,以当前版本实际提示与官方后续说明为准。
配置层级(优先级从高到低):
组织托管 > 启动参数 > 项目本地(.claude/settings.local.json) > 项目(.claude/settings.json) > 用户(~/.claude/settings.json)
allow(推荐替代方案):
相比危险的 --dangerously-skip-permissions 全局跳过,更安全的做法是在配置中精确指定允许的工具:
{
"permissions": {
"allow": ["Read", "Grep", "Glob", "Edit"]
}
}
allow 决定哪些匹配调用可以免询问,不会移除其他工具;还需核对 deny / ask 规则、当前模式和组织策略。要限制可见工具,用 --tools 等对应入口。bypass 也不等于所有信任检查消失。
---
### 4.7 开发辅助命令
#### /security-review - 安全审查
作用:分析当前分支尚未提交的改动,重点找安全问题
You: /security-review
Claude会围绕认证、注入、越权、敏感信息暴露等问题审查当前 git diff
⚠️ 说明:/security-review 专注安全风险。需要通用代码审查时,当前官方命令参考仍提供 /review [PR];需要更深的云端多 Agent 审查时看 /ultrareview。
---
#### 待办追踪(没有 /todos slash 命令)
作用:Claude 会在复杂多步骤任务中用内部 TodoWrite 工具追踪待办,但当前官方命令参考没有 /todos 这个用户可输入的 slash 命令。
想查看当前工作项时,直接用自然语言询问
You: 总结一下当前任务进度和剩余待办
管理后台运行任务时,用 /tasks
You: /tasks
不要混淆:TodoWrite 是 Claude/Agent SDK 的内部工具事件,不等于一个 /todos slash 命令。/tasks 管的是后台任务/后台 Bash,不是普通待办列表。
---
#### /agents - 管理子代理
作用:当前 /agents 打印提示,告诉你让 Claude 创建或管理定义,或直接编辑 .claude/agents/、~/.claude/agents/。v2.1.197 及更早版本才提供旧的交互管理界面。
/agents
看当前运行的 shell 与子代理,用 /tasks;管理独立后台会话用 shell 命令 claude agents。它们不是同一个入口,详见子代理指南。
在 claude agents 中向正在工作的后台会话发送消息时,从 v2.1.287 起,消息会进入队列;发送的斜杠命令也会等当前轮结束后执行,/stop 是例外。如果目的是停止该会话的当前工作,发送 /stop,不要用另一个普通命令当即时打断。详见官方 2.1.287 行为变化。
---
#### /fast - 快速模式切换
作用:开启支持 fast mode 的 Opus 高速配置,用更高单价换取更低响应延迟;是否可用取决于模型、账号和组织条件。
You: /fast
切换后提示
Fast mode: enabled
再次输入切换回普通模式
You: /fast
Fast mode: disabled
fast mode 本身是同一 Opus 模型的高速配置;如果当前模型不支持,开启时可能切到 Opus。关闭后不会自动回到之前的模型,要切回时用 /model。订阅用户通过 usage credits 另行计费,详细资格见本章认证附录和官方 fast mode 文档。
---
### 4.8 诊断命令
#### /doctor - 系统诊断
作用:会话内的 /doctor 检查安装、设置和上下文等问题,先报告,再确认是否修改;shell 中的 claude doctor 输出只读安装诊断,不启动会话。
/doctor
诊断项目和结果取决于实际安装。本教程的旧“API Connected / 3 MCP”菜单不是你应该逐项看见的固定输出;它也不能替代一条实际任务的认证与结果验证。
什么时候用:
- 遇到奇怪的错误
- 更新后检查是否正常
- 定期健康检查
---
#### /status - 完整状态信息
作用:显示版本、模型、账户等完整状态
You: /status
预期输出:
Claude Code Status
Version: 2.1.92 (native)
Model: claude-sonnet-5
Account: [email protected]
Plan: Pro
MCP Servers:
✓ filesystem (3 tools)
✓ github (8 tools)
Session:
Started: 10:30 AM
Duration: 45 minutes
Tokens used: 12,340
---
#### /usage - 使用量统计
v2.1.149+ 更新:/usage 会按 skills、subagents、plugins、MCP server 等类别拆分用量,排查“为什么额度消耗很快”时先看这里;额外额度入口现在统一写作 /usage-credits。
作用:显示账户使用量和限制(订阅用户)
/usage
按实际界面查看会话成本、计划用量限制和活动统计。订阅的限制窗口、usage credits 和 Console API 支出不是一个固定月度“5000消息 / 5M tokens”配额;本教程没有验证这样的数字。当前 /cost、/stats 是这个入口的别名。
---
### 4.9 其他实用命令
#### /stats - 使用统计
作用:当前 /stats 是 /usage 的别名,查看客户端提供的成本、计划用量与活动信息。
/stats
不同版本可能显示不同字段,不要把旧示意中的 $12.34、23次会话或命令排行当成默认菜单或实测数据。
---
#### /config - 统一设置入口
作用:打开设置界面,统一管理主题、模型、输出样式、编辑模式等
You: /config
⚠️ 说明:/vim 已在 v2.1.92 移除。现在想切换 Vim / Normal 编辑模式,请进入 /config → Editor mode。
---
#### /statusline - 自定义状态栏
作用:用自然语言指定底部状态栏要显示的信息,也可以配置自己的本地脚本。
/statusline 显示模型名、上下文使用百分比和当前目录,兼容 Windows
/statusline delete
在 ~/.claude/settings.json 中配置脚本路径(示例路径需换成自己的实际位置):
{
"statusLine": {
"type": "command",
"command": "node /absolute/path/statusline.cjs",
"refreshInterval": 5,
"hideVimModeIndicator": true
}
}
refreshInterval 可选,表示除事件触发外每 N 秒刷新,最小值为 1;hideVimModeIndicator 可选,用于避免重复显示 Vim 模式。Windows 路径中的反斜杠需要按 JSON 规则转义。
脚本通过标准输入接收 JSON,向标准输出写入要显示的文字:
// statusline.cjs
let input = "";
process.stdin.setEncoding("utf8");
process.stdin.on("data", chunk => { input += chunk; });
process.stdin.on("end", () => {
const data = JSON.parse(input);
const used = data.context_window?.used_percentage;
const percent = used == null ? "n/a" : ${used}%;
console.log(${data.model?.display_name ?? "Claude"} | ctx: ${percent});
});
常用字段:
字段
含义与边界
model.display_name
当前模型名称
context_window.used_percentage / context_window.context_window_size
上下文使用比例 / 容量;会话早期比例可能为 null
cost.total_cost_usd
客户端估算费用,可能与实际账单不同
workspace.current_dir / workspace.repo
当前目录 / 仓库身份;没有 origin 时仓库字段可能缺失
rate_limits.five_hour.used_percentage / rate_limits.seven_day.used_percentage
claude.ai Pro/Max 的 5h/7d 限额;不是所有订阅都有
rate_limits.five_hour.resets_at / rate_limits.seven_day.resets_at
对应窗口重置时间,Unix 秒
rate_limits.spend_limit
配置了个人支出限额的 Claude apps gateway 可提供此窗口,不等于订阅的 5h/7d 窗口
rate_limits 要在首个 API 响应后才可能出现,各窗口可分别缺失或到期移除。不要将字段缺失当成“已用 0%”。
本节核查日:2026-10-02。字段完整路径、版本与可用范围见 官方状态栏文档。
---
#### /release-notes - 查看更新日志
作用:查看各版本更新说明。
版本说明(以官方 release 为准):自 v2.1.92 起,/release-notes 为 interactive version picker(交互式版本选择器),不再等同于「固定打印最近几条 bullet」。请在终端内自行选择要查看的版本;完整变更列表以 GitHub Releases · anthropics/claude-code 为准。
You: /release-notes
---
#### /bug - 报告Bug
作用:提交Bug报告给Anthropic
You: /bug
会引导你描述问题并发送报告
Describe the bug you encountered:
[输入问题描述]
✓ Bug report submitted. Thank you!
---
### 4.10 MCP相关命令
#### /mcp - 管理MCP连接
作用:查看和管理MCP服务器连接
You: /mcp
预期输出:
MCP Server Status
✓ filesystem (local)
Tools: list_directory, read_file, write_file
✓ github (authenticated)
Tools: create_issue, list_repos, ...
⚠ database (not configured)
---
#### /plugin - 管理插件
作用:管理 Claude Code 插件,支持发现、安装、启用、禁用、更新
You: /plugin
你会看到 Discover / Installed / marketplace 等交互入口
---
#### /reload-plugins / /remote-control / /install-github-app / /tasks
这几个命令在 2.1.92 里都值得认识一下:
命令
作用
适合场景
/reload-plugins
重新加载当前活跃插件
刚修改本地 plugin / skill 后不想重启
/remote-control
让当前会话可从 claude.ai / 手机 App 继续
离开工位继续当前本地 session
/install-github-app
引导配置 Claude GitHub Actions app
给仓库快速接入 GitHub Actions
/tasks
查看并管理后台任务
构建、测试、开发服务器等在后台运行时
/mobile
显示下载 Claude 手机 App 的二维码
第一次用手机接 Remote Control 时
---
#### /hooks - 管理Hooks
作用:查看当前 hook 配置。新增或修改时,编辑相应 settings.json,或按当前支持的 /update-config 入口让 Claude 起草,再检查事件名、脚本和作用域。
/hooks
官方事件名包括 PreToolUse、PostToolUse 等,不能照抄旧示意的 pre-write / post-commit 当作事件字段。详细配置见 Hooks 指南。
---
## 第五部分:快捷键速查
本节目的:掌握提高效率的键盘快捷键
⏱️ 预计时间:15分钟
### 5.1 通用控制
快捷键
作用
备注
Ctrl + C
取消当前输入或生成
清空草稿后,在空提示框按 ↑ 可恢复草稿(含粘贴文本与图片,v2.1.288+)
Ctrl + D
输入框为空时退出,按提示再次确认
有文本时删除光标后的字符
Ctrl + L
重绘屏幕
保留输入和会话历史,可用于恢复显示异常
Ctrl + O
切换转录详情视图
查看工具调用细节
Ctrl + R
反向搜索历史输入
全屏和经典界面有不同搜索控件
Ctrl + Enter / Ctrl + X Ctrl + S
立即送出排队的消息与当前草稿
Claude 工作时不必等本轮结束;普通终端用第二组按键
Esc + Esc
空输入时打开 Rewind;有文本时清空草稿
先确认当前输入状态
Option/Alt + T
支持的模型上切换 Extended Thinking
始终推理的模型不受开关影响
Shift + Tab
循环权限模式
Manual / acceptEdits / plan,其他模式按条件加入
Tab
接受补全,或在权限提示中写评论
不是 thinking 开关
上/下箭头
浏览历史命令
快速复用
Claude 工作时,你可以先把补充消息排队,等它准备好再读取;需要立即送达时按 send-now。当前行为会尽量把运行中的工具移到后台,让 Claude 读取新消息,不是一律取消整轮工作;排队中有 ! shell 命令时则可能中断本轮。Skill 自己的 shell 也会移到后台。终端不支持扩展按键时,Ctrl+Enter 可能只等于 Enter,改用通用的 Ctrl+X Ctrl+S。详见官方排队与立即发送。
### 5.2 模型切换
快捷键
作用
Option + P (macOS)
切换AI模型
Alt + P (Windows/Linux)
切换AI模型
### 5.3 粘贴图片
快捷键
平台
Ctrl + V
macOS/Linux
Alt + V
Windows
### 5.4 多行输入
方法
快捷键
兼容性
反斜杠
\ + Enter
所有终端
macOS默认
Option + Enter
macOS
配置后
Shift + Enter
需运行 /terminal-setup
控制序列
Ctrl + J
所有终端
### 5.5 历史搜索 (Ctrl + R)
使用步骤:
1. 按 Ctrl+R,输入关键词。
1. 全屏界面中,用方向键选匹配,Ctrl+S 切换搜索范围,Enter 或 Tab 把匹配放入输入框,Esc 取消。
1. 经典界面中,再按 Ctrl+R 看更早的匹配;Tab / Esc 接受后继续编辑,Enter 接受并直接提交,Ctrl+C 取消。
先确认你使用哪种界面,避免把经典界面的“Enter 直接执行”套到全屏搜索框。
### 5.6 后台运行
操作
方式
提示Claude后台运行
在提示词中说"在后台运行"
手动转后台
按 Ctrl + B
tmux用户
按两次 Ctrl + B
常见后台命令:
- 构建工具(webpack、vite)
- 包管理器(npm、yarn)
- 测试运行器(jest、pytest)
- 开发服务器
### 5.7 Vim模式快捷键
如果你在 /config → Editor mode 中开启了 Vim 模式,可用这些快捷键:
模式切换:
命令
动作
Esc
进入NORMAL模式
i
在光标前插入
a
在光标后插入
o
在下方新开一行
移动(NORMAL模式):
命令
动作
h/j/k/l
左/下/上/右
w/b
下一个/上一个单词
0/$
行首/行尾
gg/G
文件开头/结尾
编辑(NORMAL模式):
命令
动作
x
删除字符
dd
删除整行
dw
删除单词
cc
修改整行
.
重复上次操作
---
## 第六部分:最佳实践
本节目的:掌握高效使用Claude Code的技巧
⏱️ 预计时间:30分钟
### 6.1 日常工作流程
推荐的每日流程:
1. 早上恢复昨天的会话
$ claude -c
2. 检查状态
You: /status
3. 开始工作
You: 我今天要完成用户认证模块
4. 工作过程中定期检查Token使用
You: /context
5. Token使用超过60%时压缩
You: /compact
6. 完成重要功能后导出对话
You: /export ~/docs/auth-implementation.md
7. 下班前重命名会话
You: /rename auth-module-day2
### 6.2 省钱技巧
#### Token优化
做法
怎样判断是否有帮助
给任务设明确范围
用 /context 检查是否加载了无关材料
同一任务需要保留重点时用 /compact
检查摘要是否保留约束,再比较实际上下文
切换到无关任务时用 /clear
新会话仍有指令和模型开销,不会退回已花费用
按任务选择模型和 effort
比较具体模型价格、完成质量和实际用量
缩短重复说明
保留必要信息,避免因缺条件反复返工
这些方法没有固定的30%、70%、80%或100%节省比例;压缩、重试和追加调用本身也可能产生用量。
#### 模型选择策略
简单任务:用Haiku(最便宜)
You: /model claude-haiku-4-5-20251001
You: 这个函数是什么意思?
日常开发:用Sonnet(性价比最高)
You: /model claude-sonnet-5
You: 帮我重构这个模块
关键决策:用Opus(最强)
You: /model claude-opus-4-8
You: ultrathink 设计这个系统的架构
### 6.3 配置别名提高效率
macOS/Linux(添加到 ~/.bashrc 或 ~/.zshrc):
快速启动
alias cc="claude"
恢复会话
alias cr="claude -c"
调试模式
alias ccv="claude --verbose"
使用Opus
alias cco="claude --model claude-opus-4-8"
Windows PowerShell(添加到 $PROFILE):
编辑配置文件
notepad $PROFILE
添加以下内容:
function cc { claude }
function cr { claude -c }
function ccv { claude --verbose }
### 6.4 大胆实验的工作方式
利用Checkpoint放心尝试:
场景:想尝试激进的重构但担心破坏代码
直接开始尝试(Checkpoint自动创建)
You: 帮我用新架构重构这个模块
不满意?双击Esc回退
[按 Esc + Esc]
[选择回到之前的检查点]
尝试另一个方案
You: 换一种方式,用工厂模式重构
还是不满意?继续回退
[按 Esc + Esc]
直到找到满意的方案
### 6.5 团队协作
分享会话给团队:
导出纯文本对话
You: /export shared/auth-discussion.txt
需要网页展示时,再用 Markdown/静态站点工具转换展示
创建可复用的 legacy Slash 命令:
在项目中创建共享命令(兼容方式;新项目长期推荐 Skills)
mkdir -p .claude/commands
创建代码审查命令
echo "Review this code for security and performance issues:" > .claude/commands/team-security-check.md
在会话中调用;名称与内置 /security-review 区分
You: /team-security-check
---
## 第七部分:常见问题FAQ
本节目的:快速解决常见问题
⏱️ 预计时间:按需查阅
### Q1: 启动时报错 "claude: command not found"
原因:Claude Code没有正确安装或不在PATH中
解决方案:
检查是否安装
which claude # macOS/Linux
where.exe claude # Windows PowerShell / CMD
如果没有输出,优先使用原生安装脚本(macOS/Linux)
curl -fsSL https://claude.ai/install.sh | bash
Windows 可优先使用 WinGet
winget install Anthropic.ClaudeCode
---
### Q2: 报错 "Authentication failed"
原因:当前认证凭据无效,常见于 claude.ai 登录过期、Console / API Key 配置错误,或环境变量没有生效
解决方案:
先查实际认证来源,不输出密钥
claude auth status --text
已确定需要重新进行账号登录时
claude auth login
订阅或 Console 浏览器登录用户不必因环境变量为空就补 API Key。选择 API Key 路径时,按安装章第4.3节检查存在性和凭据状态;组织云平台按对应提供商处理。
---
### Q3: 响应很慢怎么办
可能原因和解决方案:
原因
解决方案
对话太长
使用 /compact 压缩
网络问题
检查代理设置
服务繁忙
稍后再试
使用Opus模型
切换到Sonnet
检查Token使用
You: /context
如果超过60%,压缩对话
You: /compact
切换到更快的模型
You: /model claude-sonnet-5
---
### Q4: 怎么恢复之前的对话
方法1:命令行恢复
恢复最近的会话
claude -c
恢复指定会话
claude -r ses_abc123
方法2:交互模式恢复
You: /resume
从列表中选择要恢复的会话
---
### Q5: 文件修改后怎么回退
使用Rewind功能:
方法1:双击Escape键
[按 Esc + Esc]
选择要回退到的检查点
选择"仅恢复代码"
方法2:/rewind命令
You: /rewind
---
### Q6: Claude一直请求确认,太烦了
解决方案:先用 /permissions 和底部模式指示查看当前规则。需要自动接受常规文件编辑时可选择 acceptEdits;支持 auto 时可让分类器检查常规操作;对重复的安全命令可以配置有限的允许规则。
不要因为项目是个人项目或“信任环境”,就直接用 --dangerously-skip-permissions。只有明确建立文件和网络隔离的受控环境才考虑 bypass,详见第4.6节。
---
### Q7: 怎么让Claude记住项目规范
方法1:让 Claude 把已确认的规则写入文件
请把本项目使用 TypeScript、API 返回必须包含 code 字段这两条已确认规则
加入项目 CLAUDE.md,保留已有内容,然后让我看实际 diff。
方法2:编辑CLAUDE.md
You: /memory
在编辑器中添加项目规范
方法3:初始化项目
You: /init
Claude会自动分析项目并创建配置
---
### Q8: 怎么使用Extended Thinking
方法1:检查当前模型并调整 effort
/model
/effort high
方法2:模型支持开关时,用 Option+T(macOS)或 Alt+T(Windows/Linux)。 始终启用推理的模型不受它影响,Tab 用于补全或权限评论。
单次深入分析可以在提示词中写 ultrathink,它增加本轮指令,不改变 API effort。think / think hard 是普通任务措辞,没有固定预算映射;详细说明见第4.3节。
---
### Q9: MCP服务器连不上
诊断步骤:
/mcp
/doctor
先在会话里看服务器状态和具体错误,再检查实际加载的设置及 .mcp.json。用本机编辑器检查 JSON;不要把可能含令牌、请求头或内部端点的完整配置上传到在线校验工具。项目服务器、用户服务器和提供商认证可能有不同作用域,按 MCP 指南继续排查。
---
### Q10: 怎么省钱
综合省钱策略:
1. 选择合适的模型
- 简单任务:Haiku(最便宜)
- 日常开发:Sonnet(性价比高)
- 关键决策:Opus(按需使用)
1. 优化Token使用
- 定期 /compact 压缩对话
- 完成任务后 /clear 清空
- 简洁描述需求
1. 按模型支持情况调整推理
- 简单问题先把需求写清楚,再按需选择较低 effort
- 始终推理的模型不能靠删除 think 关闭推理;复杂任务按第4.3节处理
1. 监控使用量
- 定期 /cost 查看费用
- /context 检查Token使用
---
### Q11: 怎么处理大文件
Claude Code对大文件的处理策略:
让Claude只读取关键部分
You: 读取 @large-file.js 的前100行
或指定函数
You: 分析 @large-file.js 中的handleAuth函数
---
### Q12: 怎么批量处理多个文件
Bash / Zsh 中逐文件生成审查报告:先进入允许交给模型的样例目录,确认登录和文件范围,再运行下面的脚本。它把模型的文字回复保存成报告,不把回复冒充可运行的 JavaScript:
mkdir -p reports
for file in *.js; do
[ -f "$file" ] || continue
claude -p "只读取当前目录的 $file,提出适合添加的 JSDoc 注释,不修改文件。"
--tools "Read" --allowedTools "Read" > "reports/${file%.js}-jsdoc.txt"
done
逐份检查退出状态和报告内容,再决定是否修改源码。Windows 原生 PowerShell 不支持这段 for ... do;可以逐个运行相同 claude -p 请求,或在已准备好的 Bash 环境中使用。
---
### Q13: 输出乱码怎么办
解决方案:
Windows PowerShell
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
macOS/Linux
export LANG=en_US.UTF-8
---
### Q14: 怎么在远程服务器使用
SSH到服务器后直接使用:
SSH连接
ssh user@server
在服务器上使用Claude Code
claude
或使用单次执行
claude -p "分析这个日志文件" < error.log
---
### Q15: 怎么集成到CI/CD
GitHub Actions 片段:以下步骤必须放进完整 workflow 的 jobs.<job>.steps 中。先 checkout 仓库,再准备 Node.js 22,并在仓库 secrets 中设置适用的 API 凭据;没有这些前置条件,片段不能独立运行。
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '22' - name: Code Review
run: |
npm install -g @anthropic-ai/claude-code
claude -p "只读当前仓库,报告代码问题和对应文件位置,不修改文件。" --tools "Read,Grep,Glob" --allowedTools "Read,Grep,Glob"
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
这仍会发起模型调用并可能计费,输出是模型报告,不能代替 CI 中的测试。要审查 PR 差异,还需提供明确的比较范围;完整接入方法见官方 GitHub Actions 指南。
---
### Q16: 会话突然中断怎么办
会话自动保存,直接恢复:
恢复最近会话
claude -c
---
### Q17: 怎么看Claude在做什么
启用详细输出:
启动时启用
claude --verbose
运行时切换
Ctrl + O
---
### Q18: 怎么取消正在执行的操作
按 Ctrl + C 中断:
Claude正在生成长回答时
[按 Ctrl + C]
会立即停止生成
---
### Q19: 怎么更新Claude Code
更新命令:
在终端运行
claude update
或使用npm更新
npm update -g @anthropic-ai/claude-code
---
### Q20: 配置文件在哪里
配置文件位置:
文件
位置
作用
CLAUDE.md
项目根目录
项目配置
.mcp.json
项目根目录
MCP服务器配置
~/.claude/
用户目录
全局配置
~/.claude/commands/
用户目录
个人 legacy Slash 命令
---
## 附录:认证方式与功能可用条件
核查日:2026-10-02。 不要仅凭“API Key / 订阅”二分判断全部功能。提供商、实际认证来源、模型、席位和组织策略都会影响结果;下表按功能分别说明。
功能
API / 第三方云
Claude.ai 登录及其他条件
/voice
直接 Anthropic API Key、Bedrock、Google Cloud Agent Platform、Foundry 不支持
需要 Claude.ai 登录和本地麦克风;云会话、SSH 不可用
/remote-control
API Key、Bedrock、Google Cloud Agent Platform、Foundry、Claude apps gateway 和自定义 API endpoint 不支持
Pro/Max/Team/Enterprise;Team/Enterprise 要 Owner 开启。会话仍在本机运行,电脑和进程需保持在线
/fast
Anthropic Console API 支持,但需付费组织及 fast mode 访问开通;Bedrock、Google Cloud Agent Platform、Foundry、Claude Platform on AWS 不支持
Pro/Max/Team/Enterprise 需开启 usage credits,另行计费;Team/Enterprise 还需 Owner 开启,且模型必须支持
Auto mode
支持 Anthropic API、Claude Platform on AWS、Bedrock、Google Cloud Agent Platform、Foundry 及已登录的 Claude apps gateway
官方列为 All plans;受提供商对应的模型最低要求、客户端版本和组织策略限制
Claude Code in the cloud
单独 API Key 不等于 Claude.ai 云会话资格
Pro/Max/Team;Enterprise 需 premium seat 或 Chat + Claude Code seat,并满足组织云功能条件
Routines / /schedule
Console API Key、第三方云或其他 API 认证不能代替 Claude.ai 订阅登录
Pro/Max/Team/Enterprise,受组织开关、仓库与云环境配置限制;CLI 创建需要 v2.1.225+
状态栏 rate limit 数据
普通 API Key 不提供订阅 5h/7d 窗口;配置支出限额的 apps gateway 可提供独立 spend_limit 窗口
5h/7d 面向 Pro/Max;首个 API 响应后才可能出现,各窗口可分别缺失
/ultraplan
已移除,不再按认证方式区分可用性
官方已结束该研究预览;改用 Plan mode 或云会话规划
Auto mode 的具体支持模型会变化,请按表中官方页面核对;它减少普通确认,不代表所有操作都会获准。API Key 用户应先确认缺的是哪项资格,不必仅因旧表格的一个“❌”就购买订阅。
### 查看实际认证方式
不要打印 API Key 来排查,也不要仅凭曾经执行过登录命令判断当前认证方式:
shell:查看当前实际认证状态
claude auth status --text
shell:登录 Anthropic 账户
claude auth login
shell:选择 Anthropic Console 的 API 用量计费登录
claude auth login --console
进入 Claude Code 交互会话后使用 /login,不是在 shell 中执行 claude login。以 claude auth status 的结果为准;环境变量、apiKeyHelper 或其他凭据可能优先于既有 Claude.ai 登录。不要把凭据值贴到 Issue 或日志中。
命令依据:官方 CLI reference。以上仅说明接入条件,不自动修改登录、计费或组织权限。
---
## 附录A:完整命令速查表
### CLI启动选项
选项
简写
作用
--version
-v
显示版本
--help
-h
显示帮助
--print
-p
打印模式
--model <name>
无
指定模型
--continue
-c
恢复最近会话
--resume <id>
-r
恢复指定会话
cd <path> 后运行 claude
shell 命令
在指定项目目录启动
--verbose
无
详细输出
--dangerously-skip-permissions
无
跳过权限确认
### Slash命令速查
命令
作用
/help
显示帮助
/exit
退出
/clear
清空对话
/compact
压缩对话
/context
查看Token使用
/cost
查看费用
/model
切换模型
/status
查看状态
/doctor
系统诊断
/resume
恢复会话
/export
导出对话
/rename
重命名会话
/init
初始化项目
/memory
编辑记忆
/permissions
管理权限
/security-review
安全审查
/tasks
后台任务管理
/rewind
回退功能
/plan
规划模式
/mcp
管理MCP
/plugin
管理插件
/reload-plugins
重载插件
/hooks
管理Hooks
/config
打开统一设置界面
/stats
使用统计
/usage
使用量
/insights
查看会话/使用洞察
/schedule
计划任务入口
/statusline
状态行定制
/remote-control
远程继续当前本地会话
/mobile
手机 App 下载二维码
/install-github-app
GitHub Actions 快速接入
/tasks
管理后台任务
/theme
切换配色主题
/desktop
切到 Claude Code Desktop
/diff
查看当前变更和逐轮 diff
/btw
提一个不污染主线程的 side question
/chrome
管理 Claude in Chrome 集成
/ultraplan
在浏览器里草拟并回传 plan(v2.1.222 已移除,改用 /plan + 工作流 skill)
/release-notes
更新日志
/bug
报告Bug
/powerup
交互式功能教程(v2.1.90+,见 GitHub release)
/voice
语音模式 🆕
/effort
推理深度控制(五级:low/medium/high/xhigh/max)🆕
/loop
Bundled skill:定时循环执行 🆕
/sandbox
沙箱隔离模式 🆕
/color
会话颜色设置 🆕
/copy
复制AI回复 🆕
/branch
会话分支 🆕
/skills
查看和搜索已安装的 Skills 🆕
/proactive
/loop 的别名(v2.1.105+)🆕
### 快捷键速查
快捷键
作用
Ctrl + C
取消/中断
Ctrl + D
退出
Ctrl + L
重绘屏幕,保留输入和会话历史
Ctrl + O
切换详细输出
Ctrl + R
搜索历史
Ctrl + B
转后台运行
Esc + Esc
空输入时打开 Rewind;有文本时清空草稿
Option/Alt + T
支持模型上切换 Extended Thinking;Tab 是补全或权限评论
Shift + Tab
切换权限模式
Option/Alt + P
切换模型
---
## 总结
恭喜你完成了Claude Code基础使用的学习!
你现在掌握了:
1. 三种启动形式(空白交互 / 带初始问题的交互 / 非交互打印)
1. 30+个Slash命令
1. 高效快捷键操作
1. Checkpoint/Rewind回退功能
1. Extended Thinking深度思考
1. 省钱和效率技巧
下一步学习建议:
1. Commands系统:学习自定义Slash命令
1. MCP集成:连接外部工具
1. Hooks系统:自动化工作流
1. Skills定制:创建专业知识技能包
记住:最好的学习方式是实践!打开Claude Code,开始你的AI编程之旅吧!
---
课程反馈:如果本教程对你有帮助,欢迎分享给更多人!
问题反馈:遇到问题可以使用 /bug 命令报告,或在社区提问。
更新日期:2026年10月3日
版本:v1.6(对齐 Claude Code v2.1.270 release 差量)
---