📘 תיעוד 24

שימוש ב-Claude Code בענן

הרצת סשנים של Claude Code בענן מהדפדפן, מהטלפון, מאפליקציית Desktop או מהטרמינל, העברה שלהם עם --cloud ו---teleport, ותיקון אוטומטי של pull requests.

הערה

סשנים בענן זמינים בתוכניות Pro, Max, Ultra ו-Team, ולמשתמשי Enterprise עם מושבי פרימיום או מושבים של Chat + Claude Code. אם תפקידים מותאמים קובעים את הגישה שלך, צריך גם תפקיד עם הרשאת cloud sessions כדי להתחיל סשנים על התשתית של Anthropic מהדפדפן, מהאפליקציות או מהטרמינל. בקש מ-Owner להוסיף אותה לאחד מהתפקידים שלך ב-Organization settings > Roles.

סשן בענן הוא סשן של Claude Code שרץ על תשתית ענן במקום על המחשב שלך. כברירת מחדל הוא רץ על תשתית ש-Anthropic מנהלת, או על סביבה באירוח עצמי של הארגון שלך כשהוא מנותב לשם. הסשן ממשיך לרוץ אחרי שסוגרים את המחשב הנייד, ואפשר לבדוק אותו או לכוון אותו מכל מכשיר. הוא נספר במגבלות השימוש של התוכנית שלך יחד עם שאר השימוש שלך ב-Claude וב-Claude Code, ואין חיוב נפרד על ה-VM בענן.

כדי לאפשר לסשנים בענן לשכפל את הקוד שלך מ-GitHub ולדחוף ענפים, חבר את GitHub באחת משיטות החיבור ל-GitHub. אם המאגר שלך נמצא ב-GitLab, ב-Bitbucket או במארח אחר, ראה מגבלות פלטפורמה לגבי מה שעובד.

אפשר להתחיל סשן בענן מכל אחד מהמשטחים האלה:

• דפדפן: claude.ai/code, שנקרא גם Claude Code on the web
• נייד: הלשונית Code באפליקציית Claude
• אפליקציית Desktop: בחר סביבה תחת Cloud בבורר הסביבות כשמתחילים סשן
• טרמינל: claude --cloud
• משימות מתוזמנות בענן: הרצות מתוזמנות ומופעלות, וכל אחת רצה כסשן בענן

אחרי שההגדרה הושלמה, השתמש בדף הזה כדי להעביר עבודה בין הטרמינל לענן, לנהל ולשתף סשנים, להפעיל תיקון אוטומטי ל-pull requests, ולפתור בעיות.

הערה

המקרים האלה מכוסים בדפים אחרים:

• התחלת הסשן הראשון בענן: תחילת עבודה עם סשנים בענן מחברת את GitHub ומדריכה במשימה בדפדפן
• הרבה סשנים בענן לגוף עבודה אחד: פרויקט גורם ל-Claude להתחיל אותם ולעקוב אחריהם בשבילך
• כיוון סשן מקומי ממכשיר אחר: סשנים בטרמינל, ב-IDE או באפליקציית Desktop כש-Local נבחר רצים על המחשב שלך, ו-Remote Control מאפשר להגיע אליהם מהטלפון או מהדפדפן

#סביבות ענן

כל סשן בענן רץ בסביבת ענן, התצורה השמורה ששולטת בגישה לרשת, במשתני סביבה ובסקריפטי הגדרה.

• הסביבה הראשונה שלך: אם עדיין אין לך אחת, תהליך ההצטרפות מגדיר סביבת Default עם גישת רשת Trusted, על ידי יצירה בשבילך או על ידי בקשה שתיצור אותה. ראה סביבת Default לגבי מה מבין אלה קורה בתוכנית שלך
• איזו סביבה סשן משתמש: ראה סביבת Default לגבי האופן שבו סשנים בוחרים סביבה כשיש יותר מאחת
• שינוי מה שסשנים יכולים להגיע אליו או להריץ בהפעלה: ראה הגדרת סביבות ענן
• מה מותקן בלי שום הגדרה: ראה כלים מותקנים

#אפשרויות אימות ל-GitHub

סשנים בענן צריכים גישה למאגרי GitHub שלך כדי לשכפל קוד ולדחוף ענפים. אפשר להעניק גישה בשתי דרכים:

היכולות האלה תלויות בכך ש-Claude GitHub App מותקנת על המאגר:

• Auto-fix: התקנת Claude GitHub App על מאגר גם מפעילה Auto-fix ל-pull requests שבו
• Projects: שרשורים בפרויקט צריכים ש-Claude GitHub App תהיה מותקנת על כל מאגר שהם משכפלים, בכל שיטת חיבור שבחרת. ראה הגדרת גישה ל-GitHub

בסביבות שמתארחות אצל Anthropic, פרטי הגישה שלך ל-GitHub נשארים מוצפנים בשרתים של Anthropic ולעולם לא נכנסים ל-VM של סשן. פעולות GitHub מה-VM עוברות דרך פרוקסי GitHub, שמצרף את פרטי הגישה בצד השרת.

ראה חיבור מהטרמינל להדרכה של /web-setup, כולל מה /web-setup שומר ואיך להסיר אותו.

הערה

ארגונים ש-Zero Data Retention מופעל אצלם, או שתצורת HIPAA חלה עליהם, לא יכולים להשתמש ב-/web-setup או ביכולות אחרות של סשנים בענן. ארגונים שמשתמשים ב-מפתחות הצפנה בניהול הלקוח (CMEK) גם לא יכולים להתחיל סשנים בענן.

#הגדרה מהירה ל-Team ול-Enterprise

הגדרה מהירה היא הגדרת ארגון שמסירה שלבים מהגדרת GitHub ומהגדרת הסביבה של החברים. בתוכניות Team ו-Enterprise היא כבויה כברירת מחדל.

זה מה שמשתנה לחברים כשהיא פועלת:

