跳至内容

Claude Code · 速查

Claude Code 速查手册

常用命令、快捷键、权限模式和配置文件的位置,按用途分组,敲一下就能找到。

v2.1.278 命令清单取自本机安装的该版本,只收录逐条验证存在的条目

先记住这四个

真正每天都会用到的就这几个,其余的用到时再查。

怎么敲做什么
claude在当前目录开一个会话。
claude -c接着当前目录最近那次对话继续,不用重新交代背景。
/clear清空对话重新开始。换话题时用它,比让 Claude 硬记着一堆无关内容强。
/compact上下文快满时压缩成摘要继续,保留要点、腾出空间。

在终端敲:常用调用

命令含义
claude启动交互会话。
claude "问题"带着第一个问题启动。
claude -p "问题"跑完直接打印结果就退出,适合写进脚本或接管道。
claude -c继续当前目录最近一次对话。
claude -r从历史会话里挑一个恢复;也可直接跟会话 ID。
claude install安装/更新原生版本,可指定 stable、latest 或具体版本号。

在终端敲:常用选项

跟在 claude 后面。带底色的那两条会关掉安全确认,看清楚再用。

选项含义什么时候用
--model <名>指定模型,可用别名 opus / sonnet / fable。想换脑子时
--permission-mode <模式>启动时就定好权限模式,见下面的权限模式表。想一上来就进只读或自动模式
--add-dir <目录…>额外允许访问的目录。代码和文档分在两个仓库
--allowedTools <工具…>只允许这些工具,例如 "Bash(git *) Edit"。想收紧能做的事
--disallowedTools <工具…>禁用这些工具。只想挡掉某几样
--effort <级别>思考投入程度:low / medium / high / xhigh / max。难题调高,杂活调低
--agent <名>用指定的 agent 开这次会话。有专门配好的角色
--output-format <格式>配合 -p:text / json / stream-json。要把结果喂给别的程序
-w, --worktree [名]为这次会话新建一个 git worktree,改动与主工作区隔离。不想弄脏当前工作区
--bg, --background会话转入后台并立刻返回,打印一个短 id 供后续操作。交给它慢慢跑,自己干别的
-n, --name <名>给这次会话起个显示名。同时开好几个容易搞混
--fork-session恢复时另起一个新会话 ID,而不是覆盖原来那条。想从某个点分两条路试
--fallback-model <名>主模型过载时自动降级到备用模型。长任务怕中断
--max-budget-usd <金额>配合 -p 限制这次最多花多少钱。跑自动化脚本时兜底
--safe-mode关掉所有自定义(CLAUDE.md、skills、插件、hooks、MCP…)启动。配置改崩了要排查
--restricted去掉能跑命令和代码的工具,文件操作限制在工作目录内。处理不信任的内容
-d, --debug开调试输出,可带类别过滤如 api,hooks。查为什么不按预期运行
--dangerously-skip-permissions跳过所有权限确认,什么都不问直接做。仅限无外网的沙箱
--allow-dangerously-skip-permissions允许「跳过权限」作为一个可选项,但不默认开启。同上,稍微温和一点

关于那两条危险选项:它们的意思是「任何操作都不再问你」——包括删文件、改配置、往外发东西。官方建议只在没有外网的沙箱里用。日常想少点打扰,优先用 acceptEdits 模式或在 /permissions 里配白名单,而不是整个关掉。

在终端敲:子命令

子命令含义
claude auth管理登录认证。
claude mcp配置和管理 MCP 服务器。
claude plugin管理插件。
claude doctor检查安装是否健康。会话里的 /doctor 更全,还能顺手修。
claude project管理项目状态。
claude import从别的 AI 编码工具导入配置。
claude setup-token生成长期认证令牌(需订阅)。
claude ultrareview云端多代理审查当前分支或指定 PR,打印结论。

后台会话

用 claude --bg 把活丢到后台,拿到一个短 id 之后就靠这几条操作它。

命令含义
claude agents列出所有后台会话。
claude attach <id>把某个后台会话接到当前终端来看。
claude logs <id>打印它最近的终端输出。
claude stop <id>停掉它,对话会留着,之后还能 attach 或 resume。
claude rm <id>删掉已退出的后台会话,安全时连它的 worktree 一起删。
claude respawn [id]用当前版本重启后台会话,--all 重启全部。

会话里敲:日常

在对话框里以 / 开头。/help 永远是最权威的清单——版本升级后新增的命令会先出现在那里。

命令含义
/help列出当前版本所有可用命令。
/clear清空对话重新开始。
/compact压缩上下文成摘要后继续。
/context看当前上下文用了多少、还剩多少。
/cost看这次会话花了多少。
/usage看用量和额度情况。
/status看当前会话的状态信息。
/todos看当前的待办列表。
/exit退出会话。

