这是 Claude Code CLI 的完整命令参考。核心用法：claude 启动交互会话，claude -p "提示词" 非交互输出后退出，claude -c 继续上次对话。常用标志：--permission-mode plan 只读计划模式，--allowedTools 预批准工具，--output-format json 结构化输出，--model sonnet 切换模型。用 claude --help 可查看所有标志，但部分高级标志不列在其中，以本文为准。

Claude Code CLI 命令参考：标志速查与常见用法 #

命令速查表 #

常用标志参考 #

系统提示相关标志 #

--system-prompt 和 --system-prompt-file 互斥，追加标志可与替换标志组合使用。如果在交互和非交互模式下都可用，追加标志保留默认提示的工具指导和安全指令，替换标志则完全丢弃。

会话管理 #

权限控制 #

输出控制 #

模型与代理 #

后台会话与远程控制 #

实用技巧 #

非交互式脚本用法 #

# 管道输入
cat build-error.txt | claude -p "简要解释这个构建错误的根本原因"

# 结构化输出供脚本解析
claude -p "列出所有 API 端点" --output-format json > endpoints.json

# 流式 JSON 实时处理
claude -p "分析日志文件" --output-format stream-json | jq '.content'

# 组合权限限制与最大回合数
claude -p "分析认证系统" --permission-mode plan --max-turns 5 --tools "Read,Glob,Grep"

常见错误排查 #

常见问题 #

怎么恢复一个指定名称的对话会话？ #

使用 claude -r <会话名称>，例如 claude -r "my-feature-work"。会话名称在启动时用 --name 设置，或通过 /rename 命令在会话期间设置。

Claude Code CLI 能集成到 CI/CD 流程中吗？ #

可以。用 claude -p "查询" 非交互模式，结合 --output-format json 输出结构化结果供脚本解析。--max-turns 和 --max-budget-usd 可控制资源消耗，--fallback-model 在模型过载时自动回退。

怎么在脚本中限制 Claude 只能读文件不能执行修改？ #

使用 claude --permission-mode plan 启动只读计划模式，并用 --tools "Read,Glob,Grep" 限制可用工具集合。--allowedTools 可以进一步预设无需确认的工具。