CLI Flags 速查

CLI Flags 速查

claude 命令后面能挂的 flag 多到记不住。这一页把它们按用途分桶成 9 类，每类一张表，每行一个 flag 加一句话说明——你不需要背，需要时回来查就行。

会话控制

决定「这次会话怎么开、怎么存、叫什么」。

Flag	作用
--continue / -c	继续最近一次会话
--resume / -r <id|name>	按 ID 或名字恢复会话
--fork-session	从某个会话分叉出一个新分支，原会话不动
--name <name>	给当前会话起名
--no-session-persistence	不持久化本次会话，跑完即弃

# 从某会话分叉一个新分支做实验，原会话保留
claude --resume abc123 --fork-session

权限

控制 Claude 能干什么、不能干什么、要不要问。

Flag	作用
--permission-mode <mode>	启动时指定权限模式（default/acceptEdits/plan/auto/dontAsk/bypassPermissions）
--allow-dangerously-skip-permissions	跳过所有权限提示（危险，仅沙箱使用）
--allowedTools <list>	允许使用的工具白名单
--disallowedTools <list>	禁止使用的工具黑名单
--tools <list>	显式指定本次可用工具集

# Plan 模式启动，只读分析
claude --permission-mode plan

# 只允许读和编辑，不让跑 bash
claude --allowedTools "Read,Edit"

详见 权限模式。

模型与思考

决定「用哪个脑子、想多深」。

Flag	作用
--model <alias>	指定模型别名（sonnet / opus / haiku / opusplan / sonnet[1m] 等）
--effort <level>	思考强度：low / medium / high / xhigh / max
--append-system-prompt <text>	在默认 system prompt 后追加内容
--system-prompt-file <path>	从文件读完整 system prompt 覆盖默认值

# 用 Opus 跑深度推理
claude --model opus --effort high

# 追加一段项目特定的 system prompt
claude --append-system-prompt "本项目用 Rust，禁止 unsafe"

详见 模型配置。

输入输出

控制「怎么喂、怎么吐」。

Flag	作用
--print / -p	Headless 模式，跑完即退，不进交互
--output-format <format>	输出格式：text / json / stream-json
--input-format <format>	输入格式：text / stream-json
--json-schema <path|string>	强制输出符合给定 JSON Schema 的结构化结果
--verbose	详细输出，显示更多底层信息

# Headless + JSON 输出，便于脚本解析
claude -p "列出所有 TODO" --output-format json | jq '.result'

详见 输入输出格式。

MCP 与插件

把外部世界接进来。

Flag	作用
--mcp-config <path>	指定 MCP 配置文件（JSON）
--strict-mcp-config	严格模式：MCP 服务器启动失败时直接报错而非降级
--plugin-dir <path>	从本地目录加载插件
--plugin-url <url>	从 URL 安装并加载插件

# 用一份自定义 MCP 配置启动
claude --mcp-config ./mcp-prod.json --strict-mcp-config

后台与远程

让 Claude 在云端或后台跑。

Flag	作用
--bg	后台模式，会话在后台运行，可 claude attach 接入
--remote	远程执行模式
--remote-control	启用远程控制接口，允许外部触发
--teleport	把当前会话状态迁移到另一台机器

# 起一个后台会话跑长任务
claude --bg "跑全量测试并生成报告"

Worktree

结合 git worktree 做并行分支开发。

Flag	作用
--worktree	在新的 git worktree 里开 Claude，互不污染
--tmux	在 tmux 分屏里跑，适合多会话并排看

# 在独立 worktree 里实验新分支
claude --worktree --name feature-experiment

调试

排错时打开。

Flag	作用
--debug	打开调试输出
--debug-file <path>	把调试日志写到文件
--bare	裸模式，禁用一切插件/MCP/扩展，最小启动，便于隔离问题

# 怀疑是插件导致问题，用裸模式排查
claude --bare

其他

杂项但实用。

Flag	作用
--add-dir <path>	把额外目录加进 Claude 可访问的工作目录
--agents <config>	指定 subagents 配置
--betas <list>	启用 beta 特性
--channels <list>	指定更新通道（stable / beta 等）
--chrome	启动带 Chrome 调试的工具
--init	为项目生成 CLAUDE.md 初始文件
--max-budget-usd <n>	限制本次会话最大花费（美元）
--max-turns <n>	限制最大 agentic 轮数，防止失控

# 给团队新人设个保护栏：单次会话最多花 5 美元
claude --max-budget-usd 5 --max-turns 50

# 给项目初始化一个 CLAUDE.md
claude --init

速查心法

50 多个 flag 不可能全记，记住这三条就够：

1. 会话控制（-c/-r/--name）解决「接着干」。
2. 权限（--permission-mode/--allowedTools）解决「能干啥」。
3. 输入输出（-p/--output-format/--json-schema）解决「自动化」。

剩下的查表即可。

一句话总结

Flag 是 Claude Code 的旋钮盘。日常你只用三五个，剩下的是「需要时知道有」——这就是速查表存在的意义。

继续看 权限模式 或 模型配置 把旋钮拧到合适的刻度。🎛️