Claude Code 是 Anthropic 推出的 AI 终端编程助手,直接在命令行运行,可以读取代码库、编辑文件、执行命令。它比普通对话窗口强大得多——前提是你得知道所有快捷键和命令在哪里。

这篇文章整理了 Claude Code 的全部快捷键、Slash 命令、CLI 参数与实用技巧,适合刚开始使用和想要提升效率的开发者。


一、安装与入门

安装方式(三选一)

# 官方推荐:原生二进制
curl -fsSL https://claude.ai/install.sh | bash

# macOS Homebrew
brew install --cask claude-code

# npm(已弃用,建议迁移)
npm install -g @anthropic-ai/claude-code

验证安装

claude --version    # 查看版本号
claude doctor       # 检查环境是否正常

登录认证

claude auth login     # 登录 / 切换账号
claude auth status    # 查看当前登录状态
claude auth logout    # 退出登录

最基本的启动方式

claude                    # 在当前目录启动交互会话
claude "你的任务"          # 启动后立即提交第一条消息
claude --help             # 查看所有可用参数

💡 小贴士:把 export ANTHROPIC_API_KEY=你的key 写入 ~/.zshrc 或 ~/.bashrc,以后不用每次手动设置。


二、键盘快捷键(完整版)

会话控制(最核心)

快捷键作用说明
Shift + Tab切换权限模式在 default、acceptEdits、plan 等模式间循环切换,是最重要的快捷键之一
Ctrl + C取消当前执行中断正在运行的任务,或清除未提交的输入
Ctrl + D退出 Claude Code发送 EOF 信号,干净地关闭会话
Esc + Esc(双击)回退到检查点恢复代码和对话到上一个检查点,等同于 /rewind
Alt + T切换扩展思考模式开启更深度推理。macOS 用 Option+T(需配置终端 Meta 键)
Alt + P切换模型在 Sonnet / Opus / Haiku 之间切换,不会清空当前对话
Alt + O切换快速模式用同一模型获得更快响应
Ctrl + B后台运行任务将 bash 命令或 agent 发送到后台。tmux 用户需要按两次
Ctrl + G在外部编辑器中编辑用你默认的文本编辑器编辑提示词,也可用 Ctrl+X Ctrl+E

macOS 用户注意:Alt/Option 快捷键(Alt+T, Alt+P, Alt+O)需要在终端中将 Option 配置为 Meta 键。iTerm2 路径:Settings → Profiles → Keys → 将 Left/Right Option 设为 “Esc+”。VS Code 终端则需要设置 "terminal.integrated.macOptionIsMeta": true

输入与导航

快捷键作用说明
Shift + Enter换行(不提交)在 iTerm2、WezTerm、Ghostty、Kitty 中开箱即用;其他终端运行 /terminal-setup
↑ / ↓浏览历史命令按目录存储,执行 /clear 后重置
Ctrl + R反向搜索历史输入关键词搜索,再次按 Ctrl+R 循环匹配,Tab/Esc 确认,Enter 执行
Tab自动补全自动补全文件路径或命令,在 @ 文件引用和 ! bash 前缀后有效
Ctrl + U删除到行首readline 风格编辑
Ctrl + K删除到行尾readline 风格编辑
Ctrl + W向前删除一个词readline 风格编辑
Ctrl + Y粘贴剪切内容粘贴刚才删除的内容(yank)
Ctrl + V从剪贴板粘贴图片macOS iTerm2 用 Cmd+V,Windows 用 Alt+V

视图与显示

快捷键作用
Ctrl + O切换 transcript 查看器(普通视图 → transcript 模式 → 专注视图,显示详细工具调用)
Ctrl + T切换任务列表显示/隐藏
Ctrl + L清除当前输入(保留对话历史)

Vim 模式

通过 /config → Editor mode 开启后,可使用完整的 Vim 键位:

快捷键作用
h j k l普通模式导航
w b e按词移动
d c y p删除、修改、复制、粘贴
iw i" i{文本对象(词、引号内、花括号内)

三、Slash 命令(会话内输入 / 触发)

上下文与对话管理

