Automatizare Headless & CI/CD (claude -p) în Claude Code CLI

claude -p "instrucțiune" [opțiuni]

Deși este proiectat nativ ca un partener interactiv de terminal, Claude Code dispune de modul Headless (Print Mode) activat prin flagul -p (sau --print). Acest mod permite invocarea asistentului ca o comandă standard Unix care preia instrucțiunea, o execută autonom și afișează direct rezultatul la `stdout`.

Modul Headless transformă Claude Code într-un motor puternic de automatizare: poate fi integrat în pipeline-uri de CI/CD pentru a genera automat changelog-uri pe baza commit-urilor, pentru a redacta recenzii detaliate la fiecare Pull Request deschis sau pentru a remedia automat erorile de linting înainte de merge.

Combinat cu flagul --permission-mode sau permisiuni stricte de sandbox, Claude Code devine un membru de echipă automatizat ce rulează pe servere fără intervenție umană.

Sintaxă, opțiuni și concepte cheie

Opțiune / Concept	Descriere practică
-p, --print	Activează execuția non-interactivă: procesează promptul, efectuează acțiunile autorizate și se oprește.
--permission-mode	Setează politica de execuție: ‘ask’ (implicit), ‘allow-safe’ sau ‘dangerously-skip-permissions’ (utilizat în containere izolate de CI).
--output-format	Formatul rezultatului la ieșire: text simplu, Markdown sau JSON pentru parsare facilă în alte scripturi.
STREAMS & Exit Codes	Returnează cod de eroare 0 la succes și >0 la eșec, integrându-se perfect cu ‘set -e’ în Bash.

Exemple practice de terminal și cod

Exemplul 1: Workflow GitHub Actions pentru recenzia automată a Pull Request-urilor

Pas de pipeline ce rulează Claude Code pe diff-ul de cod nou.

# .github/workflows/ai-review.yml
name: AI PR Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 20 }
      - run: npm install -g @anthropic-ai/claude-code
      - name: Rulează Review Headless
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p "Analizează diff-ul din acest PR și raportează vulnerabilitățile de securitate sau scăpările de memorie." > review.md
      - run: gh pr comment ${{ github.event.number }} --body-file review.md

Rezultat & Impact

Recenzie tehnică de nivel senior postată automat pe GitHub în mai puțin de 60 de secunde.

Greșeli frecvente și bune practici

• Folosirea modului headless pe mașini de producție fără containerizare sau fără restricționarea comenzilor de ștergere fișiere.
• Omiterea verificării codului de ieșire (exit status) în scripturile automate de integrare continuă.

Ghiduri și comenzi înrudite

• claude-hooks
• claude-subagents
• claude-md-avansat