Claude Code 命令参考（claude CLI）

本文档整理 Claude Code 命令行程序 claude 的用法：顶层子命令、启动参数（flags）、以及 交互会话内以 / 开头的内置命令。

校验说明： 已在当前环境执行 claude --version / claude --help 及主要子命令的 --help 做核对。下文 第 3～4 节以该校验时的 Claude Code 2.1.62 输出为准；你本机版本不同请以 claude --help 为准。官方在线文档（CLI reference）可能包含更新版本的额外子命令或标志，已收在 附录 A。

1. 快速对照

类别 说明
可执行名 claude
交互会话 在项目目录执行 claude，在提示符下输入自然语言或 /命令
非交互（打印模式） claude -p "…" 或 claude --print（-p 会跳过工作区信任对话框，仅在你信任的目录使用）
续聊 / 恢复 -c / --continue，-r / --resume（均可带可选参数，见下）
子命令（2.1.62 claude --help 所列） agents、auth、doctor、install、mcp、plugin、setup-token、update（与 upgrade 同义）

在会话中输入 / 可浏览当前环境可用的全部命令；部分命令随平台、订阅或功能开关隐藏（见 Built-in commands）。

2. 启动方式与会话形态

2.1 基本调用

形式 说明
claude 进入当前目录的交互会话
claude "初始提示" 启动时附带第一条用户消息（作为 prompt 参数）
claude -p "查询" 打印模式：执行后退出，无交互 TUI
cat file | claude -p "查询" 将管道 stdin 作为输入（配合 --input-format 等）

2.2 续聊与恢复（与 2.1.62 一致）

形式 说明
claude -c / claude --continue 继续当前目录最近一次会话
claude -c -p "查询" 在同一延续会话上执行单次打印查询
claude -r <会话ID或名称> 恢复指定会话
claude -r / claude --resume 无参数：打开交互式会话选择器；亦可传可选搜索词（见 --help 中 resume [value]）
claude --resume … --fork-session 恢复时新建会话 ID，不覆盖原会话
claude --from-pr [值] 按 PR 号/URL 恢复关联会话；无参时可打开选择器

会话显示名可在会话内用 /rename 设置（本机 2.1.62 的 claude --help 未列出 -n / --name 启动参数；若你版本中有，见附录 A）。

2.3 打印模式（-p / --print）常用搭配（2.1.62）

标志 说明
--output-format text|json|stream-json 输出结构
--input-format text|stream-json 输入格式；stream-json 为实时流式输入
--include-partial-messages 流式输出局部片段（需 --print 且 --output-format=stream-json）
--replay-user-messages 将 stdin 中的用户消息再输出到 stdout 做确认（需 stream-json 输入与输出）
--max-budget-usd <金额> API 花费上限（美元）
--no-session-persistence 不持久化会话，不可恢复
--json-schema '<schema>' 结构化输出 JSON Schema 校验
--fallback-model <model> 主模型过载时自动降级（仅与 --print 一起生效）

3. 顶层子命令（2.1.62）

3.1 claude update / claude upgrade

检查并安装更新（update 与 upgrade 为同一命令）。

3.2 claude install [options] [target]

安装 Claude Code 原生构建。[target] 可为 stable、latest 或具体版本号。--force：即使已安装也强制重装。

3.3 claude doctor

检查 自动更新器健康状态（与交互里 /doctor 的全面诊断不同侧重时，以各自输出为准）。

3.4 claude setup-token

配置长期认证令牌（需 Claude 订阅；详见交互提示）。

3.5 claude auth

子命令 说明
claude auth login 登录。2.1.62 帮助列出： --email、 --sso。若需 Console/API 计费账号等流程，以 Authentication 为准
claude auth logout 登出
claude auth status 认证状态（--text 人类可读等选项见 claude auth status --help）

会话内快捷方式：/login、/logout。

3.6 claude agents [options]

列出已配置的 agents。选项： --setting-sources <sources>（与顶层同名参数含义一致）。

3.7 claude mcp

管理 MCP 服务器。

claude mcp add [options] <name> <commandOrUrl> [args...]

  • 传输： -t, --transport <stdio|sse|http>，未指定时默认为 stdio。
  • HTTP 示例： claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
  • Header： -H, --header（帮助文案称可用于 WebSocket 等场景，按提示格式传递）
  • stdio 与环境变量： -e, --env KEY=value（可多次）
  • 作用域： -s, --scope local|user|project，默认 local
  • OAuth： --callback-port、--client-id、--client-secret（或通过环境变量 MCP_CLIENT_SECRET）

-- 用法： 所有 claude mcp add 的选项须出现在 <name> 之前；-- 之后为子进程命令与参数。

其它子命令：

