Το Claude Code διαβάζει πλέον το AGENTS.md: τι άλλαξε στην έκδοση 2.1.277

Στις 18 Σεπτεμβρίου 2026, προστέθηκε υποστήριξη για το AGENTS.md στο Claude Code 2.1.277. Αν η λειτουργία είναι διαθέσιμη στη συνεδρία και στον κατάλογο εργασίας και δεν υπάρχει κανένα CLAUDE.md, .claude/CLAUDE.md ή CLAUDE.local.md σε κανένα σημείο της αλυσίδας καταλόγων πάνω από αυτόν, το Claude Code διαβάζει το AGENTS.md από προεπιλογή, χωρίς χειροκίνητη εισαγωγή. Προηγουμένως, αυτό γινόταν μέσω εισαγωγής @AGENTS.md στο CLAUDE.md ή μέσω συμβολικού συνδέσμου CLAUDE.md προς το AGENTS.md—για περισσότερες λεπτομέρειες, δείτε το άρθρο για ένα αρχείο οδηγιών για πολλούς πράκτορες.

Αν χρησιμοποιείτε το Claude Code και ένα ή δύο άλλα εργαλεία στο ίδιο αποθετήριο, η λειτουργία Project instructions που επιλέγετε καθορίζει ποια αρχεία οδηγιών διαβάζει το Claude Code. Παρακάτω παρατίθενται οι συνθήκες για καθεμία από τις τέσσερις λειτουργίες και τα βήματα για τη μετάβαση από την παλιά ρύθμιση.

Περισσότερο υλικό για τη ρύθμιση εργαλείων είναι διαθέσιμο στην τεκμηρίωση του Ailoot.

Τι άλλαξε στην έκδοση 2.1.277;#

Το επίσημο αρχείο CHANGELOG.md του έργου Claude Code στο GitHub το διατυπώνει ως εξής:

Μετάφραση: προστέθηκε υποστήριξη για το AGENTS.md—σε ένα έργο χωρίς CLAUDE.md, το Claude Code διαβάζει πλέον το AGENTS.md αντί αυτού· αυτό μπορεί να αλλάξει από την ενότητα «Project instructions» στο /config (δεν είναι ακόμη διαθέσιμο στα Bedrock, Vertex ή Foundry).

Πριν από αυτήν την έκδοση, η απουσία των CLAUDE.md, .claude/CLAUDE.md και CLAUDE.local.md στον φάκελο εργασίας και στους ανώτερους καταλόγους δεν αρκούσε από μόνη της για να ενεργοποιηθεί η ανάγνωση του AGENTS.md. Χρειαζόταν ρητή εισαγωγή, συμβολικός σύνδεσμος ή χειροκίνητο hook. Τώρα, όταν η δυνατότητα είναι διαθέσιμη, ο πράκτορας εντοπίζει το αρχείο αυτόματα.

Ποια αρχεία εμποδίζουν την αυτόματη ανάγνωση του AGENTS.md#

Αν έχετε ένα προσωπικό ~/.claude/CLAUDE.md με ρυθμίσεις για το στυλ κώδικα, δεν θα εμποδίσει το Claude Code να διαβάσει το AGENTS.md του έργου. Όμως, οποιοδήποτε CLAUDE.local.md στον φάκελο εργασίας—ακόμη κι αν δεν έχει προστεθεί στο Git και χρησιμοποιείται για προσωπικές σημειώσεις—εμποδίζει την αυτόματη ανάγνωση του AGENTS.md στην προεπιλεγμένη λειτουργία. Η ρητή εισαγωγή εξακολουθεί να λειτουργεί· για να διαβάζει απευθείας και τα δύο αρχεία, πρέπει να αλλάξετε λειτουργία.

