מדריך קלוד קוד בעברית

תיעוד 24

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

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

הערה: הפעלות ענן נמצאות בתצוגה מקדימה למחקר (research preview) עבור משתמשי Pro, Max ו-Team, ועבור משתמשי Enterprise עם מושבי פרימיום (premium seats) או מושבי Chat + Claude Code.

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

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

כדי ש-Claude יתחיל ויעקוב אחר הפעלות ענן רבות עבור גוף עבודה אחד, השתמשו ב-פרויקט. הפעלה בטרמינל שלכם, ב-IDE שלכם, או באפליקציית שולחן העבודה כאשר נבחר Local, רצה במקום זאת על המחשב שלכם. כדי לכוון אחת מההפעלות המקומיות הללו מהטלפון או מהדפדפן שלכם, השתמשו ב-Remote Control.

טיפ: חדשים בהפעלות ענן? התחילו עם תחילת העבודה כדי לחבר את חשבון ה-GitHub שלכם ולהגיש את המשימה הראשונה שלכם.

דף זה מכסה:

#סביבות ענן

כל הפעלת ענן רצה בתוך סביבת ענן, התצורה השמורה השולטת בגישת רשת, במשתני סביבה ובסקריפטים של הגדרה (setup scripts). אם עדיין אין לכם סביבה, תהליך ההצטרפות (onboarding) מגדיר סביבת Default עם גישת רשת מסוג Trusted, או על ידי יצירתה עבורכם או על ידי בקשה מכם ליצור אותה. ראו סביבת ברירת המחדל כדי לבדוק מה מביניהם קורה בתוכנית שלכם וכיצד הפעלות בוחרות סביבה כאשר יש לכם יותר מאחת.

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

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

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

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

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

התקנת אפליקציית Claude GitHub App במאגר מאפשרת גם תיקון אוטומטי (Auto-fix) עבור pull requests בתוכו.

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

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

הגדרה מהירה ברשת (Quick web setup) היא הגדרת ארגון שמאפשרת לחברים לחבר את GitHub באמצעות /web-setup, מדלגת על הבקשה להתקנת Claude GitHub App במהלך תהליך ההצטרפות בדפדפן, וגורמת לתהליך ההצטרפות בדפדפן ליצור את סביבת ה-Default עבורם במקום להציג את טופס הסביבה. בתוכניות Team ו-Enterprise היא כבויה כברירת מחדל, מה שמסתיר את /web-setup. בעלים (Owner) מפעיל אותה באמצעות המתג Quick web setup בכתובת Admin settings > Claude Code.

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

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

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

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

#מהטרמינל לענן

התחילו הפעלת ענן משורת הפקודה באמצעות הדגל --cloud:

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

פעולה זו יוצרת הפעלת ענן חדשה ב-claude.ai. המכונה הווירטואלית (VM) בענן משכפלת את ה-remote של GitHub של התיקייה הנוכחית שלכם בענף הנוכחי שלכם, ולא את העותק המקומי שלכם (checkout), לכן בצעו push תחילה אם יש לכם commits מקומיים. ראו שליחת מאגרים מקומיים ללא GitHub למקרים שבהם Claude Code מעלה את המאגר המקומי שלכם במקום לשכפל.

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

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

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

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

אם Claude שואל שאלה וההפעלה ממתינה ללא פעילות (idle), אתם עדיין יכולים לענות כשתחזרו, עד ל-פקיעת תוקף הסביבה, וההפעלה תמשיך מתוך התשובה שלכם.

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

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

claude --permission-mode plan

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

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 מתוך מאגר שאין לו git remote, או מתוך מאגר github.com שבו אפליקציית Claude GitHub App אינה מותקנת, Claude Code אורז בחבילה (bundles) את המאגר המקומי שלכם ומעלה אותו ישירות להפעלת הענן. הדבר חל גם אם חיברתם את GitHub באמצעות /web-setup. החבילה כוללת את היסטוריית המאגר המלאה שלכם על פני כל הענפים, בתוספת שינויים שטרם נשמרו ב-commit בקבצים הנמצאים במעקב (tracked files).