命令作用用法示例
/compact压缩对话历史,释放 token/compact focus on tests 可指定保留重点
/clear清空对话,重置上下文切换不相关任务时使用
/context查看 token 用量和建议了解上下文窗口消耗情况
/undo撤销上次操作回退最近一次文件修改
/rewind恢复到检查点同 Esc+Esc 双击
/branch分支当前对话从同一个点探索不同方案

模型与性能

命令作用
/model opus切换到 Claude Opus(最强,适合复杂任务)
/model sonnet切换到 Claude Sonnet(默认,速度与质量均衡)
/model haiku切换到 Claude Haiku(最快,适合简单任务)
/effort high设置高精度模式
/effort low设置快速模式
/fast切换快速输出模式

会话管理

命令作用用法示例
/rename为当前会话命名/rename feature-auth
/resume恢复历史会话/resume 1 或 /resume feature-auth
/copy复制代码块/copy 2 复制第 2 个最新的代码块
/status查看当前会话状态、模型、设置

配置与工具

命令作用
/config打开完整配置界面(包括 Vim 模式、颜色主题等)
/permissions交互式管理权限设置
/mcp管理 MCP 服务器,/mcp enable / /mcp disable
/memory查看和管理自动记忆文件
/hooks查看 hook 配置
/usage查看 token 用量、费用、计划使用情况
/init初始化项目,生成 CLAUDE.md
/terminal-setup配置终端以支持 Shift+Enter 换行等高级快捷键
/help显示所有可用命令

💡 技巧:在会话中输入 / 然后输入字母可以过滤命令,不需要记住所有命令名称。


四、CLI 启动参数

常用参数速查

参数作用示例
-p打印模式:单次查询后退出(适合脚本/自动化)claude -p "列出所有 TODO"
-c继续最近一次会话claude -c
-r / --resume恢复指定会话(按名称或编号)claude -r "auth-refactor"
-n / --name启动时为会话命名claude -n "feature-x"
--model指定模型claude --model opus
--max-turns限制自主执行轮数claude -p "修复 lint" --max-turns 10
--output-format输出格式:text / json / stream-jsonclaude -p "统计文件数" --output-format json
--enable-auto-mode启动时开启自动模式claude --enable-auto-mode
--init初始化项目并生成 CLAUDE.mdclaude --init
--debug启用调试日志claude --debug
--from-pr关联到 GitHub PR 启动会话claude --from-pr 123
-w在隔离的 git worktree 中启动claude -w
--fork-session从恢复的会话创建分支claude -r base --fork-session
--allowedTools限制可用工具claude -p "修复" --allowedTools "Edit,Bash(npm:*)"
--permission-mode设置权限模式claude --permission-mode auto

提示词前缀(会话内直接输入)

前缀作用示例
@文件路径引用文件,触发路径自动补全@src/auth.ts 修复这个 bug
! bash命令直接执行 bash 命令! npm run build
# 注释在提示词中加注释(不影响 Claude)# 这是背景说明

五、CLAUDE.md:最重要的配置文件

CLAUDE.md 是 Claude Code 的「记忆核心」。每次启动会话时,Claude Code 会自动读取项目目录中的这个文件,无需重复解释项目背景。

初始化

claude --init
# 或在会话中执行
/init

CLAUDE.md 可以写什么

  • 项目结构说明(目录含义、主要文件)
  • 技术栈版本(Node.js 版本、框架版本)
  • 代码规范(命名风格、注释要求)
  • 常用命令(构建、测试、部署命令)
  • 禁止事项(不要修改哪些文件)
  • 业务上下文(项目目标、特殊逻辑)

CLAUDE.md 示例结构

# 项目名称

## 技术栈
- Node.js 20, TypeScript 5.4
- React 18, Tailwind CSS 3.4
- PostgreSQL 16

## 项目结构
src/
  components/   # React 组件
  api/          # API 路由
  utils/        # 工具函数

## 常用命令
npm run dev     # 本地开发
npm run build   # 构建生产版本
npm test        # 运行测试

## 代码规范
- 使用 ESLint + Prettier
- 组件使用 PascalCase
- 函数使用 camelCase
- 不要直接修改 dist/ 目录

💡 技巧:将 CLAUDE.md 提交到 Git,多台设备切换时无需重新配置上下文。


