--- title: "Claude Code 命令大全" source: "https://x.com/shachepi/status/2032036375894413458" author: - "[[Unknown]]" published: 2026-03-08 created: 2026-03-13 description: "Be quiet" tags: - "clippings" --- 本文内容基于Claude Code 2.1.74 整理。不同版本、套餐、插件、技能和平台,具体显示可能有少量差异。但是万变不离其宗。 发过一篇比较简单的,这篇更详细。**Codex和Gemini的命令版本请查看文章底部** 这篇教程的目标很简单: 1. 用最短路径让你能马上上手。 2. 用最清晰的结构让你不再混淆。 3. 用最少的记忆成本建立命令地图。 ## 一、先把命令体系分成三层 Claude Code 的命令体系只有三层,记住它,你就不会乱。 第一层:终端主命令,也就是你在 Shell 里直接输入的 claude,作用是“打开程序”。 第二层:终端子命令,也就是 claude 后面跟的功能菜单(auth、mcp、plugins 等),作用是“管理功能”。 第三层:Slash 命令,也就是进入交互界面后输入的 /help、/model、/clear 等,作用是“控制会话”。 一句话总结:主命令打开程序,子命令管理功能,Slash 命令控制会话。 ## 二、新手先记住 3 条主命令 这 3 条是你 90% 的入口: 1. claude:进入交互式 Claude Code 会话。 2. claude -p "任务":非交互模式,执行完直接输出后退出,适合脚本和批处理。 3. claude -c:继续当前目录最近一次会话,适合断点续聊。 如果你只记 3 个入口,优先记这三个。 ## 三、主命令常见参数(最有实际价值的一组) 下面是最常见、最有实际价值的一组全局参数: - \--add-dir:额外开放更多目录给 Claude Code 访问,适合跨目录读写。 - \--agent:指定当前会话使用哪个 agent。 - \--agents:临时传入自定义 agents 的 JSON 定义。 - \--allowed-tools:只允许指定工具运行。 - \--disallowed-tools:显式禁止某些工具运行。 - \--tools:自定义本次会话可用工具集合。 - \--system-prompt:直接覆盖本次会话的系统提示词。 - \--append-system-prompt:在默认系统提示词后追加补充说明。 - \--model:指定模型。 - \--fallback-model:默认模型拥堵时,为 print 模式指定备用模型。 - \--effort:指定思考强度,常见有 low、medium、high、max。 - \--permission-mode:指定权限策略,例如 default、auto、plan、dontAsk。 - \--settings:加载额外 settings 文件或 JSON。 - \--setting-sources:限制只从哪些设置层读取配置。 - \--mcp-config:加载 MCP 配置文件或 JSON。 - \--strict-mcp-config:只使用命令行指定的 MCP 配置。 - \--plugin-dir:临时加载某些插件目录。 - \--debug:开启调试模式。 - \--debug-file:把调试日志写入指定路径。 - \--verbose:强制打开 verbose。 - \-p 或 --print:输出后退出,不进入交互模式。 - \--output-format:控制输出格式,可用于 text、json、stream-json。 - \--input-format:控制输入格式,常用于 text 或 stream-json。 - \--json-schema:要求输出满足指定 JSON Schema。 - \--include-partial-messages:流式输出时包含中途分片。 - \--max-budget-usd:限制本次 print 模式的 API 花费上限。 - \--no-session-persistence:不保存会话到本地。 - \--session-id:手动指定会话 ID。 - \--fork-session:恢复旧会话时,分叉出一个新会话。 - \--from-pr:从关联 PR 恢复会话。 - \--ide:如果本机只有一个可用 IDE,自动连接。 - \--chrome 或 --no-chrome:开启或关闭 Claude in Chrome 集成。 - \-w 或 --worktree:为本次任务创建新的 Git worktree。 - \--tmux:配合 worktree 建立 tmux 会话。 - \--file:启动时下载文件资源到指定相对路径。 如果从“小白优先级”来排序,最值得先记的是下面 5 个: 1. \--model:指定模型。 2. \--effort:指定思考强度。 3. \--permission-mode:控制工具权限策略。 4. \--debug:开启调试模式。 5. \--output-format:控制输出格式。 ## 四、哪些参数要格外谨慎 下面这一组要特别小心,因为它们会直接影响 Claude Code 的行为边界和安全边界: 1. \--dangerously-skip-permissions:跳过权限确认。 2. \--allow-dangerously-skip-permissions:允许跳过权限确认。 3. \--tools:自定义可用工具集合。 4. \--system-prompt:直接覆盖系统提示词。 5. \--permission-mode:切换权限策略。 ## 五、一级子命令总览 Claude Code 当前常见一级子命令如下: - claude agents:列出或管理 agents。 - claude auth:管理登录状态和账号认证。 - claude auto-mode:查看 auto mode 分类器配置。 - claude doctor:检查 Claude Code 安装和更新器健康状态。 - claude install:安装 Claude Code 原生版本。 - claude mcp:管理 MCP 服务器。 - claude plugin 或 claude plugins:管理插件。 - claude setup-token:设置长期认证 token。 - claude update 或 claude upgrade:检查并安装新版本。 ## 六、auth 认证命令 这一组用于登录、退出和查看认证状态: - claude auth login:登录 Anthropic 账号。 - claude auth login --email 你的邮箱:预填邮箱。 - claude auth login --sso:强制走 SSO 登录。 - claude auth logout:退出当前账号。 - claude auth status:查看认证状态。 - claude auth status --json:以 JSON 格式显示。 - claude auth status --text:以人类可读文本显示。 ## 七、auto-mode 命令 这一组用于看自动模式的规则: - claude auto-mode config:输出当前生效的 auto mode 配置。 - claude auto-mode defaults:输出默认的 auto mode 规则。 这类命令更像“查看系统策略”,不是日常高频,但排障时很有用。 ## 八、doctor、install、update、setup-token - claude doctor:检查安装状态和自动更新器健康情况。 - claude install stable:安装稳定版。 - claude install latest:安装最新版。 - claude install 具体版本号:安装指定版本。 - claude install --force:即使已安装,也强制重新安装。 - claude update:检查更新并安装。 - claude upgrade:与 update 类似,用于升级。 - claude setup-token:配置长期认证 token。 ## 九、MCP 命令详解 MCP 可以理解成 Claude Code 对外接工具、服务和上下文桥接的一套机制。 常见命令如下: - claude mcp list:列出已经配置的 MCP 服务器。 - claude mcp get 名称:查看某个 MCP 的详情。 - claude mcp add 名称 命令或URL:新增一个 MCP。 - claude mcp add-json 名称 JSON:用 JSON 直接添加 MCP。 - claude mcp add-from-claude-desktop:从 Claude Desktop 导入 MCP。 - claude mcp remove 名称:删除 MCP。 - claude mcp reset-project-choices:重置当前项目里 MCP 的批准和拒绝记录。 - claude mcp serve:启动 Claude Code 自己的 MCP 服务端。 claude mcp add 常见参数: - \--transport:传输方式,常见是 stdio、sse、http。 - \--env:给 MCP 进程注入环境变量。 - \--header:给 HTTP 或相关连接设置请求头。 - \--scope:指定配置范围,常见是 local、user、project。 - \--client-id:某些 OAuth 场景下使用。 - \--client-secret:输入 OAuth client secret。 - \--callback-port:固定 OAuth 回调端口。 如果你是普通用户,最常见的是这三种场景: 1. 用 claude mcp list 看现在连了哪些服务。 2. 用 claude mcp add 增加一个本地或远程 MCP。 3. 用 claude mcp remove 删除不用的连接。 ## 十、插件命令详解 插件命令既可以写成 claude plugin,也可以写成 claude plugins。 常见命令如下: - claude plugins list:查看已安装插件。 - claude plugins list --json:以 JSON 显示。 - claude plugins list --available --json:连同市场可安装插件一起显示。 - claude plugins install 插件名:安装插件。 - claude plugins enable 插件名:启用插件。 - claude plugins disable 插件名:禁用插件。 - claude plugins disable -a:禁用全部已启用插件。 - claude plugins update 插件名:更新插件。 - claude plugins uninstall 插件名:卸载插件。 - claude plugins validate 路径:校验插件或 marketplace 的 manifest。 常见 scope 参数: - user:对当前用户生效。 - project:对当前项目生效。 - local:更偏向本地目录层的配置。 ## 十一、插件市场 marketplace 命令 这一组用于管理插件来源: - claude plugins marketplace list:列出已配置市场。 - claude plugins marketplace list --json:以 JSON 显示。 - claude plugins marketplace add 来源:添加一个市场。 - claude plugins marketplace remove 名称:删除一个市场。 - claude plugins marketplace update:更新全部市场。 - claude plugins marketplace update 名称:只更新指定市场。 claude plugins marketplace add 常见参数: - \--scope:指定市场定义写到 user、project 或 local 哪一层。 - \--sparse:如果来源是 monorepo,可用稀疏检出只拉一部分目录。 ## 十二、交互式 Slash 命令总览 使用方式很简单:先输入 claude 进入交互会话,再输入 /help、/model、/clear 这种命令。 注意三点: 1. Slash 命令属于“会话内部快捷指令”。 2. 不同版本、账号权限、插件、技能、平台,列表会略有变化。 3. 下面优先列的是本机交互菜单里实际抓到的命令。 ## 十三、上下文与会话管理类 Slash 命令 - /help:显示帮助和可用命令列表。 - /exit:退出当前 REPL。 - /clear:清空会话历史,释放上下文。 - /compact:压缩上下文,保留摘要。 - /resume:恢复之前的对话。 - /rewind:把代码和或对话回退到某个历史点。 - /fork:从当前点分叉一个新会话。 - /rename:重命名当前会话。 - /copy:复制 Claude 最近一条回复,或其中的代码块。 - /export:导出当前对话到文件或剪贴板。 - /diff:查看未提交变更和每轮差异。 理解这组命令的关键: 1. /clear 是彻底清空当前上下文。 2. /compact 是缩短上下文,但保留摘要记忆。 3. /resume 是恢复过去会话。 4. /rewind 是退回到过去某个检查点。 5. /fork 是从当前状态开一个分支,不是回退。 ## 十四、运行环境与界面设置类 Slash 命令 - /status:查看当前状态,例如版本、模型、环境。 - /stats:查看使用统计和活动。 - /usage:查看套餐额度和使用限制。 - /cost:查看当前会话总成本和耗时。 - /config:打开配置面板。 - /model:切换当前模型。 - /plan:进入或查看 Plan 模式。 - /permissions:管理工具权限规则。 - /sandbox:查看或配置沙箱状态。 - /theme:切换主题。 - /vim:切换 Vim 编辑模式和普通编辑模式。 - /fast:切换 Fast Mode。 - /ide:管理 IDE 集成和连接状态。 - /add-dir:添加工作目录。 - /statusline:设置状态栏 UI。 - /terminal-setup:为终端安装 Shift+Enter 换行支持。 ## 十五、账号、安装与连接类 Slash 命令 - /login:登录或切换 Anthropic 账号。 - /logout:退出账号。 - /upgrade:升级套餐。 - /doctor:检查安装状态。 - /init:初始化新的 CLAUDE.md 文件。 - /desktop:把当前会话继续到 Claude Desktop。 - /chrome:管理 Claude in Chrome 的设置。 - /mobile:显示二维码以下载 Claude 手机 App。 ## 十六、扩展能力类 Slash 命令 - /agents:管理 agent 配置。 - /hooks:管理工具事件 hooks。 - /skills:列出当前可用 skills。 - /mcp:管理 MCP 服务器。 - /plugin:管理 Claude Code 插件。 - /reload-plugins:让当前会话应用等待生效的插件改动。 - /install-github-app:为仓库接入 Claude GitHub Actions。 - /install-slack-app:安装 Claude Slack App。 ## 十七、工程流程与自动化类 Slash 命令 - /tasks:查看和管理后台任务。 - /loop:按固定间隔重复执行一个 prompt 或 slash 命令。 - /batch:用于大规模改动,先调研和规划,再推进执行。 - /review:审查 Pull Request。 - /pr-comments:读取 GitHub Pull Request 评论。 - /security-review:从安全角度检查当前待提交改动。 - /simplify:检查修改后的代码是否还能继续简化、复用或提质。 - /debug:开启本会话调试日志,辅助排障。 - /feedback:提交使用反馈。 - /stickers:订购 Claude Code 贴纸。 - /insights:生成 Claude Code 会话分析报告。 - /release-notes:查看发布说明。 ## 十八、动态技能型 Slash 命令 这一类命令不是每台机器都一样,因为它们取决于你本机装了哪些 skills、插件和扩展。 例如某些机器在交互补全里会看到: - /x-post-reply-skill:X 内容生成技能。 - /claude-api:Claude API / Anthropic SDK 使用指导。 要分清两件事: 1. 内置 Slash 命令,是 Claude Code 自己稳定提供的。 2. 动态技能命令,是当前环境额外挂进去的。 ## 十九、最推荐记住的高频命令 如果你不想一口气记太多,最值得优先掌握的是下面这些。 终端高频: 1. claude:启动交互式 Claude Code 会话。 2. claude -p "任务":一次性执行并输出后退出。 3. claude -c:继续当前目录最近一次会话。 4. claude --help:查看总帮助。 5. claude mcp list:列出当前 MCP 连接。 6. claude plugins list --json:以 JSON 查看插件列表。 Slash 高频: 1. /help:显示帮助和可用命令列表。 2. /clear:清空会话历史。 3. /compact:压缩上下文并保留摘要。 4. /status:查看当前状态。 5. /model:切换模型。 6. /permissions:管理工具权限规则。 7. /config:打开配置面板。 8. /mcp:管理 MCP 服务器。 9. /plugin:管理插件。 10. /review:审查 PR。 ## 二十、小白最容易混淆的 5 组区别 第一组:claude 和 claude -p 1. claude:进入交互界面。 2. claude -p:一次性执行,打印结果后退出。 第二组:/clear 和 /compact 1. /clear:直接清掉上下文。 2. /compact:压缩上下文,但保留摘要。 第三组:/resume 和 /rewind 1. /resume:找回旧对话。 2. /rewind:把当前状态退回过去。 第四组:MCP 和插件 1. MCP:外部能力连接器。 2. 插件:Claude Code 内部扩展模块。 第五组:终端子命令和 Slash 命令 1. 终端子命令:在 Shell 里运行。 2. Slash 命令:在 Claude Code 会话内部运行。 ## 二十一、最后给你的使用路线 如果你是第一次系统学 Claude Code,建议按这个顺序上手: 1. 先掌握 claude、claude -p、claude -c。 2. 再掌握 /help、/clear、/compact、/model。 3. 然后理解 auth、mcp、plugins 这三组命令。 4. 最后再碰 /permissions、/sandbox、/batch、/review 这类偏工程化的功能。 这样学,最稳,也最不容易乱。 ## 二十二、极简结论 Claude Code 的命令体系并不乱,它只是分成了终端入口、终端子命令、会话内 Slash 命令三层。 你真正需要先掌握的,不是“背完整清单”,而是先把三层地图建立起来。 如果你只想现在立刻开始用,那就记住下面这一组: 1. claude:启动交互式 Claude Code 会话。 2. claude -p "任务":一次性执行并输出后退出。 3. claude -c:继续当前目录最近一次会话。 4. /help:显示帮助和可用命令列表。 5. /clear:清空会话历史。 6. /compact:压缩上下文但保留摘要。 7. /model:切换当前模型。 8. /mcp:管理 MCP 服务器。 9. /plugin:管理插件。 10. /review:审查 PR。 ## 其他相关: > 3月8日 > 3月7日