• /web-setup: חברים יכולים לחבר את GitHub עם /web-setup. כשההגדרה כבויה, הפקודה מוסתרת
• הנחיית GitHub App: ההצטרפות בדפדפן מדלגת על הנחיית ההתקנה של Claude GitHub App
• הסביבה הראשונה: ההצטרפות בדפדפן יוצרת את סביבת Default לחברים במקום להציג את טופס הסביבה

Owner מפעיל אותה עם מתג Quick setup ב-Organization settings > Claude Code.

#העברת משימות בין המסוף לענן

תהליכי העבודה האלה דורשים את Claude Code CLI מחובר לאותו חשבון claude.ai. אפשר להתחיל סשנים חדשים בענן מהמסוף, או למשוך סשנים מהענן אל המסוף כדי להמשיך מקומית. סשנים בענן נשמרים גם אם סוגרים את המחשב הנייד, ואפשר לעקוב אחריהם מכל מקום, כולל אפליקציית Claude לנייד.

[!NOTE]

מה-CLI, העברת הסשן היא חד כיוונית: אפשר למשוך סשנים מהענן אל המסוף עם --teleport, אבל אי אפשר לדחוף סשן מסוף קיים לענן. הדגל --cloud עם תיאור משימה יוצר סשן ענן חדש למאגר הנוכחי. עם -p ומזהה סשן או כתובת claude.ai/code הוא במקום זאת מעמיד הודעה בתור לסשן הקיים הזה. אפליקציית שולחן העבודה יכולה לשלוח סשן מקומי בלשונית Code שלה לענן מתפריט Open in.

#התחלת סשן ענן מהמסוף

התחילו סשן ענן משורת הפקודה עם הדגל --cloud:

claude --cloud "Fix the authentication bug in src/auth/login.ts"

זה יוצר סשן ענן חדש ב-claude.ai. מכונת הווירטואלית בענן משכפלת את ה-remote של GitHub של התיקייה הנוכחית, בענף הנוכחי, ולא את העותק המקומי, אז דחפו קודם אם יש קומיטים מקומיים. ראו שליחת מאגרים מקומיים בלי GitHub למקרים שבהם Claude Code מעלה את המאגר המקומי במקום לשכפל. אם המסוף מדפיס Branch <name> is not on GitHub, ראו הענף לא נמצא ב-GitHub.

--cloud עובד עם מאגר אחד בכל פעם. המשימה רצה בענן בזמן שממשיכים לעבוד מקומית. האיות הישן --remote עדיין עובד ככינוי מיושן ל---cloud.

בזמן שקונטיינר הענן עולה, ה-CLI מציג רשימת בדיקה חיה של שלבי ההקמה, כמו שכפול המאגר והרצת סקריפט ההקמה. הוא מעמיד בתור הודעות שמקלידים במהלך ההקצאה, ושולח אותן ברגע שהסשן מוכן.

[!NOTE]

--cloud יוצר סשנים בענן. --remote-control לא קשור: הוא מאפשר לעקוב אחרי סשן CLI מקומי ולכוון אותו מ-claude.ai או מאפליקציית Claude. ראו Remote Control.

פתחו את הסשן ב-claude.ai או באפליקציית Claude לנייד כדי לבדוק התקדמות או לקיים אינטראקציה ישירה. משם אפשר לכוון את Claude, לתת משוב, או לענות על שאלות כמו בכל שיחה אחרת.

אם Claude שואל שאלה והסשן נשאר במצב המתנה, עדיין אפשר לענות כשחוזרים, עד תפוגת הסביבה, והסשן ממשיך מהתשובה.

#טיפים למשימות בענן

תכננו מקומית, בצעו בענן: למשימות מורכבות, התחילו את Claude במצב תכנון כדי לשתף פעולה על הגישה, ואז שלחו את העבודה לענן:

claude --permission-mode plan

במצב תכנון, Claude קורא קבצים, מריץ פקודות כדי לחקור, ומציע תוכנית בלי לערוך קוד מקור. כשמרוצים, שמרו את התוכנית במאגר, בצעו commit ודחפו, כדי שמכונת הווירטואלית בענן תוכל לשכפל אותה. אחר כך התחילו סשן ענן לביצוע אוטונומי:

claude --cloud "Execute the migration plan in docs/migration-plan.md"

הרצת משימות במקביל: כל פקודת --cloud יוצרת סשן ענן משלה שרץ באופן עצמאי. אפשר להתחיל כמה משימות, וכולן ירוצו בו זמנית בסשנים נפרדים:

claude --cloud "Fix the flaky test in auth.spec.ts"
claude --cloud "Update the API documentation"
claude --cloud "Refactor the logger to use structured output"

כשסשן מסתיים, אפשר ליצור PR מ-claude.ai/code או לבצע teleport של הסשן אל המסוף כדי להמשיך לעבוד.

#שליחת מאגרים מקומיים בלי GitHub

כשמריצים claude --cloud ממאגר שאין לו remote של git, או ממאגר github.com שהאפליקציה Claude GitHub App לא מותקנת עליו, Claude Code אורז את המאגר המקומי ומעלה אותו ישירות לסשן הענן. זה חל גם אם חיברתם את GitHub עם /web-setup.

לשכפול מלא, החבילה כוללת את היסטוריית המאגר בכל הענפים, וגם שינויים שלא בוצע להם commit בקבצים במעקב.

מה קורה לשינויים שלא בוצע להם commit בקבצים רגישים תלוי בפלטפורמה:

• macOS, Linux ו-WSL: Claude Code משאיר מחוץ להעלאה שינויים שלא בוצע להם commit בקבצים ששמם דומה לפרטי התחברות או מפתחות. זה כולל קבצי .env, קבצי Terraform *.tfvars, וקבצי מפתח כמו id_rsa ו-*.pem. הוא גם משאיר בחוץ שינויים שלא בוצע להם commit בקבצים שמסנן git כמו Git LFS מנהל. הודעה Left on this machine: מציינת את הקבצים שהושארו בחוץ, והסשן מתחיל עם הגרסה שעברה commit של כל אחד, או בלי הקובץ אם אף גרסה לא עברה commit.
• Windows מקורי: שינויים שלא בוצע להם commit בקבצים במעקב עולים כמו שהם, יהיה שם הקובץ אשר יהיה. בצעו stash או revert לעריכה שלא רוצים בסשן הענן לפני שמתחילים אותו.