ב-macOS, ב-Linux וב-WSL, Claude Code משאיר מחוץ להעלאה שינויים שטרם נשמרו ב-commit בקבצים ששמותיהם נראים כמו פרטי אימות או מפתחות, ומציין את שמות הקבצים שהושארו בחוץ. הדבר מכסה קובצי .env, קובצי Terraform מסוג *.tfvars, וקובצי מפתחות כגון id_rsa ו-*.pem. ההפעלה מתחילה עם הגרסה שנשמרה ב-commit של כל אחד מהם, או ללא הקובץ אם אף גרסה שלו לא נשמרה ב-commit. במבנה של worktree מקושר, submodule או מבנה דומה, Claude Code מעלה שינויים אלה יחד עם השאר ומציין את שמות הקבצים שהוא מעלה.

כדי להעלות חבילה גם כאשר 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. מאגרים גדולים יותר נסוגים לאריזה של הענף הנוכחי בלבד, לאחר מכן לתמונת מצב (snapshot) יחידה ומאוחדת (squashed) של עץ העבודה, ונכשלים אם תמונת המצב עדיין גדולה מדי
  • קבצים שאינם במעקב (untracked files) אינם נכללים, הריצו git add על קבצים שברצונכם שהפעלת הענן תראה
  • הפעלות שנוצרו מחבילה יכולות לדחוף בחזרה ל-remote של GitHub רק כאשר ל-חיבור ה-GitHub שלכם יש הרשאת push לאותו מאגר

#שליחת הודעות המשך מה-CLI

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

הפקודה מפרסמת הודעה אחת ויוצאת:

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

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

עבור <session-id>, העבירו את המזהה בלבד, כגון session_... או cse_..., או את כתובת ה-URL של ההפעלה מסוג claude.ai/code/<id>, עם או בלי הפרוטוקול (scheme) או מחרוזת השאילתה (query string). מצאו את המזהה ברשימת ההפעלות שלכם ב-claude.ai/code.

הערה: הדגל --cloud דורש חשבון Anthropic. הוא אינו זמין כאשר Claude Code מוגדר עבור Amazon Bedrock, עבור Agent Platform של Google Cloud, או עבור ספק צד שלישי אחר. שער LLM (LLM gateway) המוגדר אך ורק דרך 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>.

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

הודעהמה המשמעות
Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.Claude Code מוגדר עבור ספק צד שלישי. ההודעה מציינת את הספק בתווית שבה התצורה שלכם משתמשת, כגון Amazon Bedrock או Google Vertex AI. הסירו את התצורה של אותו ספק, לדוגמה על ידי ביטול ההגדרה של CLAUDE_CODE_USE_BEDROCK, והתחברו באמצעות חשבון Anthropic‏ (claude auth login).
Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.מדיניות הארגון allow_remote_sessions כבויה.
Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.Claude Code לא הצליח לאחזר את מדיניות הארגון שלכם, ולכן הוא מסרב לשלוח במקום להניח שהפעלות ענן מורשות. בדקו את חיבור הרשת שלכם ונסו שוב.
Attaching to an existing cloud session is not enabled for your account.הרצתם את --cloud <session-id> ללא -p. שלחו את ההודעה באמצעות claude -p "your message" --cloud <session-id>.
Session not found: <id>המזהה או כתובת ה-URL אינם תואמים להפעלה שיש לכם גישה אליה. בדקו אותם מול כתובת ה-URL של ההפעלה ב-claude.ai/code.
cloud session <id> is archived and cannot accept new messagesההפעלה הועברה לארכיון. התחילו הפעלה חדשה במקום זאת.

#מהענן לטרמינל

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

  • באמצעות --teleport: משורת הפקודה, הריצו claude --teleport לקבלת בורר הפעלות אינטראקטיבי, או claude --teleport <session-id> כדי לחדש הפעלה ספציפית ישירות. אם יש לכם שינויים שטרם נשמרו ב-commit, תתבקשו לבצע להם stash תחילה.
  • באמצעות /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 מוודא שאתם נמצאים במאגר הנכון, מושך (fetches) ומבצע checkout לענף מתוך הפעלת הענן, וטוען את היסטוריית השיחה המלאה לטרמינל שלכם. הטרמינל מקבל עותק משלו של ההפעלה: עבודה חדשה שם נשארת מקומית ואינה מופיעה בהפעלת הענן ב-claude.ai או באפליקציית Claude במובייל. כדי להמשיך לכוון מהטלפון שלכם לאחר teleport, התחילו את /remote-control בהפעלה המקומית.

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

