Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Διαμόρφωση του περιβάλλοντός σας και του αρχείου AGENTS.md

Μάθημα 3 / 20 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Προετοιμάστε το έργο σας για το Codex
  2. Βήμα 1: Η πρόσβασή σας στο Codex
  3. Βήμα 2: Εγκατάσταση της επέκτασης του επεξεργαστή
  4. Βήμα 3: Εγκατάσταση του CLI
  5. Το αρχείο AGENTS.md—ο οδηγός του έργου σας
  6. Βέλτιστες πρακτικές για το AGENTS.md
  7. Βασικά σημεία

Ενημερώθηκε στις 3 Νοεμβρίου 2026 με βάση την τεκμηρίωση του Codex (Codex CLI, Πιστοποίηση, Επέκταση IDE Codex, Προσαρμοσμένες οδηγίες με AGENTS.md): το πακέτο @openai/codex-cli και η εντολή codex auth login δεν υπάρχουν (χρησιμοποιήστε npm install -g @openai/codex και codex login)· το αναγνωριστικό της επέκτασης είναι openai.chatgpt· η διεύθυνση codex.openai.com και τα προγράμματα “Team, Enterprise, ή API” έχουν αντικατασταθεί από τις τρέχουσες μεθόδους πρόσβασης· και η σειρά ανάγνωσης του AGENTS.md έχει διευκρινιστεί (ρίζα έργου → τρέχων κατάλογος). Πηγές: Codex CLI · Πιστοποίηση · AGENTS.md · Τιμολόγηση.

Προετοιμάστε το έργο σας για το Codex

Δύο πράγματα πρέπει να είναι έτοιμα πριν από την πρώτη σας εργασία: η πρόσβασή σας στο Codex—ο λογαριασμός σας και η σύνδεση με το GitHub—και το ίδιο το έργο σας, το οποίο ορίζεται μέσω του αρχείου AGENTS.md που θα καθοδηγεί τον πράκτορα. Το πρώτο μέρος διαρκεί περίπου 15 λεπτά και είναι μια ρύθμιση μίας χρήσης. Το δεύτερο καθορίζει την ποιότητα όλων όσων λαμβάνετε από το Codex, διαχωρίζοντας τις ομάδες που είναι ικανοποιημένες από το Codex από εκείνες που το βρίσκουν απογοητευτικό.

Βήμα 1: Η πρόσβασή σας στο Codex

Μπορείτε να χρησιμοποιήσετε το Codex με έναν λογαριασμό ChatGPT ή ένα κλειδί API. Τα προγράμματα Free και Go παρέχουν πρόσβαση, ανάλογα με την τρέχουσα ανάπτυξη, στο GPT-6 Luna στην εφαρμογή επιφάνειας εργασίας. Ξεκινώντας από το Plus, το Codex είναι διαθέσιμο στον ιστό, στο CLI, στην επέκταση του επεξεργαστή και στο iOS, με ενσωματώσεις cloud όπως η αυτοματοποιημένη αναθεώρηση κώδικα. Ένα κλειδί API λειτουργεί για αυτοματοποίηση σε κοινόχρηστα περιβάλλοντα όπως το CI, χρησιμοποιώντας το CLI, το SDK ή την επέκταση—αν και ορισμένες λειτουργίες ενδέχεται να μην είναι διαθέσιμες. Λεπτομέρειες και όρια χρήσης υπάρχουν στη σελίδα τιμολόγησης του Codex.

Για να εργαστείτε στο cloud στα αποθετήριά σας, συνδέστε το GitHub όταν δημιουργείτε το πρώτο σας περιβάλλον Codex Cloud (Μάθημα 2). Κατά τη χορήγηση δικαιωμάτων, κρατήστε τα στο ελάχιστο: περιορίστε την πρόσβαση μόνο στα αποθετήρια που χρειάζεστε πραγματικά.

Βήμα 2: Εγκατάσταση της επέκτασης του επεξεργαστή

Στο VS Code και στα παράγωγά του (Cursor, Windsurf), εγκαταστήστε την επέκταση Codex από την αγορά—το αναγνωριστικό της είναι openai.chatgpt:

code --install-extension openai.chatgpt

Στη συνέχεια, ανοίξτε το Codex μέσω του εικονιδίου του ή μέσω της παλέτας εντολών με Codex: Open Codex Sidebar και συνδεθείτε. Το Xcode και τα IDE της JetBrains έχουν τις δικές τους ενσωματώσεις: στο JetBrains, ανοίξτε το AI Chat και επιλέξτε το Codex.

