Claude Code 速查表与快速参考

设置和访问

$curl -fsSL https://claude.ai/install.sh | bash
$curl -fsSL https://claude.ai/install.sh | bash

在 macOS、Linux 或 WSL 上原生安装 Claude Code,具有自动后台更新。

$irm https://claude.ai/install.ps1 | iex

从 Windows PowerShell 使用原生安装程序安装 Claude Code,具有自动后台更新。

$curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

从 Windows CMD 使用原生安装程序安装 Claude Code,具有自动后台更新。

$brew install --cask claude-code
$brew install --cask claude-code

使用 Homebrew 安装 Claude Code。

$brew upgrade claude-code
$brew upgrade claude-code

Homebrew 安装不会自动更新。运行此命令以获取最新功能和安全修复。

$winget install Anthropic.ClaudeCode

在 Windows 上使用 WinGet 安装 Claude Code。

$winget upgrade Anthropic.ClaudeCode

WinGet 安装不会自动更新。运行此命令以获取最新功能和安全修复。

$claude

在当前项目中启动交互式 Claude Code 会话。

$claude -v

显示已安装的 Claude Code 版本。

$claude update

手动将 Claude Code 更新到最新版本。

$claude --init

运行初始化钩子并启动交互模式。

$claude auth login

从终端登录到您的 Claude 帐户。使用 --email 预填电子邮件或 --sso 强制 SSO 身份验证。

$claude auth status --text

将身份验证状态显示为 JSON。使用 --text 获得人类可读的输出。如果已登录,则以代码 0 退出,否则以代码 1 退出。

$claude "write a test for this function"

运行一次性任务并获取响应,而无需启动交互会话。

$claude commit

使用 Claude Code 编写提交消息来创建 Git 提交。

/init

为当前项目初始化项目指导文件。

/memory

从会话内部打开 Claude 内存管理。

/login

登录到您的 Anthropic 帐户。

/logout

从您的 Anthropic 帐户注销。

/mobile
/ios
/android

显示二维码以下载 Claude 移动应用。

/import codex
/import gemini
/import cursor

将 OpenAI Codex、Google Gemini CLI 或 Cursor 的配置迁移到 Claude Code,包括指令文件、MCP 服务器、命令、子代理和技能。

提示和输入

$claude -p "explain this function"

在打印模式下运行 Claude 一次,并以单个响应退出。

Ctrl + G
Ctrl + X then Ctrl + E

在默认文本编辑器中打开当前提示。

/btw what was the name of that config file again?

提出一个侧边问题,而无需将其添加到主对话历史记录中。可以在 Claude 工作时运行。

Ctrl + K

删除从光标到行尾的内容。

Ctrl + U

删除整个当前行。

Ctrl + Y

粘贴使用 readline kill 命令删除的文本。

Alt + Y

粘贴后循环浏览较早的 kill-ring 条目。

Alt + B

将光标向后移动一个单词。

Alt + F

将光标向前移动一个单词。

Ctrl + V or Cmd + VAlt + VCtrl + V or Alt + V

从剪贴板粘贴图像。

\ + Enter
Shift + Enter
Ctrl + J
Option + EnterShift + EnterShift + Enter

为多行输入插入换行符。

/

从提示的开始处打开斜杠命令选择器。

!

从提示的开始处进入 bash 模式。

@

触发文件路径自动完成。

Tab

接受提示建议以进行编辑。

Enter

接受提示建议并立即提交。

Escape
Backspace
Ctrl + U

当提示为空时退出 bash 模式。

/voice

切换推送式语音听写。

Space
Enter
Escape

关闭 /btw 侧边问题覆盖层并返回主提示。

/goal all tests passing
/goal clear

设定目标:Claude 会在多轮之间持续工作,直到条件满足。传入 clear 可提前移除活动目标。

/loop 5m check if the deploy finished

在会话保持打开期间按间隔(如 5m)重复运行提示,或让 Claude 自行掌握节奏。别名:/proactive。

/schedule

创建、更新、列出或运行按计划在云端执行的例程。别名:/routines。

/deep-research compare state of the art RAG approaches

围绕一个问题发散多路网络搜索,获取并交叉核对来源,然后综合出带引用的报告。

Ctrl + S

暂存当前提示以便稍后使用。输入中有文本时会将其暂存并清空输入;在空输入上再次按下则恢复暂存的文本。

Ctrl + A

将光标移动到当前行的开头。在多行输入中,移动到当前逻辑行的开头。

Ctrl + E

将光标移动到当前行的末尾。在多行输入中,移动到当前逻辑行的末尾。

Ctrl + W

向前删除至上一个空白字符。一次按键即可删除整个路径或 --flag=value。

Alt + D

删除至当前单词的末尾;若光标位于单词之间,则删除至下一个单词的末尾。

