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-json | claude -p "统计文件数" --output-format json |
--enable-auto-mode | 启动时开启自动模式 | claude --enable-auto-mode |
--init | 初始化项目并生成 CLAUDE.md | claude --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 命令
官方文档
- 入门文档:docs.anthropic.com/en/docs/claude-code/overview
- CLI 参考:code.claude.com/docs/en/cli-reference
- 交互模式:code.claude.com/docs/en/interactive-mode
- 快捷键配置:code.claude.com/docs/en/keybindings(保存在
~/.claude/keybindings.json,输入/keybindings管理)
总结:最值得记住的 12 个命令
- Shift + Tab——切换计划/执行模式,大改前先看计划
- Ctrl + C——取消执行,随时可以叫停
- Esc + Esc——出错了?双击回退到检查点
- Ctrl + R——搜索历史命令,不用重复输入
- /compact——token 快用完了?压缩一下再继续
- /clear——换任务了?彻底清空更干净
- /model opus——遇到难题?切换最强模型
- /init——新项目第一件事,生成 CLAUDE.md
- @文件路径——引用文件,比粘贴内容省 token
- claude -c——继续昨天的会话,无缝衔接
- claude -p “任务”——自动化脚本的入口
- /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 循环切换模式,切到 auto 或 acceptEdits 即可跳过当前会话的确认提示。
几种模式的区别:
| 模式 | 行为 |
|---|---|
default | 每次操作都询问 |
acceptEdits | 自动允许文件编辑,bash 命令仍询问 |
auto | 自动允许大部分操作 |
--dangerously-skip-permissions | 跳过全部提示,包括危险操作 |
日常开发推荐用 auto 模式,写入 settings.json 最省事。如果是在 CI/CD 脚本里用,配合 -p 参数加 --dangerously-skip-permissions 是标准做法。
发表回复