# Headless Mode
 
Headless モードでは、Qwen Code を対話的な UI を使用せずに、コマンドラインスクリプトや自動化ツールからプログラム的に実行できます。これは、スクリプティング、自動化、CI/CD パイプライン、AI を活用したツール構築に最適です。
 
- [Headless Mode](#headless-mode)
  - [概要](#overview)
  - [基本的な使い方](#basic-usage)
    - [直接プロンプト入力](#direct-prompts)
    - [Stdin からの入力](#stdin-input)
    - [ファイル入力との組み合わせ](#combining-with-file-input)
  - [出力形式](#output-formats)
    - [テキスト出力（デフォルト）](#text-output-default)
    - [JSON 出力](#json-output)
      - [使用例](#example-usage)
    - [Stream-JSON 出力](#stream-json-output)
    - [入力形式](#input-format)
    - [ファイルリダイレクト](#file-redirection)
  - [設定オプション](#configuration-options)
  - [使用例](#examples)
    - [コードレビュー](#code-review)
    - [コミットメッセージの生成](#generate-commit-messages)
    - [API ドキュメント作成](#api-documentation)
    - [一括コード解析](#batch-code-analysis)
    - [PR コードレビュー](#pr-code-review)
    - [ログ分析](#log-analysis)
    - [リリースノートの生成](#release-notes-generation)
    - [モデルおよびツール利用状況のトラッキング](#model-and-tool-usage-tracking)
  - [関連リソース](#resources)

qwen --prompt "What is machine learning?"

echo "Explain this code" | qwen

cat README.md | qwen --prompt "Summarize this documentation"

qwen -p "What is the capital of France?"

The capital of France is Paris.

qwen -p "What is the capital of France?" --output-format json

[
  {
    "type": "system",
    "subtype": "session_start",
    "uuid": "...",
    "session_id": "...",
    "model": "qwen3-coder-plus",
    ...
  },
  {
    "type": "assistant",
    "uuid": "...",
    "session_id": "...",
    "message": {
      "id": "...",
      "type": "message",
      "role": "assistant",
      "model": "qwen3-coder-plus",
      "content": [
        {
          "type": "text",
          "text": "The capital of France is Paris."
        }
      ],
      "usage": {...}
    },
    "parent_tool_use_id": null
  },
  {
    "type": "result",
    "subtype": "success",
    "uuid": "...",
    "session_id": "...",
    "is_error": false,
    "duration_ms": 1234,
    "result": "The capital of France is Paris.",
    "usage": {...}
  }
]

qwen -p "Explain TypeScript" --output-format stream-json

{"type":"system","subtype":"session_start","uuid":"...","session_id":"..."}
{"type":"assistant","uuid":"...","session_id":"...","message":{...}}
{"type":"result","subtype":"success","uuid":"...","session_id":"..."}

qwen -p "Write a Python script" --output-format stream-json --include-partial-messages

 
# ファイルに保存
qwen -p "Explain Docker" > docker-explanation.txt
qwen -p "Explain Docker" --output-format json > docker-explanation.json
 
# ファイルに追記
qwen -p "Add more details" >> docker-explanation.txt
 
# 他のツールにパイプ
qwen -p "What is Kubernetes?" --output-format json | jq '.response'
qwen -p "Explain microservices" | wc -w
qwen -p "List programming languages" | grep -i "python"

qwen -p "Explain Docker" --output-format stream-json | jq '.type'
qwen -p "Write code" --output-format stream-json --include-partial-messages | jq '.event.type'

cat src/auth.py | qwen -p "Review this authentication code for security issues" > security-review.txt

result=$(git diff --cached | qwen -p "Write a concise commit message for these changes" --output-format json)
echo "$result" | jq -r '.response'

result=$(cat api/routes.js | qwen -p "Generate OpenAPI spec for these routes" --output-format json)
echo "$result" | jq -r '.response' > openapi.json

for file in src/*.py; do
    echo "Analyzing $file..."
    result=$(cat "$file" | qwen -p "Find potential bugs and suggest improvements" --output-format json)
    echo "$result" | jq -r '.response' > "reports/$(basename "$file").analysis"
    echo "Completed analysis for $(basename "$file")" >> reports/progress.log
done

result=$(git diff origin/main...HEAD | qwen -p "Review these changes for bugs, security issues, and code quality" --output-format json)
echo "$result" | jq -r '.response' > pr-review.json

grep "ERROR" /var/log/app.log | tail -20 | qwen -p "Analyze these errors and suggest root cause and fixes" > error-analysis.txt

result=$(git log --oneline v1.0.0..HEAD | qwen -p "Generate release notes from these commits" --output-format json)
response=$(echo "$result" | jq -r '.response')
echo "$response"
echo "$response" >> CHANGELOG.md

result=$(qwen -p "Explain this database schema" --include-directories db --output-format json)
total_tokens=$(echo "$result" | jq -r '.stats.models // {} | to_entries | map(.value.tokens.total) | add // 0')
models_used=$(echo "$result" | jq -r '.stats.models // {} | keys | join(", ") | if . == "" then "none" else . end')
tool_calls=$(echo "$result" | jq -r '.stats.tools.totalCalls // 0')
tools_used=$(echo "$result" | jq -r '.stats.tools.byName // {} | keys | join(", ") | if . == "" then "none" else . end')
echo "$(date): $total_tokens tokens, $tool_calls tool calls ($tools_used) used with models: $models_used" >> usage.log
echo "$result" | jq -r '.response' > schema-docs.md
echo "Recent usage trends:"
tail -5 usage.log