Files
Obsidian/Claude/Claude Code 命令大全.md
2026-07-21 14:53:24 +08:00

403 lines
16 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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日