Εντολές & Ρυθμίσεις του OpenAI Codex CLI (Cheat Sheet)

Το OpenAI Codex CLI είναι ο εγγενής πράκτορας προγραμματισμού τερματικού της OpenAI που επιθεωρεί βάσεις κώδικα, επεξεργάζεται αρχεία, εκτελεί δοκιμές, ενσωματώνεται με απομακρυσμένες εργασίες Codex Cloud και συνδέεται με εξωτερικά εργαλεία μέσω MCP απευθείας από τη γραμμή εντολών.

Αυτός ο οδηγός αναφοράς καλύπτει τις υποεντολές και παραμέτρους του Codex CLI, τις πολιτικές sandbox και έγκρισης, τις διαδραστικές εντολές slash του TUI, τις συντομεύσεις πληκτρολογίου και τη διαμόρφωση των config.toml / AGENTS.md.

🔗 Σχετικοί Οδηγοί Αναφοράς: Σύγκριση Εργαλείων AI Προγραμματισμού Τερματικού · Οδηγός Claude Code CLI · Οδηγός Antigravity CLI (agy) · Οδηγός Μηχανικής AI Agent Harness

1. Εγκατάσταση, Έλεγχος Ταυτότητας & Βασικές Εντολές CLI

1.1 Εγκατάσταση & Έλεγχος Ταυτότητας

Ενέργεια	Εντολή	Σημειώσεις
Καθολική εγκατάσταση npm	`npm install -g @openai/codex`	Τυπική διαπλατφορμική εγκατάσταση
Επίσημο σενάριο εγκατάστασης	`curl -fsSL https://chatgpt.com/codex/install.sh \| sh`	Εγκατάσταση μίας γραμμής για macOS / Linux
Σύνδεση μέσω προγράμματος περιήγησης	`codex login`	Έλεγχος ταυτότητας με λογαριασμό ChatGPT Plus / Pro / Team
Έλεγχος ταυτότητας με API key	`export OPENAI_API_KEY="sk-..."`	Ιδανικό για περιβάλλοντα headless CI ή containers

1.2 Υποεντολές CLI & Καθολικές Παράμετροι

Εντολή / Παράμετρος	Περιγραφή	Παράδειγμα Χρήσης
`codex`	Εκκίνηση του διαδραστικού TUI στον τρέχοντα κατάλογο	`codex`
`codex "prompt"`	Έναρξη διαδραστικής συνεδρίας με αρχική προτροπή	`codex "Debug 500 timeout errors on login"`
`codex exec` / `codex e`	Μη διαδραστική (headless) εκτέλεση για scripts και CI	`codex exec "Run all unit tests and fix failures"`
`codex exec --json`	Ροή δομημένων αρχείων καταγραφής JSON για συλλογισμό και επεξεργασίες	`codex exec --json "Refactor utils" > run.jsonl`
`codex review`	Μη διαδραστικός έλεγχος κώδικα στο τρέχον Git diff	`codex review`
`codex resume`	Άνοιγμα επιλογέα συνεδριών (αποθηκεύονται στο `~/.codex/sessions/`)	`codex resume` / `codex resume --last` / `codex resume <id>`
`codex apply` / `codex a`	Εφαρμογή diffs από εργασίες Codex Cloud στον τοπικό χώρο εργασίας	`codex apply <task_id>`
`codex cloud`	Επιθεώρηση ή διαχείριση απομακρυσμένων εργασιών Codex Cloud	`codex cloud`
`codex mcp`	Διαχείριση συνδέσεων διακομιστών Model Context Protocol (MCP)	`codex mcp list` / `codex mcp add <name> ...`
`-m, --model <name>`	Καθορισμός του υποκείμενου μοντέλου για τη συνεδρία ή εκτέλεση	`codex -m gpt-6.1-sol`
`--strict-config`	Αυστηρή επικύρωση της σύνταξης και των κλειδιών του `config.toml`	`codex --strict-config`

2. Πίνακας Πολιτικών Sandbox & Έγκρισης

Το Codex CLI διαχωρίζει τα δικαιώματα σε δύο ορθογώνια επίπεδα: τι μπορεί να αγγίξει το περιβάλλον (--sandbox) και πότε να ζητά επιβεβαίωση από τον χρήστη (--ask-for-approval).

