Claude Code官方文档CLI命令参考
Claude Code CLI 命令参考完整手册 - 子命令 / 标志 / 用法
Claude Code 命令行界面的完整参考，包含所有子命令与命令行标志，从启动会话、恢复对话到 MCP、subagents 与系统提示等所有 CLI 选项。
· 阅读约 16 分钟
CLI 命令
您可以使用这些命令启动会话、管道内容、恢复对话和管理更新：
| 命令 | 描述 | 示例 |
|---|---|---|
claude | 启动交互式会话 | claude |
claude "query" | 使用初始提示启动交互式会话 | claude "explain this project" |
claude -p "query" | 通过 SDK 查询，然后退出 | claude -p "explain this function" |
cat file | claude -p "query" | 处理管道内容 | cat logs.txt | claude -p "explain" |
claude -c | 在当前目录中继续最近的对话 | claude -c |
claude -c -p "query" | 通过 SDK 继续 | claude -c -p "Check for type errors" |
claude -r "<session>" "query" | 按 ID 或名称恢复会话 | claude -r "auth-refactor" "Finish this PR" |
claude update | 更新到最新版本 | claude update |
claude install [version] | 安装或重新安装本机二进制文件。接受版本号如 2.1.118、stable 或 latest | claude install stable |
claude auth login | 登录您的 Anthropic 账户。使用 --email 预填充电子邮件，--sso 强制 SSO，--console 使用 Anthropic Console 登录 | claude auth login --console |
claude auth logout | 从您的 Anthropic 账户登出 | claude auth logout |
claude auth status | 以 JSON 格式显示身份验证状态。使用 --text 获取人类可读的输出 | claude auth status |
claude agents | 列出所有已配置的 subagents，按来源分组 | claude agents |
claude auto-mode defaults | 以 JSON 格式打印内置 auto mode 分类器规则 | claude auto-mode defaults > rules.json |
claude mcp | 配置 Model Context Protocol (MCP) 服务器 | 请参阅 Claude Code MCP 文档 |
claude plugin | 管理 Claude Code plugins。别名：claude plugins | claude plugin install code-review@claude-plugins-official |
claude project purge [path] | 删除项目的所有本地 Claude Code 状态 | claude project purge ~/work/repo --dry-run |
claude remote-control | 启动 Remote Control 服务器以从 Claude.ai 或 Claude 应用控制 Claude Code | claude remote-control --name "My Project" |
claude setup-token | 为 CI 和脚本生成长期 OAuth 令牌 | claude setup-token |
claude ultrareview [target] | 非交互式运行 ultrareview | claude ultrareview 1234 --json |
如果您输入错误的子命令，Claude Code 会建议最接近的匹配项并退出而不启动会话。例如，claude udpate 会打印 Did you mean claude update?。
CLI 标志
使用这些命令行标志自定义 Claude Code 的行为。claude --help 不会列出每个标志，因此标志在 --help 中的缺失并不意味着它不可用。
| 标志 | 描述 | 示例 |
|---|---|---|
--add-dir | 为 Claude 添加额外的工作目录以读取和编辑文件 | claude --add-dir ../apps ../lib |
--agent | 为当前会话指定代理（覆盖 agent 设置） | claude --agent my-custom-agent |
--agents | 通过 JSON 动态定义自定义 subagents | claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' |
--allow-dangerously-skip-permissions | 将 bypassPermissions 添加到 Shift+Tab 模式循环中而不启动它 | claude --permission-mode plan --allow-dangerously-skip-permissions |
--allowedTools | 无需提示权限即可执行的工具 | "Bash(git log *)" "Bash(git diff *)" "Read" |
--append-system-prompt | 将自定义文本附加到默认系统提示的末尾 | claude --append-system-prompt "Always use TypeScript" |
--append-system-prompt-file | 从文件加载额外的系统提示文本并附加到默认提示 | claude --append-system-prompt-file ./extra-rules.txt |
--bare | 最小模式：跳过 hooks、skills、plugins、MCP 服务器、自动内存和 CLAUDE.md 的自动发现 | claude --bare -p "query" |
--betas | 要包含在 API 请求中的 Beta 标头（仅限 API 密钥用户） | claude --betas interleaved-thinking |
--channels | （研究预览）MCP 服务器，其 channel 通知 Claude 应在此会话中侦听 | claude --channels plugin:my-notifier@my-marketplace |
--chrome | 启用 Chrome 浏览器集成以进行网络自动化和测试 | claude --chrome |
--continue, -c | 加载当前目录中最近的对话 | claude --continue |
--dangerously-load-development-channels | 启用不在批准的允许列表中的 channels，用于本地开发 | claude --dangerously-load-development-channels server:webhook |
--dangerously-skip-permissions | 跳过权限提示。等同于 --permission-mode bypassPermissions | claude --dangerously-skip-permissions |
--debug | 启用调试模式，可选类别过滤（例如，"api,hooks" 或 "!statsig,!file"） | claude --debug "api,mcp" |
--debug-file <path> | 将调试日志写入特定文件路径。隐式启用调试模式 | claude --debug-file /tmp/claude-debug.log |
--disable-slash-commands | 为此会话禁用所有 skills 和命令 | claude --disable-slash-commands |
--disallowedTools | 从模型的上下文中删除的工具，无法使用 | "Bash(git log *)" "Bash(git diff *)" "Edit" |
--effort | 为当前会话设置工作量级别。选项：low、medium、high、xhigh、max | claude --effort high |
--exclude-dynamic-system-prompt-sections | 将每台机器的部分从系统提示移到第一条用户消息中 | claude -p --exclude-dynamic-system-prompt-sections "query" |
--fallback-model | 当默认模型过载时启用自动回退到指定模型（仅打印模式） | claude -p --fallback-model sonnet "query" |
--fork-session | 恢复时，创建新的会话 ID 而不是重用原始 ID | claude --resume abc123 --fork-session |
--from-pr | 恢复链接到特定拉取请求的会话 | claude --from-pr 123 |
--ide | 如果恰好有一个有效的 IDE 可用，则在启动时自动连接到 IDE | claude --ide |
--init | 在会话前运行带有 init 匹配器的 Setup hooks（仅打印模式） | claude -p --init "query" |
--init-only | 运行 Setup 和 SessionStart hooks，然后退出而不启动对话 | claude --init-only |
--include-hook-events | 在输出流中包含所有 hook 生命周期事件 | claude -p --output-format stream-json --include-hook-events "query" |
--include-partial-messages | 在输出中包含部分流事件 | claude -p --output-format stream-json --include-partial-messages "query" |
--input-format | 为打印模式指定输入格式（选项：text、stream-json） | claude -p --output-format json --input-format stream-json |
--json-schema | 在代理完成其工作流后获得与 JSON Schema 匹配的验证 JSON 输出 | claude -p --json-schema '{"type":"object","properties":{...}}' "query" |
--maintenance | 在会话前运行带有 maintenance 匹配器的 Setup hooks | claude -p --maintenance "query" |
--max-budget-usd | API 调用前停止的最大美元金额（仅打印模式） | claude -p --max-budget-usd 5.00 "query" |
--max-turns | 限制代理转数（仅打印模式） | claude -p --max-turns 3 "query" |
--mcp-config | 从 JSON 文件或字符串加载 MCP 服务器（以空格分隔） | claude --mcp-config ./mcp.json |
--model | 为当前会话设置模型 | claude --model claude-sonnet-4-6 |
--name, -n | 为会话设置显示名称 | claude -n "my-feature-work" |
--no-chrome | 为此会话禁用 Chrome 浏览器集成 | claude --no-chrome |
--no-session-persistence | 禁用会话持久化 | claude -p --no-session-persistence "query" |
--output-format | 为打印模式指定输出格式（选项：text、json、stream-json） | claude -p "query" --output-format json |
--permission-mode | 以指定的权限模式开始 | claude --permission-mode plan |
--permission-prompt-tool | 指定 MCP 工具以在非交互模式下处理权限提示 | claude -p --permission-prompt-tool mcp_auth_tool "query" |
--plugin-dir | 仅为此会话从目录或 .zip 存档加载插件 | claude --plugin-dir ./my-plugin |
--plugin-url | 仅为此会话从 URL 获取插件 .zip 存档 | claude --plugin-url https://example.com/plugin.zip |
--print, -p | 打印响应而不进入交互模式 | claude -p "query" |
--remote | 在 claude.ai 上创建新的网络会话，提供任务描述 | claude --remote "Fix the login bug" |
--remote-control, --rc | 启动启用了 Remote Control 的交互式会话 | claude --remote-control "My Project" |
--remote-control-session-name-prefix <prefix> | 当未设置显式名称时，Remote Control 自动生成会话名称的前缀 | claude remote-control --remote-control-session-name-prefix dev-box |
--replay-user-messages | 从 stdin 重新发出用户消息到 stdout 以进行确认 | claude -p --input-format stream-json --output-format stream-json --replay-user-messages |
--resume, -r | 按 ID 或名称恢复特定会话，或显示交互式选择器 | claude --resume auth-refactor |
--session-id | 为对话使用特定的会话 ID（必须是有效的 UUID） | claude --session-id "550e8400-e29b-41d4-a716-446655440000" |
--setting-sources | 逗号分隔的设置源列表以加载（user、project、local） | claude --setting-sources user,project |
--settings | 设置 JSON 文件的路径或内联 JSON 字符串 | claude --settings ./settings.json |
--strict-mcp-config | 仅使用来自 --mcp-config 的 MCP 服务器，忽略所有其他 MCP 配置 | claude --strict-mcp-config --mcp-config ./mcp.json |
--system-prompt | 用自定义文本替换整个系统提示 | claude --system-prompt "You are a Python expert" |
--system-prompt-file | 从文件加载系统提示，替换默认提示 | claude --system-prompt-file ./custom-prompt.txt |
--teleport | 在本地终端中恢复网络会话 | claude --teleport |
--teammate-mode | 设置 agent team 队友的显示方式：auto（默认）、in-process 或 tmux | claude --teammate-mode in-process |
--tmux | 为 worktree 创建 tmux 会话。需要 --worktree | claude -w feature-auth --tmux |
--tools | 限制 Claude 可以使用的内置工具 | claude --tools "Bash,Edit,Read" |
--verbose | 启用详细日志记录，显示完整的逐轮输出 | claude --verbose |
--version, -v | 输出版本号 | claude -v |
--worktree, -w | 在隔离的 git worktree 中启动 Claude | claude -w feature-auth |
系统提示标志
Claude Code 提供四个标志用于自定义系统提示。所有四个都在交互和非交互模式下工作。
| 标志 | 行为 | 示例 |
|---|---|---|
--system-prompt | 替换整个默认提示 | claude --system-prompt "You are a Python expert" |
--system-prompt-file | 用文件内容替换 | claude --system-prompt-file ./prompts/review.txt |
--append-system-prompt | 附加到默认提示 | claude --append-system-prompt "Always use TypeScript" |
--append-system-prompt-file | 将文件内容附加到默认提示 | claude --append-system-prompt-file ./style-rules.txt |
--system-prompt 和 --system-prompt-file 互斥。附加标志可以与任一替换标志组合。
对于大多数用例，使用附加标志。附加保留 Claude Code 的内置功能，同时添加您的要求。仅当您需要对系统提示进行完全控制时，才使用替换标志。
另请参阅
- 快速入门指南 - Claude Code 入门
- Claude Code 如何工作 - 代理循环和上下文管理
- 最佳实践 - 高级工作流和模式
- MCP - 配置 MCP 服务器
- Subagents - 创建自定义子代理
本文翻译自 Anthropic Claude Code 官方文档，最近一次同步：2025-05-01。