admin/Obsidian
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
Obsidian/AiCoding/Claude Code 命令大全.md
T
coco 8b94d76799 a
2026-07-21 13:57:15 +08:00

16 KiB
Raw Permalink Blame History

title, source, author, published, created, description, tags
title source author published created description tags
Claude Code 命令大全 https://x.com/shachepi/status/2032036375894413458
Unknown
2026-03-08 2026-03-13 Be quiet
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日

Reference in New Issue View Git Blame Copy Permalink