Παράμετρος	Έγκυρες Τιμές	Συμπεριφορά & Προτεινόμενη Χρήση
`--sandbox <mode>` (ψευδώνυμο `-s`)	`read-only`	Μόνο για ανάγνωση: επιθεώρηση και αναζήτηση κώδικα χωρίς τροποποίηση αρχείων
	`workspace-write`	Εγγραφή στον χώρο εργασίας (Προτεινόμενη προεπιλογή): επιτρέπει αλλαγές μόνο εντός του δέντρου εργασίας
	`danger-full-access`	Απεριόριστη πρόσβαση: πλήρης πρόσβαση σε σύστημα αρχείων/σύστημα (μόνο σε απομονωμένα containers)
`--ask-for-approval <policy>`	`on-request`	Προτεινόμενη προεπιλογή: το μοντέλο ζητά επιβεβαίωση όταν το απαιτούν επικίνδυνες ενέργειες
	`on-failure`	Κλιμάκωση μόνο σε αποτυχία (χρησιμοποιήστε `on-request` αν σας ενδιαφέρουν οι προτροπές ανύψωσης sandbox)
	`never`	Πλήρως αθόρυβη λειτουργία: καμία διαδραστική ερώτηση (για CI / αυτοματοποιημένα pipelines)

⚠️ Ειδοποίηση Παρωχημένων & Αποσυρμένων Παραμέτρων:

Η παράμετρος --full-auto είναι παρωχημένη (deprecated) από την έκδοση v0.128.0. Ορίστε ρητά τις πολιτικές sandbox και έγκρισης: codex --sandbox workspace-write --ask-for-approval on-request "Fix failing tests"

Η πολιτική έγκρισης untrusted αποσύρθηκε στην έκδοση v0.149.0· μεταφέρετε τις ρυθμίσεις σας στο on-request.

3. Διαδραστικές Εντολές Slash του TUI

Πληκτρολογήστε / μέσα στη γραμμή εντολών του διαδραστικού TUI του codex για να ελέγξετε συμφραζόμενα, δικαιώματα και ροές εργασίας:

3.1 Συμφραζόμενα, Μοντέλα & Δικαιώματα

Εντολή	Λειτουργία	Σημειώσεις & Χρήση
`/init`	Δημιουργία αρχικού `AGENTS.md` προσαρμοσμένου στο αποθετήριο	Προτεινόμενο πρώτο βήμα σε νέο έργο
`/status`	Επιθεώρηση ενεργού μοντέλου, δικαιωμάτων και κατανάλωσης tokens	Παρακολούθηση υπολειπόμενης χωρητικότητας context
`/model`	Διαδραστική εναλλαγή μοντέλου και επιπέδου Reasoning Effort	Ρύθμιση βάθους συλλογισμού χωρίς επανεκκίνηση
`/permissions`	Προσαρμογή λειτουργίας sandbox και πολιτικής έγκρισης στη μέση της συνεδρίας	Αυστηροποίηση ή χαλάρωση δικαιωμάτων κατά απαίτηση
`/mcp`	Επιθεώρηση και διαχείριση συνδεδεμένων διακομιστών MCP	Επαλήθευση συνδεσιμότητας εξωτερικών εργαλείων και ΒΔ

3.2 Ροές Εργασίας Μηχανικής & Έλεγχος Συνεδρίας

Εντολή	Λειτουργία	Σημειώσεις & Χρήση
`/plan`	Σύνταξη και έλεγχος σχεδίου υλοποίησης πριν την επεξεργασία αρχείων	Ευθυγράμμιση αρχιτεκτονικής πριν από μεγάλα refactors
`/review`	Εκτέλεση ελέγχου κώδικα πολλαπλών προοπτικών σε μη καταχωρισμένες αλλαγές	Εντοπισμός σφαλμάτων, οριακών περιπτώσεων και κινδύνων ασφαλείας
`/diff`	Επιθεώρηση τρεχουσών μη καταχωρισμένων τροποποιήσεων αρχείων	Έλεγχος diffs γραμμή προς γραμμή πριν την αποδοχή
`/fork`	Διακλάδωση του νήματος συνομιλίας σε ξεχωριστό σημείο ελέγχου	Διερεύνηση εναλλακτικής προσέγγισης χωρίς ρύπανση του κύριου context
`/compact`	Σύνοψη ιστορικού συνομιλίας για ανάκτηση χώρου συμφραζομένων	Αποτροπή απόκλισης σε μακρές συνεδρίες πολλαπλών γύρων
`/copy`	Αντιγραφή της τελευταίας ολοκληρωμένης απάντησης στο πρόχειρο	Γρήγορη εξαγωγή patches ή περιλήψεων
`/title`	Μετονομασία του τρέχοντος νήματος συνομιλίας	Διευκολύνει την εύρεση συνεδριών στο `codex resume`
`/statusline` / `/theme`	Προσαρμογή στοιχείων κατάστασης υποσέλιδου ή χρωματικού θέματος TUI	Εξατομίκευση εμφάνισης τερματικού
`/prompts:<name>`	Κλήση προσαρμοσμένου προτύπου προτροπής Markdown	Εκτελεί το `~/.codex/prompts/<name>.md`

