第 3 章:快速上手

启动、交互模式与基本命令

Claude Code 的交互体验是其区别于传统 IDE 插件的核心竞争力。它不是一个需要点击按钮的图形界面工具,而是一个深度融入终端工作流的命令行伴侣。理解它的启动流程、交互模式和内置命令体系,是高效使用 Claude Code 的第一步。

Claude Code 的交互体验是其区别于传统 IDE 插件的核心竞争力。它不是一个需要点击按钮的图形界面工具,而是一个深度融入终端工作流的命令行伴侣。理解它的启动流程、交互模式和内置命令体系,是高效使用 Claude Code 的第一步。

本章将从最基础的 claude 命令开始,逐步深入欢迎界面的信息解读、三种核心交互模式、完整的 Slash Commands 参考手册、权限审批流程、会话持久化机制,以及能够显著提升效率的快捷键组合。目标是让你在五分钟内从完全新手成长为能够流畅驾驭 Claude Code 的熟练用户。


一、启动 Claude Code

1.1 基础启动命令

Claude Code 的入口命令是 claude。在已安装并认证的机器上,进入任意项目目录并执行:

# 进入项目目录后启动交互式会话
cd my-project
claude

这是最常用的启动方式。Claude Code 会将当前目录识别为项目根目录,自动加载该目录下的 CLAUDE.md.claude/settings.json 等配置文件,并开始一个全新的交互式会话。

如果你希望启动时直接附带一个初始任务,可以将提示词作为参数传递:

# 启动并立即执行指定任务
claude "explain the authentication flow in this project"

# 启动并请求代码审查
claude "review the recent changes in src/ for security issues"

这种方式适合有明确目标的单次任务。Claude 会在完成初始提示词的处理后,保持会话开启等待后续输入。

1.2 常用启动参数

Claude Code 提供了丰富的命令行标志(CLI flags)来控制启动行为。以下是日常开发中最常用的参数:

参数简写说明示例
--continue-c继续当前目录下最近的会话claude -c
--resume-r按名称或 ID 恢复指定会话claude -r "auth-refactor"
--print-p非交互模式,执行后退出claude -p "fix the build"
--model指定使用的模型claude --model opus
--effort设置推理努力程度claude --effort high
--permission-mode以指定权限模式启动claude --permission-mode plan
--name-n为会话命名claude -n "feature-payments"
--worktree-w在隔离的 git worktree 中启动claude -w feature-branch
--bare最小化模式,跳过插件和配置加载claude --bare
--debug启用调试日志claude --debug
--version-v显示版本号claude -v

继续与恢复会话是最省时的启动方式。Claude Code 会自动保存每个会话的完整上下文(包括已读取的文件、已执行的命令、已做出的决策),让你可以在中断后无缝接续:

# 继续当前目录下最近的会话
claude -c

# 恢复指定名称的会话
claude -r "my-feature-work"

# 恢复与某个 PR 关联的会话
claude --from-pr 42

