本页目录3
要点速览
- claude 启动交互;claude "query" 带初始提示;claude -p 非交互(脚本/CI)后退出。
- claude -c 继续当前目录最近会话;claude -r "<id|name>" 按 ID/名恢复或弹选择器。
- -p 配 --output-format text|json|stream-json 便于程序解析;--max-turns 限制轮数。
- --permission-mode 取 default/acceptEdits/plan/auto/dontAsk/bypassPermissions;--dangerously-skip-permissions 等价 bypassPermissions。
- --bare 跳过 hooks/skills/plugins/MCP/memory/CLAUDE.md 自动发现,CI 行为可复现。
本文是对官方 CLI reference 的中文整理,命令与参数以原文为准。
命令
| 命令 | 说明 |
|---|---|
claude | 启动交互式会话 |
claude "query" | 带初始提示启动 |
claude -p "query" | 非交互(经 SDK)查询后退出 |
claude -c | 继续当前目录最近一次对话 |
claude -c -p "query" | 非交互方式继续 |
claude -r "<session>" "query" | 按 ID 或名称恢复会话 |
claude update | 更新到最新版 |
claude install [version] | 安装/重装原生二进制(接受 2.1.118/stable/latest) |
claude auth login | 登录(--email 预填邮箱,--sso 强制 SSO,--console 用 Console 按量计费) |
claude auth logout | 退出登录 |
claude mcp ... | 管理 MCP 服务器 |
高频参数
| 参数 | 说明 |
|---|---|
--print, -p | 非交互输出(脚本/CI;见 Agent SDK) |
--model | 设模型别名 sonnet/opus/haiku/fable 或完整 ID |
--output-format | print 模式输出:text / json / stream-json |
--input-format | print 输入:text / stream-json |
--permission-mode | default/acceptEdits/plan/auto/dontAsk/bypassPermissions |
--allowedTools / --disallowedTools | 免提示/禁用的工具(权限规则语法) |
--add-dir | 增加可读写的工作目录 |
--continue, -c | 加载当前目录最近会话 |
--resume, -r | 按 ID/名恢复或弹选择器 |
--fork-session | 恢复时新建 session ID(配 --resume/--continue) |
--session-id | 指定会话 ID(合法 UUID) |
--max-turns | 限制 agentic 轮数(仅 print) |
--append-system-prompt | 在默认系统提示末尾追加文本 |
--mcp-config | 从 JSON 文件/字符串加载 MCP(空格分隔) |
--settings | settings JSON 文件路径或内联 JSON(覆盖同名键) |
--agents | 用 JSON 动态定义子代理(字段同 frontmatter) |
--effort | 设 effort:low/medium/high 等 |
--bare | 最小模式:跳过 hooks/skills/plugins/MCP/memory/CLAUDE.md 自动发现 |
--dangerously-skip-permissions | 跳过权限提示(等价 bypassPermissions) |
--verbose | 详细日志,逐轮完整输出 |
常用范式
# 一次性查询
claude -p "Explain what this project does"
# 结构化输出供脚本解析
claude -p "List all API endpoints" --output-format json
# 流式
claude -p "Analyze this log" --output-format stream-json --verbose
# 自动模式跑批
claude --permission-mode auto -p "fix all lint errors"
参数众多,本表为高频项;完整 flag(含 --chrome/--remote-control/--from-pr/--safe-mode 等)见官方原文。