Claude Code 无头模式使用指南：命令行脚本运行与自动化集成教程 | SkillsMDClaude Code 无头模式使用指南：命令行脚本运行与自动化集成教程
claude-code-headless by 0xdarkmatter/claude-mods
npx skills add https://github.com/0xdarkmatter/claude-mods --skill claude-code-headless🇨🇳中文介绍
Claude Code 无头模式
无需交互式界面，通过脚本运行 Claude Code。
快速开始
# 基本无头执行
claude -p "解释这段代码" --allowedTools "Read,Grep"
# JSON 输出以便解析
claude -p "列出文件" --output-format json
# 继续对话
claude -p "开始分析" --output-format json > result.json
session=$(jq -r '.session_id' result.json)
claude --resume "$session" "现在修复问题"
核心 CLI 选项
| 标志 | 描述 |
|---|
-p, --print | 非交互式（无头）模式 |
--output-format | text, json, stream-json |
-r, --resume |
🇺🇸English
Claude Code Headless Mode
Run Claude Code from scripts without interactive UI.
Quick Start
# Basic headless execution
claude -p "Explain this code" --allowedTools "Read,Grep"
# JSON output for parsing
claude -p "List files" --output-format json
# Continue conversation
claude -p "Start analysis" --output-format json > result.json
session=$(jq -r '.session_id' result.json)
claude --resume "$session" "Now fix the issues"
Essential CLI Options
| Flag | Description |
|---|
-p, --print | Non-interactive (headless) mode |
--output-format | text, json, stream-json |
-r, |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
--allowedTools | 逗号分隔的允许工具列表 |
--disallowedTools | 逗号分隔的禁止工具列表 |
--mcp-config | MCP 服务器配置 JSON 文件路径 |
--append-system-prompt | 添加到系统提示词 |
权限模式
| 模式 | 标志 | 效果 |
|---|
| 默认 | (无) | 请求权限确认 |
| 接受编辑 | --permission-mode acceptEdits | 自动接受文件更改 |
| 绕过 | --permission-mode bypassPermissions | 跳过所有提示 |
输出格式
文本（默认）
claude -p "你好"
# 输出：人类可读的响应
JSON
claude -p "你好" --output-format json
{
"type": "result",
"subtype": "success",
"result": "你好！我能帮你什么？",
"session_id": "abc123",
"total_cost_usd": 0.001,
"duration_ms": 1234,
"num_turns": 1
}
流式 JSON
claude -p "你好" --output-format stream-json
# 每条消息的实时 JSONL 输出
常用模式
带工具限制的脚本
claude -p "分析代码库" \
--allowedTools "Read,Grep,Glob" \
--disallowedTools "Write,Edit,Bash"
CI/CD 集成
claude -p "审查此 PR 差异" \
--permission-mode acceptEdits \
--output-format json \
--append-system-prompt "重点关注安全问题"
多轮自动化
session=$(claude -p "开始任务" --output-format json | jq -r '.session_id')
claude --resume "$session" "继续步骤 2"
claude --resume "$session" "完成并报告"
错误处理
result=$(claude -p "任务" --output-format json)
if [[ $(echo "$result" | jq -r '.is_error') == "true" ]]; then
echo "错误: $(echo "$result" | jq -r '.result')" >&2
exit 1
fi
官方文档
额外资源
./references/cli-options.md - 完整 CLI 标志参考./references/output-formats.md - 输出格式架构./references/integration-patterns.md - CI/CD 与脚本示例
另请参阅： claude-code-hooks 用于自动化事件，claude-code-debug 用于故障排除
--resume
-c, --continue | Continue most recent session |
--allowedTools | Comma-separated allowed tools |
--disallowedTools | Comma-separated denied tools |
--mcp-config | Path to MCP server config JSON |
--verbose | Enable verbose logging |
--append-system-prompt | Add to system prompt |
Permission Modes
| Mode | Flag | Effect |
|---|
| Default | (none) | Prompt for permissions |
| Accept edits | --permission-mode acceptEdits | Auto-accept file changes |
| Bypass | --permission-mode bypassPermissions | Skip all prompts |
Output Formats
Text (default)
claude -p "Hello"
# Outputs: Human-readable response
JSON
claude -p "Hello" --output-format json
{
"type": "result",
"subtype": "success",
"result": "Hello! How can I help?",
"session_id": "abc123",
"total_cost_usd": 0.001,
"duration_ms": 1234,
"num_turns": 1
}
Stream-JSON
claude -p "Hello" --output-format stream-json
# Real-time JSONL output for each message
Common Patterns
Script with tool restrictions
claude -p "Analyze the codebase" \
--allowedTools "Read,Grep,Glob" \
--disallowedTools "Write,Edit,Bash"
CI/CD integration
claude -p "Review this PR diff" \
--permission-mode acceptEdits \
--output-format json \
--append-system-prompt "Focus on security issues"
Multi-turn automation
session=$(claude -p "Start task" --output-format json | jq -r '.session_id')
claude --resume "$session" "Continue with step 2"
claude --resume "$session" "Finalize and report"
Error Handling
result=$(claude -p "Task" --output-format json)
if [[ $(echo "$result" | jq -r '.is_error') == "true" ]]; then
echo "Error: $(echo "$result" | jq -r '.result')" >&2
exit 1
fi
Official Documentation
Additional Resources
./references/cli-options.md - Complete CLI flag reference./references/output-formats.md - Output format schemas./references/integration-patterns.md - CI/CD and scripting examples
See Also: claude-code-hooks for automation events, claude-code-debug for troubleshooting
AI新闻播客制作技能：实时新闻转对话式播客脚本与音频生成
