מה זה Headless Mode ב-Claude Code?

Headless Mode (מצב לא-אינטראקטיבי) ב-Claude Code הוא אופן הרצה שבו הכלי פועל בלי ממשק שיחה: נותנים לו הוראה כארגומנט בשורת-הפקודה באמצעות הדגל -p (או --print), והוא מבצע את המשימה ומחזיר את הפלט ל-stdout — מתאים לסקריפטים, אוטומציות ו-CI/CD.

מאת איליי אוסטרוב · מייסד DigitalBox ומדריך קורס Claude Code Mastery

עודכן ב-28 ביוני 2026

מונחים נרדפים (עברית): מצב לא-אינטראקטיבי · מצב הדפסה
English: Headless Mode · Print Mode · Non-interactive mode
הגדרה באנגלית: Headless mode in Claude Code runs the tool non-interactively: you pass the instruction as a command-line argument via the -p (or --print) flag, and it prints the result to stdout — built for scripts, automation, and CI/CD.

איך זה עובד

במקום להריץ claude ולפתוח שיחה, מעבירים את ההוראה ישירות בדגל -p. הכלי מבצע, מדפיס תשובה ל-stdout ויוצא — כך אפשר לחבר אותו ל-pipe, לשמור את הפלט לקובץ, או לעבד אותו בסקריפט:

# הרצה לא-אינטראקטיבית בסיסית
claude -p "summarize the changes in this repo"

# פלט בפורמט מובנה לעיבוד אוטומטי
claude -p "review the staged changes" --output-format=json

למה זה שימושי

🔎 הערת אימות (FLAG): שם הדגל -p / --print אומת ישירות מול הפלט של claude --help בגרסה Claude Code v2.1.195 (28 ביוני 2026): "-p, --print — Print response and exit". מקור רשמי: docs.anthropic.com/claude-code.

קשור ל־

שאלות נפוצות

מה הדגל שמפעיל Headless Mode ב-Claude Code?

הדגל הוא -p, שזהה ל---print. מריצים למשל: claude -p "ההוראה שלך". הכלי מבצע את המשימה, מדפיס את התשובה ל-stdout ויוצא, בלי להיכנס לשיחה אינטראקטיבית.

איך מקבלים פלט בפורמט מובנה?

מוסיפים את הדגל --output-format עם הערך json או stream-json, למשל: claude -p "..." --output-format=json. כך אפשר לעבד את התוצאה בסקריפט או ב-pipeline.

מתי כדאי להשתמש ב-Headless Mode?

בכל מקום שבו אין אדם מול המסך: סקריפטים, hooks של pre-commit, משימות מתוזמנות (cron) ו-CI/CD — למשל סקירת קוד אוטומטית על כל Pull Request.

מה הקשר בין Headless Mode ל-Agent SDK?

מצב ה-print הוא הבסיס לשימוש התכנותי ב-Claude Code: הוא מאפשר לקרוא לכלי מתוך קוד ולקבל פלט מובנה, וזו אבן-הבניין שעליה נשען ה-Agent SDK לבניית סוכנים אוטומטיים.

רוצים לאוטמט את Claude Code בעבודה שלכם?

קורס Claude Code Mastery מלמד Headless Mode, CI/CD ואוטומציה — בעברית.

לעמוד הקורס