#דרישות עבור Teleport

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

דרישהפרטים
מצב git נקיספריית העבודה שלכם חייבת להיות ללא שינויים שטרם נשמרו ב-commit. הפקודה Teleport מבקשת מכם לבצע stash לשינויים במידת הצורך.
מאגר נכוןעליכם להריץ את --teleport מתוך עותק מקומי (checkout) של אותו מאגר, ולא מתוך fork. אם תריצו אותה מתוך עותק של מאגר שונה, Claude Code יציג שגיאה המציינת הן את מאגר ההפעלה והן את מאגר העותק שלכם. לפני גרסה v2.1.219, השגיאה לא ציינה את מאגר העותק שלכם. אם Claude Code אינו יכול לנתח את ה-remote שלכם לשם מארח (hostname), למשל כינוי מארח SSH כמו git@work:owner/repo.git, הוא מבקש מכם לאשר, ומקבל את העותק המקומי כאשר הבעלים ושם המאגר של ה-remote תואמים למאגר של ההפעלה.
ענף זמיןהענף מהפעלת הענן חייב להידחף (pushed) ל-remote. הפקודה Teleport מושכת (fetches) ומבצעת לו checkout באופן אוטומטי.
אותו חשבוןעליכם להיות מאומתים לאותו חשבון claude.ai ששימש בהפעלת הענן.

#הפקודה --teleport אינה זמינה

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

#עבודה עם הפעלות

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

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

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

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

#ניהול הקשר

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

  • /model, /effort, /color ו-/rename: מעבירים את הערך כארגומנט, לדוגמה /model sonnet, במקום לפתוח את הבורר או המחוון של הטרמינל. צורות הארגומנט דורשות Claude Code בגרסה v2.1.205 ומעלה בסביבת ההפעלה ופועלות לפי הערות הזמינות של כל פקודה: הפקודה /effort מדווחת על Not applied כל עוד השהיית מאמץ כברירת מחדל בהשקה (launch-default effort hold) של מודל מסוים נמצאת בתוקף.
  • /fast: מחליף מצב עבור מצב מהיר (fast mode) בהפעלה כאשר מצב מהיר זמין בחשבונכם. דורש Claude Code בגרסה v2.1.271 ומעלה בסביבת ההפעלה.
  • /config: בדפדפן ב-claude.ai/code, פותח את מקטע Claude Code של ההגדרות שלכם במקום להגדיר ערך, ומתעלם מטקסט שלאחר הפקודה, כולל key=value. כדי לשנות הגדרה עבור הפעלת ענן, הגדירו משתנה סביבה בסביבה, או בהפעלה עם מאגר יחיד, בצעו commit למפתח בקובץ .claude/settings.json של אותו מאגר. הדף הגדרות בהפעלות ענן מפרט מה כל הפעלה קוראת.

עבור ניהול הקשר באופן ספציפי:

פקודהפועלת בהפעלות ענןהערות
/compactכןמתמצתת את השיחה כדי לפנות הקשר. מקבלת הנחיות מיקוד אופציונליות כמו /compact keep the test output
/contextכןמציגה את מה שנמצא כעת בחלון ההקשר
/clearלאהתחילו הפעלה חדשה מסרגל הצד במקום זאת

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

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

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

צוותי סוכנים (Agent teams) כבויים כברירת מחדל אך ניתן להפעיל אותם על ידי הוספת CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 ל-משתני הסביבה שלכם.

#מצבי הרשאה בהפעלות ענן

אתם בוחרים את מצב ההרשאה (permission mode) של הפעלת ענן מתוך התפריט הנפתח של המצבים, הן בעת יצירת המשימה והן בזמן שההפעלה רצה. כאשר אתם פותחים מחדש הפעלה שה-סביבה שלה באירוח Anthropic פגה, או שולחים הודעה להפעלה ש-runner באירוח עצמי שחרר בזמן שהייתה במצב המתנה, Claude Code מחדש את ההפעלה במצב ההרשאה שבו היא הייתה.

