Εγκατάσταση του OpenCode και ρύθμιση του OmniProxy

Το OpenCode είναι ένας βοηθός κωδικοποίησης ανοιχτού κώδικα που σας επιτρέπει να γράφετε κώδικα από τερματικό, IDE ή επιφάνεια εργασίας. Δεν αποθηκεύει τον κώδικα ή το πλαίσιο σας, καθιστώντας το κατάλληλο για έργα με ευαίσθητα δεδομένα ιδιωτικότητας. build χρησιμοποιείται για την τροποποίηση ενός έργου, ενώ το plan είναι μόνο για ανάγνωση από προεπιλογή και είναι χρήσιμο για την κατανόηση άγνωστου κώδικα και τον σχεδιασμό αλλαγών πριν από την πραγματοποίησή τους. Μπορείτε να επιλέξετε μια υπηρεσία μοντέλου με βάση τις ανάγκες σας.

Πριν ξεκινήσετε

Το σενάριο εγκατάστασης είναι η ευκολότερη επιλογή. Χρειάζεστε ένα σύγχρονο τερματικό—μια εφαρμογή τερματικού που μπορεί να εκτελεί εντολές και να εργάζεται με αρχεία έργου—όπως το WezTerm, το Alacritty, το Ghostty ή το Kitty. Στα Windows, προτιμάται το WSL. Παρέχει ένα περιβάλλον Linux εντός των Windows με πληρέστερη απόδοση και λειτουργικότητα.

Ευκολότερο

Σενάριο εγκατάστασης

• curl opencode.ai/install
• Χρησιμοποιήστε απευθείας σε macOS Linux
• Το WSL προτείνεται στα Windows

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Ενημερώνεται συχνότερα από το formula
• Ένα πακέτο είναι επίσης διαθέσιμο για Arch

Εγγενή Windows

Διαχειριστής πακέτων

• choco ή scoop
• Ή εγκαταστήστε καθολικά με npm
• Μπορείτε επίσης να το κατεβάσετε από τις Εκδόσεις (Releases)

Προετοιμάστε επίσης το αναγνωριστικό μοντέλου από την τρέχουσα λίστα μοντέλων. Ένα αναγνωριστικό μοντέλου είναι το όνομα που χρησιμοποιεί η υπηρεσία για να αναγνωρίσει ένα συγκεκριμένο μοντέλο με ακρίβεια.

Εγκατάσταση και πρώτη εκκίνηση

Η ευκολότερη εντολή εγκατάστασης είναι:

curl -fsSL https://opencode.ai/install | bash

Μπορείτε επίσης να χρησιμοποιήσετε μία από αυτές τις μεθόδους εγκατάστασης:

• Node.js: npm install -g opencode-ai. Το Bun, το pnpm και το Yarn έχουν επίσης αντίστοιχες εντολές καθολικής εγκατάστασης· δείτε τη σελίδα εισαγωγής στο τέλος αυτού του οδηγού.
• Homebrew σε macOS και Linux: brew install anomalyco/tap/opencode. Χρησιμοποιήστε αυτό το tap επειδή ενημερώνεται συχνότερα από το brew install opencode, το οποίο συντηρείται από την ομάδα του Homebrew.
• Arch Linux: χρησιμοποιήστε το sudo pacman -S opencode για τη σταθερή έκδοση ή το πακέτο AUR opencode-bin για μια νεότερη έκδοση.
• Windows: χρησιμοποιήστε το choco install opencode ή scoop install opencode. Μπορείτε επίσης να χρησιμοποιήσετε το npm install -g opencode-ai. Τα δυαδικά αρχεία μπορούν επίσης να ληφθούν από τις Εκδόσεις. Η υποστήριξη για εγκατάσταση με Bun στα Windows είναι ακόμα σε εξέλιξη.

Εισαγάγετε τον κατάλογο του έργου σας και, στη συνέχεια, εκκινήστε το OpenCode:

cd /path/to/project
opencode

Όταν το χρησιμοποιείτε για πρώτη φορά, μπορείτε να εκτελέσετε /init. Αναλύει το έργο και δημιουργεί το AGENTS.md στη ρίζα του έργου. Αυτό το αρχείο μπορεί να δεσμευτεί στο Git ώστε το έργο να διατηρεί αυτές τις οδηγίες.

Λήψη τιμών σύνδεσης από το OmniProxy

baseURL: https://your-omniproxy-origin.example/v1
API Key: <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

baseURL είναι η διεύθυνση υπηρεσίας, API Key είναι το διαπιστευτήριο πρόσβασης και Model ID είναι το πλήρες όνομα του μοντέλου.