כדי להעלות חבילה גם כש-Claude Code היה אחרת משכפל מה-remote, הגדירו CCR_FORCE_BUNDLE=1:

CCR_FORCE_BUNDLE=1 claude --cloud "Run the test suite and fix any failures"

מאגרים ארוזים חייבים לעמוד במגבלות האלה:

• התיקייה חייבת להיות מאגר git עם לפחות commit אחד
• המאגר הארוז חייב להיות מתחת ל-100 MB. מאגרים גדולים יותר עוברים לאריזה של הענף הנוכחי בלבד, אחר כך לתמונת מצב מכווצת אחת של עץ העבודה, ונכשלים אם תמונת המצב עדיין גדולה מדי
• קבצים שלא במעקב לא כלולים. הריצו git add על קבצים שרוצים שהסשן בענן יראה
• ב-macOS, ב-Linux וב-WSL, Claude Code מסרב להעלאה כשהוא לא יכול לעקוב אחרי הגדרת git שמשפיעה על כללי attribute שחלים על הקבצים, כמו core.attributesFile שמוגדר בקובץ config שנכלל. הודעת הסירוב מציינת את ההגדרה ואת התיקון
• סשנים שנוצרו מחבילה יכולים לדחוף בחזרה ל-remote של GitHub רק כשחיבור GitHub כולל הרשאת push למאגר הזה

ב-macOS, ב-Linux וב-WSL, ההעלאה דורשת גם git 2.31 או חדש יותר ופריסת checkout שהיא תומכת בה, בעוד שב-Windows מקורי Claude Code מעלה בלי אף אחת מהבדיקות. כש-checkout לא עומד בדרישות האלה, Claude Code לא מתחיל את הסשן. הוא מדפיס שגיאה שמכילה Not uploading this working tree:, מציין את הסיבה, ואומר מה לשנות. אלה הסיבות הנפוצות:

• git ישן יותר: ה-git המותקן ישן מ-2.31. עדכנו את git, ואז נסו שוב.
• פריסת checkout שההעלאה לא תומכת בה: התחלתם בתוך submodule, בשכפול שנעשה עם git clone --separate-git-dir, --shared או --reference, ב-checkout שבו core.worktree מוגדר, או במאגר ששומר את ה-refs בפורמט reftable. התחילו מה-checkout הראשי של שכפול שנעשה עם git clone רגיל.
• worktree מקושר עם sparse checkout: git sparse-checkout כותב הגדרות לקובץ config.worktree של ה-worktree עצמו, שההעלאה לא מקבלת, ולכן worktree שיש לו את ההגדרות האלה לא מועלה, וגם לא אחד ש-Claude Code יצר עם worktree.sparsePaths. התחילו מה-checkout הראשי של המאגר.
• תצורת Git שנשמרת בתוך עץ העבודה: תצורת git כוללת קובץ שנמצא בתוך ה-checkout, למשל רשומת include.path שמצביעה לתוך המאגר. העבירו את הקובץ אל מחוץ לעץ העבודה או הסירו את ה-include, ואז נסו שוב.

ב-macOS, ב-Linux וב-WSL, שכפול חלקי שנעשה עם git clone --filter עולה כתמונת מצב של עץ העבודה בלי היסטוריה, כל עוד השכפול מחזיק כל קובץ במעקב באופן מקומי.

עבור claude --cloud, אם המאגר נמצא ב-GitHub, אפשר להימנע מההעלאה ומהדרישות שלה: דחפו את הענף, התקינו את Claude GitHub App על המאגר, והתחילו את הסשן שוב כדי שהוא ישכפל מ-GitHub.

#שליחת המשכים מה-CLI

אחרי שסשן ענן רץ, בכל מקום שהוא מתבצע, שלחו אליו הודעת המשך מה-CLI של claude בכל מכונה שבה מחוברים עם claude auth login. ה-CLI מאמת עם פרטי החשבון של Anthropic ולא שולח מצב סשן מקומי, ולכן הפקודה לא חייבת לרוץ מהמכונה שהתחילה את הסשן.

הפקודה שולחת הודעה אחת ויוצאת:

claude -p "your message" --cloud <session-id>

ה-CLI מעמיד את ההודעה בתור לסשן ויוצא בלי להמתין לתשובה. השתמשו בזה כדי לכוון סשן ארוך, להעמיד בתור את השלב הבא בזמן שהנוכחי עדיין מסתיים, או לשלוח המשכים מסקריפט CI. אפשר גם להזרים את ההודעה ב-stdin במקום להעביר אותה כארגומנט: echo "your message" | claude -p --cloud <session-id>.

עבור <session-id>, העבירו את המזהה עצמו, כמו session_... או cse_..., או את כתובת claude.ai/code/<id> של הסשן, עם או בלי הסכמה או מחרוזת השאילתה. מצאו את המזהה ברשימת הסשנים ב-claude.ai/code.

[!NOTE]

--cloud דורש חשבון Anthropic. הוא לא זמין כש-Claude Code מוגדר ל-Amazon Bedrock, ל-Agent Platform של Google Cloud, או לספק צד שלישי אחר. שער LLM שמוגדר רק דרך ANTHROPIC_BASE_URL לא נחשב לספק צד שלישי בבדיקה הזאת, אבל עדיין צריך להתחבר עם claude auth login. מדיניות allow_remote_sessions של הארגון חייבת גם היא להיות מופעלת. Owner יכול להפעיל אותה בהגדרות הניהול של Claude Code בכתובת claude.ai/admin-settings/claude-code.

#פלט

בהצלחה, הפקודה מדפיסה את מזהה הסשן וקישור לצפייה בסשן:

Sent to cloud session.
Session ID: session_01DiUkqY2kzbUbDmW1w96rfi
View: https://claude.ai/code/session_01DiUkqY2kzbUbDmW1w96rfi?from=cli&m=0

