这是 Claude Code 命令行接口的完整参考,用于在终端及自动化流程中调用 Claude Code。
用途与场景:查询可用 CLI 标志、使用无头(headless)模式、在自动化或 CI/CD 中运行 Claude、选择输出格式、通过 CLI 设置系统提示,以及正确地生成子智能体。
核心命令:claude 启动交互式 REPL;claude "query" 带初始提示启动;claude -p "query" 进入无头(SDK)模式;cat file | claude -p 处理管道内容;claude -c 继续最近会话;claude -c -p "query" 经 SDK 继续;claude -r "id" "query" 恢复会话;claude update 更新版本;claude mcp 配置 MCP 服务器。
会话控制:--continue/-c 载入最近对话,--resume/-r 按 ID 或名称恢复,--session-id 指定 UUID,--fork-session 恢复时新建会话。
无头模式:--print/-p 非交互执行后退出,--output-format 支持 text、json、stream-json,--max-turns 限制智能体轮次,--verbose 输出逐轮详情,--dangerously-skip-permissions 跳过权限提示,--include-partial-messages 包含流式事件,--input-format 指定输入格式。
工具控制:--allowedTools 自动批准指定工具,--disallowedTools 屏蔽工具,--tools 仅允许所列工具。
子智能体:通过 --agents 以内联 JSON 定义,字段包括 description(必填,何时调用)、prompt(必填,行为系统提示)、tools(可选,省略则继承全部)、model(可选,sonnet、haiku 或 claude-opus-4-5-20251101)。Lead 使用 Task 工具时会依据定义自动生成,无需手动 spawn。
系统提示:--system-prompt 替换整个提示(交互与打印模式),--system-prompt-file 从文件替换(仅打印模式),--append-system-prompt 追加到默认提示(交互与打印模式,多数情况推荐,可保留 Claude Code 原有能力)。
模型与 MCP:--model 设置会话模型,--fallback-model 在默认过载时回退,别名有 sonnet、opus、haiku。--mcp-config 从 JSON 载入 MCP 服务器,--strict-mcp-config 仅使用这些服务器。
其他标志:--add-dir 添加工作目录,--agent 指定会话智能体,--permission-mode 设置初始权限模式,--permission-prompt-tool 指定权限用 MCP 工具,--plugin-dir 载入插件目录,--settings 载入设置,--setting-sources 选择设置来源,--betas 添加 Beta API 头,--debug 开启调试,--ide 自动连接 IDE,--chrome 与 --no-chrome 开关 Chrome 集成,--enable-lsp-logging 输出 LSP 调试,--version/-v 输出版本。
输出格式:JSON 便于解析,stream-json 输出换行分隔事件便于实时监控,配合 --json-schema 可做结构化输出校验。
无头智能体模式:建议同时使用 --session-id 跟踪会话、--dangerously-skip-permissions(无头模式必需)、--max-turns 防止无限循环,缺失任一项可能导致挂起。
常见模式:CI/CD 自动化(-p 加权限跳过、轮次限制、json 输出后用 jq 提取)、管道输入(cat error.log | claude -p,gh pr diff | claude -p)、多轮会话(先取 session_id 再用 --resume 继续)、流监控(stream-json 配合 include-partial-messages 逐行读取)。
交互快捷键:Ctrl+C 取消,Ctrl+D 退出,Ctrl+R 反向搜索历史,Esc Esc 回退更改,Shift+Tab 切换权限模式。快捷前缀:/ 斜杠命令,! Bash 模式,# 加入记忆,@ 提及文件。
限制与缺失:资料未提供各功能的收费、价格、平台要求与性能或效果数据。