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

在 macOS 上使用 Homebrew 安装 Claude Code。

$brew upgrade claude-code

Homebrew 安装不会自动更新。运行此命令以获取最新功能和安全修复(如果你安装的是该 cask,请使用 brew upgrade claude-code@latest)。

$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 -p --init "query"

在会话前使用 init 匹配器运行 Setup 钩子(仅打印模式)。

$claude auth login

从终端登录你的 Claude 账户。使用 --email 预填邮箱,--sso 强制 SSO,或 --console 使用 Console API 计费。

$claude auth status
$claude auth status --text

以 JSON 显示认证状态,或传入 --text 获取可读输出。已登录时退出码为 0,否则为 1。

$claude "explain this project"

以初始提示启动交互式会话。

/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 install stable

安装或重新安装原生 Claude Code 二进制文件。传入版本号、stable 或 latest。

$claude doctor

运行只读的安装和设置诊断,无需启动会话。

$claude setup-token

为 CI 和脚本生成长期有效的 OAuth 令牌。需要 Claude 订阅。

提示和输入

$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 + V in iTerm2)Alt + VCtrl + V (or Alt + V on WSL)

从剪贴板粘贴图像。

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

插入换行以进行多行输入。Shift+Enter 需要受支持的终端(运行 /terminal-setup);在 macOS 上,为 Option+Enter 启用 Option 作为 Meta。

/

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

!

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

@

触发文件路径自动完成。

Tab

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

Enter

提交已通过 Tab 或右方向键放入输入的提示建议。

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 --fallback-model sonnet,haiku "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

按 ID 或名称恢复对话,或打开会话选择器;后台会话会标记为 bg。

/rename feature-auth

重命名当前对话。

/fork bug-investigation

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

/context

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

/plan fix the auth bug

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

/tasks

查看和管理当前会话中的后台工作,包括运行中的 shell 和已完成的子代理。这是后台任务视图,不是 Claude 的待办清单。

/copy

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

/export notes.txt

将当前对话导出为纯文本,可选导出到文件。

/desktop
/app

在 Claude Code 桌面应用中继续当前会话(macOS 或 x64 Windows)。

/add-dir <path>

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

/branch feature-auth

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

/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

打开会话选择器,筛选与拉取请求关联的会话;接受 PR 编号或 GitHub/GitLab/Bitbucket URL。当 Claude 创建 PR 时会话会自动关联。

$claude --teleport

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

$claude --cloud "Fix the login bug"

使用提供的任务描述在 claude.ai 上创建新的云端会话。--remote 别名已弃用。

$claude --remote-control "My Project"
$claude --rc "My Project"

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

$claude --bg "investigate the flaky test"
$claude --bg --exec 'pytest -x'

将会话作为后台代理启动并立即返回。结合 --exec 可将 shell 命令作为后台作业运行。

$claude agents

打开代理视图以监控和调度并行的后台会话。

$claude logs 7c5dcf5d
$claude attach 7c5dcf5d

打印后台会话的近期输出,或在此终端中附加到该会话。

$claude stop 7c5dcf5d
$claude respawn 7c5dcf5d
$claude rm 7c5dcf5d

从 shell 停止、重启或移除后台会话。

导航和控制

Ctrl + C

取消当前输入或生成。

Ctrl + X then Ctrl + K

停止此会话中所有运行中的后台子代理(3 秒内按两次以确认)。

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

/usage 的别名,打开“统计”选项卡,显示会话费用、套餐使用限制和活动统计。

/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

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

$claude ultrareview 1234 --json

以非交互方式运行云端托管的多代理代码审查并打印结果。

反向搜索

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

管理 IDE 集成并显示连接状态。

/agents

打印提示,提醒你让 Claude 创建或管理子代理,或直接编辑 .claude/agents/ 或 ~/.claude/agents/。

/hooks

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

/config

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

/statusline

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

Shift + TabShift + Tab or Alt + M (when VT input mode is unavailable)Shift + Tab

切换权限模式。

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 动态定义自定义子代理;使用 --print 时也接受 JSON 文件路径。

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

限制 Claude 可以使用哪些内置工具。使用 "" 禁用全部,使用 "default" 表示默认集合,或列出工具名称。

$claude --effort high

启动时设置会话的努力级别:low、medium、high、xhigh、max 或 ultracode(取决于模型)。

$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 配置。

$claude --safe-mode

在禁用所有自定义的情况下启动,以排查损坏的配置。

$claude --bare -p "query"

以适合脚本的最小模式启动:跳过钩子、技能、插件、MCP 服务器和 CLAUDE.md 发现。

$claude --chrome
$claude --no-chrome

启用或禁用用于 Web 自动化和测试的 Chrome 浏览器集成。

$claude --settings ./settings.json

从 JSON 文件或内联 JSON 字符串加载此会话的设置。

$claude --plugin-dir ./my-plugin

仅为此会话从目录或 .zip 归档加载插件。

$claude -p --json-schema '{"type":"object","properties":{...}}' "query"

在代理完成工作流后获取符合 JSON Schema 的经过验证的 JSON 输出(仅打印模式)。

帮助和发现

/help

打开内置斜杠命令帮助。

/skills

打开可用技能列表。

/release-notes

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

/feedback
/bug

提交反馈或报告错误。/bug(别名 /share)打开与 /feedback 相同的对话框。

?

在提示为空时切换键盘快捷键帮助面板。