Αν έχει επιλεγεί μια λειτουργία άμεσης ανάγνωσης στην ενότητα Project instructions (δείτε παρακάτω την ενότητα «4 λειτουργίες Project instructions—ποια να επιλέξετε») και δεν υπάρχει CLAUDE.md, .claude/CLAUDE.md ή CLAUDE.local.md στον κατάλογο εργασίας ή στους ανώτερους καταλόγους, το Claude Code διαβάζει κάθε AGENTS.md και .claude/AGENTS.md σε αυτούς τους καταλόγους κατά την έναρξη της συνεδρίας. Για την περίπτωση χωρίς αρχεία που εμποδίζουν τη φόρτωση, η τεκμηρίωση δείχνει μια γραμμή όπως η εξής σε μια διαδραστική συνεδρία:

no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md

Ένα αρχείο AGENTS.md σε υποκατάλογο φορτώνεται όταν το Claude ανοίγει ένα αρχείο εκεί χρησιμοποιώντας το εργαλείο Read. Στη λειτουργία claude-md-or-agents-md, αυτό συμβαίνει μόνο αν ο υποκατάλογος δεν έχει δικό του CLAUDE.md, .claude/CLAUDE.md ή CLAUDE.local.md. Για τη λειτουργία claude-md-and-agents-md, η τεκμηρίωση περιγράφει τον γενικό κανόνα: τα CLAUDE.md και AGENTS.md διαβάζονται μαζί, πρώτα το CLAUDE.md και έπειτα το AGENTS.md σε κάθε κατάλογο. Τα AGENTS.local.md, AGENTS.override.md και οτιδήποτε βρίσκεται στον κατάλογο .agents/ δεν διαβάζονται αυτόματα.

Υλικό σχετικά με τη ρύθμιση του χώρου εργασίας ενός πράκτορα AI, συμπεριλαμβανομένων αρχείων οδηγιών με πληροφορίες για το έργο, είναι διαθέσιμο στην τεκμηρίωση του Ailoot.

4 λειτουργίες Project instructions—ποια να επιλέξετε#

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

Μπορείτε επίσης να επιλέξετε τη λειτουργία χωρίς τη διεπαφή, μέσω του settings.json:

{
  "pluginConfigs": {
    "agents-md@builtin": {
      "options": {
        "instructionFiles": "claude-md-and-agents-md"
      }
    }
  }
}

Το Claude Code αγνοεί αυτήν την τιμή στις ρυθμίσεις project και local. Σύμφωνα με την τεκμηρίωση της Anthropic, μπορεί να οριστεί στο ~/.claude/settings.json, σε ένα αρχείο --settings ή στις ρυθμίσεις που διαχειρίζεται ο οργανισμός.

Αν έχετε ήδη ρυθμίσει ένα κοινό αρχείο οδηγιών για πολλά εργαλεία AI σε ένα αποθετήριο, οι οδηγίες για εκδόσεις πριν από την 2.1.277 εξηγούν πώς λειτουργεί η εισαγωγή @. Αυτή η μέθοδος εξακολουθεί να λειτουργεί σήμερα.

Γιατί λείπει το Project instructions από το /config#

Πρώτα ελέγξτε την έκδοση με την εντολή claude --version. Αν είναι παλαιότερη από την 2.1.277, ενημερώστε το Claude Code. Αν η έκδοση είναι κατάλληλη αλλά η ενότητα εξακολουθεί να μην εμφανίζεται, ελέγξτε τους άλλους λόγους που αναφέρονται παραπάνω. Όσο η δυνατότητα δεν είναι διαθέσιμη, η εισαγωγή @AGENTS.md στο CLAUDE.md παραμένει λειτουργική εναλλακτική.

Τι να κάνετε με την παλιά εισαγωγή @AGENTS.md#

Τα επόμενα βήματα εξαρτώνται από την παλιά ρύθμιση. Πρώτα, βεβαιωθείτε ότι η δυνατότητα είναι διαθέσιμη στη συνεδρία σας, όπως περιγράφεται στην προηγούμενη ενότητα.