Όταν χρησιμοποιείτε το /v1/chat/completions, ορίστε το πακέτο npm σε @ai-sdk/openai-compatible. Το Chat Completions είναι ένας τύπος διεπαφής αιτήματος συνομιλίας. Μεταβείτε στο @ai-sdk/openai μόνο όταν το μοντέλο χρησιμοποιεί /v1/responses. Όταν το OmniProxy χρησιμοποιείται μέσω του τελικού σημείου chat completions, διατηρήστε το πακέτο συμβατότητας.

Αντιγράψτε ολόκληρο το αναγνωριστικό μοντέλου από την τρέχουσα λίστα του OmniProxy, συμπεριλαμβανομένων τυχόν καθέτων. Από τις 09-10-2026, δύο αναγνωριστικά αναφοράς ήταν claude-sonnet-5-5 και gpt-6-luna. gpt-6-luna υποστηρίζει Chat Completions· η κλήση συναρτήσεων μέσω Chat Completions υποστηρίζεται μόνο όταν reasoning_effort είναι none. Μην αντιγράψετε ένα αναγνωριστικό που δεν υπάρχει στη λίστα.

Εισαγωγή της διαμόρφωσης εργαλείου

Ένας Πάροχος (Provider) μπορεί να γίνει κατανοητός ως ένα σύνολο τιμών διαμόρφωσης που χρησιμοποιεί το OpenCode για να συνδεθεί σε μια υπηρεσία μοντέλου. Η τεκμηρίωση του Παρόχου αντιμετωπίζει μια υπηρεσία συμβατή με OpenAI που δεν αναφέρεται κάτω από το /connect ως προσαρμοσμένο Πάροχο. Μια υπηρεσία συμβατή με OpenAI χρησιμοποιεί την ίδια μορφή αιτήματος και μπορεί να κληθεί από τον ίδιο τύπο πελάτη.

1. Εκτελέστε το /connect στο OpenCode και μετακινηθείτε στο Other.
2. Εισαγάγετε ένα αναγνωριστικό Παρόχου. Το παρακάτω παράδειγμα χρησιμοποιεί το omniproxy. Επιλέξτε ένα αναγνωριστικό που είναι εύκολο να θυμάστε, επειδή πρέπει να χρησιμοποιήσετε το ίδιο στο αρχείο διαμόρφωσης.
3. Εισαγάγετε το API Key του OmniProxy. Αυτό το βήμα αποθηκεύει μόνο το διαπιστευτήριο· η διεύθυνση και τα μοντέλα πρέπει ακόμα να προστεθούν στο opencode.json. Το διαπιστευτήριο αποθηκεύεται στο ~/.local/share/opencode/auth.json.
4. Δημιουργήστε ή τροποποιήστε το opencode.json στον κατάλογο του έργου:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniproxy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniProxy",
      "options": {
        "baseURL": "https://your-omniproxy-origin.example/v1"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "gpt-6-luna": { "name": "GPT-6 Luna" }
      }
    }
  }
}

5. Εκτελέστε το /models. Ο προσαρμοσμένος Πάροχος και τα μοντέλα του θα εμφανιστούν στη λίστα.

Το αναγνωριστικό που εισήχθη κάτω από το /connect πρέπει να ταιριάζει με το κλειδί στο opencode.json. Μην βάζετε ένα πραγματικό μυστικό κλειδί σε αυτό το αρχείο. Εάν δεν χρησιμοποιείτε το /connect, μπορείτε να χρησιμοποιήσετε σύνταξη μεταβλητής περιβάλλοντος στο options.apiKey, όπως το {env:VARIABLE_NAME}. Κατά τη δοκιμή στις 09-10-2026 με το OpenCode 1.18.34, η τοποθέτηση του κλειδιού απευθείας στο options.apiKey του έργου χωρίς τη χρήση του /connect συνδέθηκε επίσης με επιτυχία. Εάν το gateway δεν επικυρώνει το κλειδί, αυτή η τιμή μπορεί να είναι μια συμβολοσειρά κράτησης θέσης που χρησιμοποιείται μόνο στον τοπικό υπολογιστή. Τα κλειδιά κάτω από το models πρέπει να χρησιμοποιούν τα πλήρη αναγνωριστικά από τη λίστα.

Κλειδί

/connect

• Επιλέξτε Other στο κάτω μέρος
• Επιλέξτε το δικό σας αναγνωριστικό Παρόχου
• Αποθηκεύεται στο auth.json

Έργο

opencode.json

• Το κλειδί παρόχου πρέπει να χρησιμοποιεί το ίδιο όνομα
• Χρησιμοποιήστε ένα συμβατό πακέτο npm
• Το baseURL τελειώνει με /v1

Επιλογή

/models

