启动、交互模式与基本命令
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 | 默认模型(如 opus、sonnet) |
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-6、claude-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 会在以下场景请求确认:
- 首次使用某个工具(如
Bash、Edit、Write) - 执行可能破坏性的命令(如
rm、git 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 模型(opus、sonnet、haiku)。切换时重新读取完整历史 |
/effort [level] | 设置推理努力程度:low、medium、high、xhigh、max 或 auto |
/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?
回答以临时浮层显示,按 Space、Enter 或 Escape 即可关闭,不消耗上下文空间。
五、权限审批与 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 | 只读模式,不能编辑或执行命令 | 安全探索和分析 |
auto | AI 分类器自动决定允许/拒绝 | 有清晰规则的项目 |
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+Enter | macOS 需开启 Option 作为 Meta |
| Shift 回车 | Shift+Enter | iTerm2、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 / . | 撤销/重复上次修改 |
>> / << | 缩进/反缩进 |
九、参考来源
本文档内容综合整理自以下权威来源:
- Claude Code 官方文档 - Commands — 完整的内置命令参考
- Claude Code 官方文档 - Interactive mode — 键盘快捷键和交互功能
- Claude Code 官方文档 - CLI reference — 命令行标志和选项
- Claude Code 官方文档 - Common workflows — 常用工作流指南
- Claude Code 官方文档 - Work with sessions — 会话持久化机制
- ComputingForGeeks - Claude Code Cheat Sheet (2026) — 综合速查表
- Claude Directory - Claude Code Cheat Sheet (2026) — 命令、快捷键完整列表
十、本章速查卡
| 我想做... | 命令/操作 |
|---|---|
| 启动 Claude Code | claude |
| 继续上次会话 | claude -c |
| 恢复指定会话 | claude -r "name" 或 /resume |
| 非交互执行 | claude -p "task" |
| 查看所有命令 | /help |
| 清空对话 | /clear |
| 压缩上下文 | /compact |
| 查看费用 | /cost |
| 切换模型 | /model opus 或 Option+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" |