非交互模式(-p 是 Claude Code 融入自动化工作流的关键。它接受一个提示词,执行完毕后直接输出结果并退出,不会进入交互式 REPL:

# 管道输入:分析日志文件
cat error.log | claude -p "what caused this crash?"

# Git diff 审查
git diff main | claude -p "review for security issues"

# 生成结构化输出
claude -p "list all TODO comments" --output-format json

# 设置预算上限,防止 CI 中失控消费
claude -p "run lint check" --max-budget-usd 2.00

1.3 环境变量

以下环境变量可以在启动前影响 Claude Code 的行为:

环境变量作用
ANTHROPIC_MODEL默认模型(如 opussonnet
ANTHROPIC_API_KEY使用 API Key 而非订阅认证
CLAUDE_CODE_EFFORT_LEVEL默认努力程度(low/medium/high/xhigh/max
CLAUDE_CODE_NO_FLICKER设置为 1 启用平滑渲染引擎,消除终端闪烁
CLAUDE_CODE_DISABLE_AUTO_MEMORY设置为 1 禁用自动记忆功能
MAX_THINKING_TOKENS限制思考 token 预算
HTTPS_PROXY企业网络代理配置

推荐将 CLAUDE_CODE_NO_FLICKER=1 加入 shell 配置文件,可显著改善终端渲染体验:

echo 'export CLAUDE_CODE_NO_FLICKER=1' >> ~/.zshrc

二、欢迎界面解读

首次启动 Claude Code 或在 /clear 后,你会看到一个精心设计的欢迎界面。它不仅是装饰,更是信息密度极高的状态面板。

2.1 界面布局

典型的欢迎界面包含以下区域:

╭────────────────────────────────────────────────────────────╮
│  Claude Code v2.1.x                                       │
│  Model: claude-sonnet-4-6  |  Effort: medium              │
│  Project: /Users/you/my-project                           │
│  Git: main (clean)                                        │
│                                                            │
│  Recent conversations:                                     │
│  • auth-refactor      (2h ago, 12 messages)               │
│  • fix-login-bug      (5h ago, 8 messages)                │
│  • docs-update        (1d ago, 15 messages)               │
│                                                            │
│  Type /help for commands  |  /resume to continue          │
╰────────────────────────────────────────────────────────────╯

claude>

2.2 各区域含义

版本与模型信息:显示当前 Claude Code CLI 版本、正在使用的 AI 模型(如 claude-sonnet-4-6claude-opus-4-7)以及当前 effort 级别。这帮助你确认是否使用了预期的配置。

项目路径:显示当前工作目录。Claude Code 以此目录为项目根,加载 CLAUDE.md.claude/ 配置。如果路径不对,应先 cd 到正确目录再启动。

Git 状态:显示当前分支名称和工作区状态(clean 表示无未提交更改,或有 X files changed 提示)。这让你在开始工作前了解代码库状态。

最近会话列表:列出当前项目下可恢复的历史会话,包含会话名称(如已命名)、最后活动时间、消息数量。点击或输入 /resume 可直接恢复。

底部提示:显示常用快捷入口。/help 查看所有命令,/resume 打开会话选择器。

2.3 更新提示

当有新版本可用时,欢迎界面顶部会出现更新提示:

┌────────────────────────────────────────────────────────────┐
│  Update available: v2.1.118 → v2.1.120                     │
│  Run `claude update` to install                            │
└────────────────────────────────────────────────────────────┘

Claude Code 采用自动更新机制。建议定期运行 claude update 获取最新功能和修复。在 CI/CD 环境中,可通过设置 DISABLE_AUTOUPDATER=1 禁用自动更新检查。


三、交互模式

Claude Code 支持三种核心交互模式,每种模式对应不同的工作场景和信任级别。

3.1 自然语言对话模式(默认模式)

这是 Claude Code 的默认工作方式。你以自然语言描述需求,Claude 自主决定需要读取哪些文件、执行哪些命令、做出哪些修改。在每次执行可能影响代码库或系统的操作前,Claude 会请求你的批准。

claude> Add rate limiting to the /api/auth endpoints

I'll analyze the current auth endpoints and add rate limiting. Let me start by 
examining the relevant files.

○ Read(13) src/api/auth.ts
○ Read(5) src/middleware/

I found the auth endpoints. I'll use express-rate-limit to add rate limiting. 
Let me check if it's already a dependency.

○ Bash(1) grep -r "rate-limit" package.json

It's not installed. Here's my plan:

1. Install express-rate-limit
2. Create a rate limiter middleware in src/middleware/rateLimiter.ts
3. Apply it to the auth routes in src/api/auth.ts

May I proceed with these changes? (Y/n)

在默认模式下,Claude 会在以下场景请求确认:

  • 首次使用某个工具(如 BashEditWrite
  • 执行可能破坏性的命令(如 rmgit push --force
  • 修改超出预期范围的文件

3.2 命令模式(Bash 模式)

! 开头的输入会直接进入 Bash 命令模式,绕过 Claude 的推理直接执行 shell 命令,并将输出加入会话上下文:

claude> !npm test

> my-project@1.0.0 test
> jest

 PASS  src/utils/auth.test.ts
 PASS  src/api/users.test.ts

Test Suites: 2 passed, 2 total

Bash 模式的特点:

  • 命令和输出直接加入对话上下文,Claude 后续可以引用这些结果
  • 支持 Ctrl+B 将长命令放入后台执行(tmux 用户需按两次 Ctrl+B
  • 支持基于历史记录的自动补全:输入部分命令后按 Tab 补全
  • 适合快速查看状态、运行测试、检查日志等操作

3.3 代码块交互模式

当 Claude 的响应包含可执行代码块时,你可以直接与这些代码块交互:

  • 复制代码块:鼠标选中或使用 /copy 命令
  • 写入文件:在代码块选择器中按 w 将内容写入指定文件(通过 SSH 时特别有用)
  • 应用编辑:对于 diff 格式的输出,可以直接确认应用

代码块交互在审查 Claude 生成的代码时尤为重要。你可以逐块审阅、选择性接受,而不是一次性接受全部输出。


四、内置 Slash Commands 大全

Slash Commands 是 Claude Code 的核心操作界面。在提示符处输入 / 即可查看所有可用命令,输入 / 后接字母可快速过滤。以下按功能分类详细说明。

4.1 会话管理命令

命令别名功能说明
/help显示所有可用命令和快捷键的帮助信息
/clear/reset, /new清空当前对话上下文,开始新会话。历史会话保留在 /resume
/compact [instructions]压缩对话历史,通过总结释放上下文空间。可指定保留重点
/resume [session]/continue恢复历史会话。无参数时打开交互式选择器
/rename [name]为当前会话命名,便于后续识别和恢复
/branch [name]/fork从当前对话创建分支,保留原会话供回溯
/export [filename]导出当前对话为纯文本文件
/copy [N]复制最近第 N 条助手回复到剪贴板。含代码块时显示选择器
/exit/quit退出 Claude Code

/compact 的使用场景:当对话变长、响应变慢时,运行 /compact 让 Claude 总结之前的讨论,丢弃细节但保留关键决策和上下文。这比 /clear 更温和,不会丢失工作连续性。

claude> /compact Focus on the auth module changes

/resume 选择器快捷键

快捷键动作
/ 在会话列表中导航
/ 展开/折叠分组会话
Enter恢复选中的会话
Space预览会话内容
Ctrl+R重命名会话
/进入搜索模式
Ctrl+A显示所有项目的会话
Ctrl+W显示当前仓库所有 worktree 的会话
Esc退出选择器

4.2 配置与模型命令

命令功能说明
/config/settings 打开设置界面,调整主题、模型、输出样式等
/model [model]切换 AI 模型(opussonnethaiku)。切换时重新读取完整历史
/effort [level]设置推理努力程度:lowmediumhighxhighmaxauto
/theme切换颜色主题,支持 auto(跟随终端)、亮色、暗色、色盲友好主题
/permissions/allowed-tools 管理工具的允许/询问/拒绝规则
/status显示版本、模型、账户和连接状态
/fast [on|off]切换快速模式
/voice [hold|tap|off]切换语音输入模式

模型切换示例

claude> /model opus
# 切换到 Opus 模型处理复杂架构问题

claude> /effort xhigh
# 设置最高推理深度(Opus 4.7 默认即为 xhigh)

4.3 账户与系统命令

命令功能说明
/login登录 Anthropic 账户
/logout退出当前账户
/cost/stats, /usage 显示当前会话的 token 用量和费用
/doctor诊断安装、认证、设置和 MCP 的健康状态
/insights生成会话分析报告,包括交互模式、效率建议和摩擦点
/release-notes查看版本更新日志
/bug/feedback 提交反馈或 bug 报告

/cost 输出示例

Session cost: $0.47
Plan usage: 12% of daily limit
Messages: 24
Tokens in: 45,200
Tokens out: 8,100

4.4 项目与代码工具命令

命令功能说明
/init初始化项目,自动生成 CLAUDE.md 项目指南
/memory查看和编辑 CLAUDE.md 记忆文件,管理自动记忆
/diff打开交互式 diff 查看器,查看未提交更改和每轮修改
/context可视化当前上下文使用情况,显示优化建议
/add-dir <path>添加额外的工作目录供当前会话访问
/plan [description]进入计划模式,只读探索后再实施
/security-review扫描当前分支的待提交更改,检查安全漏洞
/simplify [focus]审查最近修改的文件,优化代码质量和效率
/review [PR]在本地会话中审查 Pull Request

4.5 特殊命令

命令功能说明
/btw <question>问一个快速旁支问题,不加入对话历史。低成本、无工具访问
/loop [interval] [prompt]按间隔重复运行提示词。如 /loop 5m check deploy status
/schedule [description]创建、更新、列出或运行定时远程代理
/tasks/bashes 列出和管理后台任务
/skills列出可用技能。按 t 按 token 数排序
/mcp管理 MCP 服务器连接和 OAuth 认证
/chrome配置 Chrome 浏览器集成
/desktop/app 将当前会话移交到桌面应用(macOS/Windows)
/teleport/tp 将网页版会话拉取到当前终端
/rewind/checkpoint, /undo 回溯到之前的检查点

/btw 的使用场景:当你正在执行一个长任务,突然想确认之前提到的某个文件名,但又不想打断当前工作流时:

claude> /btw what was the name of that config file we edited earlier?

回答以临时浮层显示,按 SpaceEnterEscape 即可关闭,不消耗上下文空间。


五、权限审批与 Y/n 交互

5.1 审批流程

Claude Code 在执行可能影响代码库的操作前会请求你的批准。这是其安全设计的核心。

典型的审批提示如下:

○ Bash(1) npm install express-rate-limit

Allow Claude to run this command? (Y/n/d/a)

Y - Yes (this time)
n - No (skip this command)
d - Don't ask again for similar commands
a - Always allow this pattern

选项含义:

  • Y(是):仅批准当前这一次操作
  • n(否):跳过当前操作,Claude 会调整策略
  • d(不再询问):将当前命令模式加入允许列表,后续不再提示
  • a(始终允许):更宽泛地允许类似操作

5.2 权限模式切换

Shift+Tab(或 Alt+M)可在不同权限模式间循环切换:

模式行为适用场景
default首次使用每个工具时提示日常交互开发
acceptEdits自动批准文件编辑,命令仍提示信任的大规模重构
plan只读模式,不能编辑或执行命令安全探索和分析
autoAI 分类器自动决定允许/拒绝有清晰规则的项目
dontAsk自动拒绝除非预先批准严格管控
bypassPermissions跳过所有提示(危险)容器/沙箱环境

也可以通过启动参数指定初始模式:

# 以只读计划模式启动
claude --permission-mode plan

# 以自动模式启动
claude --permission-mode auto

5.3 预批准规则

.claude/settings.json 中配置永久性的权限规则:

{
  "permissions": {
    "allow": [
      "Read",
      "Bash(git *)",
      "Bash(npm run *)",
      "Bash(docker compose *)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(sudo *)"
    ]
  }
}

这种细粒度的控制让你可以安全地自动化日常操作,同时保留对危险命令的审批。


六、退出与恢复

6.1 退出方式

方式说明
Ctrl+D在空提示符处发送 EOF 信号,优雅退出
/exit/quit通过命令退出
Ctrl+C(两次)中断当前操作后再次按下退出

退出时,Claude Code 会自动保存当前会话状态到磁盘。如果你在 worktree 中工作且无未提交更改,worktree 会被自动清理。

6.2 会话持久化机制

Claude Code 的会话持久化是其核心特性之一:

  • 自动保存:每个会话自动写入 ~/.claude/projects/<编码后的工作目录>/<会话ID>.jsonl
  • 按目录隔离:会话与启动时的工作目录绑定,不同项目的会话互不干扰
  • 完整上下文:恢复会话时,Claude 拥有之前读取过的文件、执行过的命令、做出的决策等全部上下文
  • 权限记忆:已批准的命令模式在后续会话中无需重复审批

6.3 恢复会话的三种方式

# 方式一:继续最近会话(最常用)
claude -c

# 方式二:按名称恢复特定会话
claude -r "auth-refactor"

# 方式三:在交互会话中切换
claude> /resume
# 打开交互式选择器,支持搜索、预览、重命名

会话命名最佳实践

# 启动时命名
claude -n "feature-oauth2"

# 会话中重命名
claude> /rename "bugfix-memory-leak"

给会话起描述性名称是管理多个并行任务的关键。命名后的会话在 /resume 选择器中更容易识别。

6.4 会话总结恢复

当恢复的会话非常长时,Claude Code 会智能地提供"总结恢复"选项:

This session is large. Resume from summary instead? (Y/n)

选择 Y 会以会话的摘要版本恢复,节省 token 用量。选择 n 则加载完整历史。


七、快捷键与效率技巧

7.1 通用控制快捷键

快捷键功能
Ctrl+C取消当前输入或生成
Ctrl+D退出会话
Ctrl+L清屏并强制重绘(保留对话历史)
Ctrl+R反向搜索命令历史
Ctrl+O切换详细输出视图(显示工具调用详情)
Ctrl+T切换任务列表显示
Ctrl+B将命令放入后台执行
Ctrl+X Ctrl+K终止所有后台代理(3 秒内按两次确认)
Ctrl+G / Ctrl+X Ctrl+E在外部编辑器中编辑提示词
Esc + Esc回溯到之前的检查点
Shift+Tab / Alt+M循环切换权限模式

7.2 文本编辑快捷键

快捷键功能
Ctrl+A光标移到行首
Ctrl+E光标移到行尾
Ctrl+K删除到行尾(可粘贴)
Ctrl+U删除到行首(可粘贴)
Ctrl+W删除前一个词(可粘贴)
Ctrl+Y粘贴删除的文本
Alt+Y循环粘贴历史
Alt+B / Alt+F光标按词前后移动

7.3 多行输入方法

方法快捷键说明
反斜杠转义\ + Enter所有终端通用
Option/Alt 回车Option+Enter / Alt+EntermacOS 需开启 Option 作为 Meta
Shift 回车Shift+EnteriTerm2、WezTerm、Ghostty、Kitty、Warp 原生支持
控制序列Ctrl+J任何终端无需配置
直接粘贴粘贴代码块自动进入多行模式

7.4 模型与模式切换快捷键

快捷键功能
Option+P / Alt+P切换模型(不丢失当前提示词)
Option+T / Alt+T切换扩展思考模式
Option+O / Alt+O切换快速模式

7.5 快速前缀

前缀功能
/打开 Slash Command 菜单
!进入 Bash 命令模式
@触发文件路径自动补全

7.6 效率技巧

1. 提示词建议

会话开始时,提示栏会显示灰色的示例命令(基于项目 git 历史)。按 Tab 接受建议,Enter 接受并提交。这些建议复用父会话的 prompt cache,额外成本极低。

2. 会话回顾(Session Recap)

离开终端超过 3 分钟后返回,Claude Code 会自动生成一行会话摘要,告诉你之前做了什么。也可随时运行 /recap 手动生成。

3. PR 状态显示

当你在带有开放 PR 的分支上工作时,终端底部会显示可点击的 PR 链接,下划线颜色表示审查状态(绿色=已批准,黄色=待审查,红色=需修改)。

4. 图片粘贴

Ctrl+V(macOS 上 iTerm2 为 Cmd+V,Windows 为 Alt+V)可直接从剪贴板粘贴图片,Claude 会以 [Image #N] 标记引用它。

5. 文件提及

输入 @ 后接文件路径可快速引用文件,支持自动补全:

claude> Look at @src/auth.ts and fix the validation bug

八、Vim 编辑模式

对于 Vim 用户,Claude Code 提供了完整的 Vim 风格输入模式。通过 /config → Editor mode 启用。

8.1 模式切换

命令动作从何种模式
Esc进入 NORMAL 模式INSERT、VISUAL
i在光标前插入NORMAL
I在行首插入NORMAL
a在光标后插入NORMAL
A在行尾插入NORMAL
o / O在下方/上方新开一行NORMAL
v / V进入字符/行选择模式NORMAL

8.2 NORMAL 模式导航

命令动作
h/j/k/l左/下/上/右
w / b / e下一个词/上一个词/词尾
0 / $ / ^行首/行尾/首个非空字符
gg / G输入开头/结尾
f{char} / F{char}跳到下一个/上一个字符
; / ,重复/反向重复上次跳转

8.3 NORMAL 模式编辑

命令动作
x删除字符
dd / D删除行/删除到行尾
yy / Y复制行
p / P在光标后/前粘贴
u / .撤销/重复上次修改
>> / <<缩进/反缩进

九、参考来源

本文档内容综合整理自以下权威来源:

  1. Claude Code 官方文档 - Commands — 完整的内置命令参考
  2. Claude Code 官方文档 - Interactive mode — 键盘快捷键和交互功能
  3. Claude Code 官方文档 - CLI reference — 命令行标志和选项
  4. Claude Code 官方文档 - Common workflows — 常用工作流指南
  5. Claude Code 官方文档 - Work with sessions — 会话持久化机制
  6. ComputingForGeeks - Claude Code Cheat Sheet (2026) — 综合速查表
  7. Claude Directory - Claude Code Cheat Sheet (2026) — 命令、快捷键完整列表

十、本章速查卡

我想做...命令/操作
启动 Claude Codeclaude
继续上次会话claude -c
恢复指定会话claude -r "name"/resume
非交互执行claude -p "task"
查看所有命令/help
清空对话/clear
压缩上下文/compact
查看费用/cost
切换模型/model opusOption+P
切换权限模式Shift+Tab
退出Ctrl+D/exit
取消生成Ctrl+C
运行 Bash 命令!command
引用文件@path/to/file
回溯更改Esc + Esc
反向搜索历史Ctrl+R
多行输入Shift+Enter\ + Enter
诊断问题/doctor
查看上下文使用/context
命名会话/rename "my-task"