תיעוד 155
הפניה ל-CLI
הפניה מלאה לממשק שורת הפקודה של Claude Code, כולל פקודות ודגלים.
#פקודות CLI
אפשר להתחיל סשנים, להזרים תוכן בצינור, לחדש שיחות ולנהל עדכונים עם הפקודות האלה:
| פקודה | תיאור | דוגמה |
|---|---|---|
claude | התחלת סשן אינטראקטיבי | claude |
claude "query" | התחלת סשן אינטראקטיבי עם הנחיה ראשונית | claude "explain this project" |
claude -p "query" | שאילתה דרך SDK, ואז יציאה | claude -p "explain this function" |
cat file | claude -p "query" | עיבוד תוכן שהוזרם בצינור | cat logs.txt | claude -p "explain" |
claude -c | המשך השיחה האחרונה בתיקייה הנוכחית | claude -c |
claude -c -p "query" | המשך דרך SDK | claude -c -p "Check for type errors" |
claude -r "<session>" "query" | חידוש סשן לפי מזהה או שם | claude -r "auth-refactor" "Finish this PR" |
claude update | עדכון לגרסה האחרונה | claude update |
claude gateway | הפעלת שרת שער יישומי Claude באירוח עצמי, למנהלים שמפריסים SSO ומדיניות לפני Claude Code ב-Amazon Bedrock, ב-Agent Platform של Google Cloud, או ב-Microsoft Foundry. דורש --config שמצביע על gateway.yaml. | claude gateway --config gateway.yaml |
claude install [version] | התקנה או התקנה מחדש של הקובץ הבינארי המקורי. מקבל גרסה כמו 2.1.118, או stable או latest. ראו התקנת גרסה מסוימת | claude install stable |
claude auth login | כניסה לחשבון Anthropic. השתמשו ב---email כדי למלא מראש את כתובת הדוא"ל, ב---sso כדי לכפות אימות SSO, וב---console כדי להיכנס עם Anthropic Console לחיוב שימוש ב-API במקום מנוי Claude | claude auth login --console |
claude auth logout | יציאה מחשבון Anthropic | claude auth logout |
claude auth status | הצגת מצב האימות כ-JSON. השתמשו ב---text לפלט קריא לאדם. יוצא עם קוד 0 אם מחוברים, ו-1 אם לא. ה-JSON כולל שדה configDirectory שמציין את ספריית התצורה שה-CLI משתמש בה. השדה דורש Claude Code v2.1.268 או מאוחר יותר. השדה authMethod ב-JSON הוא אחד מ-none, claude.ai, oauth_token, api_key, api_key_helper, או third_party | claude auth status |
claude agents | פתיחת תצוגת סוכנים כדי לנטר ולשגר סשנים מקבילים ברקע. השתמשו ב---cwd <path> כדי להציג רק סשנים שהתחילו תחת התיקייה הזו, או ב---json כדי להדפיס סשנים פעילים כמערך JSON לסקריפטים (--json --all כולל גם סשני רקע שהסתיימו). העבירו --permission-mode, --model, --effort, או --agent כדי להגדיר ברירות מחדל לסשנים שמשגרים. מקבל --settings, --add-dir, --plugin-dir, ו---mcp-config כמו פקודת claude ברמה העליונה. פתיחת תצוגת הסוכנים דורשת מסוף אינטראקטיבי | claude agents --json |
claude attach <id|name> | התחברות לסשן רקע במסוף הזה. העברת חלק משם של סשן שרץ במקום המזהה דורשת Claude Code v2.1.290 או מאוחר יותר | claude attach 7c5dcf5d |
claude auto-mode defaults | הדפסת כללי המסווג המובנים של מצב אוטומטי כ-JSON. השתמשו ב-claude auto-mode config כדי לראות את התצורה בפועל אחרי החלת ההגדרות. --label <prefix> מדפיס רק את הכללים שהתווית שלהם מתחילה בקידומת הזו, בהתאמה בלי תלות ברישיות. דורש Claude Code v2.1.208 או מאוחר יותר | claude auto-mode defaults --label 'Git Destructive' |
claude auto-mode reset | שחזור תצורת ברירת המחדל של מצב אוטומטי על ידי הסרת מקטע autoMode מקובץ הגדרות המשתמש. מבקש אישור לפני כתיבה. העבירו -y/--yes כדי לדלג על הבקשה. כללים מהגדרות מנוהלות או מדגל --settings עדיין חלים. דורש Claude Code v2.1.212 או מאוחר יותר. ראו בדיקת ברירות המחדל והתצורה בפועל | claude auto-mode reset --yes |
claude daemon logs | מעקב אחרי קובץ היומן של המפקח של סשני הרקע, ~/.claude/daemon.log, והדפסת שורות חדשות כשהן מגיעות עד שלוחצים על Ctrl+C | claude daemon logs |
claude daemon run | הרצת המפקח של סשני הרקע בחזית של המסוף הזה, עם הדפסת היומן שלו | claude daemon run |
claude daemon status | הדפסת המצב, הגרסה, ספריית ה-socket ומספר ה-workers של המפקח של סשני הרקע, לאבחון. יוצא עם 1 אם המפקח לא רץ | claude daemon status |
claude daemon stop --any | עצירת המפקח של סשני הרקע והסשנים שהוא מארח. העבירו --keep-workers כדי להשאיר סשני רקע רצים כדי שהמפקח הבא יתחבר אליהם מחדש. --any מאשר עצירה של מפקח לפי דרישה, שזו ברירת המחדל. השתמשו בזה כדי להתאושש ממפקח שלא מגיב | claude daemon stop --any --keep-workers |
claude doctor | הדפסת אבחון התקנה והגדרות לקריאה בלבד מהמסוף בלי להתחיל סשן, כולל תקינות ההתקנה, שגיאות אימות של קובץ ההגדרות, וזכאות ל-Remote Control. לבדיקת ההגדרה מתוך הסשן שיכולה גם להחיל תיקונים, הריצו /doctor | claude doctor |
claude import [source] | התחלת סשן אינטראקטיבי שמריץ /import כדי להביא תצורה מסוכני קוד אחרים אל Claude Code. מקבל את אותן אפשרויות --dry-run ו---yes כמו הפקודה. לא זמין ב-Amazon Bedrock, ב-Agent Platform של Google Cloud, ב-Microsoft Foundry, או ב-Claude Platform on AWS. גם לא זמין כשמכבים משיכת דגלי תכונות. דורש Claude Code v2.1.213 או מאוחר יותר | claude import codex --dry-run |
claude logs <id|name> | הדפסת פלט אחרון מסשן רקע. העברת חלק משם הסשן במקום המזהה דורשת Claude Code v2.1.290 או מאוחר יותר | claude logs 7c5dcf5d |
claude mcp | הגדרת שרתי Model Context Protocol (MCP) | ראו את תיעוד MCP של Claude Code. |
claude mcp login <name> | הרצת זרימת OAuth של שרת MCP מוגדר בלי לפתוח את לוח /mcp האינטראקטיבי. עובד עבור שרתי HTTP, SSE, ומחברי claude.ai. הוסיפו --no-browser מעל SSH כדי להדפיס את כתובת ההרשאה במקום לפתוח דפדפן. עבור שרת HTTP או SSE, הדביקו את כתובת ההפניה חזרה בשורת ההנחיה. עבור מחבר claude.ai, ראו הרשאה מחדש של מחבר מהמעטפת. ראו אימות משורת הפקודה | claude mcp login sentry |
claude mcp logout <name> | ניקוי אישורי OAuth שמורים של שרת MCP | claude mcp logout sentry |
claude plugin | ניהול תוספים של Claude Code. כינוי: claude plugins. ראו הפניה לתוספים לתת-פקודות | claude plugin install code-review@claude-plugins-official |
claude purge [path] | מחיקת כל המצב המקומי של Claude Code לפרויקט: תמלילים, רשימות משימות, יומני ניפוי, היסטוריית עריכת קבצים, שורות היסטוריית הנחיות, והרשומה של הפרויקט ב-~/.claude.json. השמיטו את [path] כדי לבחור מרשימה אינטראקטיבית. דגלים: --dry-run לתצוגה מקדימה, -y/--yes לדילוג על אישור, -i/--interactive לאישור כל פריט, --all לכל פרויקט. ראו ניקוי נתונים מקומיים | claude purge ~/work/repo --dry-run |
claude remote-control | הפעלת שרת Remote Control כדי לשלוט ב-Claude Code מ-Claude.ai או מאפליקציית Claude. רץ במצב שרת (בלי סשן אינטראקטיבי מקומי). ראו דגלי מצב שרת. אחרי שעוצרים את השרת, אפשר להחזיר את הסשנים שהוא שירת. ראו חידוש סשנים אחרי עצירת השרת | claude remote-control --name "My Project" |
claude respawn <id> | הפעלה מחדש של סשן רקע, רץ או עצור, כשהשיחה שלו נשמרת. השתמשו ב---all כדי להפעיל מחדש כל סשן שרץ, למשל כדי לקלוט קובץ בינארי מעודכן של Claude Code | claude respawn 7c5dcf5d |
claude rm <id> | הסרה של סשן רקע מהרשימה. כשההסרה נדחית בגלל ה-worktree של הסשן ו-claude rm שני יכול לפתור את זה, הדחייה מדפיסה את הדגל והערך המדויקים להעברה: --discard-unpushed <commit>@<worktree-id> משליך worktree שיש בו קומיטים שלא נדחפו יחד עם הקומיטים האלה, ו---force-remove-worktree <worktree-id> מוחק תיקיית worktree ש-git או ה-hook WorktreeRemove לא הצליחו להסיר. --discard-unpushed דורש Claude Code v2.1.260 או מאוחר יותר, ו---force-remove-worktree דורש v2.1.268 או מאוחר יותר. תמליל השיחה נשאר במחשב המקומי, זמין דרך claude --resume | claude rm 7c5dcf5d |
claude self-hosted-runner | הפעלת תהליך runner שרושם את המכונה או את הקונטיינר הזה בסביבה באירוח עצמי ומארח סשני ענן של Claude Code על התשתית שלכם. הריצו claude self-hosted-runner setup לסיור מודרך למפעיל, claude self-hosted-runner doctor כדי לאבחן runner פרוס, ו-claude self-hosted-runner orchestrator כדי להפעיל runners לפי דרישה. דורש Claude Code v2.1.224 או מאוחר יותר | claude self-hosted-runner setup |
claude setup-token | יצירת אסימון OAuth ארוך טווח ל-CI ולסקריפטים. מדפיס את האסימון למסוף בלי לשמור אותו. דורש מנוי Claude. ראו יצירת אסימון ארוך טווח | claude setup-token |
claude stop <id> | עצירת סשן רקע. מקבל גם claude kill | claude stop 7c5dcf5d |
claude ultrareview [target] | הרצת ultrareview באופן לא אינטראקטיבי. מדפיס ממצאים ל-stdout ויוצא עם 0 בהצלחה או 1 בכישלון. השתמשו ב---json למטען הגולמי וב---timeout <minutes> כדי לעקוף את ברירת המחדל של 45 דקות. השתמשו ב---post על יעד pull request ב-github.com כדי לפרסם את הממצאים המוגמרים ל-PR כתגובה רגילה אחת מחשבון GitHub שלכם. --no-post הוא ברירת המחדל. --post ו---no-post דורשים Claude Code v2.1.227 או מאוחר יותר. ראו פרסום ממצאים ל-pull request | claude ultrareview 1234 --json |
אם מקלידים תת-פקודה עם שגיאת הקלדה, Claude Code מציע את ההתאמה הקרובה ביותר ויוצא בלי להתחיל סשן. לדוגמה, claude udpate מדפיס Did you mean claude update?.
claude --dangerously-skip-permissions daemon <subcommand> מריץ את תת-הפקודה daemon, כך שתת-הפקודה עובדת כש-claude מוגדר ככינוי שכולל את הדגל. רק --dangerously-skip-permissions או --allow-dangerously-skip-permissions מובילים בתחילה מנתבים אל daemon בצורה הזו. עם כל דגל אחר לפני daemon, תת-הפקודה לא רצה.
#דגלי CLI
התאימו את ההתנהגות של Claude Code עם דגלי שורת הפקודה האלה. claude --help לא מציג כל דגל, כך שהיעדר דגל מ---help לא אומר שהוא לא זמין.
| דגל | תיאור | דוגמה |
|---|---|---|
--add-dir | מוסיף ספריות עבודה נוספות כדי ש Claude יוכל לקרוא ולערוך קבצים. מעניק גישה לקבצים. Claude Code לא מגלה את רוב תצורת .claude/ מהספריות האלה. מאמת שכל נתיב קיים כספרייה. אי אפשר להוסיף את רוב נתיבי הרשת, כמו \\server\share. כדי לשמור את הספריות האלה בין סשנים, הגדירו את permissions.additionalDirectories בהגדרות | claude --add-dir ../apps ../lib |
--advisor <model> | מפעיל את כלי היועץ בצד השרת לסשן הזה עם כינוי מודל, fable, opus, או sonnet, או מזהה מודל מלא. גובר על הגדרת advisorModel לסשן. fable דורש גישת Fable | claude --advisor opus |
--agent | מציין סוכן לסשן הנוכחי (דורס את הגדרת agent) | claude --agent my-custom-agent |
--agents | מגדיר סוכני משנה מותאמים באופן דינמי באמצעות JSON. מקבל את השדות המפורטים לסוכני משנה שמוגדרים ב CLI. עם --print, הערך יכול להיות במקום זאת הנתיב לקובץ JSON שמחזיק את האובייקט. צורת הקובץ דורשת Claude Code v2.1.281 או חדש יותר. Claude Code מאמת את הערך בהפעלה ויוצא על ערך לא תקין. ראו Invalid --agents configuration להודעה ולדגלים ולמשתנה הסביבה שמדלגים על האימות. האימות דורש Claude Code v2.1.242 או חדש יותר | claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' |
--allow-dangerously-skip-permissions | מוסיף את bypassPermissions למחזור המצבים של Shift+Tab בלי להתחיל בו. מאפשר להתחיל במצב אחר כמו plan ולעבור ל bypassPermissions אחר כך. ראו מצבי הרשאה | claude --permission-mode plan --allow-dangerously-skip-permissions |
--allowedTools, --allowed-tools | כלים שרצים בלי בקשת הרשאה, חוץ מקריאות מנתיבי רשת. ראו תחביר כללי הרשאה להתאמת תבניות. כדי להגביל אילו כלים זמינים, השתמשו ב --tools במקום. אם מציינים כאן אחד מכלי מעקב המשימות, Claude Code גם מצרף את הסשן | "Bash(git log *)" "Bash(git diff *)" "Read" |
--append-subagent-system-prompt | מוסיף טקסט מותאם בסוף הנחיית המערכת של כל סוכן משנה, כולל סוכני משנה מקוננים, חוץ מסוכן משנה מסועף, שמשתמש מחדש בהנחיה של השיחה עצמה. חל רק במצב לא אינטראקטיבי עם -p. דורש Claude Code v2.1.205 או חדש יותר | claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query" |
--append-subagent-system-prompt-file | טוען טקסט מקובץ ומוסיף אותו להנחיות המערכת של סוכן משנה. חלופה ל --append-subagent-system-prompt לטקסט ארוך מדי להעברה בשורת הפקודה. אי אפשר לשלב את שני הדגלים. חל רק במצב לא אינטראקטיבי עם -p. דורש Claude Code v2.1.261 או חדש יותר | claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query" |
--append-system-prompt | מוסיף טקסט מותאם בסוף הנחיית המערכת של ברירת המחדל | claude --append-system-prompt "Always use TypeScript" |
--append-system-prompt-file | טוען טקסט נוסף של הנחיית מערכת מקובץ ומוסיף אותו להנחיית ברירת המחדל | claude --append-system-prompt-file ./extra-rules.txt |
--autocompact <auto|tokens> | מגדיר את חלון הדחיסה האוטומטית לסשן הזה בלי לשנות את ההגדרות השמורות. מקבל את אותם ערכים כמו /autocompact. הסעיף הזה מכסה את צורות הערך ואת מה שדורס את הדגל. דורש Claude Code v2.1.221 או חדש יותר | claude --autocompact 500k |
--ax-screen-reader | מרנדר פלט ידידותי לקורא מסך: טקסט שטוח בלי מסגרות דקורטיביות או אנימציות. כופה את המרנדר הקלאסי, כך שלהגדרת tui אין השפעה. סשני רקע מחוברים עדיין מתרנדרים במסך מלא. גובר על CLAUDE_AX_SCREEN_READER ועל הגדרת axScreenReader. דורש Claude Code v2.1.181 או חדש יותר | claude --ax-screen-reader |
--bare | מצב מינימלי: מדלג על גילוי אוטומטי של hooks, skills, פקודות מותאמות, סוכני משנה, תוספים מותקנים, שרתי MCP, זיכרון אוטומטי, ו CLAUDE.md כדי שקריאות מתוסרטות יתחילו מהר יותר. skills בספרייה שמעבירים עם --add-dir עדיין נטענים. ל Claude יש גישה לכלי Bash, קריאת קבצים ועריכת קבצים. מגדיר את CLAUDE_CODE_SIMPLE. ראו מצב bare | claude --bare -p "query" |
--betas | כותרות בטא לכלול בבקשות API (משתמשי מפתח API בלבד) | claude --betas interleaved-thinking |
--bg, --background | מתחיל את הסשן כסוכן רקע וחוזר מיד. מדפיס את מזהה הסשן ופקודות ניהול. שלבו עם --exec כדי להריץ פקודת מעטפת כמשימת רקע במקום סשן Claude, או עם --agent כדי להריץ סוכן משנה מסוים. בודק אמון סביבת עבודה לספרייה לפני שהוא מתחיל. אי אפשר לשלב עם -p/--print. ראו את הפניית השגיאות | claude --bg "investigate the flaky test" |
--channels | (תצוגה מקדימה מחקרית) שרתי MCP ש Claude צריך להאזין להתראות הערוץ שלהם בסשן הזה. רשימה מופרדת ברווחים של רשומות plugin:<name>@<marketplace>. דורש אימות Anthropic דרך claude.ai או מפתח API של Console | claude --channels plugin:my-notifier@my-marketplace |
--chrome | מפעיל שילוב דפדפן Chrome לאוטומציה ובדיקות באינטרנט | claude --chrome |
--cloud | עם תיאור משימה, יוצר סשן ענן חדש. עם מזהה סשן (session_... או cse_...) או כתובת claude.ai/code, מכניס הודעה לתור באותו סשן קיים במקום, עם -p. ראו שליחת הודעת המשך. | claude --cloud "Fix the login bug" |
--continue, -c | טוען את השיחה האחרונה בספרייה הנוכחית, כולל סשן רקע שהסתיים. פתיחת סשני רקע שהסתיימו דורשת Claude Code v2.1.257 או חדש יותר. מדלג על סשנים שנוצרו עם claude -p או Agent SDK, ועל סשנים שההנחיה הראשונה שלהם הייתה /loop. claude -p --continue כולל סשני -p, SDK, ו /loop. כולל סשנים שהוסיפו את הספרייה הזו עם /add-dir | claude --continue |
--dangerously-load-development-channels | מפעיל ערוצים שאינם ברשימת ההיתר המאושרת, לפיתוח מקומי. מקבל רשומות plugin:<name>@<marketplace> ו server:<name>. מבקש אישור, ולכן נכנס לתוקף בסשנים אינטראקטיביים. עם -p, Claude Code מתעלם מהדגל | claude --dangerously-load-development-channels server:webhook |
--dangerously-skip-permissions | מדלג על בקשות הרשאה. שקול ל --permission-mode bypassPermissions. ראו מצבי הרשאה לגבי מה זה עושה ומה זה לא מדלג. לסשנים שהתחילו עם --bg, המצב נשמר כשהמפקח מפעיל מחדש את הסשן | claude --dangerously-skip-permissions |
--debug | מפעיל מצב ניפוי עם סינון קטגוריות אופציונלי, כמו --debug='mcp,startup' או --debug='!mcp'. המסנן נקשר רק בצורה של =. מסנן מופרד ברווחים מפעיל מצב ניפוי בלי סינון | claude --debug='mcp,startup' |
--debug-file <path> | כותב יומני ניפוי לנתיב קובץ מסוים. מפעיל באופן משתמע מצב ניפוי. גובר על CLAUDE_CODE_DEBUG_LOGS_DIR | claude --debug-file /tmp/claude-debug.log |
--desktop | פותח את אפליקציית Claude Desktop על הספרייה הנוכחית ויוצא בלי להתחיל סשן בטרמינל. הוסיפו --continue, או --resume עם מזהה סשן, כדי לפתוח את הסשן הזה ב Desktop במקום. --resume כאן מקבל רק מזהה סשן, לא שם או נתיב תמליל. לא מקבל הנחיה ולא דגלים אחרים חוץ מ --verbose ומדגלי --debug, כי האפליקציה מתחילה את הסשן בעצמה. זמין ב macOS וב Windows x64 כשאתם מחוברים עם מנוי Claude. דורש Claude Code v2.1.285 או חדש יותר | claude --desktop |
--disable-slash-commands | משבית את כל ה skills והפקודות לסשן הזה | claude --disable-slash-commands |
--disallowedTools, --disallowed-tools | כללי דחייה. שם כלי חשוף מסיר את הכלים התואמים מההקשר של Claude: "Edit" מסיר את Edit, "*" מסיר כל כלי, ו "mcp__*" מסיר כל כלי MCP. כלל מתוחם כמו Bash(rm *) משאיר את הכלי זמין ודוחה רק קריאות שתואמות כפי שנכתב. כלל שמציין את EndConversation לא יכול להסיר אותו כל עוד נשאר כלי אחר | "Bash(git log *)" "Bash(git diff *)" "Edit" |
--effort | מגדיר את רמת המאמץ לסשן הנוכחי. אפשרויות: low, medium, high, xhigh, max, או ultracode. הרמות הזמינות תלויות במודל. ultracode מבקש מאמץ xhigh עם ultracode מופעל, ודורש Claude Code v2.1.203 או חדש יותר. במודל של השיחה הראשית, דורס את הגדרות modelSettings ו effortLevel לסשן הזה ולא נשמר | claude --effort high |
--enable-auto-mode | הוסר ב v2.1.111. מצב אוטומטי נמצא עכשיו במחזור Shift+Tab כברירת מחדל. השתמשו ב --permission-mode auto כדי להתחיל בו | claude --permission-mode auto |
--environment <environment-id> | יוצר סשן ענן חדש שרץ על הסביבה המתארחת עצמית עם המזהה הנתון. מזהי סביבה מתחילים ב ccpool_. ראו התנהגות השיגור של --environment להתנהגות השיגור ולשילובי הדגלים שהוא דוחה. דורש Claude Code v2.1.224 או חדש יותר | claude -p "Fix the login bug" --environment ccpool_abc123 |
--exclude-dynamic-system-prompt-sections | מעביר הקשר לפי משתמש, כמו מיקום הזיכרון האוטומטי, החוצה מהנחיית המערכת ולתוך הודעת המשתמש הראשונה. משפר שימוש חוזר במטמון ההנחיה בין משתמשים ומכונות שונים שמריצים את אותה משימה. חל רק עם הנחיית המערכת של ברירת המחדל. מתעלמים ממנו כש --system-prompt או --system-prompt-file מוגדר. השתמשו עם -p לעומסי עבודה מתוסרטים מרובי משתמשים | claude -p --exclude-dynamic-system-prompt-sections "query" |
--exec | מריץ פקודת מעטפת כמשימת רקע מגובה PTY במקום להתחיל סשן Claude. השתמשו עם --bg כדי להפעיל מהמעטפת | claude --bg --exec 'pytest -x' |
--fallback-model | מפעיל נפילה אוטומטית למודל או למודלים שצוינו כשהמודל הראשי עמוס או לא זמין, למשל מודל שיצא משימוש. מקבל רשימה מופרדת בפסיקים שמנוסה לפי הסדר. ראו שרשראות מודל גיבוי. כדי לשמור שרשרת בין סשנים, השתמשו בהגדרת fallbackModel, שהדגל הזה דורס | claude --fallback-model sonnet,haiku |
--fork-session | בחידוש, יוצר מזהה סשן חדש במקום שימוש חוזר במקורי (השתמשו עם --resume או --continue) | claude --resume abc123 --fork-session |
--forward-subagent-text | פולט בלוקי טקסט וחשיבה של סוכן משנה בזרם הפלט כהודעות assistant ו user עם parent_tool_use_id מוגדר, כדי שאפשר יהיה לשחזר את התמליל של כל סוכן משנה. בלי הדגל הזה, Claude Code משמיט את בלוקי הטקסט והחשיבה של סוכן משנה שרץ בחזית. דורש --print ו --output-format stream-json. לסוכני משנה מקוננים, skills מסועפים, והגרסה שכל אחד דורש, ראו מעקב אחרי הודעות סוכן משנה. משתנה הסביבה CLAUDE_CODE_FORWARD_SUBAGENT_TEXT מפעיל את אותה התנהגות. דורש Claude Code v2.1.211 או חדש יותר | claude -p --output-format stream-json --verbose --forward-subagent-text "query" |
--from-pr | פותח את בורר הסשנים מסונן לסשנים שמקושרים לבקשת משיכה מסוימת. מקבל מספר PR, כתובת PR של GitHub או GitHub Enterprise, כתובת merge request של GitLab, או כתובת pull request של Bitbucket. סשנים מקושרים אוטומטית כש Claude יוצר את בקשת המשיכה | claude --from-pr 123 |
--ide | מתחבר אוטומטית ל IDE בהפעלה אם זמין בדיוק IDE תקין אחד | claude --ide |
--init | מריץ ווי Setup עם המתאם init לפני הסשן (מצב הדפסה בלבד) | claude -p --init "query" |
--init-only | מריץ ווי Setup ו SessionStart, ואז יוצא בלי להתחיל שיחה | claude --init-only |
--include-hook-events | כולל אירועי מחזור חיים של hooks בזרם הפלט. אירועי ה hook SessionStart ו Setup תמיד כלולים ולא צריכים את הדגל הזה. חלק מאירועי ה hook, כמו Notification, SessionEnd, PreCompact, ו PostCompact, אף פעם לא מייצרים אירוע hook_started, גם עם הדגל הזה. לאירועים האלה, Claude Code עדיין פולט hook_progress בזמן ש hook פקודה שרץ יותר משנייה מייצר פלט, ופולט hook_response רק כשhook שרץ ברקע מסתיים. דורש --output-format stream-json | claude -p --output-format stream-json --verbose --include-hook-events "query" |
--include-partial-messages | כולל אירועי הזרמה חלקיים בפלט. דורש --print ו --output-format stream-json | claude -p --output-format stream-json --verbose --include-partial-messages "query" |
--input-format | מציין פורמט קלט למצב הדפסה (אפשרויות: text, stream-json) | claude -p --input-format stream-json --output-format stream-json --verbose |
--json-schema | מקבל פלט JSON מאומת שתואם ל JSON Schema אחרי שהסוכן מסיים את זרימת העבודה שלו (מצב הדפסה בלבד). ראו פלטים מובנים. Claude Code יוצא עם שגיאה על סכמה לא תקינה ומקבל את מילת המפתח format כהערה בלי אימות בצד הלקוח | claude -p --json-schema '{"type":"object","properties":{...}}' "query" |
--maintenance | מריץ ווי Setup עם המתאם maintenance לפני הסשן (מצב הדפסה בלבד) | claude -p --maintenance "query" |
--max-budget-usd | עוצר את הריצה ברגע שההוצאה המשוערת על קריאות API מגיעה לסכום הזה (מצב הדפסה בלבד). Claude Code בודק את התקרה מול אומדן העלות בצד הלקוח שלו, שיכול להיות שונה מהחשבון. הוצאה מסוכני משנה נספרת לתקרה. ההוצאה יכולה לעבור את התקרה, אז השאירו מרווח. כשחוזרים לשיחה עם --continue או --resume, סיכומים ששוחזרו מריצות קודמות לא נספרים אליה. ברגע שההוצאה מגיעה לתקרה, יצירת סוכן משנה נוסף נכשלת עם Budget limit reached, ו Claude Code עוצר סוכני משנה ברקע שעדיין רצים. התנהגויות אכיפת התקרה דורשות Claude Code v2.1.217 או חדש יותר | claude -p --max-budget-usd 5.00 "query" |
| דגל | תיאור | דוגמה |
|---|---|---|
--max-turns | מגביל את מספר תורות הסוכן (מצב הדפסה בלבד). אין מגבלה כברירת מחדל. עם --input-format stream-json, הודעה שעדיין בתור כשהמגבלה מסיימת תור נשארת בתור ומתחילה תור חדש עם מגבלה משלה | claude -p --max-turns 3 "query" |
--mcp-config | טוען שרתי MCP מקובצי JSON או ממחרוזות (מופרדים ברווח). כשמעבירים את הדגל הזה עם -p, Claude Code ממתין לשרתים שעדיין בהמתנה שיתחברו לפני הרצת התור הראשון, עד לזמן הקצוב להפעלה של MCP_TIMEOUT, 30 שניות כברירת מחדל. שרת עם רשימת כלים במטמון מדלג על ההמתנה ומתחבר בשימוש הראשון. בסביבה באירוח עצמי חלה המתנה קצרה יותר. ההמתנה דורשת Claude Code v2.1.221 או חדש יותר | claude --mcp-config ./mcp.json |
--model | מגדיר את המודל להפעלה הנוכחית עם כינוי מודל כגון sonnet, opus, haiku, או fable, או השם המלא של מודל. דורס את הגדרת model ואת ANTHROPIC_MODEL | claude --model claude-sonnet-5 |
--name, -n | מגדיר שם תצוגה להפעלה, שמוצג ב-/resume ובכותרת הטרמינל. אפשר לחדש הפעלה בעלת שם עם claude --resume <name>. /rename משנה את השם באמצע ההפעלה וגם מציג אותו בשורת ההנחיה | claude -n "my-feature-work" |
--no-chrome | משבית את שילוב דפדפן Chrome להפעלה זו | claude --no-chrome |
--no-session-persistence | משבית את שמירת ההפעלה כך שההפעלות לא נשמרות לדיסק ואי אפשר לחדש אותן. מצב הדפסה בלבד. משתנה הסביבה CLAUDE_CODE_SKIP_PROMPT_HISTORY עושה את אותו הדבר בכל מצב | claude -p --no-session-persistence "query" |
--output-format | מציין את פורמט הפלט למצב הדפסה (אפשרויות: text, json, stream-json) | claude -p "query" --output-format json |
--permission-mode | מתחיל במצב הרשאות שצוין. מקבל את default, acceptEdits, plan, auto, dontAsk, bypassPermissions, או את manual ככינוי ל-default. הכינוי manual בוחר את מצב ההרשאות שהממשק מתייג כ-Manual ודורש Claude Code v2.1.200 או חדש יותר. claude --help מציג אותו במקום default, ושני הערכים עובדים. דורס את defaultMode מקובצי ההגדרות. בלי הדגל הזה או --dangerously-skip-permissions, הפעלה חדשה מתחילה במצב ההרשאות המתואר בבאיזה מצב הרשאות הפעלה מתחילה, שכולל גם במה ריצת -p מתחילה | claude --permission-mode plan |
--permission-prompt-tool | מציין כלי MCP שיטפל בהנחיות הרשאה במצב לא אינטראקטיבי. מעבירים את השם המלא, כגון mcp__<server>__<tool>, של כלי בשרת MCP שהריצה טוענת. Claude Code ממתין ששרת ה-MCP של הכלי הזה יתחבר לפני הרצת התור הראשון, עד לזמן הקצוב להפעלה של MCP_TIMEOUT, 30 שניות כברירת מחדל. כלי ההנחיה לא יכול לאשר כלי MCP שמסומן כדורש אינטראקציה של משתמש: Claude Code ממיר תוצאת allow עבור כלי כזה ל-deny. ההגבלה הזו דורשת Claude Code v2.1.199 או חדש יותר | claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query" |
--permission-prompts | מגדיר מי עונה על הנחיות הרשאה במצב הדפסה. עם ברירת המחדל host, Claude Code שולח אותן למארח Agent SDK או לכלי --permission-prompt-tool. מעבירים none כשאף אחד לא יכול לענות, ו-Claude Code דוחה אותן. ראו כיבוי הנחיות הרשאה בריצות ללא השגחה. דורש Claude Code v2.1.259 או חדש יותר | claude -p --permission-prompts none "query" |
--plugin-dir | טוען תוסף מתיקייה או מארכיון .zip, או כמה מתיקייה של תוספים, להפעלה זו בלבד. כל דגל מקבל נתיב אחד. חוזרים על הדגל לנתיבים נוספים: --plugin-dir A --plugin-dir B.zip. העברת תיקייה של תוספים דורשת Claude Code v2.1.265 או חדש יותר | claude --plugin-dir ./my-plugin |
--plugin-url | מביא ארכיון .zip של תוסף מכתובת URL להפעלה זו בלבד. חוזרים על הדגל לכמה תוספים, או מעבירים כתובות URL מופרדות ברווח בערך מצוטט אחד | claude --plugin-url https://example.com/plugin.zip |
--print, -p | מדפיס תגובה בלי מצב אינטראקטיבי (ראו תיעוד Agent SDK לפרטי שימוש תכנותי). עבור --resume על הפעלת רקע שעדיין רצה, ראו חידוש הפעלת רקע שרצה | claude -p "query" |
--prompt-suggestions | פולט הודעת prompt_suggestion עם הנחיית המשתמש הבאה החזויה אחרי כל תור שמייצר אחת. שיחות קצרות מאוד יכולות לא לייצר אף אחת. דורש --print, --output-format stream-json, ו---verbose. ראו הצעות הנחיה | claude -p --prompt-suggestions --output-format stream-json --verbose "query" |
--ref <branch> | עם --environment, מבסס את ה-checkout של ההפעלה החדשה על ref בעל שם במקום HEAD המקומי | claude -p "Run the smoke test" --environment ccpool_abc123 --ref main |
--remote | כינוי שהוצא משימוש עבור --cloud, כולל הצורה להפעלה קיימת | claude --remote "Fix the login bug" |
--remote-control, --rc | מתחיל הפעלה אינטראקטיבית עם Remote Control מופעל, כדי שאפשר גם לשלוט בה מ-claude.ai או מאפליקציית Claude. אפשר להעביר שם להפעלה | claude --remote-control "My Project" |
--remote-control-session-name-prefix <prefix> | קידומת לשמות הפעלות Remote Control שנוצרים אוטומטית כשלא מוגדר שם מפורש. ברירת המחדל היא שם המארח של המכונה, ונוצרים שמות כמו myhost-graceful-unicorn. מגדירים CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX לאותה השפעה | claude remote-control --remote-control-session-name-prefix dev-box |
--replay-user-messages | פולט מחדש הודעות משתמש מ-stdin בחזרה ב-stdout לצורך אישור. דורש --input-format stream-json ו---output-format stream-json | claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages |
--restricted | מתחיל במצב מוגבל. משתמשים בו כשרתמת הערכה מפעילה את claude על מכונה משותפת ו-Claude Code אסור לו להריץ פקודות או לקרוא את הגדרות המשתמש והפרויקט של המכונה הזו. Claude Code מסיר את הכלים המובנים שמריצים פקודות או קוד, ואת WebFetch, אלא אם מציינים אותם אחד אחד ב---tools, לא דרך ערכת default. הוא גם מגביל את כלי הקבצים המובנים לתיקיות העבודה, טוען רק הגדרות מנוהלות ו---settings, מסרב ל-bypassPermissions, ומסרב ליצור הפעלות ענן. דורש Claude Code v2.1.248 או חדש יותר | claude --restricted -p "query" |
--resume, -r | מחדש הפעלה מסוימת לפי מזהה או שם, או מציג בוחר אינטראקטיבי לבחירת הפעלה. במקום מזהה, אפשר להעביר את הנתיב המוחלט לקובץ התמליל .jsonl של הפעלה, קובץ תמליל. הבוחר וחיפוש לפי שם כוללים הפעלות שהוסיפו את התיקייה הזו עם /add-dir. כשמעבירים מזהה הפעלה, Claude Code מחפש בתיקיית הפרויקט הנוכחית ובעצי העבודה של git שלה, ואחר כך בכל פרויקט אחר במכונה הזו. לפני v2.1.223, חיפוש המזהה כיסה רק את תיקיית הפרויקט הנוכחית ואת עצי העבודה של git שלה. הפעלות רקע מופיעות בבוחר מסומנות ב-bg. חידוש של הפעלה שעדיין רצה פותח את ההפעלה הזו בטרמינל הזה דרך claude attach, והנחיה שמעבירים בשורת הפקודה מגיעה אליה כתור הבא שלה. לפני v2.1.285, Claude Code סירב והדפיס את פקודת claude attach שיש להריץ | claude --resume auth-refactor |
--safe-mode | מתחיל כשכל ההתאמות האישיות מושבתות כדי לאבחן תצורה שבורה: CLAUDE.md, skills, plugins, hooks, שרתי MCP, פקודות וסוכנים מותאמים אישית, סגנונות פלט, workflows, ערכות נושא מותאמות אישית, קיצורי מקשים מותאמים אישית, פקודות status line ו-file-suggestion, שרתי LSP, ו-auto memory לא נטענים. אימות, בחירת מודל, כלים מובנים והרשאות עובדים כרגיל, באופן ששונה מ---bare. מדיניות ההגדרות המנוהלות עדיין חלה, כולל hooks, status line ופקודות file-suggestion שמוגדרים במדיניות. תוספים מנוהלים, skills מנוהלים, CLAUDE.md מנוהל, ושרתי MCP שמוגדרים במדיניות לא נטענים. שימושי לבדיקה אם התאמה אישית היא מה שמפעיל נפילה אוטומטית למודל. מגדיר את CLAUDE_CODE_SAFE_MODE | claude --safe-mode |
--session-id | משתמש במזהה הפעלה מסוים לשיחה (חייב להיות UUID תקין) | claude --session-id "550e8400-e29b-41d4-a716-446655440000" |
--setting-sources | רשימה מופרדת בפסיקים של מקורות הגדרות לטעינה (user, project, local). ראו תצוגת סוכן וצוותי סוכנים לגבי ההפעלות שמתחילים מההפעלה הזו ויורשות את הרשימה | claude --setting-sources user,project |
--settings | נתיב לקובץ JSON של הגדרות או מחרוזת JSON מוטמעת. ערכים שמגדירים כאן דורסים את אותם מפתחות בקבצי settings.json שלכם להפעלה זו. מפתחות שמשמיטים שומרים על הערכים שלהם מהקובץ. הקובץ חייב להיות קובץ רגיל שלא גדול מ-2 MiB. ראו קדימות הגדרות | claude --settings ./settings.json |
--strict-mcp-config | משתמש רק בשרתי MCP מ---mcp-config, ומתעלם מכל שאר תצורות ה-MCP. ראו שליטה בלעדית עם managed-mcp.json לגבי מה שהדגל עושה תחת קובץ MCP מנוהל | claude --strict-mcp-config --mcp-config ./mcp.json |
--system-prompt | מחליף את כל הנחיית המערכת בטקסט מותאם | claude --system-prompt "You are a Python expert" |
--system-prompt-file | טוען הנחיית מערכת מקובץ, במקום הנחיית ברירת המחדל | claude --system-prompt-file ./custom-prompt.txt |
--system-prompt-snapshot | מעבירים off כדי לבנות מחדש את הנחיית המערכת בכל בקשה במקום לעשות שימוש חוזר בהנחיה שנרשמה בבקשה הראשונה של השיחה, למשל בזמן שמשנים את טקסט --append-system-prompt לאורך ריצות --continue. דורש Claude Code v2.1.257 או חדש יותר | claude --system-prompt-snapshot off |
--teleport | מחדש הפעלת ענן בטרמינל המקומי | claude --teleport |
--teammate-mode | מגדיר איך חברי צוות סוכנים מוצגים: in-process (ברירת מחדל), auto, tmux, או iterm2. דורס את הגדרת teammateMode להפעלה זו. ראו בחירת מצב תצוגה | claude --teammate-mode auto |
--tmux | יוצר הפעלת tmux לעץ העבודה. דורש --worktree. משתמש בחלוניות מקוריות של iTerm2 כשהן זמינות. מעבירים --tmux=classic ל-tmux מסורתי | claude -w feature-auth --tmux |
--tools | מגביל באילו כלים מובנים Claude יכול להשתמש. משתמשים ב-"" כדי להשבית את כולם, ב-"default" לערכה של ברירת המחדל, או בשמות כלים כמו "Bash,Edit,Read". ב-macOS, ב-Linux וב-WSL, ערכת ברירת המחדל משמיטה את Glob ואת Grep, כמתואר תחת התנהגות כלי Glob. אם מציינים כאן אחד מכלי מעקב המשימות, Claude Code גם מצרף את ההפעלה. הדגל לא משפיע על כלי MCP. כדי לדחות גם אותם, משתמשים ב---disallowedTools "mcp__*". רשימה שמשמיטה את EndConversation לא מסירה אותו. "" מסיר אותו רק כשלא נשארים כלי MCP | claude --tools "Bash,Edit,Read" |
--verbose | מפעיל רישום מפורט, ומציג פלט מלא תור אחר תור. דורס את הגדרת viewMode להפעלה זו | claude --verbose |
--version, -v | מציג את מספר הגרסה | claude -v |
--worktree, -w | מתחיל את Claude ב-git worktree מבודד ב-<repo>/.claude/worktrees/<name>. אם לא נותנים שם, Claude Code מייצר אחד. מעבירים #<number>, כתובת URL של pull request ב-GitHub, או כתובת URL של merge request ב-GitLab כדי להביא את ה-PR או ה-MR הזה מ-origin ולפתוח ממנו ענף לעץ העבודה. פתיחת ענף מ-merge request של GitLab דורשת Claude Code v2.1.233 או חדש יותר | claude -w feature-auth |
#דגלי הנחיית מערכת
Claude Code מספק חמישה דגלים להתאמה אישית של הנחיית המערכת. ארבעה קובעים את הטקסט שלה, ועם --system-prompt-snapshot שולטים אם שיחה שומרת את הטקסט שאיתו התחילה. כל החמישה עובדים גם במצב אינטראקטיבי וגם במצב לא אינטראקטיבי.
| דגל | התנהגות | דוגמה |
|---|---|---|
--system-prompt | מחליף את כל הנחיית ברירת המחדל | claude --system-prompt "You are a Python expert" |
--system-prompt-file | מחליף בתוכן של קובץ | claude --system-prompt-file ./prompts/review.txt |
--append-system-prompt | מוסיף לנחיית ברירת המחדל | claude --append-system-prompt "Always use TypeScript" |
--append-system-prompt-file | מוסיף את תוכן הקובץ לנחיית ברירת המחדל | claude --append-system-prompt-file ./style-rules.txt |
--system-prompt-snapshot | עם off, בונה מחדש את ההנחיה בכל בקשה. עם on, ברירת המחדל, משתמש מחדש בהנחיה שנרשמה במקום שבו הרישום חל | claude --append-system-prompt "Draft rules" --system-prompt-snapshot off |
אפשר לשלב את הדגלים האלה. כדי להחליף את הנחיית ברירת המחדל ועדיין להוסיף טקסט משלך, העבר את --append-system-prompt או --append-system-prompt-file יחד עם --system-prompt או --system-prompt-file. ב-Claude Code גרסה v2.1.283 ואילך, אפשר גם להעביר דגל יחד עם צורת הקובץ שלו, למשל --append-system-prompt עם --append-system-prompt-file, ו-Claude Code משתמש בשניהם.
לדוגמה, הרץ את הפקודה הבאה במעטפת כדי להוסיף גם מדריך סגנון מקובץ וגם הוראה נוספת אחת:
claude -p --append-system-prompt-file ./style.md --append-system-prompt "Always reply in French" "Summarize README.md"Claude מקבל את הנחיית המערכת של ברירת המחדל ואחריה את התוכן של style.md, שורה ריקה, ואז Always reply in French. תוכן הקובץ מגיע קודם גם אם מעבירים את --append-system-prompt לפני --append-system-prompt-file.
כשטקסט ההחלפה משלב הוראות שזהות בכל הרצה עם הקשר שמשתנה בכל הרצה, הוסף שורה שמכילה רק __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ בין ההוראות להקשר. Claude Code מפצל את ההנחיה בשורה הראשונה כזאת ומסיר את השורה, כך שהחלק שמעליה נשאר במטמון בעוד החלק שמתחתיה משתנה. נדרש Claude Code גרסה v2.1.275 ואילך. שמירת החלק הסטטי של הנחיה מותאמת במטמון מפרט את התצורות שבהן הפיצול חל.
בחר לפי השאלה אם הזהות של ברירת המחדל של Claude Code עדיין מתאימה למשימה. השתמש בדגל הוספה כש-Claude צריך להישאר עוזר תכנות שגם עוקב אחרי הכללים הנוספים שלך: הוראות לכל הפעלה, עיצוב פלט, או הקשר תחום עבור סקריפט -p. ההוספה שומרת על הדרכת הכלים של ברירת המחדל, הוראות הבטיחות ומוסכמות התכנות, כך שמספקים רק את מה ששונה. השתמש בדגל החלפה כשהמשטח, הזהות או מודל ההרשאות שונים מאלה של Claude Code, למשל סוכן שאינו לתכנות בצינור שאף אדם לא צופה בו. ההחלפה משמיטה את כל הנחיית ברירת המחדל, כולל הדרכת כלים והוראות בטיחות, כך שנושאים באחריות לכל מה שהמשימה עדיין צריכה.
לפרסונות קבועות שאפשר לעבור ביניהן ולשתף בפרויקט, השתמש ב-סגנונות פלט. למוסכמות פרויקט ש-Claude צריך תמיד לעקוב אחריהן, השתמש ב-CLAUDE.md. מדריך Agent SDK על הנחיות מערכת מכסה את אותה החלטה בעומק רב יותר.
#דגלי הנחיית מערכת בשיחות שחודשו
כברירת מחדל, Claude Code בונה את הנחיית המערכת פעם אחת, בבקשה הראשונה של שיחה, עם הטקסט מכל דגלי הנחיית המערכת שהופעלו, ורושם אותה בסשן. עד שהשיחה נדחסת, כל בקשה מאוחרת יותר משתמשת בהנחיה שנרשמה, כולל אחרי שחוזרים לשיחה עם --resume או --continue. אם מעבירים טקסט שונה של דגל הנחיית מערכת, או לא מעבירים כלל, בהפעלה המאוחרת הזאת, הוא נכנס לתוקף ברגע שהשיחה נדחסת או כשמתחילים שיחה חדשה.
מחוץ ל-סשנים בענן, אם מפעילים את Claude Code ב-מצב bare על ידי העברת --bare או הגדרת CLAUDE_CODE_SIMPLE=1, הרישום נשאר כבוי אלא אם מעבירים --system-prompt-snapshot on. לפני v2.1.268, סשנים שלא מושכים דגלי תכונות, כולל סשנים ב-Amazon Bedrock, ב-Agent Platform של Google Cloud וב-Microsoft Foundry, בנו מחדש את ההנחיה בכל בקשה ול---system-prompt-snapshot לא הייתה השפעה.
כדי לבנות מחדש את ההנחיה בכל בקשה במקום זאת, למשל בזמן שמשפרים את הניסוח שלה לאורך הרצות --continue, העבר --system-prompt-snapshot off. לפני v2.1.265, העברת כל אחד מדגלי הנחיית המערכת גם כיבתה את הרישום אלא אם העברת --system-prompt-snapshot on.
#ראה גם
- תוסף Chrome - אוטומציה של דפדפן ובדיקות רשת
- מצב אינטראקטיבי - קיצורי דרך, מצבי קלט ותכונות אינטראקטיביות
- מדריך התחלה מהירה - תחילת העבודה עם Claude Code
- תהליכי עבודה נפוצים - תהליכי עבודה ודפוסים מתקדמים
- הגדרות - אפשרויות תצורה
- תיעוד Agent SDK - שימוש תכנותי ואינטגרציות