• CLAUDE.md με εισαγωγή @AGENTS.md. Μπορείτε να το αφήσετε ως έχει—το Claude Code δεν θα διαβάσει το αρχείο δύο φορές με καμία τιμή Project instructions. Η διαγραφή του CLAUDE.md είναι προαιρετική: η εισαγωγή δίνει ήδη στο Claude πρόσβαση στα περιεχόμενα του AGENTS.md. Συνεχίστε να ελέγχετε τη φόρτωση μέσω της εισαγωγής με το /memory· μια άμεση ερώτηση στο Claude για το περιεχόμενο των οδηγιών είναι μόνο ένας ασθενής έλεγχος.
• CLAUDE.md που ζητά με λόγια να διαβαστεί το AGENTS.md. Ένα τέτοιο αίτημα δεν είναι εισαγωγή και από μόνο του δεν εγγυάται ότι θα φορτωθεί το αρχείο. Αντικαταστήστε τη διατύπωση με εισαγωγή @AGENTS.md, αν θέλετε να διατηρήσετε το CLAUDE.md (για παράδειγμα, για εργαλεία που επίσης το διαβάζουν). Αν αποφασίσετε να διαγράψετε εντελώς το CLAUDE.md και έχει επιλεγεί η λειτουργία claude-md-or-agents-md, ελέγξτε πρώτα ότι το CLAUDE.md δεν περιέχει μοναδικές οδηγίες και ότι δεν υπάρχει άλλο CLAUDE.md, .claude/CLAUDE.md ή CLAUDE.local.md στον κατάλογο εργασίας ή στους ανώτερους καταλόγους· διαφορετικά, το Claude Code θα συνεχίσει να διαβάζει το αρχείο που απομένει αντί για το AGENTS.md. Αφού το διαγράψετε, βεβαιωθείτε ότι ολοκληρώθηκε η μετάβαση: όταν δεν απομένουν αρχεία που εμποδίζουν τη φόρτωση, εμφανίζεται η γραμμή AGENTS.md loaded σε μια διαδραστική συνεδρία. Αν το CLAUDE.md παραμείνει και διαβάζονται και τα δύο αρχεία στη λειτουργία claude-md-and-agents-md, ελέγξτε το /memory (στην έκδοση 2.1.280+). Μια άμεση ερώτηση στο Claude δεν μπορεί να διακρίνει την άμεση φόρτωση από μια εισαγωγή.
• Συμβολικός σύνδεσμος CLAUDE.md προς το AGENTS.md. Μπορείτε να τον διατηρήσετε: δεν θα γίνει διπλή ανάγνωση σε καμία λειτουργία. Πριν διαγράψετε τον σύνδεσμο στη λειτουργία claude-md-or-agents-md, ελέγξτε ότι έχουν διατηρηθεί οι απαραίτητες οδηγίες και ότι δεν υπάρχει άλλο CLAUDE.md, .claude/CLAUDE.md ή CLAUDE.local.md στον κατάλογο εργασίας ή στους ανώτερους καταλόγους. Ελέγξτε τη φόρτωση με τον ίδιο τρόπο: με τη γραμμή AGENTS.md loaded κατά την έναρξη της συνεδρίας, όταν δεν υπάρχουν αρχεία που εμποδίζουν τη φόρτωση, ή με το /memory (2.1.280+). Αν το CLAUDE.md παραμείνει στη λειτουργία claude-md-and-agents-md, μια άμεση ερώτηση στο Claude είναι μόνο ασθενής έλεγχος. Η απουσία σφάλματος δεν αρκεί για να επιβεβαιωθεί η φόρτωση.
• Hook SessionStart που εμφάνιζε χειροκίνητα τα περιεχόμενα του AGENTS.md. Όταν το αρχείο διαβάζεται απευθείας, ένα τέτοιο hook προσθέτει δεύτερο αντίγραφο στο περιεχόμενο της συνεδρίας. Όσο εκτελείται το hook, η ερώτηση «τι υπάρχει στις οδηγίες σου;» δεν επιβεβαιώνει την άμεση φόρτωση: ο Claude μπορεί να απαντήσει βάσει του κειμένου που προστέθηκε από το hook. Αλλάξτε με την εξής σειρά:
  1. Ελέγξτε ότι η δυνατότητα είναι διαθέσιμη: έκδοση 2.1.277 ή νεότερη, η συνεδρία λαμβάνει σημαίες δυνατοτήτων, το πρόσθετο είναι ενεργοποιημένο και έχει ολοκληρωθεί η πρώτη συνεδρία μετά την εγκατάσταση ή την ενημέρωση. Επιλέξτε λειτουργία άμεσης ανάγνωσης—ούτε claude-md ούτε managed-only. Για την προεπιλεγμένη λειτουργία, ελέγξτε επίσης ότι δεν υπάρχουν αρχεία που εμποδίζουν τη φόρτωση.
  2. Αφαιρέστε το hook.
  3. Κλείστε τη συνεδρία και ανοίξτε νέα. Το hook SessionStart προσθέτει το κείμενό του κατά την εκκίνηση, επομένως το περιεχόμενό του παραμένει στο πλαίσιο μιας ήδη ανοιχτής συνεδρίας. Η απάντηση του Claude σχετικά με το περιεχόμενο των οδηγιών σε μια τέτοια συνεδρία δεν επιβεβαιώνει την άμεση φόρτωση.
  4. Ελέγξτε τη φόρτωση στη νέα συνεδρία. Στην έκδοση 2.1.280+, η διαδρομή προς το AGENTS.md είναι ορατή στο /memory. Στις εκδόσεις 2.1.277–2.1.279, αν δεν υπάρχουν αρχεία που εμποδίζουν τη φόρτωση, αναζητήστε τη γραμμή AGENTS.md loaded κατά την εκκίνηση: η τεκμηρίωση την περιγράφει συγκεκριμένα για την περίπτωση όπου δεν βρέθηκε CLAUDE.md. Αν διατηρήσετε το CLAUDE.md και χρησιμοποιήσετε τη λειτουργία claude-md-and-agents-md, ο έλεγχος είναι περιορισμένος: το /memory δεν εμφανίζει το AGENTS.md σε αυτές τις εκδόσεις, η τεκμηρίωση δεν περιγράφει γραμμή φόρτωσης για αυτήν την περίπτωση και μια παράφραση των οδηγιών δεν μπορεί να διακρίνει την άμεση ανάγνωση από μια εισαγωγή @ μέσα στο CLAUDE.md. Σε αυτήν την περίπτωση, ενημερώστε στην έκδοση 2.1.280+ και ελέγξτε το /memory.

