从终端启动 Claude Code 时的启动参数、顶级子命令和启动环境变量参考。
- 会话管理
- 模型与配置
- 权限与安全
- 输出与格式
- 系统提示
- 代理与子代理
- MCP 与插件
- 目录与工作区
- 预算与限制
- 集成
- 初始化与维护
- 调试与诊断
- 设置覆盖
- 版本与帮助
- 子命令
- 环境变量
| 参数 |
短参数 |
说明 |
--continue |
-c |
在当前目录继续最近的对话 |
--resume |
-r |
通过 ID 或名称恢复特定会话，或显示交互式选择器 |
--from-pr <NUMBER|URL> |
|
恢复链接到特定 GitHub PR 的会话 |
--fork-session |
|
恢复时创建新的会话 ID（与 --resume 或 --continue 一起使用） |
--session-id <UUID> |
|
使用特定的会话 ID（必须是有效的 UUID） |
--no-session-persistence |
|
禁用会话持久化（仅打印模式） |
--remote |
|
在 claude.ai 上创建新的 Web 会话 |
--teleport |
|
在本地终端恢复 Web 会话 |
| 参数 |
短参数 |
说明 |
--model <NAME> |
|
使用别名（sonnet、opus、haiku）或完整模型 ID 设置模型 |
--fallback-model <NAME> |
|
默认模型过载时的自动回退模型（仅打印模式） |
--betas <LIST> |
|
要包含在 API 请求中的 Beta 标头（仅限 API 密钥用户） |
| 参数 |
短参数 |
说明 |
--dangerously-skip-permissions |
|
跳过所有权限提示。请极度谨慎使用 |
--allow-dangerously-skip-permissions |
|
启用权限绕过作为选项而不激活它 |
--permission-mode <MODE> |
|
以指定的权限模式开始：default、plan、acceptEdits、bypassPermissions |
--allowedTools <TOOLS> |
|
无需提示即可执行的工具（权限规则语法） |
--disallowedTools <TOOLS> |
|
从模型上下文中完全移除的工具 |
--tools <TOOLS> |
|
限制 Claude 可以使用的内置工具（使用 "" 禁用所有） |
--permission-prompt-tool <TOOL> |
|
指定在非交互式模式下处理权限提示的 MCP 工具 |
| 参数 |
短参数 |
说明 |
--print |
-p |
以非交互模式打印响应（无头/SDK 模式） |
--output-format <FORMAT> |
|
输出格式：text、json、stream-json |
--input-format <FORMAT> |
|
输入格式：text、stream-json |
--json-schema <SCHEMA> |
|
获取匹配模式的验证 JSON（仅打印模式） |
--include-partial-messages |
|
包含部分流事件（需要 --print 和 --output-format=stream-json） |
--verbose |
|
启用详细日志记录，显示完整的逐轮输出 |
| 参数 |
短参数 |
说明 |
--system-prompt <TEXT> |
|
用自定义文本替换整个系统提示 |
--system-prompt-file <PATH> |
|
从文件加载系统提示，替换默认值（仅打印模式） |
--append-system-prompt <TEXT> |
|
将自定义文本附加到默认系统提示 |
--append-system-prompt-file <PATH> |
|
将文件内容附加到默认提示（仅打印模式） |
| 参数 |
短参数 |
说明 |
--agent <NAME> |
|
为当前会话指定代理 |
--agents <JSON> |
|
通过 JSON 动态定义自定义子代理 |
--teammate-mode <MODE> |
|
设置代理团队显示：auto、in-process、tmux |
| 参数 |
短参数 |
说明 |
--mcp-config <PATH|JSON> |
|
从 JSON 文件或字符串加载 MCP 服务器 |
--strict-mcp-config |
|
仅使用来自 --mcp-config 的 MCP 服务器，忽略所有其他 |
--plugin-dir <PATH> |
|
仅为此会话从目录加载插件（可重复） |
| 参数 |
短参数 |
说明 |
--add-dir <PATH> |
|
添加 Claude 可访问的额外工作目录 |
--worktree |
-w |
在隔离的 git worktree 中启动 Claude（从 HEAD 分支） |
| 参数 |
短参数 |
说明 |
--max-budget-usd <AMOUNT> |
|
API 调用前的最大美元金额（仅打印模式） |
--max-turns <NUMBER> |
|
限制代理轮次数量（仅打印模式） |
| 参数 |
短参数 |
说明 |
--chrome |
|
启用 Chrome 浏览器集成以进行 Web 自动化 |
--no-chrome |
|
为此会话禁用 Chrome 浏览器集成 |
--ide |
|
如果只有一个有效的 IDE 可用，则在启动时自动连接 |
| 参数 |
短参数 |
说明 |
--init |
|
运行初始化 Hook 并以交互模式启动 |
--init-only |
|
运行初始化 Hook 并退出（无交互会话） |
--maintenance |
|
运行维护 Hook 并退出 |
| 参数 |
短参数 |
说明 |
--debug <CATEGORIES> |
|
启用调试模式，可选类别过滤（例如 "api,hooks"） |
| 参数 |
短参数 |
说明 |
--settings <PATH|JSON> |
|
要加载的设置 JSON 文件或 JSON 字符串的路径 |
--setting-sources <LIST> |
|
要加载的来源的逗号分隔列表：user、project、local |
--disable-slash-commands |
|
为此会话禁用所有技能和斜杠命令 |
| 参数 |
短参数 |
说明 |
--version |
-v |
输出版本号 |
--help |
-h |
显示帮助信息 |
这些是以 claude <subcommand> 运行的顶级命令：
| 子命令 |
说明 |
claude |
启动交互式 REPL |
claude "query" |
使用初始提示启动 REPL |
claude agents |
列出已配置的代理 |
claude auth |
管理 Claude Code 认证 |
claude doctor |
从命令行运行诊断 |
claude install |
安装或切换 Claude Code 原生构建 |
claude mcp |
配置 MCP 服务器（add、remove、list、get、enable） |
claude plugin |
管理 Claude Code 插件 |
claude remote-control |
管理远程控制会话 |
claude setup-token |
为订阅使用创建长期令牌 |
claude update / claude upgrade |
更新到最新版本 |
这些仅启动环境变量在启动 Claude Code 之前在 Shell 中设置（它们不能通过 settings.json 配置）：
| 变量 |
说明 |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 |
启用实验性代理团队 |
CLAUDE_CODE_TMPDIR |
覆盖内部文件的临时目录。也可通过 env 键配置 —— 请参阅 设置参考 |
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 |
启用额外的目录 CLAUDE.md 加载 |
DISABLE_AUTOUPDATER=1 |
禁用自动更新 |
CLAUDE_CODE_EFFORT_LEVEL |
控制思考深度 —— 请参阅 设置参考 |
USE_BUILTIN_RIPGREP=0 |
使用系统 ripgrep 而不是内置的（Alpine Linux） |
CLAUDE_CODE_SIMPLE |
启用简单模式（仅 Bash + Edit 工具）。也可通过 env 键配置 —— 请参阅 设置参考 |
CLAUDE_BASH_NO_LOGIN=1 |
跳过 BashTool 的登录 Shell |
CCR_FORCE_BUNDLE=1 |
使用 claude --remote 时强制捆绑/上传本地仓库 |
对于可通过 settings.json 中的 "env" 键配置的环境变量（包括 MAX_THINKING_TOKENS、CLAUDE_CODE_SHELL、CLAUDE_CODE_ENABLE_TASKS、CLAUDE_CODE_DISABLE_BACKGROUND_TASKS、CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 等），请参阅 Claude 设置参考。