子命令 说明
add-json [options] <name> <json> 用 JSON 字符串添加（帮助中描述为 stdio 或 SSE）
add-from-claude-desktop [options] 从 Claude Desktop 导入（Mac 与 WSL）
list 列出已配置服务器
get <name> 查看单个服务器详情
remove [options] <name> 删除
reset-project-choices 重置本项目中对已批准/拒绝的 project 级 .mcp.json 服务器的选择
serve [options] 启动 Claude Code 作为 MCP server（-d/--debug、--verbose）

会话内管理：/mcp。

3.8 claude plugin

子命令 说明
install / i claude plugin install [options] <plugin>；`-s user
uninstall / remove claude plugin uninstall [options] <plugin>；-s 默认 user（2.1.62 无 --keep-data，若新版本增加见附录）
enable / disable 启用或禁用插件
update 更新到最新版（提示可能需重启生效）
list 列出已安装插件；--json；--available 需与 --json 同用
validate <path> 校验插件或 marketplace 的 manifest
marketplace 子命令：add <source>、list、`remove

会话内：/plugin、/reload-plugins。

3.9 claude remote-control（未出现在 2.1.62 的 claude --help 列表中）

本机执行 claude remote-control --help 在未登录时会提示需 claude.ai 订阅并先登录。说明二进制内包含该命令，但 claude --help 的 Commands 表未列出（可能是隐藏或帮助滞后）。用途与参数以登录后帮助或 Remote Control 为准。

4. 启动标志一览（与 Claude Code 2.1.62 claude --help 对齐）

下列为顶层 claude [options] [command] [prompt] 的 Options；说明为中文摘要。

4.1 工作目录、会话、IDE、工作树

标志 说明
--add-dir <directories...> 额外允许工具访问的目录
-c, --continue 继续当前目录最近会话
-r, --resume [value] 按 ID 恢复，或打开选择器（可选搜索词）
--fork-session 与 --resume / --continue 联用，新建会话 ID
--session-id <uuid> 固定会话 UUID
--from-pr [value] 按 PR 恢复或 PR 选择器
--ide 仅当检测到唯一可用 IDE 时自动连接
-w, --worktree [name] 新建 git worktree 并在其中会话
--tmux / --tmux=classic 依赖 --worktree；iTerm2 原生分屏或经典 tmux

4.2 权限与工具

标志 说明
--permission-mode <mode> 可选值（2.1.62）： acceptEdits、bypassPermissions、default、dontAsk、plan
--allow-dangerously-skip-permissions 允许选用「跳过权限」类模式，但不默认开启；仅建议隔离/无网络沙箱
--dangerously-skip-permissions 绕过权限检查；高风险，同上
--allowedTools / --allowed-tools <tools...> 允许的工具列表（逗号或空格分隔，示例见 --help）
--disallowedTools / --disallowed-tools <tools...> 禁止的工具列表
--tools <tools...> 内置工具子集；"" 全关，default 全部，或 Bash,Edit,Read 形式

4.3 模型与其它行为

标志 说明
--model <model> 模型别名（如 sonnet、opus）或完整 ID
--effort <level> 2.1.62 帮助仅列出： low、medium、high（会话级；是否与在线文档的 max 等一致取决于版本）
--betas <betas...> API key 用户的 beta 请求头
--fallback-model <model> 与 --print 联用，主模型过载时回退
--agent <agent> 覆盖设置中的 agent
--agents <json> JSON 动态定义自定义 agents
--chrome / --no-chrome 启用 / 禁用 Claude in Chrome
--system-prompt <prompt> 替换本会话系统提示（覆盖默认）
--append-system-prompt <prompt> 在默认系统提示后追加

4.4 MCP 与插件

标志 说明
--mcp-config <configs...> 从 JSON 文件或字符串加载 MCP（可多个）
--strict-mcp-config 仅使用上述配置中的 MCP
--mcp-debug 已弃用，请用 --debug
--plugin-dir <paths...> 本会话仅从指定目录加载插件（可重复）

4.5 配置、调试、通用

标志 说明
--settings <file-or-json> 额外加载设置 JSON 文件或字符串
--setting-sources <sources> user,project,local 逗号分隔
-d, --debug [filter] 调试类别过滤，如 api,hooks 或 !1p,!file
--debug-file <path> 将调试日志写入文件（隐式开启 debug）
--verbose 详细输出
--disable-slash-commands 2.1.62 描述为： 禁用全部 skills（slash 能力）
-h, --help 帮助
-v, --version 版本号

4.6 打印模式专用

标志 说明
-p, --print 打印结果后退出
--output-format text（默认）、json、stream-json
--input-format text（默认）、stream-json
--include-partial-messages 流式输出增量消息块
--replay-user-messages 流式下回显用户消息到 stdout
--json-schema <schema> 结构化输出校验
--max-budget-usd <amount> 花费上限
--no-session-persistence 不写入磁盘、不可恢复

