| --add-dir <directories...> |
添加允许工具访问的目录 |
指定 Claude 可读写的额外目录(多个目录用空格分隔) |
| --agent |
指定当前会话的智能体 |
覆盖配置中的 "agent" 项,选择预设智能体 |
| --agents |
自定义智能体配置(JSON 格式) |
示例:'{"代码审核员":{"description":"审核代码","prompt":"你是专业的代码审核专家"}}' |
| --allow-dangerously-skip-permissions |
允许跳过权限校验(需手动开启) |
仅推荐无网络的沙箱环境使用,有安全风险 |
| --allowedTools, --allowed-tools <tools...> |
允许使用的工具列表 |
逗号/空格分隔,如 "Bash(git:*) Edit"(允许执行Git命令和编辑文件) |
| --append-system-prompt |
追加系统提示词 |
在默认系统提示词后补充自定义内容 |
| --betas <betas...> |
API 请求携带的 Beta 头信息 |
仅 API Key 用户可用 |
| --brief |
启用智能体与用户交互的消息发送工具 |
让 Claude 可主动向用户发送交互消息 |
| --chrome |
启用 Chrome 浏览器集成 |
关联 Claude 浏览器插件 |
| -c, --continue |
继续当前目录下最近的对话 |
你之前问的核心参数:复用当前目录最近一次的会话上下文(加载上次生成内容的关键) |
| --dangerously-skip-permissions |
跳过所有权限校验 |
高危操作,仅沙箱环境推荐 |
| -d, --debug [filter] |
启用调试模式(可选分类过滤) |
示例:"api,hooks"(仅调试API和钩子)或 "!1p,!file"(排除1p和文件相关) |
| --debug-file |
将调试日志写入指定文件 |
自动启用调试模式 |
| --disable-slash-commands |
禁用所有快捷指令 |
关闭 / 开头的内置快捷命令 |
| --disallowedTools, --disallowed-tools <tools...> |
禁止使用的工具列表 |
格式同 allowed-tools,用于屏蔽特定工具 |
| --effort |
当前会话的算力等级 |
可选:low/medium/high/max(等级越高生成越精细) |
| --fallback-model |
默认模型过载时的备用模型 |
仅配合 --print 参数生效 |
| --file <specs...> |
启动时下载的文件资源 |
格式:文件ID:相对路径(如 --file file_abc:doc.txt) |
| --fork-session |
恢复会话时创建新会话ID |
配合 --resume / --continue 使用,不覆盖原会话 |
| --from-pr [value] |
恢复PR关联的会话 |
通过PR编号/URL恢复,或带搜索词打开交互式选择器 |
| -h, --help |
显示命令帮助 |
查看所有参数说明 |
| --ide |
自动连接可用的IDE |
若仅检测到一个有效IDE则自动关联 |
| --include-partial-messages |
实时输出部分消息片段 |
仅配合 --print 和 --output-format=stream-json 生效 |
| --input-format |
输入格式 |
仅 --print 可用:text(默认)/ stream-json(实时流式输入) |
| --json-schema |
结构化输出校验的JSON Schema |
示例:{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]} |
| --max-budget-usd |
API 调用的最大美元预算 |
仅 --print 生效,控制消费上限 |
| --mcp-config <configs...> |
加载MCP服务器配置 |
支持JSON文件/字符串(多个配置用空格分隔) |
| --mcp-debug |
启用MCP调试模式(已废弃) |
改用 --debug 参数 |
| --model |
指定会话使用的模型 |
支持别名(sonnet/opus)或完整名称(claude-sonnet-4-6) |
| -n, --name |
设置会话显示名称 |
在 /resume 和终端标题中展示 |
| --no-chrome |
禁用 Chrome 集成 |
关闭浏览器插件关联 |
| --no-session-persistence |
禁用会话持久化 |
会话不保存到磁盘,无法恢复(仅 --print 生效) |
| --output-format |
输出格式 |
仅 --print 可用:text(默认)/ json(单次结果)/ stream-json(实时流式) |
| --permission-mode |
会话的权限模式 |
可选:acceptEdits/bypassPermissions/default/dontAsk/plan/auto |
| --plugin-dir |
加载指定目录的插件 |
可重复使用(--plugin-dir A --plugin-dir B),默认空 |
| -p, --print |
输出响应后退出 |
适合管道操作,跳过工作区信任弹窗(仅信任目录使用) |
| --replay-user-messages |
回显用户输入消息 |
仅配合 --input-format=stream-json 和 --output-format=stream-json 生效 |
| -r, --resume [value] |
恢复指定会话 |
通过会话ID恢复,或带搜索词打开交互式选择器 |
| --session-id |
使用指定的会话ID |
必须是有效的UUID格式 |
| --setting-sources |
加载配置的来源列表 |
逗号分隔:user(用户)/ project(项目)/ local(本地) |
| --settings |
加载额外配置文件/JSON |
支持配置文件路径或JSON字符串 |
| --strict-mcp-config |
仅使用指定的MCP配置 |
忽略其他MCP配置来源 |
| --system-prompt |
会话使用的系统提示词 |
覆盖默认系统提示词 |
| --tmux |
创建tmux会话(配合工作区) |
需加 --worktree,iTerm2优先用原生窗格,--tmux=classic 用传统tmux |
| --tools <tools...> |
指定可用的内置工具 |
"" 禁用所有,"default" 启用全部,或指定工具名(如 "Bash,Edit,Read") |
| --verbose |
覆盖配置中的详细模式 |
输出更多日志信息 |
| -v, --version |
输出版本号 |
查看当前 Claude Code 版本 |
| -w, --worktree [name] |
创建新的Git工作区 |
可选指定名称,隔离代码修改 |