• Το μοντέλο εμφανίζεται στη λίστα
• Επιλέξτε ένα πριν κάνετε μια ερώτηση
• Χρησιμοποιήστε το αναγνωριστικό από τη λίστα gateway

Επαλήθευση με μια πραγματική εργασία

Εκτελέστε πρώτα μια πραγματική εργασία από τον κατάλογο του έργου. Η μορφή αναφοράς μοντέλου είναι Provider ID/model ID; διατηρήστε τυχόν καθέτους εντός του αναγνωριστικού μοντέλου:

opencode run --model omniproxy/claude-sonnet-5-5 --auto "Explain what a file you specify does. Do not modify the file."

--auto επιτρέπει σε αυτήν την εκτέλεση να χρησιμοποιεί εργαλεία όπως εργαλεία ανάγνωσης αρχείων. Κατά τη δοκιμή στις 09-10-2026 με το OpenCode 1.18.34, διάβασε με επιτυχία τα περιεχόμενα του καθορισμένου αρχείου. Η πρώτη εκτέλεση διήρκεσε περίπου δύο λεπτά.

Για διαδραστική χρήση, εκτελέστε το opencode, στη συνέχεια επιλέξτε ένα μοντέλο με το /models. Μπορείτε να χρησιμοποιήσετε το @ για αναζήτηση αρχείων. Χρησιμοποιήστε το opencode auth list για να επιβεβαιώσετε το διαπιστευτήριο που αποθηκεύτηκε μέσω του /connect, στη συνέχεια ελέγξτε τα αρχεία αιτημάτων του OmniProxy για να επαληθεύσετε την πηγή και το αναγνωριστικό μοντέλου.

Εκκίνηση

Το opencode εκκινείται

• Πρώτα cd στον κατάλογο του έργου
• Το auth list εμφανίζει το αναγνωριστικό
• Το αρχείο διαμόρφωσης βρίσκεται στο έργο

Εργασία

Διάβασε τον κώδικα

• Ρωτήστε για ένα συγκεκριμένο αρχείο
• Επανεξετάστε την εξήγησή του
• Χρησιμοποιήστε /undo αν είναι λάθος

Αρχεία καταγραφής (Logs)

Ορατό στο gateway

• Η πηγή είναι το OpenCode
• Το Model ID ταιριάζει
• Μην δεσμεύετε το κλειδί

Κοινά σφάλματα

• Το OmniProxy δεν εμφανίζεται κάτω από το /models: Ελέγξτε ότι το αναγνωριστικό που εισήχθη κάτω από το /connect ταιριάζει με το κλειδί στο opencode.json, ότι το npm έχει οριστεί σε @ai-sdk/openai-compatible, και ότι το baseURL τελειώνει με /v1.
• Το διαπιστευτήριο λείπει: Εκτελέστε το opencode auth list. Πάροχοι όπως το Bedrock που βασίζονται σε μεταβλητές περιβάλλοντος δεν εμφανίζονται εδώ· ένας προσαρμοσμένος Πάροχος που έχει ρυθμιστεί μέσω του /connect θα πρέπει να είναι ορατός.
• Η λειτουργικότητα των Windows είναι ελλιπής: Χρησιμοποιήστε το σενάριο εγκατάστασης εντός του WSL.
• Το αναγνωριστικό μοντέλου είναι άκυρο: Αντιγράψτε το ξανά από την τρέχουσα λίστα του OmniProxy και ενημερώστε το αντίστοιχο κλειδί κάτω από το models.
• Τα αιτήματα πηγαίνουν στο λάθος τελικό σημείο: Διατηρήστε το @ai-sdk/openai-compatible για chat completions. Μην αλλάζετε το πακέτο για τη διεπαφή Αποκρίσεων (Responses) εκτός εάν αυτό το μοντέλο στο OmniProxy χρησιμοποιεί πραγματικά το /v1/responses.

Επίσημες αναφορές

Για την εγκατάσταση, δείτε την OpenCode introduction. Για προσαρμοσμένους Παρόχους, δείτε Providers. Για τα αναγνωριστικά μοντέλων που χρησιμοποιούνται στα παραδείγματα, δείτε το Claude model overview και GPT-6 Luna.

Αντικαταστήστε κάθε θέση με τιμές από τη δική σας ρύθμιση OmniProxy. Ποτέ μην δημοσιεύετε πραγματικό κλειδί.

Ένα αποθηκευμένο αποτέλεσμα ή HTTP 200 μόνο του δεν αποδεικνύει πλήρη συμβατότητα Πράκτορα. Ελέγξτε την πηγή και το μοντέλο στην καταγραφή κλήσεων του OmniProxy.

Επίσημες πηγές · OpenCode ↗