#סקירת שינויים

כל הפעלה מציגה מחוון diff עם שורות שנוספו והוסרו, כמו +42 -18. בחרו בו כדי לפתוח את תצוגת ה-diff, להשאיר הערות מוטמעות (inline comments) על שורות ספציפיות, ולשלוח אותן ל-Claude עם ההודעה הבאה שלכם.

תצוגת ה-diff משווה את שינויי ההפעלה מול ענף הבסיס שלה כברירת מחדל. כדי להשוות מול כל ענף אחר במאגר, בחרו ב-Compare against ובחרו ענף.

Claude Code מחשב את ה-diffs הללו, כולל ה-diffs לפי קובץ המוצגים בעת ש-Claude עורך, מתוך תוכן git blob גולמי, כך שדרייברים של diff ומסנני textconv המוגדרים במאגר אינם חלים. עבור קובץ במאגר שאינו אחד מעותקי ההפעלה עצמה (checkouts), כגון מאגר ששוכפל בתוך סביבת העבודה במהלך ההפעלה, ה-diff לפי קובץ מציג את העריכה של Claude עצמה ולא השוואת git.

ראו סקירה ואיטרציה למדריך המלא כולל יצירת PR. כדי ש-Claude ינטר את ה-PR עבור כשלים ב-CI והערות סקירה באופן אוטומטי, ראו תיקון אוטומטי של pull requests.

#שיתוף הפעלות

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

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

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

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

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

עבור חשבונות Max ו-Pro, שתי אפשרויות הניראות הן Private ו-Public. ניראות Public הופכת את ההפעלה לגלויה לכל משתמש המחובר ל-claude.ai.

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

כדי לדרוש מהנמענים גישה למאגר, או כדי להסתיר את שמכם מהפעלות משותפות, עברו אל Settings > Claude Code > Sharing settings.

#העברת הפעלות לארכיון

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

כדי להעביר הפעלה לארכיון, רחפו מעל ההפעלה בסרגל הצד ובחרו בסמל הארכיון.

#מחיקת הפעלות

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

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

תתבקשו לאשר לפני שהפעלה נמחקת.

#תיקון אוטומטי של pull requests

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

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

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

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

תיקון אוטומטי הוא מתג עבור כל PR בנפרד. כדי להפסיק את הניטור, פתחו את שורת מצב ה-CI בהפעלה ב-claude.ai/code ובטלו את הסימון במתג Auto-fix, או אמרו ל-Claude להפסיק לעקוב אחר ה-PR.

#כיצד Claude מגיב לפעילות ב-PR

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

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

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

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

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

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

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

  • מכונות וירטואליות מבודדות: כל הפעלה רצה בתוך VM מבודד ומנוהל על ידי Anthropic. הפעלות שהארגון שלכם מנתב אל סביבה באירוח עצמי רצות במקום זאת על גבי התשתית שלכם, שבה הבידוד הוא באחריות הפריסה שלכם
  • בקרות גישת רשת: בסביבות באירוח Anthropic, גישת הרשת מוגבלת כברירת מחדל וניתנת להשבתה. ראו גישת רשת לרמות הגישה, דומיינים מורשים כברירת מחדל, והתעבורה שאינה עוברת דרך רשימת המורשים. בסביבה באירוח עצמי, אתם מגבילים את תעבורת היציאה (egress) של ההפעלה בגבול הרשת שלכם. כאשר רצים עם גישת רשת מושבתת, Claude Code עדיין יכול לתקשר עם ה-API של Anthropic, דבר שעשוי לאפשר לנתונים לצאת מה-VM.
  • הגנה על פרטי אימות: בסביבות באירוח Anthropic, פרטי אימות של git ומפתחות חתימה נשארים מחוץ לארגז החול (sandbox), ושרת proxy מבצע אימות בשם ההפעלה באמצעות פרטי אימות בעלי היקף מוגדר (scoped credentials). בסביבה באירוח עצמי, הפריסה שלכם מספקת פרטי אימות של git, ראו הגדרת git
  • פרטי אימות של API: בסביבות באירוח Anthropic בתוכניות Pro ו-Max, מפתחות שאתם מוסיפים לסביבת ענן נשארים מחוץ לארגז החול באותו אופן, ומצורפים לבקשות תואמות לאחר שהן יוצאות מההפעלה. בסביבה באירוח עצמי אין פרטי אימות של API, ובתוכניות Team ו-Enterprise עדיין אין אותם
  • ניתוח מאובטח: קוד מנותח ומשונה בתוך הסביבה המבודדת של ההפעלה לפני יצירת בקשות PR

