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"`	通过 SDK 继续	`claude -c -p "Check for type errors"`
`claude -r "<session-id>" "query"`	按 ID 恢复会话	`claude -r "abc123" "Finish this PR"`
`claude update`	更新到最新版本	`claude update`
`claude mcp`	配置 MCP 服务器	参见 MCP 文档

CLI 标志

标志	描述	示例
`--add-dir`	添加额外的工作目录	`claude --add-dir ../apps ../lib`
`--agents`	通过 JSON 动态定义自定义子代理	`claude --agents '{"reviewer":{...}}'`
`--allowedTools`	应允许的工具列表	`"Bash(git log:*)" "Read"`
`--disallowedTools`	应禁止的工具列表	`"Bash(git commit:*)"`
`--print, -p`	打印响应而不进入交互模式	`claude -p "query"`
`--system-prompt`	用自定义文本替换整个系统提示	`claude --system-prompt "You are a Python expert"`
`--system-prompt-file`	从文件加载系统提示	`claude -p --system-prompt-file ./prompt.txt "query"`
`--append-system-prompt`	将自定义文本附加到默认系统提示	`claude --append-system-prompt "Always use TypeScript"`
`--output-format`	指定输出格式（text、json、stream-json）	`claude -p "query" --output-format json`
`--input-format`	指定输入格式（text、stream-json）	`claude -p --input-format stream-json`
`--verbose`	启用详细日志记录	`claude --verbose`
`--max-turns`	限制非交互模式中的代理轮数	`claude -p --max-turns 3 "query"`
`--model`	为当前会话设置模型	`claude --model claude-sonnet-4-5-20250929`
`--permission-mode`	以指定的权限模式开始	`claude --permission-mode plan`
`--resume`	按 ID 恢复特定会话	`claude --resume abc123 "query"`
`--continue`	加载当前目录中最近的对话	`claude --continue`
`--dangerously-skip-permissions`	跳过权限提示（谨慎使用）	`claude --dangerously-skip-permissions`

代理标志格式

--agents 标志接受定义自定义子代理的 JSON 对象：

字段	必需	描述
`description`	是	何时应调用子代理的描述
`prompt`	是	指导子代理行为的系统提示
`tools`	否	子代理可以使用的工具数组
`model`	否	要使用的模型别名

示例：

bash

claude --agents '{
  "code-reviewer": {
    "description": "Expert code reviewer",
    "prompt": "You are a senior code reviewer.",
    "tools": ["Read", "Grep", "Glob"],
    "model": "sonnet"
  }
}'

系统提示标志

标志	行为	模式
`--system-prompt`	替换整个默认提示	交互 + 打印
`--system-prompt-file`	替换为文件内容	仅打印
`--append-system-prompt`	附加到默认提示	交互 + 打印

CLI 参考 ​

命令 ​

CLI 标志 ​

代理标志格式 ​

系统提示标志 ​

CLI 参考

命令

CLI 标志

代理标志格式

系统提示标志