无头模式自动化

Claude Code 包含无头模式，可用于 CI、预提交钩子、构建脚本和自动化等非交互式上下文。

什么是无头模式

无头模式允许您以编程方式使用 Claude Code，而无需交互式界面。使用 -p 标志与提示词来启用无头模式。

基本用法

claude -p "分析当前项目的代码质量并生成报告"

常用参数

--output-format stream-json - 流式JSON输出
--allowedTools - 指定允许的工具
--verbose - 详细输出用于调试

应用场景

1. 问题分类

无头模式可以支持由GitHub事件触发的自动化：

claude -p "分析这个GitHub Issue并添加适当的标签" \
  --allowedTools "Read,Bash(gh:*)"

2. 代码检查

超出传统工具检测范围的主观代码审查：

claude -p "检查代码中的拼写错误、过时注释和误导性函数名" \
  --allowedTools "Read,Write"

3. 批量处理

处理大型迁移或分析任务：

# 生成任务列表
claude -p "生成需要从React迁移到Vue的文件列表"

# 循环处理
for file in $(cat migration-list.txt); do
  claude -p "将 $file 从React迁移到Vue" \
    --allowedTools "Edit,Bash(git commit:*)"
done

注意事项

无头模式不在会话间持续，每次都需要重新启动
使用 --verbose 进行调试，生产环境建议关闭
确保网络连接稳定

相关阅读: 多Claude协作 - 学习并行协作工作流程。

无头模式自动化

On this page