העבירו --output-format json לתוצאה קריאה למכונה: {ok, session_id, url} בהצלחה, או {ok: false, session_id, error} כשהשליחה נכשלת, למשל כשהסשן חסר או בארכיון. שגיאות תצורה, כמו ספק לא נתמך או מדיניות ארגון מושבתת, מודפסות ל-stderr בלי JSON. --output-format stream-json לא נתמך עם --cloud <session-id>.

אם השליחה נכשלת, ראו שגיאות בשליחה לסשן ענן.

#המשך סשן ענן במסוף

משכו סשן ענן אל המסוף באחת מהדרכים האלה:

• שימוש ב---teleport: משורת הפקודה, הריצו claude --teleport לבורר סשנים אינטראקטיבי, או claude --teleport <session-id> כדי לחדש סשן מסוים ישירות. אם יש שינויים שלא בוצע להם commit, תוצג בקשה לבצע להם stash קודם. --resume פותח מחדש שיחה מההיסטוריה המקומית של המכונה הזאת ולא מציג סשנים בענן.
• שימוש ב-/teleport: בתוך סשן CLI קיים, הריצו /teleport או /tp כדי לפתוח את אותו בורר סשנים בלי להפעיל מחדש את Claude Code.
• מ-/tasks: הריצו /tasks כדי לראות את סשני הרקע, ואז לחצו t כדי לבצע teleport לאחד מהם.
• מ-claude.ai/code: בחרו Open in > Terminal מתפריט הסשן כדי להעתיק פקודה שאפשר להדביק במסוף.
• מתוך סשן הענן: הקלידו /teleport ו-Claude Code משיב עם הפקודה המדויקת claude --teleport <session-id> לסשן הזה, מוכנה להרצה מ-checkout של המאגר. נדרש Claude Code v2.1.223 או חדש יותר בסביבת הסשן.

כשמבצעים teleport לסשן, Claude מוודא שנמצאים במאגר הנכון, מושך ועושה checkout לענף מסשן הענן, וטוען את השיחה אל המסוף.

[!NOTE]

אם Claude Code דחס את סשן הענן, מה שהוא עושה אוטומטית בסשן ארוך, ההודעות המוקדמות שהוא סיכם לא מועתקות למסוף. Claude ממשיך מהסיכום. כדי לקרוא את ההודעות המקוריות, גללו למעלה בסשן הענן ב-claude.ai או באפליקציית Claude לנייד.

המסוף מקבל עותק משלו של הסשן: עבודה חדשה שם נשארת מקומית ולא מופיעה בסשן הענן ב-claude.ai או באפליקציית Claude לנייד. כדי להמשיך לכוון מהטלפון אחרי teleport, התחילו /remote-control בסשן המקומי.

#דרישות teleport

Teleport בודק את הדרישות האלה לפני חידוש סשן. אם דרישה כלשהי לא מתקיימת, תראו שגיאה או תתבקשו לפתור את הבעיה.

כש-teleport מושך את ענף הסשן, ה-fetch אף פעם לא ממתין לקלט במסוף. אם git או ssh היו מבקשים סיסמה, ביטוי סיסמה למפתח, או אישור של מארח SSH חדש, ה-fetch נכשל, וה-checkout עובד אחר כך רק אם לשכפול המקומי כבר יש את הענף. בשני מקרי ה-SSH, טענו את המפתח ל-ssh-agent והריצו git fetch פעם אחת ידנית קודם כדי לרשום את המארח.

#--teleport לא זמין

Teleport דורש אימות מנוי של claude.ai. מצאו את המקרה שמתאים לכם:

• מחוברים עם מפתח API או חשבון Console: הריצו claude auth login במעטפת, ואז התחברו עם claude.ai
• השגיאה מציינת את הספק: סשנים בענן לא זמינים דרך ספקי צד שלישי. ראו את טבלת השגיאות
• כבר מחוברים דרך claude.ai: ייתכן שהארגון השבית סשנים בענן

#עבודה עם סשנים

סשנים מופיעים בסרגל הצד בכתובת claude.ai/code. משם אפשר לעיין בשינויים, לשתף עם חברי צוות, להעביר לארכיון עבודה שהסתיימה, או למחוק סשנים לצמיתות.

#מצבי הרשאה בסשנים בענן

בוחרים את מצב ההרשאה של סשן ענן מתוך תפריט המצב, גם כשיוצרים את המשימה וגם בזמן שהסשן רץ.

Claude Code ממשיך סשן במצב ההרשאה שבו הוא היה כשעושים אחד מאלה:

• פותחים מחדש סשן שהסביבה המתארחת ב-Anthropic שלו פגה
• שולחים הודעה לסשן ש-runner באירוח עצמי שחרר בזמן שהיה לא פעיל

#עיון בשינויים

אחרי ש-Claude דוחף את השינויים שלו לענף, כרטיס Changes בלוח שליד הצ'אט מציג את השורות שנוספו והוסרו, למשל +42 -18. לוחצים על ספירת השורות בכרטיס Changes כדי לפתוח את תצוגת ה-diff.

• אפשר גם ללחוץ על Changes בשורת הכותרת של הסשן, או בתפריט ⋮ של השורה.
• כדי להציג את הלוח כשהוא מוסתר, לוחצים על סמל Show session rail בשורת הכותרת של הסשן, או בתפריט ⋮ של השורה.

בתצוגת ה-diff אפשר להגיב על שורות ולהשוות מול ענף אחר:

• Comment: משאירים תגובות בתוך השורה על שורות מסוימות, ואז שולחים את התגובות ל-Claude עם ההודעה הבאה
• Compare: תצוגת ה-diff משווה את שינויי הסשן מול ענף הבסיס שלו כברירת מחדל. כדי להשוות מול כל ענף אחר במאגר, בוחרים Compare against ובוחרים אחד

Claude Code מחשב את ה-diff האלה מתוכן git blob גולמי, ולכן דרייברי diff ומסנני textconv שמוגדרים במאגר לא חלים.

השלבים האלה מכוסים במקום אחר:

