Claude Code 速查表 — 命令、快捷键和参数
Claude Code 斜杠命令、CLI 参数、键盘快捷键、CLAUDE.md 和设置文件位置、Hooks 以及 MCP 命令,一页全覆盖。
Claude Code 速查表 — freetoolsforweb.com
已于 对照 Claude Code 文档核实(最新版本 v2.1.302 (October 16, 2026))。Claude Code 每周会发布好几个版本,如需了解更新的内容,请查看更新日志,或运行 claude --help 和 /help。
共 8 个表格,169 条
内置斜杠命令#
在会话中输入 / 可查看你能用的所有命令,包括来自插件和 MCP 服务器的技能与命令。部分命令取决于你的套餐或平台。
| 命令 | 作用 | |
|---|---|---|
| /help | 显示帮助和可用命令。 | |
| /clear | 以空上下文开始新对话。别名 /reset 和 /new。旧对话仍可在 /resume 中找到。 | |
| /compact [instructions] | 总结目前的对话以释放上下文;可附加摘要侧重点说明。 | |
| /context | 以彩色网格显示上下文窗口用量,并提示哪些内容占用了空间。 | |
| /init | 为项目创建 CLAUDE.md 指南。 | |
| /memory | 编辑 CLAUDE.md 文件、开关自动记忆,并查看自动记忆条目。 | |
| /model [model] | 切换模型并保存为默认;不带参数时打开选择器(左右箭头调整推理强度)。 | |
| /effort [level|auto|status] | 设置推理强度(low 到 xhigh、max 或 auto);status 显示当前级别。 | |
| /fast [on|off] | 开关快速模式。 | |
| /config [key=value] | 打开设置(主题、模型、输出风格……)或直接设置某个值,例如 /config theme=dark。 | |
| /status | 显示版本、模型、账号和连接状态。 | |
| /usage | 会话费用、套餐用量限额和活动统计。别名 /cost 和 /stats。 | |
| /permissions | 管理工具的允许、询问和拒绝规则,以及工作目录。 | |
| /plan [description] | 进入计划模式,可直接附带任务:/plan fix the auth bug。 | |
| /resume [session] | 按 ID 或名称恢复对话,或打开会话选择器。 | |
| /rename [name] | 重命名当前会话(显示在提示栏和 /resume 中)。 | |
| /branch [name] | 从此处分支对话以尝试其他方向;原对话仍可在 /resume 中找到。 | |
| /fork [prompt] | 把对话复制到一个新的后台会话中,并在当前会话继续工作。 | |
| /background [prompt] | 将当前会话分离为后台代理运行(别名 /bg);用 claude agents 监控。 | |
| /rewind | 将对话和/或代码回退到之前的某个点。别名 /checkpoint 和 /undo。 | |
| /btw [question] | 问一个旁支问题,不加入对话。 | |
| /diff | 查看工作区中的改动,包括 Claude 做的修改。 | |
| /review [level] [pr|branch|path] | /code-review 的别名:检查当前 diff 或 PR 中的 bug。 | |
| /security-review | 检查当前分支上的改动是否有安全漏洞(需要 origin 远程仓库)。 | |
| /simplify [target] | 技能:检查改动代码的复用、简化和效率问题,然后应用修复。 | |
| /copy [N] | 将最后一条(或倒数第 N 条)回复复制到剪贴板;可单独选择代码块。 | |
| /export [filename] | 将对话以纯文本导出到文件或剪贴板。 | |
| /add-dir <path> | 在本次会话中让 Claude 访问另一个工作目录。 | |
| /cd <path> | 将会话移到新的工作目录,保留对话。 | |
| /agents | 创建子代理的提示:让 Claude 帮你,或编辑 .claude/agents/ 或 ~/.claude/agents/。 | |
| /tasks | 查看和管理后台任务(Shell 和子代理)。也可用 /bashes。 | |
| /skills | 列出可用技能;可筛选、按 token 开销排序,以及显示或隐藏。 | |
| /mcp | 管理 MCP 服务器连接和 OAuth;/mcp reconnect all 会重试失败的服务器。 | |
| /hooks | 查看你的钩子配置。 | |
| /plugin [subcommand] | 管理插件:列出、安装、启用、停用。 | |
| /keybindings | 打开键盘快捷键文件(~/.claude/keybindings.json)。 | |
| /output-style [style] | 列出输出风格或切换到某种风格。 | |
| /theme | 更改配色主题(自动、浅色、深色、色盲友好、ANSI)。 | |
| /statusline | 配置状态栏,或根据你的 Shell 提示符自动配置。 | |
| /terminal-setup | 为终端或编辑器安装 Shift+Enter 换行绑定。 | |
| /ide | 管理 IDE 集成并显示其状态。 | |
| /doctor | 技能:检查安装、设置、扩展和 CLAUDE.md,并提出修复建议。别名 /checkup。 | |
| /loop [interval] [prompt] | 技能:在会话保持打开期间重复运行某个提示,例如 /loop 5m check the deploy。 | |
| /schedule [description] | 创建、更新、列出或运行在云端执行的例行任务。 | |
| /goal [condition|clear] | 设定一个目标,Claude 会跨多轮持续推进直到完成。 | |
| /install-github-app | 安装 Claude GitHub App,并可选择设置 GitHub Actions。 | |
| /sandbox | 开关沙盒模式(仅限受支持的平台)。 | |
| /login | 登录你的 Anthropic 账号。 | |
| /logout | 退出登录。 | |
| /bug [report] | 在确认同意后报告 bug 或分享对话。 | |
| /release-notes | 按版本浏览更新日志。 | |
| /exit | 退出 CLI。别名 /quit。 | |
| /vim (removed) | 已在 v2.1.92 中移除。请改在 /config > Editor mode 中切换 Vim 编辑模式。 |
CLI 命令(在 Shell 中运行)#
| 命令 | 作用 | |
|---|---|---|
| claude | 启动交互式会话。 | |
| claude "query" | 带着第一条提示启动交互式会话。 | |
| claude -p "query" | 不使用交互界面,回答一次后退出(print / SDK 模式)。 | |
| cat file | claude -p "query" | 处理管道输入的内容,例如 cat logs.txt | claude -p "explain"。 | |
| claude -c | 继续当前目录中最近的一次对话。 | |
| claude -r "<session>" "query" | 按 ID 或名称恢复会话,可附带新提示。 | |
| claude update | 更新到最新版本。 | |
| claude install [version] | 安装或重新安装原生二进制文件:指定版本、stable 或 latest。 | |
| claude auth login | 登录(--console 改为通过 Anthropic Console 计费,而非订阅)。 | |
| claude auth status | 以 JSON 显示登录状态(--text 输出纯文本)。 | |
| claude agents | 打开代理视图,监控和派发后台会话。 | |
| claude doctor | 不启动会话,直接输出安装和设置诊断信息。 | |
| claude mcp | 配置 MCP 服务器(见下方 MCP 表格)。 | |
| claude plugin | 管理插件(别名 claude plugins)。 | |
| claude setup-token | 为 CI 和脚本生成长期有效的 OAuth token(需要订阅)。 | |
| claude -v | 输出已安装的版本。 |
CLI 参数#
参数写在 claude 之后、提示之前。有几个(标注 -p only)只适用于 print 模式。
| 参数 | 作用 | 示例 | |
|---|---|---|---|
| --print, -p | 不进入交互模式,直接输出回复。 | claude -p "query" | |
| --continue, -c | 载入当前目录中最近的一次对话。 | claude --continue | |
| --resume, -r | 按 ID 或名称恢复会话,或显示选择器。 | claude --resume auth-refactor | |
| --fork-session | 与 --resume 或 --continue 一起使用时,新建会话 ID 而不是沿用旧的。 | claude --resume abc123 --fork-session | |
| --name, -n | 为会话命名(显示在 /resume 和终端标题中)。 | claude -n "my-feature-work" | |
| --model | 本次会话使用的模型:别名(sonnet、opus、haiku、fable)或完整模型名。 | claude --model sonnet | |
| --fallback-model | 主模型过载或不可用时,按顺序回退到这些模型。 | claude --fallback-model sonnet,haiku | |
| --effort | 本次会话的推理强度:low、medium、high、xhigh、max 或 ultracode。 | claude --effort high | |
| --permission-mode | 以指定权限模式启动:default(手动)、acceptEdits、plan、auto、dontAsk、bypassPermissions。 | claude --permission-mode plan | |
| --dangerously-skip-permissions | 跳过权限确认(等同于 --permission-mode bypassPermissions)。只应在隔离的容器或虚拟机中使用。 | claude --dangerously-skip-permissions | |
| --allowedTools | 无需询问即可运行的工具,使用权限规则语法。 | claude --allowedTools "Bash(git log *)" "Read" | |
| --disallowedTools | 拒绝规则:只写工具名会移除该工具;带范围的规则会拒绝匹配的调用。 | claude --disallowedTools "Bash(rm *)" "Edit" | |
| --tools | 限制可用的内置工具:"" 表示不提供任何工具,"default",或一个列表。 | claude --tools "Bash,Edit,Read" | |
| --output-format | print 模式的输出格式:text、json 或 stream-json。 | claude -p "query" --output-format json | |
| --input-format | print 模式的输入格式:text 或 stream-json。 | claude -p --output-format json --input-format stream-json | |
| --json-schema | 运行结束时返回符合 schema 且经过校验的 JSON(print 模式)。 | claude -p --json-schema '{"type":"object"}' "query" | |
| --max-turns | 限制代理轮次上限(print 模式)。 | claude -p --max-turns 3 "query" | |
| --max-budget-usd | 预估 API 花费达到该金额时停止(print 模式)。 | claude -p --max-budget-usd 5.00 "query" | |
| --append-system-prompt | 在默认系统提示词后追加文本。 | claude --append-system-prompt "Always use TypeScript" | |
| --system-prompt | 替换整个系统提示词。 | claude --system-prompt "You are a Python expert" | |
| --add-dir | 添加 Claude 可以读取和编辑的其他工作目录。 | claude --add-dir ../apps ../lib | |
| --mcp-config | 从 JSON 文件或字符串加载 MCP 服务器。 | claude --mcp-config ./mcp.json | |
| --strict-mcp-config | 只使用 --mcp-config 中的服务器。 | claude --strict-mcp-config --mcp-config ./mcp.json | |
| --settings | 为本次会话从 JSON 文件或字符串加载设置。 | claude --settings ./settings.json | |
| --setting-sources | 要加载哪些设置文件:user、project、local。 | claude --setting-sources user,project | |
| --agents | 以内联 JSON 定义子代理。 | claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' | |
| --agent | 以指定代理身份运行会话。 | claude --agent my-custom-agent | |
| --worktree, -w | 在 .claude/worktrees/ 下的独立 git worktree 中启动。 | claude -w feature-auth | |
| --bare | 精简模式:跳过钩子、技能、插件、MCP、自动记忆和 CLAUDE.md,让脚本运行更快。 | claude --bare -p "query" | |
| --safe-mode | 关闭所有自定义配置启动,用于排查损坏的配置。 | claude --safe-mode | |
| --verbose | 逐轮显示完整输出。 | claude --verbose | |
| --debug | 调试模式,可按类别筛选。 | claude --debug='mcp,startup' | |
| --ide | 如果恰好只有一个可用 IDE,启动时自动连接。 | claude --ide | |
| --chrome | 启用 Claude in Chrome 浏览器集成。 | claude --chrome | |
| --version, -v | 输出版本号。 | claude -v |
权限模式#
用 Shift+Tab 循环切换,用 --permission-mode 指定启动模式,或在设置中设置 defaultMode。界面中名为 Manual 的模式在配置中写作 default。
| 模式 | 无需询问即可执行的操作 | 适用场景 | |
|---|---|---|---|
| default (Manual) | 仅读取。 | 逐项审核每个操作、处理敏感工作 | |
| acceptEdits | 读取、编辑文件和常见的文件系统命令(mkdir、touch、mv、cp...)。 | 边审查边迭代代码 | |
| plan | 读取;在可使用 auto 模式时,还包括分类器批准的命令。 | 修改前先探索代码库 | |
| auto | 所有操作,并在后台进行安全检查。 | 长任务,减少确认提示 | |
| dontAsk | 读取工作目录中的文件和预先批准的工具;其他一律拒绝。 | 严格受限的 CI 和脚本 | |
| bypassPermissions | 所有操作。 | 仅限隔离的容器和虚拟机 |
记忆:CLAUDE.md 文件及其位置#
CLAUDE.md 文件会在每次会话开始时加载。在其中使用 @path/to/file 可导入另一个文件(最多嵌套四层)。
| 文件 | 范围和用途 | |
|---|---|---|
| /Library/Application Support/ClaudeCode/CLAUDE.md | 托管策略(macOS):由 IT 部署的全组织指令。Linux 和 WSL:/etc/claude-code/CLAUDE.md;Windows:C:\Program Files\ClaudeCode\CLAUDE.md。 | |
| ~/.claude/CLAUDE.md | 适用于所有项目的个人指令。 | |
| ./CLAUDE.md or ./.claude/CLAUDE.md | 通过版本控制与团队共享的项目指令。 | |
| ./CLAUDE.local.md | 你在本项目中的私人笔记;请加入 .gitignore。 | |
| .claude/rules/*.md | 主题文件(testing.md、api-design.md);可选的 paths frontmatter 可让规则只对匹配的文件加载。 | |
| ~/.claude/projects/<project>/memory/ | 自动记忆:一个 MEMORY.md 索引加上 Claude 为自己编写的主题文件;用 /memory 管理。 | |
| AGENTS.md | 同样会作为项目指令读取;记忆文档说明了它何时代替 CLAUDE.md 或与其一起加载。 |
设置文件(优先级从高到低)#
托管设置优先于 --settings,其次是项目本地设置、共享项目设置,最后是用户设置。权限规则等列表会在各文件之间合并。
| 文件 | 范围和用途 | |
|---|---|---|
| managed-settings.json | 托管:由组织部署(文件、MDM 或服务器托管)。你自己的文件和 --settings 都无法覆盖其中的键。 | |
| --settings <file-or-json> | 命令行:在单次会话中覆盖下方的文件。 | |
| .claude/settings.local.json | 项目本地:只对你、只在本项目生效;不纳入 git。 | |
| .claude/settings.json | 共享项目:提交到仓库,让团队获得相同的权限、钩子和插件。 | |
| ~/.claude/settings.json | 用户:你在所有项目中的偏好(主题、模型、你的权限规则)。 | |
| ~/.claude.json | 由 Claude Code 自己写入:登录信息、MCP 服务器、各项目状态。不属于优先级层级。 | |
| ~/.claude/keybindings.json | 自定义键盘快捷键(用 /keybindings 打开);修改无需重启即可生效。 |
钩子事件#
钩子是写在设置文件 "hooks" 键中的 Shell 命令(或提示)。对于可阻止的事件,退出码 2 会阻止该操作,并把 stderr 显示给 Claude。
| 事件 | 触发时机 | |
|---|---|---|
| SessionStart | 会话开始或恢复。 | |
| Setup | Claude Code 以 --init-only 启动,或在 -p 模式下以 --init / --maintenance 启动。 | |
| UserPromptSubmit | 提交提示后、Claude 处理之前。 | |
| UserPromptExpansion | 输入的命令展开为提示时;可阻止展开。 | |
| PreToolUse | 工具调用运行之前;可阻止调用。 | |
| PermissionRequest | 工具调用需要权限决定时。 | |
| PermissionDenied | auto 模式拒绝某个工具调用时。 | |
| PostToolUse | 工具调用成功之后。 | |
| PostToolUseFailure | 工具调用失败之后。 | |
| PostToolBatch | 一批并行工具调用完成后、下一次模型调用之前。 | |
| Notification | Claude Code 发送通知时(权限确认、空闲提示……)。 | |
| MessageDisplay | 显示助手消息文本期间。 | |
| SubagentStart | 创建子代理时。 | |
| SubagentStop | 子代理完成时。 | |
| TaskCreated | 正在创建任务时。 | |
| TaskCompleted | 任务正被标记为完成时。 | |
| Stop | Claude 完成回复时。 | |
| StopFailure | 因 API 错误导致本轮结束时。 | |
| TeammateIdle | 代理团队中的某个队友即将进入空闲时。 | |
| InstructionsLoaded | CLAUDE.md 或 .claude/rules 文件加载到上下文时。 | |
| ConfigChange | 会话期间配置文件发生变化时。 | |
| CwdChanged | 工作目录改变时(配合 direnv 很有用)。 | |
| DirectoryAdded | 通过 /add-dir 添加工作目录时。 | |
| FileChanged | 被监视的文件在磁盘上发生变化时(matcher 列出文件名)。 | |
| WorktreeCreate | 正在创建 worktree 时;会替代默认的 git 行为。 | |
| WorktreeRemove | 由 WorktreeCreate 钩子创建的 worktree 被移除时。 | |
| PreCompact | 上下文压缩之前。 | |
| PostCompact | 压缩完成之后。 | |
| PreModelSwitch | 模型切换生效之前;可阻止切换。 | |
| PostModelSwitch | 会话的模型改变之后。 | |
| Elicitation | MCP 服务器在工具调用期间请求用户输入时。 | |
| ElicitationResult | 你回答 MCP 输入请求之后、回复发送之前。 | |
| SessionEnd | 会话结束时。 |
MCP 服务器命令#
作用域:local(默认,仅本项目,保存在 ~/.claude.json)、project(仓库中的 .mcp.json,与团队共享)和 user(你的所有项目,~/.claude.json)。
| 命令 | 作用 | 示例 | |
|---|---|---|---|
| claude mcp add --transport http <name> <url> | 添加远程 HTTP 服务器。 | claude mcp add --transport http notion https://mcp.notion.com/mcp | |
| claude mcp add [options] <name> -- <command> [args...] | 添加本地 stdio 服务器;-- 之后的内容用于运行该服务器。 | claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server | |
| claude mcp add --transport sse <name> <url> | 添加只提供 SSE 端点的服务器。 | claude mcp add --transport sse asana https://mcp.asana.com/sse | |
| --scope local|project|user | 选择服务器保存的位置(默认 local)。 | claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic | |
| claude mcp add-json <name> '<json>' | 通过 JSON 配置对象添加服务器。 | claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}' | |
| claude mcp list | 列出服务器及其健康状态(Connected、Needs authentication、Failed)。 | ||
| claude mcp get <name> | 显示某个服务器的详细信息和连接问题。 | claude mcp get notion | |
| claude mcp remove <name> | 移除服务器。 | claude mcp remove notion | |
| claude mcp login <name> | 无需打开 /mcp 即可运行服务器的 OAuth 流程。 | ||
| claude mcp add-from-claude-desktop | 导入在 Claude Desktop 中配置的服务器。 | ||
| claude mcp reset-project-choices | 重置你对项目级 .mcp.json 服务器的批准。 | ||
| claude mcp serve | 将 Claude Code 本身作为 stdio MCP 服务器运行,供其他应用使用。 |
键盘快捷键
最后核对:,依据 Claude Code v2.1.302(2026 年 10 月 16 日)。共 48 个快捷键。
大多数快捷键在所有系统上都相同,而且即使在 Mac 上也是用 Control 而不是 Command。macOS 上的 Option 键快捷键(Option 键 加 B、Option 键 加 P...)需要在终端中开启“Option as Meta”。大多数操作都可以在 ~/.claude/keybindings.json 中重新绑定(运行 /keybindings)。
显示全部 48 个快捷键,共 5 个类别
常规控制#
| 操作 | macOS | Windows / Linux | 复制 |
|---|---|---|---|
| 中断 Claude 或关闭对话框停止当前回复或工具调用;已完成的工作会保留。在权限确认中按 Esc 表示“否”。 | Esc 键 | Esc 键 | |
| 清空草稿,或打开回退菜单(提示为空时) | Esc 键 然后 Esc 键 | Esc 键 然后 Esc 键 | |
| 中断;在空闲提示中清空内容,再按一次退出 | Control 键 加 C | Control 键 加 C | |
| 退出 Claude Code(按两次)提示中有文字时,Ctrl+D 改为删除光标后的字符。 | Control 键 加 D | Control 键 加 D | |
| 循环切换权限模式(Manual、acceptEdits、plan、auto...) | Shift 键 加 Tab 键 | Shift 键 加 Tab 键或 Alt 键 加 M在 Windows 上,如果运行时未启用 VT 输入模式,则为 Alt+M。 | |
| 切换模型,不清空提示 | Option 键 加 PmacOS:需要在终端中开启“Option as Meta”(见 /terminal-setup 或文档)。 | Alt 键 加 P | |
| 开关扩展思考对始终进行思考的模型(Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable)无效。 | Option 键 加 T | Alt 键 加 T | |
| 开关快速模式 | Option 键 加 O | Alt 键 加 O | |
| 在文本编辑器中编辑提示 | Control 键 加 G或 Control 键 加 X 然后 Control 键 加 E | Control 键 加 G或 Control 键 加 X 然后 Control 键 加 E | |
| 从剪贴板粘贴图片 | Control 键 加 V或 Command 键 加 V在 iTerm2 中为 Cmd+V。 | Control 键 加 V或 Alt 键 加 V在 Windows 和 WSL 上为 Alt+V。 | |
| 反向搜索提示历史 | Control 键 加 R | Control 键 加 R | |
| 历史中的上一条 / 下一条提示在多行提示中,箭头键会先移动光标。 | 上箭头或 下箭头或 Control 键 加 P或 Control 键 加 N | 上箭头或 下箭头或 Control 键 加 P或 Control 键 加 N | |
| 开关对话记录查看器(详细显示工具调用) | Control 键 加 O | Control 键 加 O | |
| 将正在运行的 Bash 命令和代理转到后台在 tmux 中需按两次。 | Control 键 加 B | Control 键 加 B | |
| 显示或隐藏 Claude 的待办清单 | Control 键 加 T | Control 键 加 T | |
| 暂存提示(在空提示中再按一次即可恢复) | Control 键 加 S | Control 键 加 S | |
| 立即发送排队中的消息 | Control 键 加 Enter 键或 Control 键 加 X 然后 Control 键 加 S | Control 键 加 Enter 键或 Control 键 加 X 然后 Control 键 加 S | |
| 停止所有后台子代理(3 秒内按两次) | Control 键 加 X 然后 Control 键 加 K | Control 键 加 X 然后 Control 键 加 K | |
| 重绘屏幕(修复显示错乱) | Control 键 加 L | Control 键 加 L | |
| 将 Claude Code 挂起到 Shell(运行 fg 恢复) | Control 键 加 Z | Control 键 加 Z仅限 Linux;Unix Shell。 | |
| 接受自动补全建议 | Tab 键 | Tab 键 | |
| 显示快捷键帮助面板(提示为空时) | 问号 | 问号 | |
| 语音听写:按住(或轻按)空格键仅在开启 /voice 时可用。 | 空格键 | 空格键 |
提示文本编辑(readline 风格)#
| 操作 | macOS | Windows / Linux | 复制 |
|---|---|---|---|
| 移到行首 | Control 键 加 A | Control 键 加 A | |
| 移到行尾 | Control 键 加 E | Control 键 加 E | |
| 删除到行尾 | Control 键 加 K | Control 键 加 K | |
| 删除从光标到行首的内容 | Control 键 加 U或 Command 键 加 Delete 键iTerm2 和“终端”App 会把 Cmd+Backspace 发送为 Ctrl+U。 | Control 键 加 U | |
| 向前删除到上一个空格(整个路径或 --参数) | Control 键 加 W | Control 键 加 W | |
| 删除前一个单词 | Option 键 加 Delete 键 | Control 键 加 退格键Windows。 | |
| 粘贴上次删除的文本 | Control 键 加 Y | Control 键 加 Y | |
| 循环切换更早删除的文本(在 Ctrl+Y 之后) | Option 键 加 YmacOS:需要在终端中开启“Option as Meta”(见 /terminal-setup 或文档)。 | Alt 键 加 Y | |
| 后退一个单词 | Option 键 加 BmacOS:需要在终端中开启“Option as Meta”(见 /terminal-setup 或文档)。 | Alt 键 加 B | |
| 前进一个单词 | Option 键 加 FmacOS:需要在终端中开启“Option as Meta”(见 /terminal-setup 或文档)。 | Alt 键 加 F | |
| 删除到单词末尾 | Option 键 加 DmacOS:需要在终端中开启“Option as Meta”(见 /terminal-setup 或文档)。 | Alt 键 加 D | |
| 撤消对提示的上一次编辑 | Control 键 加 下划线或 Control 键 加 Shift 键 加 连字符 | Control 键 加 下划线或 Control 键 加 Shift 键 加 连字符 |
多行输入#
| 操作 | macOS | Windows / Linux | 复制 |
|---|---|---|---|
| 换行:输入 \ 后按 Enter(任何终端均可) | 反斜杠 然后 Return 键 | 反斜杠 然后 Enter 键 | |
| 用 Shift+Enter 换行在 iTerm2、WezTerm、Ghostty、Kitty、Warp、Apple 终端和 Windows Terminal 中原生可用;/terminal-setup 可为 VS Code、Cursor、Alacritty 和 Zed 添加该绑定。 | Shift 键 加 Return 键 | Shift 键 加 Enter 键 | |
| 用 Ctrl+J 换行(无需设置) | Control 键 加 J | Control 键 加 J | |
| 用 Option+Enter 换行 | Option 键 加 Return 键macOS:需要在终端中开启“Option as Meta”(见 /terminal-setup 或文档)。 | 无默认快捷键 |
快捷前缀:/、!、@#
| 操作 | macOS | Windows / Linux | 复制 |
|---|---|---|---|
| 开始输入命令或技能 | 斜杠 | 斜杠 | |
| Shell 模式:运行命令并加入其输出 | 感叹号 | 感叹号 | |
| 提及文件(路径自动补全) | at 符号 | at 符号 | |
| 表情符号短代码(:name:) | 冒号 | 冒号 |
对话记录查看器(Ctrl+O)#
| 操作 | macOS | Windows / Linux | 复制 |
|---|---|---|---|
| 退出对话记录查看器 | Q或 Control 键 加 C或 Esc 键 | Q或 Control 键 加 C或 Esc 键 | |
| 显示全部内容(经典渲染器) | Control 键 加 E | Control 键 加 E | |
| 跳到上一条 / 下一条提示(全屏) | 左花括号或 右花括号 | 左花括号或 右花括号 | |
| 将对话写入终端回滚缓冲区(全屏) | 左方括号 | 左方括号 | |
| 在 $EDITOR 中打开对话(全屏) | V | V |
所有功能都在浏览器中运行,搜索内容不会发送到任何地方。各条目均已对照 Claude Code 官方文档核实。 浏览全部免费工具.
发现问题,或者觉得哪里可以更好?每条消息我们都会阅读,并尽快修复。
这份 Claude Code 速查表把 Anthropic 编程智能体的命令、键盘快捷键和 CLI 参数集中在一个可搜索的页面上:/init、/compact、/context、/rewind 等斜杠命令,Shift+Tab 切换权限模式、连按两次 Esc 回退等快捷键,以及用于脚本的 claude -p、--continue、--model 和 --permission-mode 等参数。它还列出了 CLAUDE.md 和设置文件的存放位置、所有 Hook 事件和 MCP 命令——这些正是大家在会话中途最常需要查的内容。
所有内容均于 2026-10-18 对照 code.claude.com 上的官方文档核实,当时的最新版本是 v2.1.302(2026 年 10 月 16 日)。Claude Code 每周都会发布好几个版本,命令会不断新增、改名,偶尔也会被移除;已移除的命令会加以标注,而不是悄悄删掉。在会话中输入 / 或运行 claude --help,可以查看你所安装版本支持的功能;完整的选项列表请参阅链接的文档。
使用方法
- 在参考表中搜索命令、参数、文件或 Hook 事件(如“resume”“--model”“PreToolUse”)。
- 使用表格链接跳转到斜杠命令、CLI 参数、记忆文件、设置、Hooks 或 MCP。
- 点击“复制”即可复制命令或参数;每个标题或行旁边的 # 是指向该处的直达链接。
- 向下滚动查看键盘快捷键,分 macOS 和 Windows/Linux 两列,并有单独的搜索框。
- 点击“打印 / 另存为 PDF”,获得双栏打印版。
常见问题
Claude Code 最有用的斜杠命令有哪些?
/init 为项目创建 CLAUDE.md,/clear 重新开始,/compact 把长对话压缩成摘要以释放上下文,/context 显示上下文窗口被哪些内容占用。/model 切换模型,/resume 重新打开之前的对话,/rewind 把代码和对话回退到某个检查点,/permissions 管理哪些工具无需询问即可运行。/mcp、/memory 和 /usage 分别管理服务器、CLAUDE.md 文件和用量费用。
/clear 和 /compact 有什么区别?
/clear 以空白上下文开始新对话;旧对话会被保留,可以用 /resume 重新打开。/compact 保持同一个对话,但用摘要替换历史记录,这样 Claude 既记得你在做什么,又占用更少的上下文。你可以给 /compact 附加指令,比如摘要应侧重哪些内容。
如何在 Claude Code 输入框中换行?
输入一个反斜杠再按 Enter,所有终端都适用。Ctrl+J 也在所有终端中有效。Shift+Enter 在 iTerm2、WezTerm、Ghostty、Kitty、Warp、Apple 终端和 Windows Terminal 中原生可用;在 VS Code、Cursor、Alacritty 或 Zed 中,运行 /terminal-setup 即可添加。在 macOS 上,把 Option 设为 Meta 键后,Option+Enter 也能换行。
如何继续或恢复之前的 Claude Code 会话?
运行 claude -c(或 --continue)可重新打开当前目录中最近的对话;运行 claude -r 并加上会话 ID 或名称,可恢复指定的会话。在会话中,/resume 会打开一个选择列表。用 claude -n 或 /rename 给会话命名,以后更容易找到。
CLAUDE.md 和 settings.json 应该放在哪里?
适用于所有项目的个人指令放在 ~/.claude/CLAUDE.md;与团队共享的项目指令放在 ./CLAUDE.md 或 ./.claude/CLAUDE.md,私人的项目备注放在 ./CLAUDE.local.md。设置文件遵循同样的模式:~/.claude/settings.json 给自己用,.claude/settings.json 给团队用,.claude/settings.local.json 放你的私人覆盖设置。组织下发的托管设置优先级高于以上所有设置。
如何让 Claude Code 不再每次都请求权限?
按 Shift+Tab 切换权限模式:acceptEdits 让 Claude 无需询问即可编辑文件,auto 在后台安全检查的保护下运行所有操作。用 /permissions 或 --allowedTools 预先批准特定工具,例如 Bash(git diff *)。--dangerously-skip-permissions(bypassPermissions 模式)会关闭所有检查,只应在隔离的容器或虚拟机中使用。
打印模式:在脚本和 CI 中使用 Claude Code
claude -p "prompt" 会执行一个任务并直接输出答案,不进入交互界面,这正是在 shell 脚本、git hooks 和 CI 中需要的。你可以通过管道传入内容(cat error.log | claude -p "explain this"),并搭配只在这种场景下才有意义的参数:
• --output-format json 或 stream-json 输出机器可读格式;--json-schema 输出经过校验的结构化结果
• --max-turns 和 --max-budget-usd 限制运行时长和花费
• --allowedTools / --disallowedTools 或 --permission-mode dontAsk,避免它等待一个无人响应的确认提示
• --bare 跳过加载 hooks、插件、MCP 服务器和 CLAUDE.md,运行更快、结果更可预测
• -c 或 --resume 继续之前的打印模式对话
一分钟了解 Hooks
Hooks 是 Claude Code 在固定时间点运行的命令:PreToolUse 在工具调用前,PostToolUse 在工具调用后,Stop 在 Claude 完成时,Notification 在需要你介入时,SessionStart 在会话开始时,总共约 30 个事件(见上文列表)。它们写在设置文件的 "hooks" 键下,按事件分组,可以带一个可选的匹配器,比如 "Bash" 或 "Edit|Write"。
给 Edit 加一个运行格式化工具的 PostToolUse hook,就能让 Claude 改动的每个文件都保持格式统一。给 Bash 加一个 PreToolUse hook,可以检查命令内容,并以退出码 2 阻止执行;脚本输出到 stderr 的内容会作为原因展示给 Claude。运行 /hooks 可查看哪些 hooks 正在生效。
这份速查表如何保持最新
Claude Code 的命令集变化很快:/vim、/pr-comments 和 /ultraplan 都已在近期版本中被移除,而且几乎每周都有新命令加入。这里的每个条目都来自顶部所示日期的官方文档,并用通俗的语言加以概括,页面还链接了每张表的出处。
如果这里列出的某个命令在你的会话中不存在,请用 claude -v 查看版本,并用 claude update 更新。如果有命令存在却没有列出,它可能比上次核对的时间更新,或者是你的环境特有的技能、插件或 MCP 命令;/help 和 / 菜单始终会显示你的安装所支持的功能。
相关免费工具
- MCP 配置生成器 — 只需定义一次 MCP 服务器,即可得到 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf 和 Codex 各自所需的配置文件或命令。
- Token 计数器 — 精确统计 OpenAI 模型的 token 数,估算 Claude、Gemini 和 Llama 的 token 数,查看费用,并直观看到文本如何被切分成 token。
- 大模型 API 费用计算器 — 在 40 多个模型间对比你的用量成本,计入缓存、批量折扣、长上下文分档和推理 token。价格均注明来源和日期。
- VS Code 快捷键 — Visual Studio Code 在 Windows 和 Mac 上的全部默认快捷键,并注明 Linux 的差异:多光标、搜索、重构、终端。
- Git 速查表 — 按你想做的事整理 Git 命令:撤销上一次提交、重命名分支、删除远程分支。优先给出新式 switch/restore 命令并附经典写法,危险操作有醒目标记。