六、高效使用技巧

1. 用计划模式(Plan Mode)先规划再执行

按 Shift+Tab 切换到 plan 模式,Claude Code 会先展示执行计划,等你确认后才真正修改文件。这在处理大规模重构或不熟悉的代码库时非常有价值。

2. 定期 /compact 保持上下文健康

完成一段工作后执行 /compact,Claude Code 会压缩对话历史,释放 token 空间,同时保留核心上下文。处理不相关任务时改用 /clear 完全清空。

3. 用 -p 参数构建自动化管道

# 单次执行后退出,结果写入文件
claude -p "检查代码中的安全漏洞" > security-report.txt

# 配合 JSON 输出做进一步处理
claude -p "列出所有 API 端点" --output-format json | jq '.endpoints'

4. 用自定义命令封装重复工作流

创建 .claude/commands/你的命令.md(项目级)或 ~/.claude/commands/你的命令.md(全局),在会话中用 /你的命令 一键触发。

# 示例:.claude/commands/deploy-check.md
执行以下检查:
1. 运行所有测试 npm test
2. 检查 TypeScript 类型 npm run type-check
3. 运行 ESLint npm run lint
4. 输出通过/失败摘要

5. 用路径范围规则减少噪音

在 .claude/rules/ 目录下创建规则文件,可以针对特定路径设置不同指令,Claude Code 只在接触对应文件时加载这些规则,避免所有规则堆在一起稀释上下文。

6. 用 @ 引用文件,而不是粘贴内容

直接说 @src/utils/auth.ts 帮我添加注释,比把文件内容粘贴到对话框里消耗的 token 少得多,且路径会自动补全。

7. 给长期会话命名

# 启动时命名
claude -n "用户认证模块重构"

# 会话中命名
/rename auth-refactor

# 下次从这里继续
claude -r "auth-refactor"

8. 用后台模式处理耗时任务

按 Ctrl+B 将正在运行的任务发送到后台,继续提交新指令。这在等待测试运行或构建时特别有用。


七、帮助资源

内置帮助

claude --help        # 终端内查看所有 CLI 参数
/help                # 会话内查看所有 Slash 命令

官方文档


总结:最值得记住的 12 个命令

  1. Shift + Tab——切换计划/执行模式,大改前先看计划
  2. Ctrl + C——取消执行,随时可以叫停
  3. Esc + Esc——出错了?双击回退到检查点
  4. Ctrl + R——搜索历史命令,不用重复输入
  5. /compact——token 快用完了?压缩一下再继续
  6. /clear——换任务了?彻底清空更干净
  7. /model opus——遇到难题?切换最强模型
  8. /init——新项目第一件事,生成 CLAUDE.md
  9. @文件路径——引用文件,比粘贴内容省 token
  10. claude -c——继续昨天的会话,无缝衔接
  11. claude -p “任务”——自动化脚本的入口
  12. /config——第一次使用时进去配置一遍,开启 Vim 模式等偏好

本文基于 Claude Code v2.1.x,更新于 2026 年 5 月。官方文档以 docs.anthropic.com 为准。

自动跳过确认的方法

方法一:启动时加参数(临时)

bash

claude --dangerously-skip-permissions

跳过所有权限提示,适合在受信任的本地环境用。

方法二:设置权限模式为 auto(推荐)

bash

claude --permission-mode auto

或者在会话中:

/permissions

进入交互式权限管理,把默认模式改为 auto。

方法三:写入配置文件(永久生效)

编辑 ~/.claude/settings.json,加入:

json

{
  "permissionMode": "auto"
}

之后每次启动 Claude Code 都自动允许,不再询问。

方法四:会话中用 Shift+Tab 切换

在运行中按 Shift+Tab 循环切换模式,切到 autoacceptEdits 即可跳过当前会话的确认提示。


几种模式的区别:

模式行为
default每次操作都询问
acceptEdits自动允许文件编辑,bash 命令仍询问
auto自动允许大部分操作
--dangerously-skip-permissions跳过全部提示,包括危险操作

日常开发推荐用 auto 模式,写入 settings.json 最省事。如果是在 CI/CD 脚本里用,配合 -p 参数加 --dangerously-skip-permissions 是标准做法。