• ההדרכה המלאה, כולל יצירת PR: ראו Review and iterate
• בקשה ש-Claude יעקוב אחרי ה-PR לכשלי CI ולהערות סקירה באופן אוטומטי: ראו תיקון אוטומטי של בקשות משיכה

#איתור תקלה כשקובץ חסר בתצוגת ה-diff

קובץ שציפיתם לו יכול להיות חסר מרשימת הקבצים בתצוגת ה-diff כשההשוואה היא מול ענף הבסיס, בין שהסשן דחף שינויים ובין שלא:

• עדיין לא נדחפו שינויים: הרשימה כוללת את העריכות של Claude עצמו, אבל לא שינויים שנעשו על ידי פקודות ש-Claude הריץ, כמו כלי עיצוב
• שינויים נדחפו: הרשימה כוללת קומיטים שנדחפו, אבל לא שינויים שנעשו אחרי הדחיפה האחרונה

כדי להוסיף שינוי חסר לרשימה, בקשו מ-Claude לבצע commit ו-push.

#ניהול הקשר

סשנים בענן תומכים בפקודות מובנות שמפיקות פלט טקסט. פקודות שרצות רק בממשק הטרמינל, כמו /plugin או /resume, אינן זמינות. פקודות שפותחות בורר או לוח בטרמינל מתנהגות אחרת בסשנים בענן:

• /model, /effort, /color ו-/rename: מעבירים את הערך כארגומנט, למשל /model sonnet, במקום לפתוח את הבורר או המחוון של הטרמינל. צורות הארגומנט עוקבות אחרי הערות הזמינות של כל פקודה.
• /fast: מחליף את מצב המהיר של הסשן כשמצב מהיר זמין בחשבון. נדרש Claude Code v2.1.271 או חדש יותר בסביבה של הסשן.
• /config: בדפדפן בכתובת claude.ai/code, פותח את Settings > Code או Settings > Claude Code במקום להגדיר ערך. כדי לשנות הגדרה לסשן ענן, מגדירים משתנה סביבה על הסביבה. בסשן עם מאגר אחד מחוץ לשרשורים של פרויקט, מבצעים commit של המפתח לקובץ .claude/settings.json של אותו מאגר. הגדרות בסשנים בענן מפרטות מה כל סשן קורא.

לניהול הקשר בסשן ענן מחוץ לשרשורי פרויקט:

דחיסה אוטומטית רצה אוטומטית כשחלון ההקשר מתקרב לקיבולת. סשנים בענן מגדירים בעצמם את CLAUDE_AUTOCOMPACT_PCT_OVERRIDE, ולכן הדחיסה מופעלת באמצע חלון הדחיסה האוטומטית ולא כשהחלון מתמלא. הערך הזה דורס ערך שמוסיפים במשתני הסביבה, ולכן הוספת המשתנה שם לא משנה מתי הדחיסה מופעלת.

כדי לשנות את חלון הדחיסה האוטומטית, מגדירים את CLAUDE_CODE_AUTO_COMPACT_WINDOW במשתני הסביבה, או מריצים /autocompact עם מספר טוקנים בסשן שבו המשתנה לא מוגדר.

סוכני משנה עובדים באותו אופן כמו באופן מקומי. Claude יכול להפעיל אותם עם כלי Agent כדי להעביר מחקר או עבודה מקבילית לחלון הקשר נפרד, ולהשאיר את השיחה הראשית קלה יותר. מחוץ לשרשורים של פרויקט, סוכני משנה שמוגדרים ב-.claude/agents/ של המאגר נטענים אוטומטית.

צוותי סוכנים כבויים כברירת מחדל, אבל אפשר להפעיל אותם על ידי הוספת CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 למשתני הסביבה.

#הצעות תוספים בשיחה

כרטיס בשיחה שמפרט תוסף אחד או יותר מבין התוספים, עם כפתור Add, אומר ש-Claude מציע תוספים למשימה. Claude יכול להציע את ההצעות האלה בלי שביקשתם. אין חובה להגיב, ו-Claude ממשיך במשימה בכל מקרה.

#הוספה או הסרה של תוסף מוצע

בוחרים Add על תוסף כדי להפעיל אותו לחשבון claude.ai, והוא נשאר פעיל אחרי שהסשן מסתיים. כדי לבטל, פותחים את התוסף שנוסף מהכרטיס, בוחרים Manage כדי להגיע לעמוד התוסף ב-claude.ai, ומסירים את התוסף מאותו עמוד.

#כיבוי הצעות תוספים

כדי לעצור את Claude מהצעת תוספים, דוחים את הכלים SearchPlugins ו-SuggestPluginInstall עם כללי הרשאה. בסשן עם מאגר אחד מחוץ לפרויקט, מבצעים commit של הכללים לקובץ .claude/settings.json של אותו מאגר, ומפרטים את שני שמות הכלים תחת permissions.deny:

{
  "permissions": {
    "deny": ["SearchPlugins", "SuggestPluginInstall"]
  }
}

Claude Code מתעלם מכללי הרשאה בקובץ .claude/settings.json של המאגר, כולל כללי הדחייה האלה, כשההגדרות המנוהלות שחלות על הסשן מגדירות allowManagedPermissionRulesOnly. במקרה הזה, שמים את הכללים בהגדרות המנוהלות האלה. להגדרות אחרות, כמו סשן עם כמה מאגרים או שרשור ענן בפרויקט, ראו אילו הגדרות מגיעות לסשן ענן.

#החזרת הודעה שנמצאת בתור

אם שולחים הודעה בזמן ש-Claude עובד, ההודעה נכנסת לתור עד ש-Claude קורא אותה. כדי להחזיר הודעה מהתור, לוחצים על ה-✕ שעליה. הטקסט חוזר לתיבת ההודעה כדי שאפשר יהיה לערוך אותו או לשלוח משהו אחר.

אם Claude כבר קרא את ההודעה, היא נשארת בשיחה.

#שיתוף סשנים

כדי לשתף סשן, מחליפים את הנראות שלו לפי סוגי החשבון שלמטה. אחרי זה, משתפים את קישור הסשן כמו שהוא. הנמענים רואים את המצב העדכני כשהם פותחים את הקישור, אבל התצוגה שלהם לא מתעדכנת בזמן אמת.