4. Συντομεύσεις Πληκτρολογίου Τερματικού & Σύνταξη Εισόδου

Συντόμευση / Σύνταξη	Ενέργεια	Αποτέλεσμα & Σενάριο
`@<path>`	Ασαφής αναφορά αρχείου	Ενσωμάτωση περιεχομένου αρχείου επιτόπου (π.χ. `@src/auth.ts`)
`!<command>`	Ενσωματωμένη τοπική εντολή shell	Εκτέλεση εντολών shell εντός των ενεργών κανόνων sandbox (π.χ. `!npm test`)
`Tab`	Προσθήκη επόμενης προτροπής στην ουρά	Προγραμματισμός επόμενης προτροπής, slash command ή εντολής `!` όσο εργάζεται το Codex
`Enter`	Διακοπή / καθοδήγηση κατά την εκτέλεση	Εισαγωγή πρόσθετων οδηγιών ενώ ο πράκτορας απαντά ενεργά
`Ctrl + G`	Άνοιγμα εξωτερικού επεξεργαστή	Σύνταξη προτροπών πολλαπλών γραμμών στο `$VISUAL` / `$EDITOR` (Vim, VS Code κ.λπ.)
`Ctrl + R`	Αναζήτηση ιστορικού προτροπών	Αντίστροφη αναζήτηση προηγούμενων προτροπών που υποβλήθηκαν
`Ctrl + L`	Εκκαθάριση & επανασχεδίαση οθόνης	Καθαρισμός τερματικού διατηρώντας την κατάσταση συνομιλίας
`Ctrl + O`	Αντιγραφή τελευταίας εξόδου	Ισοδύναμο με το `/copy`
`Ctrl + X`	Άνοιγμα μενού πληκτρολογίου	Πρόσβαση σε προεπιλογές πληκτρολογίου και επεκτάσεις
`Ctrl + C`	Ακύρωση / Έξοδος	Διακοπή ενεργής εργασίας ή έξοδος από τη συνεδρία Codex

5. Αρχεία Ρύθμισης & Ιεραρχία Μνήμης (`config.toml` & `AGENTS.md`)

Οι ρυθμίσεις σε επίπεδο έργου υπερισχύουν των καθολικών προεπιλογών χρήστη:

Επίπεδο	Καθολική Εμβέλεια (Όλα τα Repos)	Εμβέλεια Έργου (Τρέχον Repo)	Σκοπός
Βασική ρύθμιση	`~/.codex/config.toml`	`.codex/config.toml`	Προεπιλεγμένο μοντέλο, sandbox, πολιτική έγκρισης, διακόπτης δικτύου, MCP
Οδηγίες πράκτορα	`~/.codex/AGENTS.md`	`./AGENTS.md` (ρίζα repo)	Εντολές build/test, πρότυπα κώδικα, κανόνες αρχιτεκτονικής
Προσαρμοσμένες προτροπές	`~/.codex/prompts/*.md`	—	Επαναχρησιμοποιήσιμα πρότυπα εντολών slash `/prompts:<name>`
Αρχεία καταγραφής συνεδριών	`~/.codex/sessions/`	—	Μόνιμα αρχεία καταγραφής που επαναφέρονται με `codex resume`

Ελάχιστο Προτεινόμενο `~/.codex/config.toml`

# Προεπιλεγμένο μοντέλο
model = "gpt-6.1-sol"

# Προεπιλεγμένη λειτουργία sandbox και πολιτική έγκρισης
sandbox_mode = "workspace-write"
approval_policy = "on-request"

# Περιορισμός εξερχόμενης πρόσβασης δικτύου εντός sandbox από προεπιλογή
network_access = false