Βήμα 3: Εγκατάσταση του CLI

# Εγκατάσταση (macOS και Linux), ή npm install -g @openai/codex
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# Επαλήθευση εγκατάστασης
codex --version

# Σύνδεση (πρόγραμμα περιήγησης), ή έλεγχος κατάστασης σύνδεσης
codex login
codex login status

Η εντολή codex login ανοίγει τη ροή σύνδεσης στο πρόγραμμα περιήγησής σας. Για ένα κλειδί API, περάστε το μέσω της τυπικής εισόδου (printenv OPENAI_API_KEY | codex login --with-api-key). Το Codex αποθηκεύει τα διαπιστευτήρια είτε σε ένα αρχείο απλού κειμένου, ~/.codex/auth.json, είτε στο σύστημα keychain, ανάλογα με τη ρύθμιση cli_auth_credentials_store (file, keyring, auto ή ephemeral). Εάν χρησιμοποιείται το αρχείο, αντιμετωπίστε το όπως έναν κωδικό πρόσβασης: περιέχει διακριτικά πρόσβασης, οπότε μην το υποβάλετε ποτέ σε έλεγχο έκδοσης (commit). Το CLI και η επέκταση κοινοποιούν αυτή την προσωρινή μνήμη.

Το αρχείο AGENTS.md—ο οδηγός του έργου σας

Το AGENTS.md είναι κεντρικό για την αποτελεσματική χρήση του Codex. Είναι ένα απλό αρχείο Markdown που τοποθετείται στη ρίζα του αποθετηρίου σας και συγκεντρώνει οδηγίες, συμβάσεις και εντολές συγκεκριμένες για το έργο σας. Όταν το Codex κλωνοποιεί το αποθετήριο, διαβάζει πρώτα αυτό το αρχείο: σκεφτείτε το ως αυτόματη εισαγωγή για τον πράκτορα, ακριβώς αυτό που θα εξηγούσατε προφορικά σε ένα νέο μέλος της ομάδας.

Ο αντίκτυπος είναι άμεσος. Χωρίς το AGENTS.md, αν ζητήσετε ένα unit test σε ένα έργο που χρησιμοποιεί το Vitest, υπάρχει μεγάλη πιθανότητα το Codex να σας δώσει Jest, επειδή αυτή είναι η πιο κοινή επιλογή στο οικοσύστημα. Μια μόνο γραμμή σύμβασης αρκεί για να λάβετε σωστά το Vitest από την πρώτη φορά, γλιτώνοντάς σας από το να κάνετε την ίδια διόρθωση εκατό φορές. Ακολουθεί η δομή ενός βασικού αρχείου για ένα έργο διαχείρισης τιμολογίων SaaS.

# AGENTS.md

## Πλαίσιο έργου
Εφαρμογή διαχείρισης τιμολογίων SaaS.
Stack: Next.js 15, TypeScript, Prisma, PostgreSQL.

## Συμβάσεις κώδικα
- Χρήση λειτουργικών components React (όχι classes)
- Ονομασία αρχείων σε kebab-case
- Τύποι TypeScript σε ξεχωριστά αρχεία .types.ts
- Tests με Vitest, αρχεία .test.ts δίπλα στον κώδικα

## Χρήσιμες εντολές
- `npm run dev` — διακομιστής ανάπτυξης
- `npm run test` — εκτέλεση tests
- `npm run lint` — έλεγχος linting
- `npm run build` — build παραγωγής

## Δομή έργου
    src/
      app/          → Σελίδες Next.js (App Router)
      components/   → Επαναχρησιμοποιούμενα components React
      lib/          → Επιχειρηματική λογική και utilities
      prisma/       → Σχήμα DB και migrations

## Αυστηροί κανόνες
- ΠΟΤΕ μην τροποποιείτε το σχήμα Prisma χωρίς migration
- ΠΟΤΕ μην κάνετε commit αρχεία .env
- Πάντα να χρησιμοποιείτε Server Actions για mutations

Πώς βρίσκει το Codex τα αρχεία AGENTS.md