#שיתוף מחשבון Enterprise או Team

השיתוף עובד כך בחשבונות Enterprise ו-Team:

• אפשרויות נראות: Private ו-Team. נראות Team הופכת את הסשן לגלוי לחברים אחרים בארגון claude.ai
• גישה למאגר: האימות מופעל כברירת מחדל, לפי חשבון GitHub המחובר לחשבון של הנמען
• השם שלכם: שם התצוגה של החשבון גלוי לכל הנמענים עם גישה
• סשני Slack: סשנים של Claude in Slack משותפים אוטומטית עם נראות Team

#שיתוף מחשבון Max, Ultra או Pro

• אפשרויות נראות: Private ו-Public. נראות Public הופכת את הסשן לגלוי לכל משתמש שמחובר ל-claude.ai
• גישה למאגר: האימות לא מופעל כברירת מחדל
• תוכן רגיש: בדקו את הסשן לפני השיתוף. סשנים עשויים להכיל קוד ואישורים ממאגרי GitHub פרטיים

כדי לדרוש שלנמענים תהיה גישה למאגר, או כדי להסתיר את השם מסשנים משותפים, פותחים את Settings ב-claude.ai, ואז:

• אם תפריט Settings מציג Code במקום Claude Code: עוברים לPrivacy, שבו נמצאות ההגדרות האלה
• אחרת: עוברים לClaude Code > Sharing settings

#העברה לארכיון של סשנים

מעבירים סשן לארכיון כדי להסיר אותו מרשימת הסשנים בסרגל הצד. כדי להעביר אחד לארכיון, מרחפים מעליו בסרגל הצד, פותחים את תפריט ⋯ שלו, ובוחרים Archive.

#מציאת סשן בארכיון

כדי לראות את הסשנים בארכיון, עוברים לclaude.ai/code/sessions ופותחים את הלשונית Archived. כדי להחזיר אחד לרשימת הסשנים בסרגל הצד, מרחפים מעליו באותה לשונית, פותחים את תפריט ⋮ שלו, ובוחרים Unarchive.

#מחיקת סשנים

מחיקת סשן מסירה לצמיתות את הסשן ואת הנתונים שלו. אי אפשר לבטל את הפעולה הזו. מוחקים סשן מסרגל הצד, מתפריט הסשן, או מלשונית Archived אם כבר הועבר לארכיון:

• מסרגל הצד: מרחפים מעל הסשן, פותחים את תפריט ⋯ שלו, ובוחרים Delete
• מתפריט הסשן: פותחים סשן, בוחרים את התפריט שליד כותרת הסשן, ובוחרים Delete
• מלשונית Archived: מרחפים מעל הסשן בלשונית Archived, פותחים את תפריט ⋮ שלו, ובוחרים Delete

תתבקשו לאשר לפני שסשן נמחק.

#תיקון אוטומטי של בקשות משיכה

Claude יכול לעקוב אחרי בקשת משיכה ולהגיב אוטומטית לכשלי CI ולהערות סקירה. Claude נרשם לפעילות GitHub על ה-PR, וכשבדיקה נכשלת או שסוקר משאיר תגובה, Claude בודק ודוחף תיקון אם התיקון ברור.

[!NOTE]

תיקון אוטומטי דורש ש-Claude GitHub App יהיה מותקן על המאגר. אם עדיין לא התקנתם, התקינו אותו מעמוד ה-GitHub App.

יש כמה דרכים להפעיל תיקון אוטומטי לפי המקום שממנו הגיעה בקשת המשיכה ולפי המכשיר שבשימוש:

• בקשות משיכה שנוצרו בסשן ענן: פותחים את הסשן ב-claude.ai/code ומוצאים את בקשת המשיכה בכרטיס Changes. פותחים את תפריט ⋮ שליד כותרת בקשת המשיכה ומפעילים Auto-fix
• מהטרמינל: מריצים /autofix-pr בזמן שנמצאים על ענף ה-PR. Claude Code מזהה את בקשת המשיכה הפתוחה עם gh, מפעיל סשן ענן, ומפעיל תיקון אוטומטי בשלב אחד
• מאפליקציית המובייל: אומרים ל-Claude לתקן אוטומטית את בקשת המשיכה, למשל "watch this PR and fix any CI failures or review comments"
• כל בקשת משיכה קיימת: מדביקים את כתובת ה-PR בסשן ואומרים ל-Claude לתקן אותה אוטומטית

כדי להפסיק מעקב, מכבים את Auto-fix בתפריט ⋮ של בקשת המשיכה בכרטיס Changes של הסשן, או אומרים ל-Claude להפסיק לעקוב אחרי ה-PR.

#איך Claude מגיב לפעילות ב-PR

כשתיקון אוטומטי פעיל, Claude מקבל אירועי GitHub עבור ה-PR, כולל תגובות סקירה חדשות וכשלי בדיקות CI. לכל אירוע, Claude בודק ומחליט איך להמשיך:

• תיקונים ברורים: אם Claude בטוח בתיקון והתיקון לא מתנגש עם הוראות קודמות, Claude מבצע את השינוי, דוחף אותו, ומסביר מה נעשה בסשן
• בקשות עמומות: אם תגובה של סוקר יכולה להתפרש בכמה דרכים או נוגעת למשהו משמעותי מבחינה ארכיטקטונית, Claude שואל אתכם לפני פעולה
• אירועים כפולים או בלי פעולה: אם אירוע הוא כפול או לא דורש שינוי, Claude מציין אותו בסשן וממשיך הלאה

GitHub לא שולח webhook כשענף הבסיס מתקדם ונוצר קונפליקט מיזוג, ולכן תיקון אוטומטי לא יכול להגיב לקונפליקטים בעצמו. כדי לפתור קונפליקט, פותחים את הסשן ומבקשים מ-Claude לבצע rebase.

