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 | 全部放行,什么都不问。只适合没有外网的沙箱。 |
配置文件在哪
同名设置以靠上的为准。搞不清某条设置为什么没生效时,从上往下捋一遍。
-
最高
命令行参数
本次启动传的
--model、--permission-mode之类,压过所有文件。 - 项目·私有 .claude/settings.local.json 只属于你自己这台机器,一般不提交进仓库。
- 项目·共享 .claude/settings.json 跟着仓库走,团队共用。
- 用户 ~/.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 里显示的为准。