הבעיה: Claude Code רץ רק על ענף אחד בכל פעם
אתה באמצע פיתוח feature חדש ב-Claude Code, ואז מגיעה בקשה דחופה לתקן bug ב-production. הפתרון הרגיל? stash, checkout, stash pop, ואז חזרה. בינתיים Claude Code איבד את כל ה-context שבנה. זהו הכאב שגרם ל-Anthropic לבנות תמיכה native ב-Git Worktrees.
Git Worktrees פותרים את הבעיה מהשורש: במקום לעבור בין branches, כל branch חי בתיקייה נפרדת על הדיסק. שלושה features שרצים במקביל, שלוש תיקיות, שלושה instances של Claude Code, אפס התנגשויות.
ב-פברואר 2026, Boris Cherny (יוצר Claude Code) הכריז: "Do more in parallel. Spin up 3–5 git worktrees at once, each running its own Claude session in parallel. It's the single biggest productivity unlock, and the top tip from the team.", ועם השחרור הזה הגיע גם הדגל --worktree ל-CLI.
הדגל --worktree: הדרך הכי מהירה להתחיל
Claude Code v2.1.49 הוסיף תמיכה native שמחליפה את הצורך לנהל worktrees ידנית. פקודה אחת עושה הכל:
# יצירת worktree חדש + פתיחת Claude Code בו
claude --worktree feature-auth
# קיצור, אותו דבר
claude -w feature-auth
# ללא שם, Claude מייצר שם אוטומטי (למשל: bright-running-fox)
claude --worktree
הפקודה יוצרת תיקייה ב-.claude/worktrees/feature-auth/, מסתעפת מ-origin/HEAD, ומפעילה Claude Code מיידית. ניקוי אוטומטי: אם לא ביצעת שינויים, ה-worktree נמחק כשיוצאים. אם יש commits, Claude שואל אם לשמור.
Worktrees ידניים: שליטה מלאה
כשצריך לעבוד על branch קיים או לשלוט על מיקום, אפשר ליצור worktrees ישירות עם git:
# יצירת worktree לענף חדש
git worktree add .claude/worktrees/feature-payment -b feature/payment
# יצירת worktree לענף קיים
git worktree add .claude/worktrees/bugfix-123 bugfix/login-crash
# רשימת worktrees פעילים
git worktree list
# ניקוי אחרי סיום
git worktree remove .claude/worktrees/feature-payment
git worktree prune
לאחר יצירה ידנית, פתח טרמינל נפרד לכל worktree והפעל Claude Code:
cd .claude/worktrees/feature-payment && npm install && claude
חשוב: כל worktree הוא checkout נפרד, לכן צריך npm install (או pip install וכו') בנפרד. אל תדלג על זה; זו אחת הטעויות הנפוצות ביותר שגורמת ל-builds מסתוריים לקרוס.
Worktrees ידניים vs. --worktree: השוואה
| קריטריון | git worktree add ידני | claude --worktree |
|---|---|---|
| בקרת branch | מלאה, branch קיים או חדש | branch חדש בלבד |
| ניקוי אוטומטי | ידני | אוטומטי |
| מהירות | דורש כמה פקודות | פקודה אחת |
| base branch | כל branch שתבחר | origin/HEAD בלבד |
| subagent isolation | לא אוטומטי | isolation: worktree ב-frontmatter |
3 טיפים קריטיים לעבודה יומיומית
- סנכרן את origin/HEAD לפני שמתחילים. Worktrees מסתעפים מ-
origin/HEAD. אם ה-default branch השתנה ב-GitHub, הריצהgit remote set-head origin -aכדי לסנכרן. אחרת Claude יסתעף מ-branch ישן. - צור .worktreeinclude לקבצי .env. Worktree חדש הוא checkout נקי, ללא קבצי .env. צור קובץ
.worktreeincludeבשורש הפרויקט עם שמות הקבצים שרוצים להעתיק אוטומטית:.env
.env.local
config/secrets.json - Scope לפי module, לא לפי task. אל תפתח שני worktrees שעובדים על אותם קבצים. עבודה לפי module מבטיחה שכל instance של Claude Code עורך קבצים שונים לגמרי, ואין merge conflicts מיותרים.
דוגמה ישראלית: סטארטאפ ת"א עם 3 features במקביל
קחו צוות של מפתח אחד בסטארטאפ תל-אביבי שמפתח אפליקציית SaaS לניהול לידים. במקום לחכות שכל feature יסתיים לפני הבאה, הוא פותח שלושה worktrees:
# Feature 1: מערכת תשלומים
claude -w payment-integration
# Feature 2: ממשק משתמש לדשבורד
claude -w dashboard-redesign
# Hotfix דחוף: תיקון login
claude -w hotfix-login-crash
כל instance של Claude Code עובד עצמאית, payment-integration כותב קוד Stripe, dashboard-redesign בונה components ב-React, ו-hotfix-login-crash מתקן את ה-bug. מפתח אחד מנהל שלושה agents, כל 20 דקות מחליף מסוף. שלושה ימי עבודה נדחסים ליום אחד.