Πώς να ελέγξετε αν φορτώθηκε το AGENTS.md#

Υπάρχουν δύο ακόμη διαφορές από το συνηθισμένο CLAUDE.md: τα hooks InstructionsLoaded δεν ενεργοποιούνται για αυτόν τον τύπο AGENTS.md (λειτουργούν για AGENTS.md που εισάγεται με τη σύνταξη @ από το CLAUDE.md ή συνδέεται μέσω συμβολικού συνδέσμου CLAUDE.md)· οι κατάλογοι που προστίθενται με τη σημαία --add-dir μαζί με τη μεταβλητή CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD φορτώνουν μόνο το CLAUDE.md του αντίστοιχου καταλόγου—το AGENTS.md του δεν συμπεριλαμβάνεται.

Αν θέλετε να εξετάσετε τα περιεχόμενα ενός μεγάλου αρχείου οδηγιών έργου, δείτε τη χωριστή ανάλυση σχετικά με τη ρύθμιση του CLAUDE.md χωρίς να γίνει ογκώδες. Καλύπτει τη δομή των οδηγιών, ενώ παραπάνω περιγράφονται οι συνθήκες φόρτωσης του AGENTS.md. Για σημειώσεις εργασίας μεταξύ συνεδριών, δείτε την ανάλυση για έναν δεύτερο εγκέφαλο στο Claude Code—σχετικά με την προσωπική μνήμη που προστίθεται πάνω από τις οδηγίες του έργου.

Τι ακολουθεί#

Η δυνατότητα κυκλοφόρησε στις 18 Σεπτεμβρίου 2026, στην έκδοση 2.1.277. Η Anthropic μπορεί να διευκρινίσει λεπτομέρειες των λειτουργιών σε μελλοντικές εκδόσεις, επομένως πριν αλλάξετε ρυθμίσεις σε ένα σημαντικό έργο, συγκρίνετε αυτό το άρθρο με το τρέχον /config και το επίσημο αρχείο καταγραφής αλλαγών.