4.7 其它顶层标志（2.1.62）

标志 说明
--file <specs...> 启动时下载文件资源，格式 file_id:relative_path

4.8 System prompt 补充

2.1.62 顶层帮助仅列出 --system-prompt 与 --append-system-prompt，未列出 --system-prompt-file / --append-system-prompt-file；若你版本中有，见附录 A。在线文档建议：优先用 append 以保留内置能力。

5. 交互式内置命令（/…）

在 Claude Code 提示符下输入。表中 <arg> 表示必填，[arg] 表示可选。以下为 Built-in commands 的整理译意；以你本机输入 / 补全为准。

命令 用途
/add-dir <路径> 向当前会话增加工作目录
/agents 管理 subagent 配置
/btw <问题> 侧车式快速提问，不写入主对话历史
/chrome 配置 Claude in Chrome
/clear 清空对话释放上下文；别名 /reset、/new
/color [颜色|default] 提示条颜色
/compact [说明] 压缩对话
/config 打开设置；别名 /settings
/context 上下文占用可视化
/copy [N] 复制最近第 N 条助手回复
/cost Token 使用统计
/desktop 转到桌面端继续（macOS / Windows）；别名 /app
/diff 交互 diff
/doctor 诊断安装与配置
/effort [low|medium|high|max|auto] 调整 effort
/exit 退出；别名 /quit
/export [文件名] 导出对话
/extra-usage 超额用量配置
/fast [on|off] fast mode
/feedback [内容] 反馈；别名 /bug
/branch [名称] 对话分支；别名 /fork
/help 帮助
/hooks Hook 配置
/ide IDE 集成
/init 初始化 CLAUDE.md 等
/insights 使用分析报告
/install-github-app GitHub Actions 应用
/install-slack-app Slack 应用
/keybindings 快捷键配置
/login、/logout 登录 / 登出
/mcp MCP 与 OAuth
/memory CLAUDE.md 与 auto-memory
/mobile 移动端二维码；别名 /ios、/android
/model [模型] 选择模型
/passes 邀请体验（视账号）
/permissions 权限；别名 /allowed-tools
/plan [描述] 规划模式
/plugin 插件
/pr-comments [PR] GitHub PR 评论（常需 gh）
/privacy-settings 隐私（Pro / Max）
/release-notes 变更日志
/reload-plugins 重载插件
/remote-control 遥控；别名 /rc
/remote-env --remote 类云端会话的环境默认值
/rename [名称] 会话重命名
/resume [会话] 恢复；别名 /continue
/review 已弃用，改用 code-review 插件
/rewind 检查点；别名 /checkpoint
/sandbox 沙箱模式
/schedule [描述] 云定时任务
/security-review 安全审查当前分支变更
/skills 列出 skills
/stats 使用统计可视化
/status Status 页
/statusline 状态行配置
/stickers 贴纸
/tasks 后台任务
/terminal-setup 终端快捷键
/theme 主题
/upgrade 订阅升级页
/usage 用量与限流
/vim Vim 模式切换
/voice 语音听写

5.1 MCP 动态命令

格式常为 /mcp__<服务器>__<prompt>，以连接后补全为准，见 MCP 文档。

5.2 捆绑技能

如 /simplify、/batch、/debug、/loop 等与 / 命令并列出现，以当前版本与 Skills 为准。

6. 相关官方文档

7. 说明

  • 终端下的「Claude 程序」多指 claude（Claude Code）；API、网页客户端命令集不同。
  • 权威核对方式： 定期执行 claude --help、claude <子命令> --help。

附录 A：在线文档或更新版本中可能出现、Claude Code 2.1.62 顶层 --help 未列出的项

下列来自 code.claude.com CLI reference 等，在你本机未必存在；升级 CLI 后请用 --help 复查。

类型 示例
子命令 claude auto-mode defaults、claude auto-mode config
启动标志 --name / -n、--teleport、--remote、--remote-control / --rc、--enable-auto-mode、--max-turns、--bare、--permission-prompt-tool、--init、--init-only、--maintenance、--channels、--dangerously-load-development-channels、--teammate-mode、--append-system-prompt-file、--system-prompt-file
权限模式 文档中的 auto 模式与 Shift+Tab 循环；2.1.62 的 --permission-mode 可选值未在帮助中列出 auto，以交互 UI 与新版 CLI 为准
其它 claude auth login --console（2.1.62 的 login --help 未显示）
插件卸载 plugin uninstall --keep-data（2.1.62 无）

若你希望附录随本机版本自动对齐，可在仓库中保留一行当前校验版本号，并在升级后重新运行 claude --help 更新本文。