claude CLI 提供 16 类启动参数，覆盖会话恢复、模型选择、权限控制、输出格式、系统提示、Agent 配置、MCP 加载、预算限制等所有场景。掌握 -p/--print（无交互模式）、--permission-mode、--append-system-prompt 和 --add-dir 这几个核心参数，可以解锁绝大多数自动化和集成场景。
Claude Code CLI 启动参数完全参考：16 类命令行选项与环境变量 #
会话管理 #
| 参数 |
简写 |
说明 |
--continue |
-c |
继续当前目录最近的会话 |
--resume |
-r |
通过 ID 或名称恢复指定会话，不带参数显示选择器 |
--from-pr <NUMBER|URL> |
|
恢复关联到指定 GitHub PR 的会话 |
--fork-session |
|
恢复时创建新会话 ID（与 --resume 或 --continue 配合使用） |
--session-id <UUID> |
|
使用指定的会话 ID（必须是有效 UUID） |
--no-session-persistence |
|
禁用会话持久化（仅 print 模式） |
--remote |
|
在 claude.ai 创建新的 web 会话 |
--teleport |
|
将 web 会话拉回本地终端 |
模型与配置 #
| 参数 |
说明 |
--model <NAME> |
设置模型：别名（sonnet/opus/haiku）或完整 ID |
--fallback-model <NAME> |
默认模型过载时的备用模型（仅 print 模式） |
--betas <LIST> |
包含在 API 请求中的 beta 头（仅 API key 用户） |
权限与安全 #
| 参数 |
说明 |
--dangerously-skip-permissions |
跳过所有权限提示，极度谨慎使用 |
--allow-dangerously-skip-permissions |
允许后续激活权限绕过，但不立即激活 |
--permission-mode <MODE> |
以指定权限模式启动：default/plan/acceptEdits/bypassPermissions |
--allowedTools <TOOLS> |
无需提示即可执行的工具（permission rule 语法） |
--disallowedTools <TOOLS> |
从模型上下文完全移除的工具 |
--tools <TOOLS> |
限制 Claude 可以使用的内置工具（"" 禁用所有） |
--permission-prompt-tool <TOOL> |
在非交互模式中处理权限提示的 MCP 工具 |
--dangerously-skip-permissions 替代方案：在 settings.json 中配置 permissions.defaultMode: "bypassPermissions" 加 permissions.allow 规则，避免在命令行中使用危险参数。
输出与格式 #
| 参数 |
说明 |
--print / -p |
无交互模式（headless/SDK 模式），打印响应后退出 |
--output-format <FORMAT> |
输出格式：text/json/stream-json |
--input-format <FORMAT> |
输入格式：text/stream-json |
--json-schema <SCHEMA> |
获取符合 schema 的验证 JSON（仅 print 模式） |
--include-partial-messages |
包含流式分片事件（需 --print 和 stream-json） |
--verbose |
启用详细日志，显示完整的逐轮输出 |
常用 -p 组合：
# 单次问答
claude -p "解释这段代码" < code.ts
# 输出 JSON
claude -p --output-format json "分析 src/"
# 流式输出
claude -p --output-format stream-json "写一篇文章"
# 限制轮次和预算
claude -p --max-turns 5 --max-budget-usd 0.5 "重构这个模块"
系统提示 #
| 参数 |
说明 |
--system-prompt <TEXT> |
替换整个系统提示（不推荐，会丢失内置行为） |
--system-prompt-file <PATH> |
从文件加载系统提示（仅 print 模式） |
--append-system-prompt <TEXT> |
向默认系统提示追加自定义内容（推荐） |
--append-system-prompt-file <PATH> |
向默认提示追加文件内容（仅 print 模式） |
Agent 与 Subagent #
| 参数 |
说明 |
--agent <NAME> |
为当前会话指定 agent |
--agents <JSON> |
通过 JSON 动态定义自定义 subagent |
--teammate-mode <MODE> |
Agent 团队显示模式：auto/in-process/tmux |
MCP 与插件 #
| 参数 |
说明 |
--mcp-config <PATH|JSON> |
从 JSON 文件或字符串加载 MCP 服务器 |
--strict-mcp-config |
只使用 --mcp-config 中的 MCP，忽略其他配置 |
--plugin-dir <PATH> |
仅本次会话从指定目录加载插件（可重复使用） |
目录与工作区 #
| 参数 |
说明 |
--add-dir <PATH> |
添加额外工作目录，Claude 可以访问 |
--worktree / -w |
在隔离的 git worktree 中启动（从 HEAD 分支） |
预算与限制 #
| 参数 |
说明 |
--max-budget-usd <AMOUNT> |
API 调用最大美元金额（仅 print 模式） |
--max-turns <NUMBER> |
限制 agentic turn 数量（仅 print 模式） |
集成 #
| 参数 |
说明 |
--chrome |
启用 Chrome 浏览器集成 |
--no-chrome |
本次会话禁用 Chrome 集成 |
--ide |
启动时自动连接到 IDE |
初始化与维护 #
| 参数 |
说明 |
--init |
运行初始化 hooks 并进入交互模式 |
--init-only |
只运行初始化 hooks 后退出 |
--maintenance |
运行维护 hooks 后退出 |
调试与诊断 #
| 参数 |
说明 |
--debug <CATEGORIES> |
启用调试模式，可选分类过滤（如 "api,hooks"） |
Settings 覆盖 #
| 参数 |
说明 |
--settings <PATH|JSON> |
从 JSON 文件或字符串加载 settings |
--setting-sources <LIST> |
指定加载来源：user/project/local（逗号分隔） |
--disable-slash-commands |
本次会话禁用所有 skills 和 slash commands |
子命令 #
| 子命令 |
说明 |
claude |
启动交互式 REPL |
claude "query" |
带初始 prompt 启动 REPL |
claude agents |
列出已配置的 agents |
claude auth |
管理认证 |
claude doctor |
从命令行运行诊断 |
claude install |
安装或切换原生构建 |
claude mcp |
配置 MCP 服务器（add/remove/list/get/enable） |
claude update |
更新到最新版本 |
启动专属环境变量 #
以下变量只能在 shell 中设置，不能通过 settings.json 的 env 键配置：
| 变量 |
说明 |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 |
启用实验性 Agent Teams |
CLAUDE_BASH_NO_LOGIN=1 |
跳过 BashTool 的 login shell |
USE_BUILTIN_RIPGREP=0 |
使用系统 ripgrep（Alpine Linux） |
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 |
允许附加目录加载 CLAUDE.md |
CCR_FORCE_BUNDLE=1 |
claude --remote 强制打包上传本地仓库 |
其他可通过 settings.json 的 env 键配置的变量（如 MAX_THINKING_TOKENS、CLAUDE_CODE_EFFORT_LEVEL、CLAUDE_CODE_SUBAGENT_MODEL 等）参见 Settings 配置参考。
FAQ #
Q: -p/--print 模式和交互模式有什么核心区别？
A: -p 模式下 Claude 接收一个 prompt 后执行任务，任务结束后立即退出，不进入 REPL。适合 CI/CD 流水线、shell 脚本自动化、以及需要捕获输出的场景。--output-format json 可以获取结构化输出（包含工具调用详情）。
Q: --permission-mode acceptEdits 和 --dangerously-skip-permissions 有什么区别？
A: acceptEdits 只跳过文件编辑的确认提示，其他操作（如 Bash 命令）仍需确认；--dangerously-skip-permissions 跳过所有权限检查，包括执行 shell 命令。日常自动化推荐用 acceptEdits，配合 permissions.allow 白名单 bash 命令。
Q: 怎么在脚本中传入多行 prompt？
A: 使用 heredoc 或管道：echo "分析这个文件" | claude -p，或 claude -p < prompt.txt。也可以用 --input-format stream-json 传入 JSON 流。
Q: --worktree 和 subagent 的 isolation: "worktree" 有什么区别？
A: --worktree 是 CLI 参数，为整个主会话创建隔离的 git worktree；isolation: "worktree" 是 subagent frontmatter 字段，只为该 subagent 创建隔离 worktree，主会话不受影响。