תיעוד 24
שימוש ב-Claude Code בענן
הריצו הפעלות Claude Code בענן מהדפדפן, מהטלפון, מאפליקציית שולחן העבודה או מהטרמינל, העבירו אותן באמצעות
--cloudו---teleport, ותקנו pull requests באופן אוטומטי.
הערה: הפעלות ענן נמצאות בתצוגה מקדימה למחקר (research preview) עבור משתמשי Pro, Max ו-Team, ועבור משתמשי Enterprise עם מושבי פרימיום (premium seats) או מושבי Chat + Claude Code.
הפעלת ענן היא הפעלה של Claude Code שרצה על גבי תשתית ענן במקום על המחשב שלכם. כברירת מחדל היא רצה על תשתית ש-Anthropic מנהלת, או על סביבה באירוח עצמי של הארגון שלכם כאשר היא מנותבת לשם. ההפעלה ממשיכה לרוץ גם לאחר שאתם סוגרים את המחשב הנייד, ואתם יכולים לבדוק אותה או לכוון אותה מכל מכשיר.
באפשרותכם להתחיל הפעלת ענן מכל אחד מהמשטחים הבאים:
- דפדפן: claude.ai/code, נקרא גם Claude Code ברשת (on the web)
- מובייל: לשונית ה-Code ב-אפליקציית Claude
- אפליקציית שולחן עבודה: בחרו ב-Cloud במקום ב-Local בעת התחלת הפעלה
- טרמינל:
claude --cloud - שגרות (Routines): הרצות מתוזמנות ומופעלות (triggered) רצות כל אחת כהפעלת ענן
כדי ש-Claude יתחיל ויעקוב אחר הפעלות ענן רבות עבור גוף עבודה אחד, השתמשו ב-פרויקט. הפעלה בטרמינל שלכם, ב-IDE שלכם, או באפליקציית שולחן העבודה כאשר נבחר Local, רצה במקום זאת על המחשב שלכם. כדי לכוון אחת מההפעלות המקומיות הללו מהטלפון או מהדפדפן שלכם, השתמשו ב-Remote Control.
טיפ: חדשים בהפעלות ענן? התחילו עם תחילת העבודה כדי לחבר את חשבון ה-GitHub שלכם ולהגיש את המשימה הראשונה שלכם.
דף זה מכסה:
- סביבות ענן: היכן הפעלות רצות, והיכן להגדיר זאת
- אפשרויות אימות ב-GitHub: שתי דרכים לחבר את GitHub
- העברת משימות בין הטרמינל לענן באמצעות
--cloudו---teleport - עבודה עם הפעלות: מצבי הרשאה, סקירה, שיתוף, העברה לארכיון, מחיקה
- תיקון אוטומטי של pull requests: תגובה אוטומטית לכשלים ב-CI ולהערות סקירה
- אבטחה ובידוד: כיצד הפעלות מבודדות
- מגבלות: מגבלות קצב והגבלות פלטפורמה
#סביבות ענן
כל הפעלת ענן רצה בתוך סביבת ענן, התצורה השמורה השולטת בגישת רשת, במשתני סביבה ובסקריפטים של הגדרה (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 עבור ההפעלה.
- בדקו את status.claude.com לגבי תקלות בהפעלות ענן
- נסו שוב לאחר דקה, כיוון שקיבולת מוקצית לפי דרישה
- ודאו שחיבור ה-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. אסימון החיבור קצר מועד ומוגדר בהיקף החשבון שלכם בלבד.
- הריצו
/loginמקומית כדי לרענן את פרטי האימות שלכם, ולאחר מכן התחברו מחדש - ודאו שאתם מחוברים לאותו חשבון שבבעלותו נמצאת ההפעלה
- אם מופיעה ההודעה
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 המנוהל על ידי ארגון ורץ על אותה תשתית ענן