Ctrl + _
Ctrl + Shift + -

撤销上一次输入编辑,恢复之前的输入文本和光标位置。

Ctrl + Enter
Ctrl + X then Ctrl + S

在 Claude 仍在工作时,立即发送排队中的消息以及你的草稿。

$claude -p "query" --output-format json

从打印模式获取 JSON 输出,用于脚本和自动化。

$claude -p --fallback-model sonnet "query"

当默认模型过载时,启用自动回退到指定模型(仅打印模式)。

$claude -p --max-turns 3 "query"
$claude -p --max-budget-usd 5.00 "query"

限制代理轮数,或为打印模式运行设置支出上限。

会话和上下文

$claude -c
$claude --continue

在当前目录中继续最近的对话。

$claude --resume auth-refactor
$claude -r

按 ID 或名称恢复特定会话,或显示交互式选择器以选择会话。

/clear
/reset
/new

清除当前会话并开始新的对话。

/compact "keep only the important parts"

压缩当前对话以仅保留重要上下文。

/resume
/continue

从当前会话内部恢复另一个对话。

/rename feature-auth

重命名当前对话。

/fork bug-investigation

将当前对话复制到新的后台会话并在此继续工作。传入提示可立即让副本开始处理。要亲自切换到某个分支,请使用 /branch;要把任务交给会汇报结果的子代理,请使用 /subtask。

/context

显示当前使用了多少上下文。

/plan fix the auth bug

进入计划模式,可选传入任务描述以立即开始规划。

/tasks

打开当前会话的任务列表。

/copy

将最后一条助手回复复制到剪贴板。传入数字 N 可复制倒数第 N 条回复,或从交互选择器中挑选单个代码块。

/export notes.txt

将当前响应导出到文件。

/desktop
/app

将终端会话传输到桌面应用或网络以进行可视差异审查和继续工作。

/add-dir <path>

将新的工作目录添加到当前会话。

/branch feature-auth
/fork

在此处创建当前对话的分支。

/remote-control
/rc

从 claude.ai 启用对当前会话的远程控制。

Esc + Esc

从键盘倒回或总结。

/background

分离当前会话使其作为后台代理运行,从而释放终端。分离前传入提示可再发送一条指令。别名:/bg。

/subtask refactor the auth module

派生一个继承完整对话的子代理,在你继续工作的同时处理任务。完成后其结果会返回到本对话。

/cd ../other-project

在保留对话的同时,将会话移动到新的工作目录。

/recap

按需生成当前会话的单行摘要。

/teleport

将 claude.ai 上的云端会话拉取到本终端。会先打开选择器,再获取分支和对话。别名:/tp。

/autocompact 500k
/autocompact auto

设置自动压缩窗口:上下文窗口填充到什么程度后 Claude Code 自动压缩。可传入 500k 等大小,或 auto 使用按模型调整的默认值。

$claude -w feature-auth
$claude --worktree

在 .claude/worktrees/<name> 的隔离 git worktree 中启动 Claude,使并行会话互不冲突。未指定名称时会自动生成。

$claude -n "my-feature-work"

为会话设置显示名称,显示在 /resume 和终端标题中。之后可用 claude --resume <name> 恢复。

$claude --resume abc123 --fork-session

恢复时创建新的会话 ID 而不是复用原 ID,保持原对话不变。

$claude --from-pr 123

恢复与指定 GitHub PR 关联的会话(通过 gh pr create 创建时自动关联)。

$claude --teleport

在本地终端恢复 claude.ai 的网页会话。

$claude --remote "Fix the login bug"

在 claude.ai 上用提供的任务描述创建新的网页会话。

$claude --remote-control "My Project"

启动启用了远程控制的交互式会话,以便也能从 claude.ai 或 Claude 应用控制它。

导航和控制

Ctrl + C

取消当前输入或生成。

Ctrl + F

终止所有后台代理。

Ctrl + D

退出 Claude Code 会话。

/exit
/quit

从命令提示符退出 Claude Code。

Ctrl + L

清除终端屏幕同时保留对话历史。

Ctrl + O

切换工具执行详细信息的冗长输出。

Ctrl + B

后台运行任务。Tmux 用户按两次 Ctrl+B。

Ctrl + T

显示或隐藏任务列表。

在对话框和菜单中循环浏览选项卡。

导航命令历史。

Ctrl + Z

将 Claude Code 挂起到你的 shell(仅 Unix)。运行 fg 可恢复。

审查和诊断

/diff

在 Claude 内显示当前差异。

/rewind
/checkpoint
/undo

将对话倒回到较早的检查点。

/doctor
/checkup

运行设置体检,诊断安装、设置、扩展和 CLAUDE.md 问题,并提出修复建议,经你确认后由 Claude 应用。

/status

显示当前 Claude 会话和帐户状态。