Ένα μόνο αρχείο στη ρίζα γίνεται γρήγορα πολύ γενικό. Το Codex σας επιτρέπει να στοιχίζετε οδηγίες με μια ακριβή σειρά που πρέπει να γνωρίζετε:

  1. Παγκόσμιο επίπεδο: Στον φάκελο Codex (~/.codex, εκτός εάν το CODEX_HOME το παρακάμπτει), το Codex διαβάζει το AGENTS.override.md αν υπάρχει, διαφορετικά το AGENTS.md.
  2. Επίπεδο έργου: Ξεκινώντας από τη ρίζα του έργου (συνήθως η ρίζα Git), το Codex κατεβαίνει στον τρέχοντα κατάλογο και διαβάζει, σε κάθε φάκελο που διασχίζει, το AGENTS.override.md ή, ελλείψει αυτού, το AGENTS.md.
  3. Συγχώνευση: Τα αρχεία συνενώνονται από τη ρίζα προς τον τρέχοντα κατάλογο· εκείνα που βρίσκονται πιο κοντά στον τρέχοντα κατάλογο έρχονται τελευταία και επομένως παρακάμπτουν τις πιο γενικές οδηγίες.
my-project/
  AGENTS.md              → Οδηγίες έργου
  src/
    api/
      AGENTS.md          → "Οι διαδρομές API χρησιμοποιούν Zod για επικύρωση"

Πρακτική συνέπεια: το src/api/AGENTS.md διαβάζεται μόνο εάν το Codex εργάζεται από το src/api ή έναν από τους υποκαταλόγους του, όχι όταν εκκινείται από τη ρίζα. Τα κενά αρχεία αγνοούνται και η συνένωση σταματά στα 32 KiB από προεπιλογή (project_doc_max_bytes). Εάν το αποθετήριό σας χρησιμοποιεί ήδη άλλο όνομα, όπως TEAM_GUIDE.md, προσθέστε το στο project_doc_fallback_filenames στο ~/.codex/config.toml.

Για να επαληθεύσετε τι έχει φορτώσει πραγματικά το Codex, απλώς ρωτήστε: codex --ask-for-approval never "Summarize the current instructions.". Το Codex ξαναχτίζει την αλυσίδα οδηγιών σε κάθε εκκίνηση: αν έχετε αμφιβολίες, επανεκκινήστε το στον σωστό κατάλογο.

Βέλτιστες πρακτικές για το AGENTS.md

Η καθοδηγητική αρχή είναι η σαφήνεια. Το “Χρησιμοποιήστε Vitest, όχι Jest” είναι καλύτερο από το “Χρησιμοποιήστε το framework test μας”, το οποίο προϋποθέτει γνώσεις που ο πράκτορας δεν διαθέτει. Να συμπεριλαμβάνετε πάντα εντολές: χωρίς αυτές, το Codex δεν θα ξέρει πώς να εκτελέσει τα tests, το linter ή το build σας, και θα παραδώσει κώδικα που δεν θα μπορούσε να επαληθεύσει. Τεκμηριώστε τη δομή ως δέντρο καταλόγων, κάτι που εμποδίζει την τυφλή εξερεύνηση και τη δημιουργία αρχείων σε λάθος μέρος.

Τέλος, καταγράψτε τις απαγορεύσεις. Οι κανόνες γραμμένοι ως “ΠΟΤΕ” (NEVER) είναι οι πιο αποδοτικοί στο αρχείο, επειδή μπλοκάρουν ακριβά λάθη που είναι δύσκολο να διορθωθούν: commit ενός αρχείου .env, τροποποίηση σχήματος χωρίς migration. Η πιο δύσκολη πειθαρχία είναι η διατήρηση του αρχείου ενημερωμένου. Ένα AGENTS.md που περιγράφει το έργο του περασμένου έτους κατευθύνει ενεργά το Codex προς εγκαταλελειμμένες συμβάσεις—πολύ χειρότερα από το να μην υπάρχει καθόλου αρχείο, καθώς τότε το σφάλμα γίνεται συστηματικό.

Βασικά σημεία

  • Η αρχική ρύθμιση απαιτεί έναν λογαριασμό OpenAI και μια σύνδεση GitHub
  • Η επέκταση IDE και το CLI εγκαθίστανται σε λίγα λεπτά
  • Το AGENTS.md είναι το πιο σημαντικό αρχείο για την αποτελεσματική χρήση του Codex
  • Περιέχει συμβάσεις, εντολές και κανόνες συγκεκριμένους για το έργο σας
  • Τα αρχεία AGENTS.md στους υποκαταλόγους επιτρέπουν πλαισιακές οδηγίες