会话里敲:上下文与记忆

命令含义
/init扫描当前仓库,生成一份 CLAUDE.md 项目说明。
/memory编辑记忆文件,让偏好和约定跨会话生效。
/add-dir会话中途再加一个可访问目录。
/rewind回到之前某一步,连同那之后的文件改动一起撤掉。
/export导出当前对话。
/resume在会话里切换到另一段历史对话。

会话里敲:配置与权限

命令含义
/config打开设置界面,主题、模型这类简单项在这里改最快。
/model切换本次会话用的模型。
/permissions查看和编辑权限规则,把常用的安全操作加进白名单能少很多打扰。
/sandbox沙箱相关设置。
/hooks配置钩子。想要「每次 X 之后自动做 Y」只能靠它,写在记忆里是没用的。
/output-style切换输出风格。
/statusline配置底部状态栏显示什么。
/terminal-setup配置终端按键绑定,比如让 Shift+Enter 正常换行。
/privacy-settings隐私相关设置。

会话里敲:扩展与代码

命令含义
/agents管理子代理(agent)。
/skills看当前可用的技能。
/plugin管理插件。
/review审查代码改动。
/security-review对当前分支的改动做安全审查。
/install-github-app安装 GitHub App 做仓库集成。
/teleport传送会话。

会话里敲:账号与维护

命令含义
/login登录。
/logout登出。
/doctor给安装做全面体检,还能顺手修问题。
/upgrade升级订阅。
/release-notes看更新日志,升级后想知道多了什么就看它。
/feedback提交反馈。

输入框前缀

在对话框行首打这几个字符,会切换成不同的输入方式。

打这个含义
/斜杠命令。
!直接执行一条 shell 命令,输出会进到对话里。需要你亲自跑的交互式命令(比如登录)用它最方便。
@引用文件或目录,带补全。
#把这句话写进记忆。

权限模式

会话里按 Shift+Tab 循环切换,或启动时用 --permission-mode 指定。

模式含义
manual每个需要授权的动作都问你一次。最稳,也最啰嗦。
auto由分类器自动判断哪些该放行、哪些该问。可用 claude auto-mode 查看或重置它的配置。
acceptEdits文件编辑自动放行,其它动作照常问。日常写代码最顺手的档位。
plan只读:先调研、出方案,等你点头才动手改东西。
dontAsk不弹权限询问;需要询问才能进行的动作不会执行。
bypassPermissions全部放行,什么都不问。只适合没有外网的沙箱。

配置文件在哪

同名设置以靠上的为准。搞不清某条设置为什么没生效时,从上往下捋一遍。

  1. 最高 命令行参数 本次启动传的 --model、--permission-mode 之类,压过所有文件。
  2. 项目·私有 .claude/settings.local.json 只属于你自己这台机器,一般不提交进仓库。
  3. 项目·共享 .claude/settings.json 跟着仓库走,团队共用。
  4. 用户 ~/.claude/settings.json 你所有项目的默认值。

给 Claude 看的说明文字则放在这几个文件里:

文件含义
./CLAUDE.md项目级说明,跟着仓库走,团队共用。/init 能生成一份初稿。
./CLAUDE.local.md项目级但只属于你自己的说明。
~/.claude/CLAUDE.md全局说明,对你所有项目生效。
./.mcp.json项目级 MCP 服务器配置。
~/.claude/keybindings.json自定义快捷键。

四种扩展方式,别用混

这四样经常被搞混。选错了会出现「我明明写了它却不照做」的情况。

放哪是什么什么时候选它
~/.claude/skills/<名>/SKILL.md把一套做事流程打包,Claude 遇到对口的任务会自己加载。某类任务有固定套路
.claude/agents/*.md子代理:独立上下文的专门角色。要并行干活或隔离噪音
.claude/commands/*.md自定义斜杠命令,敲 /名字 触发。想手动一键触发一段提示词
settings.json 里的 hooks由程序在特定事件上强制执行的脚本,不依赖 Claude 是否愿意照做。要求「每次都必须」发生的事

最容易踩的坑:想要「以后每次都自动做某件事」,写进 CLAUDE.md 或记忆里是不保险的——那只是给 Claude 的建议,它可能忽略。真正每次都执行的只有 hooks,因为那是程序在跑,不是模型在自觉。

可挂钩的事件:PreToolUse、PostToolUse、UserPromptSubmit、Notification、PreCompact、PostCompact、SubagentStart、SubagentStop、SessionEnd。完整清单以 /hooks 里显示的为准。

本页命令清单提取自本机安装的 Claude Code 2.1.278,只收录逐条验证存在的条目;快捷键与配置路径按常用情况整理。版本更新后以会话里的 /help 和 /release-notes 为准。