Claude עשוי להשיב לשרשורי תגובות סקירה ב-GitHub כחלק מהפתרון שלהם. התשובות האלה מתפרסמות באמצעות חשבון GitHub שלכם, ולכן הן מופיעות תחת שם המשתמש שלכם, אבל כל תשובה מסומנת כבאה מ-Claude Code כדי שהסוקרים ידעו שהיא נכתבה על ידי הסוכן ולא ישירות על ידכם.

[!WARNING]

אם המאגר משתמש באוטומציה שמופעלת מתגובות, כמו Atlantis, Terraform Cloud, או GitHub Actions מותאמים שרצים על אירועי issue_comment, שימו לב ש-Claude יכול להשיב בשמכם, וזה יכול להפעיל את תהליכי העבודה האלה. בדקו את האוטומציה של המאגר לפני הפעלת תיקון אוטומטי, ושקלו לכבות תיקון אוטומטי במאגרים שבהם תגובה ב-PR יכולה לפרוס תשתית או להריץ פעולות עם הרשאות.

#אבטחה ובידוד

כל סשן ענן מופרד מהמחשב שלכם ומסשנים אחרים דרך כמה שכבות:

• מכונות וירטואליות מבודדות: כל סשן רץ במכונה וירטואלית מבודדת שמנוהלת על ידי Anthropic. סשנים שהארגון מנתב לסביבה באירוח עצמי רצים על התשתית שלכם, ושם הבידוד הוא באחריות הפריסה שלכם
• בקרות גישה לרשת: בסביבות המתארחות ב-Anthropic, גישת הרשת מוגבלת כברירת מחדל ואפשר לכבות אותה. ראו גישה לרשת לרמות הגישה, לדומיינים המותרים כברירת מחדל, ולתעבורה שלא עוברת דרך רשימת ההיתר. בסביבה באירוח עצמי, מגבילים את תעבורת היציאה של הסשן בגבול הרשת שלכם. כשרצים עם גישת רשת כבויה, Claude Code עדיין יכול לתקשר עם Anthropic API, וזה עשוי לאפשר לנתונים לצאת מהמכונה הווירטואלית.
• הגנה על אישורים: בסביבות המתארחות ב-Anthropic, אישורי git ומפתחות חתימה נשארים מחוץ לארגז החול, ופרוקסי מאמת בשם הסשן עם אישורים בהיקף מוגבל. בסביבה באירוח עצמי, הפריסה שלכם מספקת אישורי git. ראו Configure git
• סודות רשת: בסביבות המתארחות ב-Anthropic, מפתחות שמוסיפים לסביבת ענן נשארים מחוץ לארגז החול באותו אופן, ומצורפים לבקשות תואמות אחרי שהן יוצאות מהסשן. לסביבה באירוח עצמי אין סודות רשת
• ניתוח מאובטח: הקוד מנותח ומשתנה בתוך הסביבה המבודדת של הסשן לפני יצירת בקשות משיכה

#פתרון בעיות

שגיאות API בזמן ריצה שמופיעות בשיחה, כמו API Error: 500, 529 Overloaded, 429, או Prompt is too long, מתועדות בהפניית שגיאות. השגיאות האלה והתיקונים שלהן משותפים ל-CLI ולאפליקציית Desktop. הסעיפים למטה מכסים בעיות ייחודיות לסשנים בענן.

#יצירת הסשן נכשלה

אם סשן חדש לא מצליח להתחיל עם Session creation failed או נתקע בהקצאה, Claude Code לא הצליח להקצות VM לסשן.

• בדקו את status.claude.com לתקריות של סשנים בענן
• נסו שוב אחרי דקה, כי הקיבולת מוקצית לפי דרישה
• ודאו שחיבור GitHub שלכם יכול להגיע למאגר, לפי לא מופיעים מאגרים אחרי חיבור GitHub

#הסשן החדש לא הצליח להתחיל

הפרומפט חזר לתיבה שממנה שלחתם אותו.

• החיבור אבד: בדקו את חיבור האינטרנט וכל VPN או proxy שאתם משתמשים בהם, ואז שלחו את הפרומפט שוב
• שגיאת שרת: המתינו רגע, ואז שלחו את הפרומפט שוב. אם ההודעה מופיעה שוב, בדקו את status.claude.com

#אי אפשר לחזור להודעה הזאת

Rewind to here נכשל עם השגיאה הזאת בכל הודעה חוץ מהחדשה ביותר, כשהסשן רץ על runner מתארח עצמית עם Claude Code לפני v2.1.246. בקשו ממי שמפעיל את ה-runners של הארגון לשדרג אותם.

#Unable to get organization UUID

claude --cloud ו-claude --teleport דורשים התחברות עם חשבון claude.ai. אם אתם מאמתים עם מפתח API או התחברות Console במקום, או שפרטי החשבון השמורים ישנים, תראו הודעה כמו:

• Unable to get organization UUID
• Cloud sessions need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.
• Cloud sessions aren't available with this Console sign-in. They need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.
• Error loading Claude Code sessions בבורר הסשנים, כשמריצים claude --teleport בלי מזהה סשן

הריצו claude auth login ב-shell כדי להתחבר עם חשבון claude.ai, ואז נסו שוב את הפקודה. בתוך סשן שרץ, /login עושה את אותו דבר. אם השגיאה מציינת את הספק שלכם, ראו את טבלת השגיאות: סשנים בענן לא זמינים דרך ספקים צד שלישי.

מ-v2.1.274 עד v2.1.289, נוסח הודעת ההתחברות היה Claude Code cloud sessions require authentication with a Claude.ai account. API key authentication is not sufficient. Please run /login to authenticate, or check your authentication status with /status.

#הענף לא נמצא ב-GitHub

כש-claude --cloud מדפיס שורה שמתחילה ב-Branch <name> is not on GitHub, הסשן בענן עדיין מתחיל, אבל לא מהענף שלכם. השורה מציינת מאיפה הסשן מתחיל: commit שנדחף מההיסטוריה של הענף, או ענף ברירת המחדל של המאגר. commits שקיימים רק במחשב שלכם ושינויים שלא בוצע להם commit לא נמצאים בסשן.