/stats

显示详细的对话和使用统计,包括会话历史和条纹。

/insights

生成分析 Claude Code 会话、交互模式和摩擦点的报告。

/usage

显示当前使用信息。

/cost

显示当前支出和成本信息。

/security-review

查看当前分支以了解安全问题。

Cmd + ClickCtrl + ClickCtrl + Click

从页脚打开链接的拉取请求。

/code-review
/code-review high 1234
/code-review ultra --fix
/review

审查当前差异,或指定 PR 编号、分支或路径,查找正确性 bug。传入 --fix 应用发现的问题,--comment 将其发布到 PR,或 ultra 进行深度多代理云端审查。别名:/review。

/simplify

审查已更改的代码以寻找清理机会并应用修复。四个代理并行运行,覆盖复用、简化、效率和抽象层次。不查找正确性 bug;如需请使用 /code-review。

/verify

通过构建应用、运行并观察结果,而不是依赖测试或类型检查,来确认代码改动达到了预期效果。

/debug login fails on safari

为当前会话启用调试日志,并通过阅读会话调试日志排查问题。可选描述问题以聚焦分析。

反向搜索

Ctrl + R

启动对命令历史的反向搜索或循环已有的匹配项。

Tab
Esc

接受当前反向搜索匹配以进行编辑。

Enter

接受当前反向搜索匹配并执行它。

Backspace

查询为空时退出反向搜索。

Ctrl + C

取消反向搜索并恢复原始输入。

配置和集成

/config
/settings
/config theme=dark

打开设置界面,或传入 key=value 对直接设置某项,如 /config thinking=false 或 /config model=sonnet。

/theme

打开主题选择器。

/color orange

设置界面颜色主题。

/keybindings

打开键绑定配置。

/terminal-setup

安装特定于终端的绑定,例如 Shift+Enter 支持。

/model

从当前会话内部切换模型。

/effort high

更改当前推理工作量级别。

/fast on

在当前会话中切换快速模式。

/permissions
/allowed-tools

打开权限设置。

/sandbox

打开沙箱设置。

/mcp

管理 MCP 服务器集成。

/plugin

从会话内部管理插件。

/reload-plugins

重新加载已安装的插件。

/ide

将 Claude Code 连接到您的 IDE。

/agents

打开代理和队友选项。

/hooks

查看工具事件和自动化的钩子配置。

/config

在设置界面中切换 Vim 和普通编辑模式。已于 v2.1.92 移除 /vim 命令。

/statusline

在您的 shell 提示符中配置 Claude Code 的状态行显示。

Shift + Tab
Alt + M

切换权限模式。

Option + PAlt + PAlt + P

在不清除当前提示的情况下切换模型。

Option + TAlt + TAlt + T

切换扩展思维模式。

Ctrl + T

在主题选择器内切换语法突出显示。

/usage-credits

达到速率限制时配置使用额度,或向管理员申请。此前为 /extra-usage。

/output-style concise

列出输出样式或切换到某个样式。

/update-config allow npm test without prompting

描述一项设置更改(如允许某命令或添加 hook),Claude 会编辑相应的 settings.json 文件。主题和模型请改用 /config。

/fewer-permission-prompts

扫描你的会话记录中常见的只读 Bash 和 MCP 工具调用,然后在项目设置中添加按优先级排列的允许列表,以减少权限提示。

/skill-doctor

显示每项技能占用的上下文成本和使用频率,便于找出要关闭的技能。

/list-agents
/peers

列出 Claude 可发消息的子代理、代理团队队友及其他 Claude Code 会话,以及各自使用的名称。别名:/peers。

Option + OAlt + OAlt + O

开启或关闭快速模式。

$claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'

启动时通过 JSON 动态定义自定义子代理,使用与子代理 frontmatter 相同的字段外加 prompt 字段。

$claude --tools "Bash,Edit,Read"

限制 Claude 可使用的内置工具。使用 "" 禁用全部,"default" 表示全部,或列出工具名称。

$claude --effort high

启动时设置会话的努力程度:low、medium、high 或 max(仅 Opus,会话范围内有效)。

$claude --add-dir ../apps ../lib

添加启动时允许 Claude 访问的其他工作目录。

$claude --permission-mode plan

以指定的权限模式(如 plan)开始会话。

$claude --mcp-config ./mcp.json
$claude --strict-mcp-config --mcp-config ./mcp.json

从 JSON 文件或字符串加载 MCP 服务器,可选择忽略所有其他 MCP 配置。

帮助和发现

/help

打开内置斜杠命令帮助。

/skills

打开可用技能列表。

/release-notes

查看包含最近版本更新的完整更改日志。

/feedback
/bug

提交有关 Claude Code 的反馈或报告错误。

?

打开当前环境的快捷键图例。