Git worktree στο Claude Code: παράλληλες συνεδρίες

Πρακτικές πληροφορίες για την εργασία με το Ailoot βρίσκονται στην τεκμηρίωση.

Τι είναι το git worktree στο Claude Code#

Η εκκίνηση πολλών agents παράλληλα στον ίδιο φάκελο είναι το βασικό πρόβλημα του vibe-coding με την ταχύτητα του 2026. Οι AI agents γράφουν κώδικα πιο γρήγορα απ’ όσο μπορεί ένας άνθρωπος να παρακολουθεί ποιος αλλάζει τι. Χωρίς απομόνωση αρχείων, η εκκίνηση δύο παράλληλων συνεδριών Claude Code στον ίδιο κατάλογο καταλήγει με τη μία συνεδρία να αντικαθιστά τη δουλειά της άλλης.

Το Git worktree λύνει αυτό το πρόβλημα στο επίπεδο του συστήματος αρχείων. Έχετε έναν κύριο κατάλογο όπου εργάζεστε. Η εντολή claude --worktree feature-auth δημιουργεί τον φάκελο .claude/worktrees/feature-auth/ σε ξεχωριστό branch και ξεκινά εκεί το Claude Code. Τα αρχεία είναι απομονωμένα. Οι αλλαγές σε μία συνεδρία δεν είναι ορατές στην άλλη μέχρι να τις συγχωνεύσετε ρητά.

Η επίσημη τεκμηρίωση της Anthropic το διατυπώνει ως εξής:

Ένα στοιχείο αυτοελέγχου: αν έχετε λάβει ποτέ ένα commit όπου τα μισά αρχεία ήταν δουλειά κάποιου άλλου, χρειάζεστε worktree.

Πώς διαφέρει το git worktree από ένα κανονικό branch#

Η τυπική ροή εργασίας Git: βρίσκεστε στο branch main και εκτελείτε git checkout feature-x—το Git αντικαθιστά τα αρχεία του αντιγράφου εργασίας. Μια διεργασία npm run dev που εκτελείται χαλάει επειδή το package.json άλλαξε κάτω από αυτήν. Αποθηκεύετε προσωρινά τις μη δεσμευμένες αλλαγές σας και περιμένετε να κάνει ξανά ευρετηρίαση το IDE. Επιστρέφετε και όλα αντικαθίστανται ξανά, οπότε πρέπει να κάνετε πάλι stash και pop.

Το Git worktree σάς δίνει άλλη επιλογή: αντί να αλλάζετε branch σε έναν φάκελο, δημιουργείτε έναν δεύτερο φάκελο για ένα άλλο branch. Η εντολή git worktree add ../project-feature-x feature-x δημιουργεί τον κατάλογο ../project-feature-x/ με τα αρχεία από το branch feature-x. Το main σας παραμένει στον αρχικό φάκελο και ο dev server συνεχίζει να εκτελείται.

Παλαιότερα, η λειτουργία worktree στο Claude Code έπρεπε να ρυθμιστεί χειροκίνητα: git worktree add, μετά cd, έπειτα claude—και επανάληψη σε κάθε τερματικό. Η σημαία --worktree (επίσης -w) τα κάνει και τα τρία με μία εντολή.

Εκκίνηση της πρώτης παράλληλης συνεδρίας: η σημαία --worktree#

Ελάχιστο παράδειγμα. Ανοίξτε το πρώτο τερματικό στη ρίζα του έργου:

claude --worktree feature-auth

Το Claude Code κάνει τρία πράγματα:

1. Δημιουργεί το .claude/worktrees/feature-auth/ με ένα στιγμιότυπο του origin/HEAD (συνήθως το προεπιλεγμένο branch σας).
2. Δημιουργεί ένα νέο branch worktree-feature-auth.
3. Ξεκινά τη συνεδρία σε αυτόν τον φάκελο.

Ανοίξτε ένα δεύτερο τερματικό στον ίδιο φάκελο ρίζας του αποθετηρίου:

claude --worktree bugfix-123

Έτοιμο. Δύο συνεδρίες Claude Code, διαφορετικά αρχεία στον δίσκο, διαφορετικά branch του Git. Αν γράφετε κώδικα αυθεντικοποίησης στην πρώτη και διορθώνετε ένα αποτυχημένο test στη δεύτερη, δεν μπορούν φυσικά να μπουν η μία στον δρόμο της άλλης.

Αν δεν θέλετε να πληκτρολογήσετε όνομα, το Claude θα επινοήσει ένα:

claude --worktree
# → δημιουργεί κάτι σαν .claude/worktrees/bright-running-fox/

Συμβουλή για αρχάριους στο Git: προσθέστε το .claude/worktrees/ στο .gitignore. Διαφορετικά, όταν εκτελείτε git status στον κύριο φάκελο, θα βλέπετε τα περιεχόμενα όλων των worktrees ως μη παρακολουθούμενα αρχεία:

# .gitignore
.claude/worktrees/

Παγίδα που πρέπει να αποφύγετε: πριν από την πρώτη εκκίνηση με --worktree σε νέο κατάλογο, μπείτε σε αυτόν με ένα κανονικό claude (χωρίς τη σημαία) και αποδεχτείτε το παράθυρο διαλόγου εμπιστοσύνης χώρου εργασίας. Αν δεν το κάνετε, η σημαία αποτυγχάνει με σφάλμα “trust not accepted”—και όταν τη συνδυάζετε με -p για headless λειτουργία.

Πού βρίσκονται τα worktrees και πώς να τα εντοπίσετε#

Η προεπιλεγμένη τοποθεσία είναι σταθερή: .claude/worktrees/<value>/ στη ρίζα του αποθετηρίου. Αν το έργο σας βρίσκεται στο ~/dev/my-app/, το worktree feature-auth θα βρίσκεται στο ~/dev/my-app/.claude/worktrees/feature-auth/.

Για μη τυπικές διατάξεις (για παράδειγμα, αν θέλετε το worktree έξω από το αποθετήριο), υπάρχει το hook WorktreeCreate—περισσότερα παρακάτω στην ενότητα για SVN και Mercurial.

Μέσα σε μία συνεδρία Claude, μπορείτε να μεταβείτε σε άλλο υπάρχον worktree. Απλώς πείτε στη συνομιλία: «switch to .claude/worktrees/bugfix-123» και το Claude θα καλέσει το εργαλείο EnterWorktree. Ο τρέχων φάκελος θα παραμείνει ανέπαφος—μπορείτε να επιστρέψετε με τον ίδιο τρόπο.

Η τυπική εντολή Git εμφανίζει λίστα με όλα τα worktrees, συμπεριλαμβανομένου του κύριου και όσων δημιουργήθηκαν χειροκίνητα:

git worktree list

Το αποτέλεσμα θα μοιάζει με αυτό:

/home/user/dev/my-app                  abc1234 [main]
/home/user/dev/my-app/.claude/worktrees/feature-auth  def5678 [worktree-feature-auth]
/home/user/dev/my-app/.claude/worktrees/bugfix-123    9876fed [worktree-bugfix-123]

Αντιγραφή των .env και μυστικών: το αρχείο .worktreeinclude#

Όταν το --worktree δημιουργεί νέο φάκελο, αυτός περιέχει μόνο ό,τι έχει γίνει commit στο Git. Το .env με τα κλειδιά API και το .env.local με τις τοπικές ρυθμίσεις βρίσκονται στο .gitignore, επομένως δεν υπάρχουν στο worktree. Έτσι, το πρώτο npm run dev αποτυγχάνει με “MISSING DATABASE_URL.”

