Usage: claude [options] [command] [prompt]
Claude Code —— 默认启动交互式会话;使用 -p / --print 可获得非交互式输出
Arguments:
prompt
你的提示内容
Options:
--add-dir <directories...>
允许工具访问的额外目录
--agent <agent>
当前会话使用的 Agent(覆盖配置中的 agent)
--agents <json>
定义自定义 Agent 的 JSON 对象
示例:
{
"reviewer": {
"description": "代码审查",
"prompt": "你是一名代码审查员"
}
}
--allow-dangerously-skip-permissions
启用“可选”的跳过所有权限检查能力(默认不启用)
仅推荐用于无网络访问的沙箱环境
--allowedTools, --allowed-tools <tools...>
允许使用的工具列表(逗号或空格分隔)
示例:"Bash(git:*) Edit"
--append-system-prompt <prompt>
在默认系统提示词后追加内容
--betas <betas...>
在 API 请求中包含 Beta 头(仅 API key 用户)
--chrome
启用 Claude 的 Chrome 集成
-c, --continue
继续最近一次对话
--dangerously-skip-permissions
跳过所有权限检查
仅推荐用于无网络访问的沙箱环境
-d, --debug [filter]
启用调试模式,可按分类过滤
示例:"api,hooks" 或 "!statsig,!file"
--disable-slash-commands
禁用所有斜杠命令
--disallowedTools, --disallowed-tools <tools...>
禁止使用的工具列表(逗号或空格分隔)
示例:"Bash(git:*) Edit"
--fallback-model <model>
当默认模型过载时自动回退到指定模型
(仅在 --print 模式下生效)
--fork-session
恢复会话时创建新的 session ID
与 --resume 或 --continue 一起使用
-h, --help
显示命令帮助信息
--ide
启动时若仅检测到一个可用 IDE,则自动连接
--include-partial-messages
包含实时到达的部分消息块
(仅 --print 且 --output-format=stream-json)
--input-format <format>
输入格式(仅 --print)
可选值:text(默认)、stream-json(实时流式输入)
--json-schema <schema>
用于结构化输出校验的 JSON Schema
示例:
{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}
--max-budget-usd <amount>
API 调用的最大美元预算
(仅 --print)
--mcp-config <configs...>
从 JSON 文件或字符串加载 MCP 服务器(空格分隔)
--mcp-debug
已废弃(请使用 --debug)
启用 MCP 调试模式(显示 MCP 服务器错误)
--model <model>
当前会话使用的模型
可使用最新模型别名(如 sonnet、opus)
或完整模型名(如 claude-sonnet-4-5-20250929)
--no-chrome
禁用 Claude 的 Chrome 集成
--no-session-persistence
禁用会话持久化
会话不会保存到磁盘,无法恢复
(仅 --print)
--output-format <format>
输出格式(仅 --print)
可选值:
text(默认)
json(单结果)
stream-json(实时流式输出)
--permission-mode <mode>
会话使用的权限模式
可选值:
acceptEdits
bypassPermissions
default
delegate
dontAsk
plan
--plugin-dir <paths...>
从指定目录加载插件(仅当前会话,可重复)
-p, --print
打印响应并退出(适合管道使用)
注意:在 -p 模式下会跳过工作区信任对话
仅在你信任的目录中使用
--replay-user-messages
将 stdin 中的用户消息重新输出到 stdout
(仅 --input-format=stream-json 且 --output-format=stream-json)
-r, --resume [value]
通过 session ID 恢复会话
或打开带可选搜索词的交互式选择器
--session-id <uuid>
使用指定的会话 ID(必须是合法 UUID)
--setting-sources <sources>
加载的设置来源(逗号分隔)
user、project、local
--settings <file-or-json>
加载额外设置的 JSON 文件路径或 JSON 字符串
--strict-mcp-config
仅使用 --mcp-config 指定的 MCP 服务器
忽略所有其他 MCP 配置
--system-prompt <prompt>
当前会话使用的系统提示词
--tools <tools...>
指定可用的内置工具列表
"" 禁用所有工具
default 启用所有工具
示例:"Bash,Edit,Read"
--verbose
覆盖配置文件中的 verbose 设置
-v, --version
输出版本号
Commands:
doctor
检查 Claude Code 自动更新器的健康状态
install [options] [target]
安装 Claude Code 原生版本
target 可为:stable、latest 或指定版本号
mcp
配置和管理 MCP 服务器
plugin
管理 Claude Code 插件
setup-token
设置长期有效的认证 Token(需要 Claude 订阅)
update
检查并安装更新