#פתרון בעיות

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

#יצירת ההפעלה נכשלה (Session creation failed)

אם הפעלה חדשה נכשלת בהתחלה עם Session creation failed או נתקעת בשלב ההקצאה (provisioning), סימן ש-Claude Code לא הצליח להקצות VM עבור ההפעלה.

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

#לא ניתן לקבל UUID של ארגון (Unable to get organization UUID)

הפקודות claude --cloud ו-claude --teleport דורשות התחברות באמצעות חשבון claude.ai. אם אתם מאמתים באמצעות מפתח API, או שפרטי החשבון השמורים שלכם ישנים (stale), פקודות אלו נכשלות עם Unable to get organization UUID או עם הודעה המציינת שאימות באמצעות מפתח API אינו מספיק. עם אימות באמצעות מפתח API או פרטי חשבון ישנים, הרצת claude --teleport ללא מזהה הפעלה מציגה את השגיאה Error loading Claude Code sessions בבורר ההפעלות במקום כל אחת מההודעות הללו, ואותו תיקון חל.

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

#פקיעת תוקף הפעלת Remote Control או דחיית גישה (Remote Control session expired or access denied)

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

  1. הריצו /login מקומית כדי לרענן את פרטי האימות שלכם, ולאחר מכן התחברו מחדש
  2. ודאו שאתם מחוברים לאותו חשבון שבבעלותו נמצאת ההפעלה
  3. אם מופיעה ההודעה Remote Control may not be available for this organization, בעלים (Owner) לא הפעיל הפעלות ענן עבור הארגון שלכם

#פקיעת תוקף הסביבה (Environment expired)

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

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

#מגבלות

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

  • מגבלות קצב (Rate limits): הפעלות ענן חולקות מגבלות קצב עם כל שאר השימושים ב-Claude וב-Claude Code בתוך החשבון שלכם. הרצת מספר משימות במקביל צורכת יותר ממגבלות הקצב באופן יחסי. אין חיוב מחשוב נפרד עבור ה-VM בענן.
  • אימות מאגר: באפשרותכם למשוך הפעלת ענן לתוך הטרמינל שלכם רק כאשר אתם מאומתים לאותו חשבון
  • הגבלות פלטפורמה: שכפול מאגרים ויצירת pull requests דורשים את GitHub. מופעים של GitHub Enterprise Server באירוח עצמי נתמכים עבור תוכניות Team ו-Enterprise. באפשרותכם לשלוח מאגר GitLab, Bitbucket או מאגר אחר שאינו GitHub להפעלת ענן בתור חבילה מקומית על ידי הגדרת CCR_FORCE_BUNDLE=1, אך ההפעלה אינה יכולה לדחוף תוצאות בחזרה לאותו remote
  • רשימת היתרים של כתובות IP בארגון (Organization IP allowlist): הפעלות ענן קוראות ל-API של Anthropic מתשתית המנוהלת על ידי Anthropic, ולא מהרשת שלכם, בעוד שהפעלות בתוך סביבה באירוח עצמי קוראות לו מתוך הרשת שלכם. אם בארגון שלכם מופעלת רשימת היתרים של כתובות IP (IP allowlisting), כל הפעלת ענן באירוח Anthropic נכשלת עם שגיאת אימות. הדבר חל גם על סקירת קוד (Code Review) ועל שגרות (routines) שרצות בסביבות באירוח Anthropic. שגרה המנותבת לסביבה באירוח עצמי קוראת ל-API מתוך הרשת שלכם. פנו אל התמיכה של Anthropic כדי להחריג שירותים באירוח Anthropic מרשימת כתובות ה-IP המורשות של הארגון שלכם.

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

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