Claude Code
命令大全
Claude Code 当前命令速查:CLI 启动参数、会话内斜杠命令、后台 agent、审查、权限模式和交互快捷键。
Claude Code 的命令分两类:终端里的 claude ... 启动命令,以及会话内以 / 开头的斜杠命令。命令集会随版本更新,任何不确定都以 /help 和 claude --help 为准。
如果你关心每个命令会不会破坏 5 分钟/1 小时缓存,直接看 命令与缓存影响。
如果你要把这些命令组织成日常开发流程,看 最佳实践与工作流。
如果你关心键盘快捷键、Vim mode、shell mode、后台 Bash、tmux、fullscreen 或语音输入,看 交互模式与终端体验。
官方已移除旧 /vim 命令。现在要切换 Vim/normal 输入模式,用 /config 里的 Editor mode。
不是每个命令都会出现在你的 / 菜单里。官方命令会按 Claude Code 版本、平台、登录方式、计划、provider 和环境变量动态显示。最可靠的即时来源仍是当前环境里的 /help、/ 菜单和 claude --help。
#CLI 启动命令
| 命令 | 作用 |
|---|---|
claude | 进入交互式会话 |
claude "query" | 带初始 prompt 进入交互 |
claude -p "query" | print 模式,执行一次后退出,详见 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 |
--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 直接改,输出风格见 输出风格 |
/status | 打开状态页 |
/doctor | 诊断安装、登录、配置问题 |
/debug | 打开调试信息 |
/hooks | 查看 hooks 配置和运行状态 |
/skills | 列出技能,过滤、排序、切换可见性 |
/plugin list | 查看已安装插件 |
/reload-plugins | 重新加载插件变更 |
/theme | 切换终端主题 |
/statusline | 配置 状态栏 |
/chrome | 配置 Claude in Chrome |
/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 与回退 |
/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 | 提醒或管理 子代理 配置 |
/workflows | 查看动态 workflow 进度 |
/goal | 设置一个持续推进的完成条件 |
/loop | 配合 schedule/monitor 做循环检查或定时提示,详见 Routines 与 /loop 调度 |
多代理、后台 session 和 workflow 的选型见 多代理、后台与 Workflows。
#会话内命令:审查和发布前
| 命令 | 作用 |
|---|---|
/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 调度 |
/terminal-setup | 配置终端快捷键 |
/tui [default/fullscreen] | 切换终端 UI renderer |
/voice [hold/tap/off] | 语音输入 |
/desktop | 打开或连接桌面端能力,按平台和登录方式显示 |
/upgrade | 打开升级入口,按计划显示 |
/feedback | 携带会话上下文反馈问题 |
Web、Remote Control、/teleport 和 Passion8 自定义 Base URL 的边界见 Web、远程控制与移动端。调度和 routines 的细节见 Routines 与 /loop 调度。
#按环境显示的官方命令
这些命令不是每个账号、平台和 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 | 跳过大多数提示,只用于隔离环境 |
详见 权限与模式。
#命令与缓存影响
这张表把常见命令和 5 分钟 / 1 小时缓存放在一起看。TTL 只决定“多久没用会过期”,不改变哪些动作会命中或失效。完整逐命令表见 命令与缓存影响。
| 命令或动作 | 对缓存的影响 | 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 内更容易命中 |
详见 命令与缓存影响、Prompt 缓存、模型、Effort 与 Fast Mode、上下文窗口、输出风格、状态栏、子代理 和 Worktrees。
#自定义命令
把常用 prompt 固化到 .claude/commands/<name>.md:
.claude/commands/review.md
---
description: 审查当前改动并指出问题
argument-hint: [可选:聚焦的文件或方向]
---
审查当前 git 改动,聚焦 $ARGUMENTS。
先看 `git diff --stat`,再列出潜在 bug、风险和建议。调用:
/review 登录模块MCP server 也能暴露 prompt,命令名形如 /mcp__<server>__<prompt>。
#官方参考
Support / 支持
Need help? / 需要帮助？
接入、计费与模型异常可邮件联系；服务可用性以状态页为准。
For setup, billing, or model issues, email us. Check the status page for uptime.
也可使用右下角微信 / QQ 客服 · WeChat / QQ support is available at the bottom right
