先看要点

Claude Code 常用命令主要分为终端里的 CLI 命令、会话内的斜杠命令,以及 Git 等普通 shell 命令。开始任务可用 claude,恢复会话可用 claude -c 或 claude -r,检查改动可用 /diff 或 Git 命令。本文按实际工作场景整理用法,并提醒你以本机帮助和当前版本为准。

本文依据 Claude Code 官方 CLI 参考和命令参考整理,核查日期:2026年10月9日。命令的可用性可能因版本、平台、账号和运行环境而不同;遇到命令不一致时,先查本机帮助,不要直接照搬旧教程。

Claude Code 的命令分别在哪里输入?

先看命令的开头和输入位置,避免把终端命令误输进对话框:

命令类型输入位置例子主要用途
CLI 命令操作系统终端claude -c启动、恢复或以非交互方式运行 Claude Code
会话命令Claude Code 对话输入区/diff查看改动、调整会话或调用代码审查工作流
shell 命令终端,或会话中获准执行 shell 的位置git status查看 Git 工作区、运行项目自身的工具

命令名字相似,不代表作用相同。例如,claude -c 是启动程序时使用的终端参数;/resume 是会话内用于选择或恢复对话的命令。git diff 属于 Git 命令,而 /diff 是 Claude Code 的会话命令。区分这三类,比背诵一长串命令更实用。

启动新任务或继续上次工作,用哪些 CLI 命令?

  • claude:在当前终端目录启动交互式会话。要让 Claude 处理某个项目,先在终端确认自己处于目标项目目录,再运行它。
  • claude "explain this project":启动交互式会话,并附带一条初始任务。实际使用时,可以把引号里的英文示例替换成自己的任务描述。
  • claude -c:继续当前目录中的最近一次对话。适合在同一个项目里接着处理上次工作。
  • claude -r "auth-refactor" "Finish this PR":按会话 ID 或名称恢复指定对话,并发送新的任务内容。示例中的名称和提示词需替换为你自己的内容。
  • claude -v:查看 CLI 版本号。排查命令是否和教程一致时,可以先确认本机安装版本。
  • claude update:官方 CLI 参考列出的更新命令。具体是否适用于你的安装渠道,应以当前安装方式和官方说明为准。

恢复会话前,确认正在使用的项目目录和会话名称。特别是同时处理多个仓库时,不要只因任务描述相似就选中第一个结果;先确认历史对话属于哪个项目,再继续发出修改指令。

执行期间,哪些会话命令最值得记?

  • /help:查看帮助与可用命令。某个命令不在帮助或命令列表里时,可能是当前环境不可用,也可能是版本不同,不要默认是输入错误。
  • /plan:进入计划模式,适合先分析范围较大的任务,再审阅实施思路。计划确认前,避免把“先分析”误当成已经同意修改代码。
  • /model:打开模型选择入口;官方命令参考也支持按参数选择模型。可用选项取决于当前账号和环境,不能假设每个人看到的列表相同。
  • /context:查看当前上下文的使用情况。当会话很长、Claude 开始遗漏早期条件时,可用它判断上下文是否需要整理。
  • /compact:总结当前对话以释放上下文;可以按需要补充摘要重点。它适用于继续同一任务但对话过长的情况。
  • /clear:清空当前对话上下文,开始新任务,同时保留项目记忆。若还需要回看旧任务,可考虑用恢复会话的方式,而不是误把清空当成删除项目文件。
  • /status:查看版本、模型、账户和连接状态等信息,适合在确认配置时使用。
  • /usage:查看会话开销、套餐使用限制和活动统计等信息。显示内容会受账号和环境影响。

/context、/compact 和 /clear 解决的问题不同:先查看上下文状况,再决定是否压缩;如果要彻底切换到一件无关的新工作,才考虑清空当前对话。不要因为想让回复变短,就把清空会话当成上下文整理工具。

怎样检查改动,并避免把权限交得过多?

  • /diff:查看 Claude 在当前工作树中做了哪些更改。适合每次任务完成后,用来逐项检查改动范围。
  • /code-review:对当前差异进行代码审查,查找可能的正确性问题。它能帮助发现风险,但审查结果仍需结合代码和项目要求核实。
  • /permissions:查看或管理工具权限规则。遇到不确定的工具操作时,先检查权限设置,不要为了省去确认提示而扩大授权。
  • git status:查看当前工作区状态,判断有哪些文件已修改或尚未纳入版本控制。
  • git diff:在终端查看 Git 差异,可与 /diff 配合使用。前者是 Git 提供的 shell 命令,后者是 Claude Code 会话内的改动查看入口。

较稳妥的收尾顺序是先运行 git status,再用 /diff 或 git diff 检查具体内容,最后决定是否接受修改、运行测试或提交代码。检查命令不能替代人工审核:尤其要留意文件是否超出任务范围、是否覆盖了自己已有的工作,以及 shell 操作是否会影响重要数据。

官方 CLI 参考还提供 --dangerously-skip-permissions 这类跳过权限提示的选项。它会改变操作时的确认方式,不适合作为日常提速的默认手段。初学者更应保留对文件修改和命令执行的审阅机会;只有明确理解风险,并处于合适的隔离环境时,才考虑使用高权限运行方式。

脚本或自动化任务,常用什么入口?

claude -p "query" 会打印回复,而不进入交互模式,适合一次性查询或脚本化调用。官方参考也列出了通过管道提供内容的形式,例如 cat logs.txt | claude -p "explain",可将文件内容交给 Claude 分析。自动化任务应明确输入范围,并检查命令输出及退出状态;不要只看终端里出现了一段回复,就认定任务已成功完成。

非交互式命令更适合边界清楚、结果容易检查的任务,例如解释日志或生成一段分析。涉及删除、覆盖文件、访问凭据、生产数据或其他难以回滚的操作时,不宜在无人检查的情况下直接自动执行。密钥也不要写进公开脚本、提示词或可能被保留的日志中。

如果只是要在普通终端运行项目命令,先确认工作目录,再运行项目自身的测试或构建命令。Claude Code 的 CLI、Git 和项目脚本是不同工具;不能因为它们都在终端输入,就把某个 shell 命令当成 Claude Code 的内置命令。

新手日常先记哪几条命令?

刚开始时,先掌握一个短流程即可:

  1. 进入目标项目目录,运行 claude 开始交互式任务。
  2. 复杂任务先用 /plan 讨论方案;确认范围后再进行实现。
  3. 任务结束时用 /diff 检查 Claude 的改动,并用 git status 确认工作区状态。
  4. 要继续上次对话,优先试 claude -c;需要指定会话时,用 claude -r。
  5. 会话变长时先看 /context,再决定是否运行 /compact。

遇到命令无法识别或行为与教程不同,先在交互会话中看 /help,或在终端查看 claude --help 与 claude -v。CLI 帮助并不一定列出每个可用标志,因此官方说明和本机实际输出都值得核对;会话命令也并非对所有用户和环境都开放。遇到安装或配置问题时,终端中的 claude doctor 可运行只读安装与设置诊断;会话内的 /doctor 则用于会话中的设置检查,两者不要混为一谈。

常用命令不必一次全背:启动与恢复记住 claude、claude -c、claude -r,执行中按需使用 /plan、/context 和 /compact,结束前用 /diff 与 Git 检查改动。具体命令是否可用,以本机帮助和当前官方文档为准。

相关问题

如果某个 Claude Code 命令在本机无法识别,先检查什么?

先确认命令输入位置是否正确:CLI 命令在终端运行,会话命令在 Claude Code 对话中使用。然后查看本机版本和帮助信息,并确认该命令是否受当前版本、平台或账号环境限制。