以下是当前页面所有CLI命令与标志的Markdown表格总结，按「命令」「标志」两类拆分，覆盖核心功能与配置项：
一、CLI 命令（直接执行的操作）
| 命令 | 描述 | 示例 |
|---|
claude | 启动交互式 REPL 会话（默认进入对话模式） | claude |
claude "query" | 用初始提示启动 REPL（直接执行查询） | claude "explain this project" |
claude -p "query" | 通过 SDK 模式查询后退出（非交互，用于程序化调用） | claude -p "explain this function" |
cat file | claude -p "query" | 处理管道输入（如分析日志文件） | cat logs.txt | claude -p "explain" |
claude -c | 继续当前目录最近一次对话 | claude -c |
claude -c -p "query" | 继续最近对话并执行查询（非交互） | claude -c -p "Check for type errors" |
claude -r "<session-id>" "query" | 按会话ID恢复指定会话 | claude -r "abc123" "Finish this PR" |
claude update | 更新Claude Code到最新版本 | claude update |
claude mcp | 配置模型上下文协议（MCP）服务器（用于扩展工具） | 请参阅Claude Code MCP文档 |
二、CLI 标志（自定义行为的参数）
| 标志 | 描述 | 示例 | 模式/注意事项 |
|---|
| 基础功能类 | | | |
--add-dir <path> | 添加额外工作目录（供Claude访问外部代码库，需验证路径为目录） | claude --add-dir ../apps ../lib | 基础路径配置 |
| 代理与工具类 | | | |
--agents <JSON对象> | 动态定义自定义子代理（需包含description（描述）、prompt（提示）、tools（可选工具）、model（可选模型）） | claude --agents '{"reviewer":{...}}' | 用于拆分复杂任务（如代码审查、调试） |
--allowedTools <工具列表> | 允许的工具列表（无需用户授权，优先级高于settings.json） | "Bash(git log:*)" "Read" | 限制工具访问 |
--disallowedTools <工具列表> | 禁止的工具列表（无需用户授权，优先级高于settings.json） | "Bash(git diff:*)" "Edit" | 禁用危险/无用工具 |
| 输出与日志类 | | | |
--print, -p | 打印响应后不进入交互模式（用于程序化调用） | claude -p "query" | 配合--output-format解析结果 |
--output-format <格式> | 指定打印模式的输出格式（text/json/stream-json） | claude -p "query" --output-format json | 自动化解析推荐json |
--include-partial-messages | 输出中包含部分流事件（需配合--print+--output-format=stream-json） | claude -p --include-partial-messages "query" | 实时流式处理 |
--verbose | 启用详细日志（显示完整逐轮输出，用于调试） | claude --verbose | 排查交互/打印问题 |
| 会话与权限类 | | | |
--max-turns <数字> | 限制非交互模式中代理的对话轮数 | claude -p --max-turns 3 "query" | 控制自动化流程长度 |
--model <模型名称> | 设置当前会话模型（支持别名sonnet/opus或完整名称） | claude --model claude-sonnet-4-5-20250929 | 切换模型能力 |
--permission-mode <模式> | 以指定权限模式启动（如plan） | claude --permission-mode plan | 控制权限验证流程 |
--resume <session-id> | 按ID恢复特定会话（同命令claude -r） | claude --resume abc123 "query" | 会话管理 |
--continue | 加载当前目录最近对话（同命令claude -c） | claude --continue | 会话延续 |
--dangerously-skip-permissions | 跳过权限提示（谨慎使用，需明确风险） | claude --dangerously-skip-permissions | 仅紧急场景使用 |
| 系统提示定制类 | | | |
--system-prompt <文本> | 完全替换默认系统提示（交互+打印模式可用；v2.0.14+） | claude --system-prompt "You are a Python expert" | 彻底控制Claude指令（删除内置功能） |
--system-prompt-file <文件路径> | 从文件加载系统提示（仅打印模式可用；v1.0.54+） | claude -p --system-prompt-file ./prompt.txt | 团队一致/版本控制的提示模板 |
--append-system-prompt <文本> | 追加到默认系统提示末尾（保留内置功能；v1.0.55+） | claude --append-system-prompt "Always use TS" | 最安全选项（保留Claude Code原生能力） |
关键说明
- 互斥规则：
--system-prompt与--system-prompt-file不能同时使用（均会替换默认提示）。 - 程序化推荐：
--print -p+--output-format=json组合最适合脚本/自动化（可解析结构化响应）。 - 子代理：通过
--agents定义的子代理可继承/自定义工具与模型，适用于拆分复杂任务（如代码审查+调试）。
