Der Claude Code Headless-Modus ermöglicht die programmatische Ausführung von Claude Code aus Shell-Skripten und CI/CD-Pipelines. Diese Skill-Dokumentation bietet Anleitungen und Beispiele für nicht-interaktive Automatisierung.
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
テストする
「claude-code-headless」を使用しています。 Claude im Headless-Modus ausführen, um eine Datei zu analysieren
期待される結果:
- Claude gibt strukturiertes JSON mit Ergebnistext, Sitzungs-ID, Kosten und Dauer zurück
- Sitzungs-ID ermöglicht Fortsetzung der Unterhaltung für mehrstufige Workflows
- Exit-Codes zeigen Erfolg (0) oder Fehler (1/2) für Skript-Verarbeitung an
セキュリティ監査
安全This is a pure documentation skill containing only markdown files. It provides examples and documentation for using Claude Code CLI headless mode. No executable code, no file operations, no network calls, no command execution. The shell script examples are documentation only, not actual scripts.
品質スコア
作れるもの
CI/CD-Pipeline-Review
Code-Review in GitHub Actions, GitLab CI oder Jenkins-Pipelines automatisieren
Skriptbasierte Automatisierung
Shell-Skripte für Stapelverarbeitung und wiederkehrende Aufgaben erstellen
Automatisierte Prüfungen
Sicherheits-Scans programmatisch mit eingeschränktem Werkzeugzugriff ausführen
これらのプロンプトを試す
claude -p "Explain this code" --output-format json
claude -p "Analyze codebase" --allowedTools "Read,Grep,Glob" --disallowedTools "Write,Edit,Bash"
claude -p "Start analysis" --output-format json | jq -r '.session_id' then claude --resume "$session" "Continue analysis"
claude -p "Review PR diff" --permission-mode acceptEdits --output-format json --append-system-prompt "Focus on security"
ベストプラクティス
- --output-format json für zuverlässige programmatische Analyse in Skripten verwenden
- Werkzeugzugriff mit --allowedTools und --disallowedTools für Sicherheit einschränken
- Sitzungs-IDs und Fehler explizit für robuste Automatisierung behandeln
回避
- Headless-Modus ohne Werkzeugeinschränkungen in nicht vertrauenswürdigen Kontexten verwenden
- Exit-Codes und Fehlerantworten in Automatisierungsskripten ignorieren
- API-Schlüssel in Skripten fest kodieren statt Umgebungsvariablen zu verwenden