# Claude Code 命令大全

> Claude Code 当前命令速查:CLI 启动参数、会话内斜杠命令、后台 agent、审查、权限模式和交互快捷键。

URL: https://docs.passion8.cc/docs/claude-code/commands
Language: zh-CN
Publisher: Passion8

Claude Code 的命令分两类:终端里的 `claude ...` 启动命令,以及会话内以 `/` 开头的斜杠命令。命令集会随版本更新,任何不确定都以 `/help` 和 `claude --help` 为准。

如果你关心每个命令会不会破坏 5 分钟/1 小时缓存,直接看 [命令与缓存影响](https://docs.passion8.cc/docs/claude-code/command-cache)。

如果你要把这些命令组织成日常开发流程,看 [最佳实践与工作流](https://docs.passion8.cc/docs/claude-code/best-practices-workflows)。

如果你关心键盘快捷键、Vim mode、shell mode、后台 Bash、tmux、fullscreen 或语音输入,看 [交互模式与终端体验](https://docs.passion8.cc/docs/claude-code/interactive-terminal)。




官方已移除旧 `/vim` 命令。现在要切换 Vim/normal 输入模式,用 `/config` 里的 Editor mode。







不是每个命令都会出现在你的 `/` 菜单里。官方命令会按 Claude Code 版本、平台、登录方式、计划、provider 和环境变量动态显示。最可靠的即时来源仍是当前环境里的 `/help`、`/` 菜单和 `claude --help`。




## CLI 启动命令

| 命令 | 作用 |
| --- | --- |
| `claude` | 进入交互式会话 |
| `claude "query"` | 带初始 prompt 进入交互 |
| `claude -p "query"` | print 模式,执行一次后退出,详见 [Headless 自动化](https://docs.passion8.cc/docs/claude-code/headless) |
| `claude -c -p "query"` | 继续最近会话并用 print 模式追问 |
| `claude -p "解释错误" < logs.txt` | 把 stdin 内容交给 Claude |
| `claude -c` | 继续当前目录最近会话 |
| `claude -r "<session>"` | 按 ID 或名称恢复会话 |
| `claude -n "<name>"` | 启动时给会话命名 |
| `claude update` | 更新 Claude Code |
| `claude install stable` | 安装或重装指定版本 |
| `claude doctor` | 自检安装、配置和登录状态 |
| `claude --safe-mode` | 禁用自定义项启动,用于排错 |

## 常用 CLI flags

| Flag | 作用 |
| --- | --- |
| `--model <model>` | 指定模型 |
| `--effort <level>` | 指定 reasoning effort |
| `--permission-mode <mode>` | 用指定权限模式启动 |
| `--add-dir <path>` | 额外授予目录访问 |
| `--settings <json/path>` | 用临时 settings 覆盖 |
| `--mcp-config <path>` | 额外加载 MCP 配置 |
| `--strict-mcp-config` | 只使用指定 MCP 配置 |
| `--tools "Bash,Edit,Read"` | 限制内置工具集合 |
| `--allowedTools "Read,Edit"` | 预批准工具,不是限制工具 |
| `--disallowedTools "mcp__*"` | 禁用工具或 MCP 工具 |
| `--output-format json` | print 模式输出 JSON |
| `--input-format stream-json` | 流式 JSON 输入 |
| `--json-schema <schema>` | 约束结构化输出 |
| `--worktree <name>` | 在隔离 git worktree 中运行,详见 [Worktrees](https://docs.passion8.cc/docs/claude-code/worktrees) |
| `--fork-session` | 从继续/恢复的会话复制分支 |
| `--plugin-dir <path>` | 临时加载本地插件目录 |
| `--append-system-prompt <text>` | 追加一次性系统提示 |
| `--system-prompt <text>` | 替换默认系统提示,谨慎使用 |
| `--setting-sources user,project,local` | 指定加载哪些 settings 来源 |
| `--remote-control` | 启动或连接 Remote Control |




`--allowedTools` 的语义是“预批准”,不是“只允许”。如果要限制 Claude 能看到哪些内置工具,用 `--tools`。如果要禁止工具,用 `--disallowedTools` 或 permissions deny。




## 子命令

| 命令 | 作用 |
| --- | --- |
| `claude auth login` | 登录 Anthropic 账号,可加 `--console` |
| `claude auth logout` | 退出登录 |
| `claude auth status` | 输出登录状态 |
| `claude mcp` | 管理 MCP server |
| `claude mcp login <name>` | 命令行触发 MCP OAuth |
| `claude mcp logout <name>` | 清掉 MCP OAuth |
| `claude agents` | 打开 agent view 或 JSON 列出后台 sessions |
| `claude attach <id>` | 附加到后台 session |
| `claude daemon status` | 查看后台 session supervisor 状态 |
| `claude daemon stop --any` | 停止后台 supervisor |
| `claude logs <id>` | 查看后台 session 日志 |
| `claude stop <id>` | 停止后台 session |
| `claude respawn <id>` | 重启后台 session |
| `claude rm <id>` | 从列表移除后台 session |
| `claude plugin` | 管理插件 |
| `claude plugins` | `claude plugin` 的别名 |
| `claude plugin init <name>` | 在 skills 目录初始化一个插件 |
| `claude gateway` | 管理员启动 Claude apps gateway |
| `claude project purge` | 清理项目本地 Claude Code 状态 |
| `claude auto-mode defaults` | 输出 auto mode 内置分类规则 |
| `claude auto-mode config` | 输出当前 auto mode 生效配置 |
| `claude setup-token` | 为脚本生成长期 OAuth token |
| `claude remote-control` | 以 server mode 启动远程控制 |

## 会话内命令:项目初始化

| 命令 | 作用 |
| --- | --- |
| `/init` | 为项目生成或改进 `CLAUDE.md` |
| `/memory` | 打开和编辑记忆文件 |
| `/mcp` | 查看、认证、管理 MCP server |
| `/permissions` | 管理 allow/ask/deny 规则 |
| `/config` | 打开设置,或用 `key=value` 直接改,输出风格见 [输出风格](https://docs.passion8.cc/docs/claude-code/output-styles) |
| `/status` | 打开状态页 |
| `/doctor` | 诊断安装、登录、配置问题 |
| `/debug` | 打开调试信息 |
| `/hooks` | 查看 hooks 配置和运行状态 |
| `/skills` | 列出技能,过滤、排序、切换可见性 |
| `/plugin list` | 查看已安装插件 |
| `/reload-plugins` | 重新加载插件变更 |
| `/theme` | 切换终端主题 |
| `/statusline` | 配置 [状态栏](https://docs.passion8.cc/docs/claude-code/statusline) |
| `/chrome` | 配置 [Claude in Chrome](https://docs.passion8.cc/docs/claude-code/chrome-computer-use) |
| `/claude-api [migrate]` | 加载 Claude API/Managed Agents 参考或迁移代码 |

## 会话内命令:任务中

| 命令 | 作用 |
| --- | --- |
| `/plan` | 切入计划模式,先研究不改文件 |
| `/advisor [model\|off]` | 打开或关闭 advisor tool |
| `/model` | 切换模型,会造成缓存 miss |
| `/effort` | 调整 reasoning effort,会造成缓存 miss |
| `/fast` | 切换 fast mode |
| `/dataviz [request]` | bundled skill,做图表、dashboard 和数据可视化设计 |
| `/deep-research <question>` | bundled workflow,并行搜索和交叉验证来源 |
| `/clear [name]` | 清空上下文开始新对话,可给旧会话命名 |
| `/compact [说明]` | 摘要当前历史,腾出上下文 |
| `/context [all]` | 查看上下文窗口占用 |
| `/rewind` | 回退对话和文件检查点,详见 [Checkpoint 与回退](https://docs.passion8.cc/docs/claude-code/checkpointing) |
| `/recap` | 生成当前会话摘要供查看,不替换历史 |
| `/btw <question>` | 问一个不进入对话历史的旁路问题 |
| `/copy [N]` | 复制最近回复或指定回复 |
| `/export` | 导出当前会话 |
| `/rename <name>` | 给当前会话命名 |
| `/color [color\|default]` | 设置当前会话提示栏颜色 |
| `/usage` | 查看会话成本、计划用量、活动统计 |
| `/cost` | `/usage` 的别名 |
| `/stats` | `/usage` 的别名 |
| `/usage-credits` | 配置超出计划后的 usage credits |

## 会话内命令:并行和后台

| 命令 | 作用 |
| --- | --- |
| `/tasks` | 查看当前会话后台任务,也可用 `/bashes` |
| `/background [prompt]` | 把当前会话转入后台 agent |
| `/bg` | `/background` 别名 |
| `/stop` | 停止当前附加的后台 session |
| `/batch <instruction>` | 把大型变更拆成多个 worktree/subagent 并行执行 |
| `/branch [name]` | 从当前位置复制一条会话分支 |
| `/fork` | 把当前上下文分派给后台子任务 |
| `/agents` | 提醒或管理 [子代理](https://docs.passion8.cc/docs/claude-code/subagents) 配置 |
| `/workflows` | 查看动态 workflow 进度 |
| `/goal` | 设置一个持续推进的完成条件 |
| `/loop` | 配合 schedule/monitor 做循环检查或定时提示,详见 [Routines 与 /loop 调度](https://docs.passion8.cc/docs/claude-code/routines-scheduling) |

多代理、后台 session 和 workflow 的选型见 [多代理、后台与 Workflows](https://docs.passion8.cc/docs/claude-code/parallel-agents)。

## 会话内命令:审查和发布前

| 命令 | 作用 |
| --- | --- |
| `/diff` | 查看当前改动 |
| `/code-review [level] [--fix]` | 审查当前 diff,可自动修复发现项 |
| `/review` | 对 GitHub PR 做只读审查 |
| `/security-review` | 更深的安全审查 |
| `/simplify [target]` | 只做清理型 review 并应用修复 |
| `/verify` | 构建、运行并观察应用是否真的可用 |
| `/ultrareview` | 深度云端 review,推荐新写法是 `/code-review ultra` |
| `/ultraplan <prompt>` | 在云端草拟更深计划,再回到终端执行 |
| `/autofix-pr [prompt]` | 让 Claude Code on the web 盯 PR 失败和评论并修复 |

## 会话与远程

| 命令 | 作用 |
| --- | --- |
| `/resume` | 从历史会话恢复 |
| `/cd <path>` | 把当前会话移动到新工作目录 |
| `/add-dir <path>` | 增加可访问目录 |
| `/teleport` | 把 web 会话拉到当前终端 |
| `/remote-control` | 允许从 Claude app 或 claude.ai 控制本地会话 |
| `/web-setup` | 连接 GitHub 到 Claude Code on the web |
| `/schedule` | 设置一次性或周期性任务,详见 [Routines 与 /loop 调度](https://docs.passion8.cc/docs/claude-code/routines-scheduling) |
| `/terminal-setup` | 配置终端快捷键 |
| `/tui [default/fullscreen]` | 切换终端 UI renderer |
| `/voice [hold/tap/off]` | 语音输入 |
| `/desktop` | 打开或连接桌面端能力,按平台和登录方式显示 |
| `/upgrade` | 打开升级入口,按计划显示 |
| `/feedback` | 携带会话上下文反馈问题 |

Web、Remote Control、`/teleport` 和 Passion8 自定义 Base URL 的边界见 [Web、远程控制与移动端](https://docs.passion8.cc/docs/claude-code/remote-web)。调度和 routines 的细节见 [Routines 与 /loop 调度](https://docs.passion8.cc/docs/claude-code/routines-scheduling)。

## 按环境显示的官方命令

这些命令不是每个账号、平台和 provider 都会出现。它们通常受 Claude Code 版本、登录状态、Claude 订阅、操作系统、Anthropic API/Bedrock/Vertex/Foundry 路径、GitHub/Slack 权限和当前终端能力影响。

| 命令 | 作用 | 可用性/边界 |
| --- | --- | --- |
| `/help` | 打开当前环境可用命令帮助 | 最可靠的即时命令来源,比静态文档更贴近当前版本 |
| `/login` | 登录 Anthropic 或 Claude 账号 | Passion8 自定义 Base URL 场景通常不需要,排查官方账号能力时再用 |
| `/logout` | 退出当前登录 | 会影响后续官方能力,不是普通模型缓存优化命令 |
| `/ide` | 管理 IDE 集成和连接状态 | 主要在 VS Code、JetBrains 等 IDE 场景显示 |
| `/desktop`, `/app` | 把当前会话交给 Claude Code Desktop | macOS/Windows 且 Claude subscription 登录后显示 |
| `/mobile`, `/qr` | 生成移动端连接二维码 | 用于 Claude mobile app 或 Web 远程接续 |
| `/remote-env` | 选择默认云端 agent 环境 | 影响后续 cloud session,不等同本地 `/cd` |
| `/install-github-app` | 安装 Claude GitHub App,可继续配置 Actions 和 secrets | 需要 GitHub 权限和 `gh` 状态,适合仓库自动化 |
| `/install-slack-app` | 安装 Claude Slack app | 需要 Slack workspace 权限 |
| `/design-login` | 为 `/design-sync` 授权设计系统访问 | 依赖 claude.ai 账号能力 |
| `/design-sync [hint]` | 上传 React design system 到 Claude Design | Anthropic API 可用,Bedrock、Google Cloud Agent Platform、Foundry 下底层工具不能访问 claude.ai 时不可用 |
| `/powerup` | 交互式学习 Claude Code 功能 | 教程入口,不是生产工作流命令 |
| `/fewer-permission-prompts` | 扫描历史并建议减少权限提示的 allowlist | 会改权限习惯,适合确认项目已隔离后使用 |
| `/focus` | 开关更安静的 fullscreen focus view | 视觉模式,依赖 fullscreen/TUI 支持 |
| `/scroll-speed` | 调整 fullscreen 滚动速度 | 主要在 fullscreen renderer 下有意义 |
| `/keybindings` | 查看或配置键盘绑定 | 具体支持取决于终端和宿主编辑器 |
| `/exit` | 退出或脱离当前界面 | 在后台 session、fullscreen 或特定界面里含义会变化 |
| `/run` | 按项目 recipe 启动和驱动应用 | 依赖项目 skill 或 `/run-skill-generator` 记录的构建方式 |
| `/run-skill-generator` | 生成项目运行/验证 skill | 项目构建流程变化后应重新跑 |
| `/sandbox` | 切换 sandbox 模式 | 只在支持的系统、安装方式和权限策略下显示 |
| `/release-notes` | 查看版本更新说明 | 适合确认某命令是新增、改名还是移除 |
| `/reload-skills` | 重新加载 skills | 和 `/reload-plugins` 不完全一样,更偏 skill 可见性和内容刷新 |
| `/insights` | 生成会话使用和摩擦报告 | 会读取历史/使用数据,结果可能较长 |
| `/heapdump` | 生成诊断用 heap snapshot | 排查内存问题,不属于常规工作流 |
| `/privacy-settings` | 打开 Pro/Max 隐私设置 | 只在相关账号和计划下显示 |
| `/passes` | 管理 pass/额度类入口 | 账号能力相关,非核心开发命令 |
| `/pr-comments` | 查看或处理 PR 评论相关入口 | 需要 GitHub/PR 上下文 |
| `/setup-bedrock` | 配置 Amazon Bedrock provider | 仅在 Bedrock 环境变量或向导入口下显示 |
| `/setup-vertex` | 配置 Google Vertex AI provider | 仅在 Vertex 环境变量或向导入口下显示 |
| `/team-onboarding` | 从近期使用历史生成团队上手文档 | 会读取本地使用历史,适合团队推广 |
| `/stickers` | 订购 Claude Code stickers | 账号/地区相关的非核心命令 |
| `/radio` | 打开 Claude Code radio | 娱乐或实验入口,不影响核心开发 |
| `/vim` | 旧 Vim mode 命令 | v2.1.92 起移除,现在用 `/config` 里的 Editor mode |

## 输入区快捷玩法

| 输入 | 作用 |
| --- | --- |
| `/` | 打开命令补全 |
| `!` | shell mode,运行命令并把输出带入上下文 |
| `@` | 引用文件、目录或资源 |
| `#` | 快速写入记忆 |
| 粘贴图片 | 把截图或设计图放入上下文 |

## 常用快捷键

| 快捷键 | 作用 |
| --- | --- |
| `Ctrl+C` | 取消输入或打断 |
| `Ctrl+D` | 退出 |
| `Ctrl+L` | 清屏,不清上下文 |
| `Ctrl+R` | 搜索历史 |
| `Ctrl+O` | 展开/收起 transcript |
| `Ctrl+B` | 后台任务/会话相关入口 |
| `Ctrl+T` | 切换 TODO 视图 |
| `Esc` | 打断当前回复 |
| `Esc` 两次 | 回退并编辑上一条消息 |
| `Shift+Tab` | 切换权限模式 |
| `Option+P` | 快速进入 plan 相关操作 |
| `Option+T` | 打开任务视图 |
| `Option+O` | 打开输出或 transcript 相关入口 |

不同终端对 `Option`、`Shift+Enter`、图片粘贴支持不同。不稳定时先跑 `/terminal-setup`。

## 权限模式速查

| 模式 | 说明 |
| --- | --- |
| `default` | 默认,命令和写文件需要确认 |
| `acceptEdits` | 自动接受编辑 |
| `plan` | 只读研究,不改源文件 |
| `auto` | 自动审批研究预览 |
| `dontAsk` | 未预批准直接拒绝 |
| `bypassPermissions` | 跳过大多数提示,只用于隔离环境 |

详见 [权限与模式](https://docs.passion8.cc/docs/claude-code/permissions)。

## 命令与缓存影响

这张表把常见命令和 5 分钟 / 1 小时缓存放在一起看。TTL 只决定“多久没用会过期”,不改变哪些动作会命中或失效。完整逐命令表见 [命令与缓存影响](https://docs.passion8.cc/docs/claude-code/command-cache)。

| 命令或动作 | 对缓存的影响 | 5m / 1h 怎么理解 |
| --- | --- | --- |
| 普通追问 | 旧前缀通常命中,只处理新内容 | 5m 或 1h 内持续对话会刷新 TTL |
| `/model` | 模型是 cache key,下一轮全量 miss | TTL 再长也不能跨模型复用 |
| `/effort` | effort 是 cache key,下一轮全量 miss | 先定 effort,中途少切 |
| `/fast` | 首次开启可能因 header 或模型变化 miss | 在长会话中途开最贵 |
| `/compact` | 摘要请求读旧缓存,摘要后重建短历史缓存 | 适合自然断点,不是每轮都用 |
| `/clear` | 新会话重新加载项目上下文 | 旧会话仍可 `/resume` |
| `/rewind` | 回到早前前缀,通常能命中旧缓存 | 比 compact 更适合放弃错误方向 |
| `/recap` | 只追加摘要输出,不替换历史 | 缓存友好,但不省上下文 |
| `/cd` | 官方说明会尽量保留 conversation cache | 新目录 CLAUDE.md 作为消息追加 |
| `/config` 改 `outputStyle` | 当前会话通常不立即换 system prompt;`/clear` 或新会话后生效 | 生效后的第一轮通常全量 miss |
| `/statusline` | 配置过程是普通对话;脚本刷新不调用模型 | 状态栏本地运行,不吃 5m/1h 缓存 |
| `/usage` / `/cost` / `/stats` | 查看用量,不改变 prompt 前缀 | 不因查看用量而失效 |
| `/theme` | 终端 UI 主题,不改变模型 prompt | 不影响 5m/1h 命中 |
| `/advisor` | advisor tool 定义在缓存断点后,通常不破坏旧前缀 | 可按任务打开,仍要看 provider 支持 |
| `/batch` | 主会话追加计划,每个后台 subagent 自己建缓存 | 大任务并行时总 token 会增加,但主上下文更干净 |
| `/background` / `/bg` | 同一个 session 转后台继续 | 后台停止期间不刷新 TTL |
| `/goal` | 设置目标本身不改系统前缀 | 后续自动推进按普通轮次刷新 TTL |
| `/loop` / `/schedule` | 周期触发新轮次 | 间隔超过 5m 时 5m TTL 容易冷,1h 更稳 |
| `/mcp` 连接/断开 server | 若工具 schema upfront,可能全量 miss | tool search/deferred tools 更友好 |
| `/reload-plugins` | 只含 skill/hook/agent 通常追加;带 MCP 取决于 tool search | reload 后第一轮体现成本 |
| 修改 `CLAUDE.md` | 当前会话不立即生效,也不立刻失效 | `/clear`、`/compact` 或重启后加载 |
| 切权限模式 | 通常不影响 prompt | plan + `opusplan` 可能因模型切换 miss |
| 子代理 | 子代理有自己的上下文和缓存 | 官方说明子代理使用 5m TTL,主会话不受影响 |
| `/branch` 或 fork | 复制已有前缀,可读父会话缓存 | TTL 内更容易命中 |

详见 [命令与缓存影响](https://docs.passion8.cc/docs/claude-code/command-cache)、[Prompt 缓存](https://docs.passion8.cc/docs/claude-code/prompt-caching)、[模型、Effort 与 Fast Mode](https://docs.passion8.cc/docs/claude-code/model-fast-mode)、[上下文窗口](https://docs.passion8.cc/docs/claude-code/context)、[输出风格](https://docs.passion8.cc/docs/claude-code/output-styles)、[状态栏](https://docs.passion8.cc/docs/claude-code/statusline)、[子代理](https://docs.passion8.cc/docs/claude-code/subagents) 和 [Worktrees](https://docs.passion8.cc/docs/claude-code/worktrees)。

## 自定义命令

把常用 prompt 固化到 `.claude/commands/<name>.md`:

```markdown title=".claude/commands/review.md"
---
description: 审查当前改动并指出问题
argument-hint: [可选:聚焦的文件或方向]
---

审查当前 git 改动,聚焦 $ARGUMENTS。
先看 `git diff --stat`,再列出潜在 bug、风险和建议。
```

调用:

```text
/review 登录模块
```

MCP server 也能暴露 prompt,命令名形如 `/mcp__<server>__<prompt>`。

## 官方参考

- [Commands](https://code.claude.com/docs/en/commands.md)
- [CLI reference](https://code.claude.com/docs/en/cli-reference.md)
- [Interactive mode](https://code.claude.com/docs/en/interactive-mode.md)
- [Status line](https://code.claude.com/docs/en/statusline.md)
- [Output styles](https://code.claude.com/docs/en/output-styles.md)