一、CLI 基本命令
| 命令 | 功能 | 示例 | 详见 |
|---|---|---|---|
claude | 启动交互式 REPL | claude | -- |
claude "提示" | 带初始提示启动 REPL | claude "分析这个项目" | 对话模式 |
claude -p "提示" | 单次查询模式（非交互，完成后退出） | claude -p "解释这个函数" | 对话模式 |
cat 文件 | claude -p "提示" | 管道输入内容 | cat logs.txt | claude -p "分析错误" | 对话模式 |
claude -c | 继续最近一次对话 | claude -c | 继续上次对话 |
claude -c -p "提示" | 在最近对话基础上单次查询 | claude -c -p "检查类型错误" | 继续上次对话 |
claude -r "会话" "提示" | 恢复指定会话（按 ID 或名称） | claude -r "auth-refactor" "继续修复" | 继续上次对话 |
claude update | 更���到最新版本 | claude update | -- |
claude install | 安装/重装 native binary（接受版本号 / stable / latest） | claude install stable | -- |
claude mcp | 配��� MCP 服务器 | claude mcp | 添加服务器 |
claude agents | 列出所有已配置的 SubAgent | claude agents | 自定义 SubAgent |
claude remote-control | 以服务器模式启动远程控制 | claude remote-control --name "My Project" | Remote Control |
claude auth login | 登录（--console Console；--sso SSO；--email 预填邮箱） | claude auth login --console | -- |
claude auth logout | 登出 | claude auth logout | -- |
claude auth status | 认证状态（--text 可读格式） | claude auth status | -- |
claude auto-mode defaults | 输出内置 Auto Mode 分类器规则 | claude auto-mode defaults | Auto Mode |
claude auto-mode config | 输��合并 settings 后的有效配置 | claude auto-mode config | Auto Mode |
claude project purge | 删除项目本地 state（--dry-run / -y / -i / --all） | claude project purge ~/work/repo --dry-run | -- |
claude setup-token | ���成长期 OAuth token（CI/scripts 用） | claude setup-token | -- |
claude ultrareview | 非交互模式 ultrareview（--json --timeout） | claude ultrareview 1234 --json | -- |
claude plugin | 管理 Plugin。别名 claude plugins | claude plugin list | 安装与管理 |
claude plugin prune | 移除孤立依赖 | claude plugin prune | -- |
claude plugin tag | 创建 release git tag | claude plugin tag | -- |
claude plugin list | 列出已安装 Plugin | claude plugin list | -- |
claude plugin validate | 验证 Plugin schema | claude plugin validate | -- |
claude -v | 显示版本号 | claude -v | -- |
拼写纠错
输入错误的子命令时（如 claude udpate），会建议最接近的匹配并退出。
二、按用途分类
基本启动
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
--model | 指定模型（sonnet/opus/haiku 或完整名称；default 清除 override；best 最强可用） | claude --model opus | 模型配置 |
--effort | 设置 Effort 级别（low/medium/high/xhigh/max）；仅当前会话，不持久化 | claude --effort xhigh | Effort 系统 |
-n / --name | 设置会话名称 | claude -n "my-feature-work" | 会话命名 |
--permission-mode | 指定权限模式（default/acceptEdits/plan/auto/dontAsk/bypassPermissions） | claude --permission-mode auto | 权限模式总览 |
--bare | 最小模式：跳过 Hooks、Skills、Plugins、MCP、Auto-Memory、CLAUDE.md 的自动发现；仅保留 Bash、Read、Edit 工具 | claude --bare -p "query" | 对话模式 |
--add-dir | 添加额外工作目录 | claude --add-dir ../apps ../lib | -- |
--init | 运行 Setup hooks 后启动（仅 print 模式） | claude -p --init "query" | 用 /init 创建 |
--init-only | 运行 Setup + SessionStart hooks 后退出 | claude --init-only | 用 /init 创建 |
--maintenance | 运行 maintenance hooks 后退出（仅 print 模式） | claude -p --maintenance "query" | -- |
--ide | 自动连接 IDE | claude --ide | -- |
--chrome / --no-chrome | 启用/禁用 Chrome 浏览器集成 | claude --chrome | -- |
--teleport | 从 claude.ai 恢复远程会话到本地终端 | claude --teleport | Teleport |
会话恢复
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
-c / --continue | 继续当前目录最近的对话 | claude -c | 继续上次对话 |
-r / --resume | 恢复指定会话 | claude -r "会话名" | 继续上次对话 |
--fork-session | 恢复时创建新会话（不覆盖原会话） | claude -r abc123 --fork-session | 继续上次对话 |
--session-id | 使用指定 UUID 作为会话 ID | claude --session-id "550e8400-..." | -- |
--from-pr | 恢复关联到 PR 的会话。接受 PR 号、GitHub/GitLab MR/Bitbucket PR URL | claude --from-pr 123 | -- |
-w / --worktree | 在隔离的 git worktree 中启动 | claude -w feature-auth | Git Worktrees 并行 |
--tmux | 为 worktree 创建 tmux session（需 --worktree；--tmux=classic 用传统 tmux） | claude -w feature-auth --tmux | -- |
输出控制（Print 模式）
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
-p / --print | 单次查询模式（非交互） | claude -p "查询" | 对话模式 |
--output-format | 输出格式: text / json / stream-json | claude -p "查询" --output-format json | -- |
--input-format | 输入格式: text / stream-json | claude -p --input-format stream-json | -- |
--json-schema | 输出结构化 JSON（需符合 Schema，仅 print） | claude -p --json-schema '{"type":"object",...}' | -- |
--max-turns | 限制 Agent 轮次数（仅 print） | claude -p --max-turns 3 "查询" | -- |
--max-budget-usd | 限制 API 最大金额（仅 print） | claude -p --max-budget-usd 5.00 "查询" | -- |
--verbose | 启用详细日志 | claude --verbose | -- |
--include-partial-messages | 包含流式部分事件（需 stream-json） | claude -p --output-format stream-json --include-partial-messages | -- |
--include-hook-events | 包含 hook 生命周期事件（需 stream-json） | claude -p --output-format stream-json --include-hook-events | -- |
--no-session-persistence | 不保存会话到磁盘（仅 print） | claude -p --no-session-persistence "查询" | -- |
--fallback-model | 主模型过载时自动降级（仅 print） | claude -p --fallback-model sonnet "查询" | -- |
--exclude-dynamic-system-prompt-sections | 将机器特定段（工作目录、git status 等）从 system prompt 移到首条用户消息，提升 prompt cache 复用 | claude -p --exclude-dynamic-system-prompt-sections "query" | -- |
--replay-user-messages | 在 stdout 回显 stdin 用户消息（需双向 stream-json） | claude -p --input-format stream-json --output-format stream-json --replay-user-messages | -- |
--debug-file | 写调试日志到指定文件（隐式启用 debug） | claude --debug-file /tmp/claude-debug.log | -- |
系统提示定制
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
--system-prompt | 替换整个系统提示 | claude --system-prompt "你是 Python 专家" | -- |
--system-prompt-file | 从文件加载替换系统提示 | claude -p --system-prompt-file ./prompt.txt | -- |
--append-system-prompt | 追加到默认系统提示 | claude --append-system-prompt "始终使用 TypeScript" | -- |
--append-system-prompt-file | 从文件追加系统提示 | claude -p --append-system-prompt-file ./rules.txt | -- |
--system-prompt 和 --system-prompt-file 互斥。--append-* 可与替换类参数组合。大多数场景建议用 append 而非 replace。
工具与权限控制
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
--tools | 限制可用的内置工具（"" 禁用全部；"default" 恢复全部） | claude --tools "Bash,Edit,Read" | -- |
--allowedTools | 指定无需确认的工具 | claude --allowedTools "Bash(git log *)" "Read" | -- |
--disallowedTools | 禁用指定工具 | claude --disallowedTools "Edit" | -- |
--dangerously-skip-permissions | 等同于 --permission-mode bypassPermissions。v1.2 语义变化：绕过 .claude//.git//.vscode/ 等先前受保护路径；仅灾难性删除仍会提示 | claude --dangerously-skip-permissions | 权限模式 |
--allow-dangerously-skip-permissions | 将 bypassPermissions 加入 Shift+Tab 循环（不直接启用） | claude --permission-mode plan --allow-dangerously-skip-permissions | -- |
--permission-prompt-tool | 指定 MCP 工具处理权限提示（非交互模式） | claude -p --permission-prompt-tool mcp_auth | -- |
MCP 与插件
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
--mcp-config | 从 JSON 文件加载 MCP 服务器配置 | claude --mcp-config ./mcp.json | .mcp.json 配置 |
--strict-mcp-config | 仅使用 --mcp-config 指定的 MCP 服务器 | claude --strict-mcp-config --mcp-config ./mcp.json | 作用域管理 |
--channels | （研究预览）MCP 服务器 Channel 通知监听列表 | claude --channels plugin:my-notifier@my-marketplace | Channels |
--plugin-dir | 加载指定目录的插件（可重复使用） | claude --plugin-dir ./my-plugins | 安装与管理 |
SubAgent 与团队
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
--agent | 指定当前会话的 Agent 定义。遵守 agent 的 permissionMode 设置 | claude --agent my-custom-agent | 自定义 SubAgent |
--agents | 动态定义自定义 SubAgent（JSON）。print 模式遵守 agent 的 tools: / disallowedTools: frontmatter | claude --agents '{"reviewer":{...}}' | 自定义 SubAgent |
--teammate-mode | 设置 Agent Teams 显示方式（auto/in-process/tmux） | claude --teammate-mode in-process | 启用 Agent Teams |
系统诊断与调试
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
-v / --version | 显示版本号 | claude -v | -- |
--debug | 启用调试模式（可按类别过滤，如 "api,hooks"；"!statsig,!file" 排除） | claude --debug "api,mcp" | -- |
--debug-file | ���试日志写到指定文件 | claude --debug-file /tmp/debug.log | -- |
--verbose | 启用详细日志 | claude --verbose | -- |
--settings | 指定额外设置文件 | claude --settings ./settings.json | -- |
--setting-sources | 指定加载的设置范围 | claude --setting-sources user,project | -- |
--disable-slash-commands | 禁用所有 Skill 和斜杠命令 | claude --disable-slash-commands | -- |
--betas | 包含 Beta 头信息（API Key 用户） | claude --betas interleaved-thinking | -- |
远程与桌面
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
--remote | 在 claude.ai 上创建远程 Web 会话 | claude --remote "修复登录bug" | 远程创建 |
--remote-control / --rc | 启用远程控制 | claude --remote-control "My Project" | Remote Control |
--teleport | 从 Web 恢复远程会话到本地 | claude --teleport | Teleport |
--remote-control-session-name-prefix | 自动生成 Remote Control 会话名的前缀 | claude remote-control --remote-control-session-name-prefix dev-box | -- |
三、常用组合示例
日常使用
# 启动并继续上次对话
claude -c
# 指定模型启动
claude --model opus
# 以 Plan Mode 启动
claude --permission-mode plan
# 以 Auto Mode 启动
claude --permission-mode auto
# 恢复指定会话
claude -r "项目重构"
# 恢复关联到 PR 的会话
claude --from-pr 123自动化脚本
# 单次查询，输出 JSON
claude -p "分析错误日志" --output-format json
# 管道输入 + 限制预算
cat error.log | claude -p "总结错误原因" --max-budget-usd 1.00
# 限制工具 + 最大轮次
claude -p --tools "Read,Grep" --max-turns 5 "查找所有 TODO"
# 最小模式快速查询
claude --bare -p "快速查询"
# 追加系统提示
claude --append-system-prompt "用中文回复，输出 Markdown 格式"
# 非交互 ultrareview
claude ultrareview 1234 --json --timeout 60项目初始化与管理
# 初始化项目（创建 CLAUDE.md）
claude --init
# 仅初始化不进入交互模式
claude --init-only
# 安装/重装 native binary
claude install stable
# 删除项目本地数据（预览）
claude project purge ~/work/repo --dry-run
# 生成长期 OAuth token（CI 用）
claude setup-token进阶模式
# 指定模型和 Effort 级别启动
claude --model opus --effort xhigh
# 在 Git Worktree 中启动 + tmux
claude -w feature-auth --tmux
# 启用远程控制
claude --remote-control "My Project"
# 创建远程 Web 会话
claude --remote "分析项目结构"
# 链式操作：远程创建后 teleport 回本地
claude --remote "重构 auth" && claude --teleport
# 加载指定 MCP 配置
claude --mcp-config ./my-mcp-servers.json
# 提升 prompt cache 复用（多用户脚本场景）
claude -p --exclude-dynamic-system-prompt-sections "query"四、参数简写对照
| 简写 | 完整形式 | 含义 | 详见 |
|---|---|---|---|
-c | --continue | 继续最近对话 | 继续上次对话 |
-r | --resume | 恢复指定会话 | 继续上次对话 |
-p | --print | 单次查询模式 | 对话模式 |
-n | --name | 设置会话名称 | 会话命名 |
-v | --version | 显示版本号 | -- |
-w | --worktree | Git worktree 模式 | Git Worktrees 并行 |
五、移除 / 弃用
| Flag / 命令 | 状态 | 替代方案 |
|---|---|---|
--enable-auto-mode | v2.1.111 移除 | --permission-mode auto |
| npm 安装方式 | 弃用 | claude install 安装 native binary |
六、注意事项
- 标记"仅 print"的参数只在
-p模式下生效 --system-prompt和--system-prompt-file互斥--append-system-prompt可以和替换类参数组合使用--dangerously-skip-permissions的 v1.2 语义：绕过.claude//.git//.vscode//.idea//.husky/等先前受保护路径；仅灾难性删除（如rm -rf /）仍会提示- 布尔型参数通常有
--no-前缀的反向版本（如--chrome/--no-chrome） claude --help不列出所有 flag——flag 不在 help 输出中不代表不可用
相关速查手册: 斜杠命令速查 | 快捷键速查 | CLAUDE.md 写法速查