אתם רואים את השורה הזאת, למשל, כשמעולם לא דחפתם את הענף, או כש-GitHub מחק אותו אחרי שה-pull request שלו מוזג. אם נקודת ההתחלה שהשורה מציינת כוללת את מה שהמשימה צריכה, השתמשו בסשן כמו שהוא. אחרת, דחפו את הענף והתחילו סשן חדש כדי שהוא ישכפל את הענף שלכם.

#סשן Remote Control פג או שהגישה נדחתה

--teleport מתחבר דרך אותה תשתית סשן Remote Control שסשנים בענן משתמשים בה, ולכן שגיאות אימות ותפוגת סשן מופיעות בניסוח של Remote Control. ייתכן שתראו Remote Control session expired או Access denied. אסימון החיבור קצר חיים ומוגבל לחשבון שלכם.

• הריצו /login מקומית כדי לרענן את פרטי ההתחברות, ואז התחברו מחדש
• ודאו שאתם מחוברים לאותו חשבון שבבעלותו הסשן
• אם אתם רואים Remote Control may not be available for this organization, Owner לא הפעיל סשנים בענן לארגון שלכם

#שגיאות בשליחה לסשן בענן

השגיאות האלה מגיעות מהרצת claude עם --cloud <session-id>, עם או בלי -p. ה-CLI מוסיף לשגיאות את הקידומת Error: . מסירה שנכשלה עטופה כ-failed to send message to cloud session <id>: <reason>.

#הסביבה פגה

סשנים בענן נעצרים אחרי תקופת חוסר פעילות, וה-VM של הסשן מוחזר. סשן נחשב לא פעיל בזמן שהוא ממתין שתאשרו קריאת כלי של מחבר MCP או שתתחברו לשרת MCP, והוא יכול לפוג במהלך ההמתנה הזאת.

פתחו מחדש את הסשן מ-claude.ai/code כדי להקצות VM חדש:

• משוחזר: היסטוריית השיחה
• לא משוחזר: עבודה ברקע שעדיין רצה או הייתה ממתינה כשה-VM הוחזר, כולל:
  • פקודות shell: Claude Code אומר ל-Claude אילו פקודות נעצרו. בקשו מ-Claude להריץ מחדש את אלה שעדיין צריך.
  • סוכני משנה: Claude Code אומר ל-Claude אילו סוכני משנה נעצרו, ואילו מהם אפשר להמשיך במקום להתחיל מחדש. בקשו מ-Claude להמשיך את העבודה שלהם.
  • משימות מתוזמנות ברמת הסשן: משימות שתזמנתם בסשן ו-/loop שממתין לאיטרציה הבאה לא עוברים לסשן שנפתח מחדש. בקשו מ-Claude לתזמן את המשימות שוב, או הריצו /loop שוב כדי להפעיל מחדש את הלולאה.

#מגבלות

לפני שמסתמכים על סשנים בענן לתהליך עבודה, קחו בחשבון את האילוצים האלה:

• הגבלות קצב: סשנים בענן חולקים מגבלות קצב עם כל שאר השימוש ב-Claude וב-Claude Code בתוך החשבון. הרצת כמה משימות במקביל צורכת יותר ממגבלות הקצב באופן יחסי.
• מגבלות זמן: לפקודות ש-Claude מריץ ול-hooks של SessionStart יש timeouts ברירת מחדל שאפשר לשנות, וסקריפט setup נשמר במטמון רק כשהוא מסתיים בערך בחמש דקות. ראו מגבלות זמן
• אימות מאגר: אפשר למשוך סשן בענן לטרמינל רק כשאתם מאומתים לאותו חשבון
• הגבלות פלטפורמה: שכפול מאגר בסביבות שמתארחות ב-Anthropic ויצירת pull request דורשים GitHub. מופעים של GitHub Enterprise Server שמתארחים עצמית נתמכים בתוכניות Team ו-Enterprise. אפשר לשלוח מאגר GitLab, Bitbucket, או מאגר אחר שאינו GitHub לסשן בענן כחבילה מקומית על ידי הגדרת CCR_FORCE_BUNDLE=1, אבל הסשן לא יכול לדחוף תוצאות חזרה ל-remote הזה
  • סביבות מתארחות עצמית: למאגר על מארח git אחר, ראו את הדרישות להתחלת סשן עם --environment.
• רשימת IP מותרים של הארגון: סשנים בענן קוראים ל-API של Anthropic מתשתית שמנוהלת על ידי Anthropic, לא מהרשת שלכם, בעוד שסשנים בסביבה מתארחת עצמית קוראים אליו מהרשת שלכם. אם לארגון מופעל IP allowlisting, כל סשן בענן שמתארח ב-Anthropic נכשל עם שגיאת אימות.
  • Code Review ומשימות מתוזמנות: אותו דבר חל על Code Review ועל משימות מתוזמנות בענן שרצות בסביבות שמתארחות ב-Anthropic. משימה מתוזמנת שמנותבת לסביבה מתארחת עצמית קוראת ל-API מהרשת שלכם.
  • קבלת פטור: פנו לתמיכת Anthropic כדי לפטור שירותים שמתארחים ב-Anthropic מרשימת ה-IP המותרים של הארגון.

#משאבים קשורים

• סביבות ענן: הגדירו גישת רשת, משתני סביבה, וסקריפטי setup לסשנים בענן
• פרויקטים: שיחה אחת שבה Claude מתאם סשנים מקבילים בענן על המאגרים ומדווח בחזרה
• Ultrareview: הריצו סקירת קוד עמוקה מרובת סוכנים בארגז חול בענן
• משימות מתוזמנות בענן: אוטומציה של עבודה לפי לוח זמנים, דרך קריאת API, או בתגובה לאירועי GitHub
• הגדרת hooks: הריצו סקריפטים באירועי מחזור חיים של הסשן
• כל ההגדרות: כל אפשרויות ההגדרה
• אבטחה: הבטחות בידוד וטיפול בנתונים
• שימוש בנתונים: מה Anthropic שומרת מסשנים בענן
• Claude Tag: @Claude שמנוהל על ידי הארגון ב-Slack ורץ על אותה תשתית ענן