Κλειδί API και Μεταβλητές Περιβάλλοντος
Σε αυτήν τη σελίδα
Το μάθημα ενημερώθηκε στις 2 Νοεμβρίου 2026 με βάση τα Κλειδιά API και προφίλ: το κλειδί που εισάγετε κατά την εγκατάσταση αποθηκεύεται στο σύστημα διαχείρισης κλειδιών (keychain) του συστήματος (το αρχείο
~/.vibe/.envλειτουργεί μόνο ως εφεδρεία), η σύνδεση μέσω προγράμματος περιήγησης προσφέρεται από προεπιλογή, και οι εντολές/statusή/whoamiυποδεικνύουν την πηγή που χρησιμοποιείται. Πηγή: API keys and profiles.
Αποκτήστε το Κλειδί API της Mistral
Για να χρησιμοποιήσετε το Vibe, χρειάζεστε ένα κλειδί API της Mistral. Αυτό το κλειδί πιστοποιεί τα αιτήματά σας και επιτρέπει στο Vibe να επικοινωνεί με τα μοντέλα της Mistral. Χωρίς αυτό, το εργαλείο εγκαθίσταται και εκκινείται, αλλά δεν είναι δυνατή καμία δημιουργία περιεχομένου. Δημιουργείτε το κλειδί στην Κονσόλα της Mistral σε έξι βήματα:
- Μεταβείτε στο console.mistral.ai
- Δημιουργήστε έναν λογαριασμό ή συνδεθείτε
- Πλοηγηθείτε στην ενότητα API Keys
- Κάντε κλικ στο Create new key
- Δώστε του ένα περιγραφικό όνομα (π.χ. “vibe-cli-dev”)
- Αντιγράψτε το κλειδί αμέσως—δεν θα εμφανιστεί ξανά
Αυτό το τελευταίο σημείο δεν είναι τυπικότητα: το κλειδί είναι ορατό μόνο μία φορά. Αν κλείσετε την καρτέλα πολύ γρήγορα, θα πρέπει να δημιουργήσετε ένα νέο. Το κλειδί ακολουθεί τη μορφή sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx και πρέπει να παραμείνει εμπιστευτικό. Όποιος το κατέχει μπορεί να χρησιμοποιήσει το όριο χρήσης (quota) του API σας—και συνεπώς να δαπανήσει τον προϋπολογισμό σας.
Τρεις Μέθοδοι Διαμόρφωσης
Το Vibe δέχεται τρεις τρόπους παροχής αυτού του κλειδιού. Η επιλογή σας εξαρτάται αποκλειστικά από το περιβάλλον εργασίας σας.
Μέθοδος 1: Διαδραστική Ρύθμιση
Αυτή είναι η προεπιλεγμένη μέθοδος κατά την πρώτη εκκίνηση και η απλούστερη για έναν προσωπικό σταθμό εργασίας. Το Vibe ζητά απευθείας το κλειδί σας και το αποθηκεύει:
vibe
# → "Please enter your Mistral API key:"
# Επικολλήστε το κλειδί σας, πατήστε Enter
Το κλειδί αποθηκεύεται στο σύστημα διαχείρισης κλειδιών (keychain) του συστήματός σας (macOS Keychain, Windows Credential Manager…). Αν δεν υπάρχει διαθέσιμο σύστημα διαχείρισης κλειδιών, γίνεται χρήση του αρχείου εφεδρείας ~/.vibe/.env, το οποίο είναι αναγνώσιμο μόνο από εσάς. Σημειώστε ότι κατά την πρώτη εκκίνηση, η σύνδεση μέσω του προγράμματος περιήγησης με τον λογαριασμό Mistral συχνά καταργεί την ανάγκη για κλειδί. Για να δείτε ποια πηγή χρησιμοποιεί πραγματικά το Vibe, πληκτρολογήστε /status ή /whoami κατά τη διάρκεια μιας συνεδρίας.
# Αν το κλειδί βρίσκεται στο αρχείο .env (δεν υπάρχει διαθέσιμο keychain)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...
Μέθοδος 2: Μεταβλητή Περιβάλλοντος
Μόλις απομακρυνθείτε από το περιβάλλον του προσωπικού σταθμού εργασίας—όπως σε μια γραμμή CI/CD, ένα αυτοματοποιημένο σενάριο ή έναν κοινόχρηστο διακομιστή—μια μεταβλητή περιβάλλοντος γίνεται προτιμότερη, καθώς δεν γράφει τίποτα στον δίσκο:
export MISTRAL_API_KEY="sk-your-key-here"
Για να την κάνετε μόνιμη στο μηχάνημά σας, προσθέστε αυτή τη γραμμή στο αρχείο διαμόρφωσης του κελύφους (shell) σας:
# Στο ~/.bashrc, ~/.zshrc, ή ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"
Η μεταβλητή περιβάλλοντος έχει προτεραιότητα έναντι του αρχείου .env. Αυτό επιτρέπει ένα πολύ πρακτικό μοτίβο χρήσης: την προσωρινή εναλλαγή κλειδιών χωρίς μόνιμες αλλαγές. Μπορείτε να εργάζεστε με το κλειδί ανάπτυξης και στη συνέχεια να προτάξετε ένα διαφορετικό κλειδί σε μία μόνο εντολή για μια ευαίσθητη λειτουργία:
# Κλειδί ανάπτυξης
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"
# Κλειδί παραγωγής (προσωρινό)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"
Μέθοδος 3: Αρχείο config.toml
Τέλος, μπορείτε να αναφέρετε τη μεταβλητή περιβάλλοντος στο αρχείο διαμόρφωσης TOML του Vibe:
# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"
Σημειώστε ότι αυτή η παράμετρος δεν περιέχει το ίδιο το κλειδί, αλλά μόνο το όνομα της μεταβλητής που πρέπει να διαβαστεί. Αυτή η έμμεση αναφορά έχει νόημα όταν εργάζεστε με πολλούς παρόχους, ο καθένας με τη δική του μεταβλητή: το api_key_env_var λέει στο Vibe ποια να χρησιμοποιήσει για το προεπιλεγμένο κλειδί.
Σειρά Προτεραιότητας
Όταν διαμορφώνονται ταυτόχρονα πολλές μέθοδοι, το Vibe εφαρμόζει την εξής σειρά:
- Μεταβλητή περιβάλλοντος
MISTRAL_API_KEY(αν ορίζεται στο κέλυφος) - Αρχείο
.envστο~/.vibe/.env - Σύστημα διαχείρισης κλειδιών (System keychain), όπου ο οδηγός ρύθμισης αποθηκεύει το κλειδί
Για έναν προσαρμοσμένο πάροχο, το api_key_env_var στο config.toml απλώς ορίζει τη μεταβλητή που θα διαβαστεί, ακολουθώντας την ίδια σειρά.
Θυμηθείτε την πρώτη γραμμή παραπάνω: αν ένα αίτημα αποτύχει στην πιστοποίηση παρόλο που το .env σας περιέχει ένα έγκυρο κλειδί, ελέγξτε πρώτα αν κάποια παλιά μεταβλητή παραμένει στο κέλυφός σας και την αντικαθιστά.
Ασφάλεια Κλειδιού API
Ο πρώτος κανόνας είναι να μην κάνετε ποτέ commit το κλειδί σας σε ένα αποθετήριο Git. Προσθέστε το .env στο .gitignore πριν καν δημιουργήσετε το αρχείο. Ένα μυστικό που ωθείται σε ένα δημόσιο αποθετήριο θεωρείται compromised (διαρρευσμένο), ακόμα και αν διαγράψετε το commit αργότερα. Με την ίδια λογική, μην κοινοποιείτε το κλειδί σας σε απλό κείμενο σε μήνυμα ή έγγραφο. Αν υποψιάζεστε διαρροή, regenerate (δημιουργήστε ξανά) το αμέσως.
Οργανωτικά, χρησιμοποιήστε ξεχωριστά κλειδιά για ανάπτυξη και παραγωγή. Αν το ένα διαρρεύσει, μπορείτε να το ανακαλέσετε χωρίς να διακόψετε το άλλο. Τέλος, ορίστε όρια δαπανών στην Κονσόλα της Mistral. Αυτό είναι το πιο αποτελεσματικό δίχτυ ασφαλείας against (ενάντια σε) ένα σενάριο που εκτελείται σε βρόχο ή ένα εκτεθειμένο κλειδί: η χρέωση σταματά αυτόματα.
Επαλήθευση Λειτουργίας Κλειδιού
Μετά τη διαμόρφωση, μην υποθέτετε τίποτα. Κάντε δοκιμή με ένα ελάχιστο αίτημα:
vibe "Say hello"
Αν το κλειδί είναι έγκυρο, το Vibe αποκρίνεται κανονικά. Αν είναι άκυρο ή έχει λήξει, θα λάβετε ένα σαφές σφάλμα πιστοποίησης, γλιτώνοντάς σας από το να ψάχνετε την αιτία στην εγκατάσταση.
Αν διαμορφώσετε πρόσθετους παρόχους όπως το OpenRouter, ο καθένας χρειάζεται τη δική του μεταβλητή. Τα δύο συνυπάρχουν χωρίς πρόβλημα:
export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"
Θα καλύψουμε λεπτομερώς τη διαμόρφωση παρόχων τρίτων στο αφιερωμένο μάθημα.
Βασικά σημεία
- Αποκτήστε το κλειδί API της Mistral στο console.mistral.ai
- Τρεις μέθοδοι διαμόρφωσης: διαδραστική ρύθμιση, μεταβλητή περιβάλλοντος, config.toml
- Η μεταβλητή περιβάλλοντος έχει προτεραιότητα έναντι του αρχείου .env
- Μην κάνετε ποτέ commit το κλειδί σας στο Git
- Ορίστε όρια δαπανών στην Κονσόλα της Mistral