Η αυτοσχέδια λύση είναι να αντιγράφετε χειροκίνητα το .env μετά από κάθε --worktree. Λειτουργεί μία φορά και μετά το ξεχνάτε. Η λύση της Anthropic είναι ένα αρχείο .worktreeinclude στη ρίζα του έργου, το οποίο απαριθμεί τα αρχεία που αγνοεί το Git και πρέπει να αντιγράφονται αυτόματα σε κάθε νέο worktree.

Δημιουργήστε ένα αρχείο .worktreeinclude στη ρίζα του αποθετηρίου:

.env
.env.local
config/secrets.json

Η σύνταξη είναι ίδια με του .gitignore. Μπορείτε να χρησιμοποιήσετε μοτίβα glob:

.env*
*.local
config/*.json
.vscode/settings.json

Η Anthropic δίνει έναν σαφή κανόνα για την αποφυγή ατυχημάτων:

Με άλλα λόγια, δεν μπορείτε να αντιγράψετε κατά λάθος το package.json μέσω του .worktreeinclude—δεν βρίσκεται στο .gitignore. Είναι ασφαλές να βάλετε εκεί οποιαδήποτε μοτίβα.

Το ίδιο .worktreeinclude λειτουργεί σε τρεις τρόπους: χειροκίνητο --worktree, αυτόματα worktrees για υποπράκτορες (δείτε παρακάτω) και συνεδρίες από την εφαρμογή Claude για υπολογιστή.

Worktree από pull request για ανασκόπηση κώδικα#

Ένα τυπικό σενάριο ανασκόπησης κώδικα: ένας συνάδελφος έστειλε ένα PR· πρέπει να επιθεωρήσετε τον κώδικα, να εκτελέσετε tests και να αφήσετε ένα σχόλιο. Με ένα κανονικό git checkout pull/1234/head, αλλάζετε ξανά το αντίγραφο εργασίας και διακόπτετε την ενεργή συνεδρία σας.

Με τη σημαία --worktree, αυτό γίνεται με μία εντολή:

claude --worktree "#1234"

Τι συμβαίνει: το Claude Code εκτελεί git fetch origin pull/1234/head, δημιουργεί ένα worktree στο .claude/worktrees/pr-1234/ και κάνει checkout το branch του PR. Ξεκινά η συνεδρία. Μπορείτε αμέσως να του ζητήσετε «διάβασε το diff, εκτέλεσε τα tests και εντόπισε λογικά σφάλματα»—ενώ το Claude εργάζεται, η κύρια συνεδρία σας στο main συνεχίζει.

Η εναλλακτική σύνταξη είναι το πλήρες URL του pull request:

claude --worktree https://github.com/OWNER/REPO/pull/1234

Χρήση σε πραγματικό έργο: ο συνδυασμός του claude --worktree "#N" με τον δικό σας υποπράκτορα ανασκόπησης κώδικα σάς προσφέρει αυτόματη ανασκόπηση σε ένα ή δύο λεπτά. Εκκινήστε τον στο παρασκήνιο, συνεχίστε τη δουλειά σας στο κύριο παράθυρο και επιστρέψτε στο αποτέλεσμα μέσω του claude agents.

Βασικό branch: worktree.baseRef για fresh ή head#

Η προεπιλεγμένη ρύθμιση είναι η εξής: κάθε νέο worktree ξεκινά από το origin/HEAD. Το πλεονέκτημα είναι μια καθαρή αφετηρία που είναι βέβαιο ότι αντιστοιχεί σε αυτό που θα δει το CI. Το μειονέκτημα είναι ότι, αν έχετε μη δεσμευμένες αλλαγές ή αρκετά τοπικά commits πέρα από το remote στον τρέχοντα κλάδο σας, δεν θα συμπεριληφθούν στο νέο worktree.

Για εκκίνηση worktree από το τρέχον τοπικό HEAD commit, προσθέστε αυτό στο .claude/settings.json (ή στις καθολικές ρυθμίσεις):

{
  "worktree": {
    "baseRef": "head"
  }
}

Τώρα το claude --worktree experimental-feature ξεκινά από το τρέχον τοπικό HEAD. Χρησιμεύει όταν η λειτουργία έχει ήδη τοπικά commits που δεν προωθήθηκαν. Δεν περιλαμβάνει tracked αλλαγές που παραμένουν χωρίς commit. Αν τις χρειάζεται ο subagent, διασώστε και μεταφέρετέ τες ρητά και εξετάστε το diff προορισμού· μη συγχέετε τη μεταφορά με .worktreeinclude, που χειρίζεται ignored τοπικά αρχεία.

Η ρύθμιση δέχεται ακριβώς δύο τιμές: "fresh" (= origin/HEAD) και "head" (= τοπικό HEAD). Δεν δέχεται αυθαίρετες αναφορές όπως "feature-branch" ή ένα hash commit—αυτός είναι σκόπιμος περιορισμός για να αποφευχθεί ο συνδυαστικός πολλαπλασιασμός επιλογών.

Αυτόματη απομόνωση υποπρακτόρων: isolation: worktree#

Όταν λέτε στο Claude «εκκίνησε τρεις υποπράκτορες: ο ένας διαβάζει τη βάση δεδομένων, ο δεύτερος εξετάζει το API και ο τρίτος ελέγχει τα tests», και οι τρεις εργάζονται στο αντίγραφο εργασίας σας από προεπιλογή. Αν έστω δύο από αυτούς γράφουν ταυτόχρονα στο ίδιο αρχείο, υπάρχει σύγκρουση. Η λύση είναι να δώσετε αυτόματα στον καθένα το δικό του worktree.

Μέθοδος 1: ζητήστε το προφορικά. Γράψτε στο Claude στη συνομιλία:

Χρησιμοποίησε worktrees για τους agents σου.

Το Claude θα εφαρμόσει την απομόνωση σε όλους τους επόμενους υποπράκτορες αυτής της συνεδρίας.

Μέθοδος 2: ορίστε το ρητά στον ίδιο τον υποπράκτορα. Στο αρχείο του υποπράκτορα (για παράδειγμα, .claude/agents/code-reviewer.md), προσθέστε ένα πεδίο στο frontmatter:

---
name: code-reviewer
description: Reads the diff and writes code review comments
isolation: worktree
---

Είσαι ένας σχολαστικός αξιολογητής. Διάβασε το diff και αναζήτησε λογικά σφάλματα...

Τώρα κάθε εκκίνηση αυτού του υποπράκτορα αποκτά ένα προσωρινό worktree στο .claude/worktrees/. Αν ο υποπράκτορας δεν έγραψε τίποτα, ο φάκελος διαγράφεται αυτόματα μόλις ολοκληρώσει. Αν υπάρχουν μη δεσμευμένες αλλαγές, το Claude θα ρωτήσει αν θέλετε να τις διατηρήσετε ή να τις αφαιρέσετε.

Το βασικό branch για τα worktrees των υποπρακτόρων είναι το ίδιο με του --worktree: από προεπιλογή, origin/HEAD· με το worktree.baseRef: head, το τοπικό HEAD.

Πίνακας αποφάσεων: worktree, /bg, subagent ή Agent View#

Τυπικοί συνδυασμοί:

• «2 λειτουργίες παράλληλα, χειροκίνητα» — δύο τερματικά, το καθένα εκτελεί claude --worktree. Η απλούστερη περίπτωση.
• «Εκκίνησε μια αναπαραγοντοποίηση για όλη τη νύχτα· θα κλείσω την εφαρμογή» — /bg + /goal με συνθήκη ολοκλήρωσης. Η συνεδρία εκτελείται ανεξάρτητα από το παράθυρό σας.
• «Μία προτροπή, τρεις παράλληλες έρευνες» — τρεις υποπράκτορες με isolation: worktree. Ο καθένας στο δικό του sandbox.
• «Τι εκτελείται αυτή τη στιγμή;» — claude agents. Ένας πίνακας ελέγχου όλων των συνεδριών με φίλτρα «running», «blocked» και «done».

5 παγίδες κατά τη χρήση worktrees#

1. Εκκινήσατε worktree, λείπει το .env, τίποτα δεν λειτουργεί. Το συνηθέστερο πρόβλημα. Ένα worktree είναι νέο checkout χωρίς αρχεία που αγνοούνται από το Git. Η λύση είναι να προσθέσετε ένα αρχείο .worktreeinclude με .env* και τις απαραίτητες τοπικές ρυθμίσεις μόλις ρυθμίσετε τη λειτουργία worktree. Βεβαιωθείτε ότι το αρχείο βρίσκεται στη ρίζα του αποθετηρίου και όχι στο .claude/.

2. Θέλετε να μεταβείτε στο κύριο branch, εκτελείτε cd προς τη ρίζα και χάνετε τις μη δεσμευμένες αλλαγές στο worktree. Ο ριζικός φάκελος και το worktree είναι δύο διαφορετικά αντίγραφα εργασίας. Επιστρέψατε με cd· οι αλλαγές στο worktree παρέμειναν στη θέση τους—δεν πήγαν πουθενά. Όμως, αν μπερδευτήκατε και εκτελέσατε git stash στον κύριο φάκελο, νομίζοντας ότι βρισκόσασταν στο worktree, το stash θα δημιουργηθεί στο κύριο branch, όχι σε αυτό που περιμένατε.

3. Εκκινήσατε 5 παράλληλες συνεδρίες και δεν θυμάστε τι κάνει καθεμία. Η τεκμηρίωση της Anthropic προειδοποιεί ρητά ότι οι περισσότεροι προγραμματιστές δεν μπορούν να διαχειριστούν νοητικά περισσότερες από 2–3 συνεδρίες. Ένδειξη υπερφόρτωσης είναι να ανοίγετε το Agent View και να μην μπορείτε να πείτε αμέσως τι κάνει κάθε agent. Περιοριστείτε σε δύο ταυτόχρονες συνεδρίες. Αν η εργασία απαιτεί περισσότερες, πρέπει να οργανωθεί μέσω /goal + υποπρακτόρων και όχι χειροκίνητα.

4. Τα worktrees από -p (headless) δεν εκκαθαρίζονται αυτόματα. Η εντολή claude --worktree feature-x -p "do thing" δεν εμφανίζει διαδραστική προτροπή εξόδου, επομένως δεν υπάρχει στιγμή που το Claude να ρωτήσει «να αφαιρεθεί το worktree;». Αυτά τα worktrees συσσωρεύονται. Καθαρίστε τα χειροκίνητα: git worktree remove .claude/worktrees/feature-x. Ή χρησιμοποιήστε ένα cron script που αφαιρεί οτιδήποτε είναι παλαιότερο από 7 ημέρες.

5. Παράθυρο εμπιστοσύνης σε νέο φάκελο. Αν ανοίξετε το αποθετήριο για πρώτη φορά και εκτελέσετε αμέσως claude --worktree, η εντολή θα αποτύχει. Εκτελέστε claude χωρίς σημαίες, αποδεχτείτε την εμπιστοσύνη χώρου εργασίας και βγείτε—έπειτα το --worktree θα λειτουργήσει. Αυτό είναι σκόπιμο, ώστε το Claude να μην αποκτά πρόσβαση στο έργο κάποιου άλλου χωρίς τη συγκατάθεση του χρήστη.

Εκκαθάριση: τι διαγράφεται αυτόματα#

Η λογική εκκαθάρισης εξαρτάται από το τι έχετε κάνει στο worktree και πώς ξεκινήσατε τη συνεδρία. Η τεκμηρίωση της Anthropic παραθέτει τρία σενάρια:

Σενάριο 1: μπήκατε, δεν κάνατε τίποτα και βγήκατε—το worktree αφαιρέθηκε.

Σενάριο 2: κάνατε κάποια δουλειά χωρίς να την κάνετε commit—το Claude θα ρωτήσει «διατήρηση ή αφαίρεση;» όταν βγείτε. Η επιλογή «διατήρηση» αποθηκεύει τον φάκελο και το branch για αργότερα. Η επιλογή «αφαίρεση» διαγράφει τον κατάλογο μαζί με μη δεσμευμένες αλλαγές και νέα commits. Αυτό είναι καταστροφικό—μην επιλέγετε «αφαίρεση» από συνήθεια.

Σενάριο 3: εκκινήσατε με -p (headless) και η εντολή ολοκληρώθηκε και τερματίστηκε. Το worktree παραμένει. Καθαρίστε το χειροκίνητα:

git worktree remove .claude/worktrees/feature-x

Επιπλέον, τα worktrees από υποπράκτορες και συνεδρίες /bg αφαιρούνται αυτόματα από τον καθαρισμό παρασκηνίου αν είναι παλαιότερα από cleanupPeriodDays ημέρες (μια ρύθμιση, συνήθως 30 ημέρες από προεπιλογή) και δεν έχουν μη αποθηκευμένη εργασία. Τα worktrees από --worktree δεν επηρεάζονται από τον αυτόματο καθαρισμό—είναι δική σας ευθύνη.

Εναλλακτικές για SVN, Perforce και Mercurial: το hook WorktreeCreate#

Αν το αποθετήριο χρησιμοποιεί Subversion ή Mercurial, η σημαία --worktree δεν θα λειτουργήσει απευθείας. Η Anthropic παρέχει ένα σημείο επέκτασης μέσω δύο hooks: WorktreeCreate (δημιουργεί ένα απομονωμένο αντίγραφο) και WorktreeRemove (το αφαιρεί).

Παράδειγμα hook SVN από την επίσημη τεκμηρίωση:

{
  "hooks": {
    "WorktreeCreate": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash -c 'NAME=$(jq -r .name); DIR=\"$HOME/.claude/worktrees/$NAME\"; svn checkout https://svn.example.com/repo/trunk \"$DIR\" >&2 && echo \"$DIR\"'"
          }
        ]
      }
    ]
  }
}

Το hook διαβάζει το όνομα του worktree από το stdin ({ "name": "feature-auth" }), εκτελεί svn checkout σε έναν προκαθορισμένο κατάλογο και εκτυπώνει τη διαδρομή στο stdout—το Claude Code τη χρησιμοποιεί ως κατάλογο εργασίας για τη νέα συνεδρία.

Μια σημαντική επιφύλαξη: όταν χρησιμοποιείτε δικό σας hook, το .worktreeinclude δεν χρησιμοποιείται. Αν χρειάζεστε .env ή άλλα αρχεία που αγνοούνται από το Git στον νέο φάκελο, αντιγράψτε τα μέσα στο ίδιο το script του hook.

Τι ακολουθεί: τρεις συναφείς μηχανισμοί παραλληλισμού#

Το worktree προσφέρει απομόνωση αρχείων. Το /bg προσφέρει απομόνωση πλαισίου. Οι υποπράκτορες προσφέρουν απομόνωση εργασιών. Κάθε μηχανισμός λύνει ένα πρόβλημα από μόνος του. Μαζί παρέχουν έναν τρόπο να εργάζεστε σε τρεις έως πέντε παράλληλες εργασίες χωρίς νοητική κατάρρευση. Αυτό είναι το σύνολο δεξιοτήτων πίσω από το προχωρημένο vibe-coding το 2026.

Αυτό το θέμα συνεχίζεται φυσικά σε τρία σχετικά θέματα: πώς να ρυθμίσετε έναν αυτόνομο agent με /goal και Agent View, πώς να δημιουργήσετε τους δικούς σας υποπράκτορες για τις εργασίες σας και πώς να εκκινήσετε εκατοντάδες agents μέσω των Dynamic Workflows.

Ανοίξτε το Ailoot.