一、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 mcp | 配置 MCP 服务器 | claude mcp | 添加服务器 |
claude agents | 列出所有已配置的 SubAgent，按来源分组 | claude agents | 自定义 SubAgent |
claude remote-control | 以服务器模式启动远程控制（无本地交互会话） | claude remote-control --name "My Project" | Remote Control |
claude auth login | 登录 Anthropic 账户；--console 使用 Console 计费，--sso 强制 SSO | claude auth login --console | -- |
claude -v | 显示版本号 | claude -v | -- |
二、按用途分类
基本启动
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
--model | 指定会话使用的模型（如 sonnet、opus、haiku） | claude --model sonnet | 模型配置 |
--effort | 设置 Effort 级别（low/medium/high/max）；仅当前会话，不持久化到设置 | claude --effort high | Effort 系统 |
-n / --name | 设置会话显示名称，在 /resume 和终端标题中显示；可通过名称恢复 | claude -n "my-feature-work" | 会话命名 |
--permission-mode | 指定权限模式启动（plan、auto-accept 等） | claude --permission-mode plan | 权限模式总览 |
--bare | 最小模式：跳过 Hooks、Skills、Plugins、MCP、Auto-Memory、CLAUDE.md 的自动发现；仅保留 Bash、Read、Edit 工具；适合脚本化快速启动 | claude --bare -p "query" | -- |
--add-dir | 添加额外工作目录 | claude --add-dir ../apps ../lib | -- |
--init | 运行初始化钩子并启动 | claude --init | 用 /init 创建 |
--init-only | 仅运行初始化钩子后退出 | claude --init-only | 用 /init 创建 |
--ide | 自动连接 IDE | claude --ide | -- |
--chrome | 启用 Chrome 浏览器集成 | claude --chrome | -- |
--no-chrome | 禁用 Chrome 浏览器集成 | claude --no-chrome | -- |
--console | 使用 Anthropic Console 登录（API 用量计费） | claude auth login --console | -- |
会话恢复
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
-c / --continue | 继续当前目录最近的对话 | claude -c | 继续上次对话 |
-r / --resume | 恢复指定会话（ID 或名称），不填则交互选择 | claude -r "会话名" | 继续上次对话 |
--fork-session | 恢复时创建新会话（不覆盖原会话） | claude -r abc123 --fork-session | 继续上次对话 |
--session-id | 使用指定 UUID 作为会话 ID | claude --session-id "550e8400-..." | -- |
--from-pr | 恢复关联到 GitHub PR 的会话 | claude --from-pr 123 | -- |
-w / --worktree | 在隔离的 git worktree 中启动，支持并行开发 | claude -w feature-auth | Git Worktrees 并行 |
输出控制（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） | claude -p --json-schema '{"type":"object",...}' | -- |
--max-turns | 限制 Agent 轮次数（仅 print 模式） | claude -p --max-turns 3 "查询" | -- |
--max-budget-usd | 限制 API 调用最大金额 | claude -p --max-budget-usd 5.00 "查询" | -- |
--verbose | 启用详细日志，显示完整的轮次输出 | claude --verbose | -- |
--include-partial-messages | 包含流式部分事件 | claude -p --output-format stream-json --include-partial-messages | -- |
--no-session-persistence | 不保存会话到磁盘 | claude -p --no-session-persistence "查询" | -- |
--fallback-model | 主模型过载时自动降级 | claude -p --fallback-model sonnet "查询" | -- |
系统提示定制
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
--system-prompt | 替换整个系统提示 | claude --system-prompt "你是 Python 专家" | -- |
--system-prompt-file | 从文件加载替换系统提示（仅 print） | claude -p --system-prompt-file ./prompt.txt | -- |
--append-system-prompt | 追加到默认系统提示 | claude --append-system-prompt "始终使用 TypeScript" | -- |
--append-system-prompt-file | 从文件追加系统提示（仅 print） | claude -p --append-system-prompt-file ./rules.txt | -- |
--system-prompt会移除所有默认指令，大多数场景建议用--append-system-prompt。
工具与权限控制
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
--tools | 限制可用的内置工具 | claude --tools "Bash,Edit,Read" | -- |
--allowedTools | 指定无需确认的工具 | claude --allowedTools "Bash(git log *)" "Read" | -- |
--disallowedTools | 禁用指定工具 | claude --disallowedTools "Edit" | -- |
--dangerously-skip-permissions | 跳过所有权限确认（慎用） | claude --dangerously-skip-permissions | -- |
--allow-dangerously-skip-permissions | 允许权限跳过选项（与 --permission-mode 组合） | 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.ai 认证 | claude --channels plugin:my-notifier@my-marketplace | Channels 频道集成 |
--plugin-dir | 加载指定目录的插件 | claude --plugin-dir ./my-plugins | 安装与管理 |
SubAgent 与团队
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
--agent | 指定当前会话的 Agent 定义 | claude --agent my-custom-agent | 自定义 SubAgent |
--agents | 动态定义自定义 SubAgent（JSON 格式） | claude --agents '{"reviewer":{...}}' | 自定义 SubAgent |
--teammate-mode | 设置 Agent Teams 显示方式（in-process 或 split-panes） | claude --teammate-mode in-process | 启用 Agent Teams |
系统诊断与调试
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
-v / --version | 显示版本号 | claude -v | -- |
--debug | 启用调试模式（可按类别过滤） | claude --debug "api,mcp" | -- |
--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 | -- |
--maintenance | 运行维护钩子后退出 | claude --maintenance | -- |
远程与桌面
| 参数 | 功能 | 示例 | 详见 |
|---|---|---|---|
--remote | 在 claude.ai 上创建远程 Web 会话执行任务 | claude --remote "修复登录bug" | --remote 远程创建 |
--remote-control / --rc | 启用远程控制，使当前会话可从 claude.ai 或 Claude App 接收指令；可选传入会话名 | claude --remote-control "My Project" | Remote Control |
--teleport | 从 claude.ai 恢复远程会话到本地终端 | claude --teleport | Teleport |
三、常用组合示例
日常使用
# 启动并继续上次对话
claude -c
# 指定模型启动
claude --model opus
# 以 Plan Mode 启动
claude --permission-mode plan
# 恢复指定会话
claude -r "项目重构"自动化脚本
# 单次查询，输出 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 --append-system-prompt "用中文回复，输出 Markdown 格式"项目初始化
# 初始化项目（创建 CLAUDE.md）
claude --init
# 仅初始化不进入交互模式
claude --init-only
# 添加额外目录
claude --add-dir ../shared-lib ../config进阶模式
# 以 Plan Mode 启动，先看方案再执行
claude --permission-mode plan
# 以自动批准模式启动，跳过所有权限确认
claude --permission-mode auto-accept
# 指定模型和 Effort 级别启动
claude --model sonnet --effort high
# 最小模式启动（跳过所有自动发现）
claude --bare -p "快速查询"
# 命名会话，方便后续恢复
claude -n "auth-refactor"
# 加载指定 MCP 配置文件
claude --mcp-config ./my-mcp-servers.json
# 在 Git Worktree 中启动并行开发
claude -w feature-auth
# 启用远程控制，从 Web 发送指令
claude --remote-control "My Project"
# 创建远程 Web 会话执行任务
claude --remote "分析项目结构并生成架构文档"
# 从 Web 恢复远程会话到本地
claude --teleport四、参数简写对照
| 简写 | 完整形式 | 含义 | 详见 |
|---|---|---|---|
-c | --continue | 继续最近对话 | 继续上次对话 |
-r | --resume | 恢复指定会话 | 继续上次对话 |
-p | --print | 单次查询模式 | 对话模式 |
-n | --name | 设置会话名称 | 会话命名 |
-v | --version | 显示版本号 | -- |
-w | --worktree | Git worktree 模式（并行开发） | Git Worktrees 并行 |
五、注意事项
- 标记"仅 print"的参数只在
-p模式下生效 --system-prompt和--system-prompt-file互斥，不能同时使用--append-system-prompt可以和任一替换类参数组合使用--dangerously-skip-permissions会跳过所有安全确认，请谨慎使用- 布尔型参数通常有
--no-前缀的反向版本（如--chrome/--no-chrome）
相关速查手册: 斜杠命令速查 | 快捷键速查 | CLAUDE.md 写法速查