Ιστολόγιο

OpenCode: εγκατάσταση, μοντέλα και πρώτη εκκίνηση

Markdown

Εγκατάσταση σε macOS, Linux και Windows, OpenCode 1.x και 2.0, σύνδεση παρόχων και Ollama, διαμόρφωση, κόστος και αντιμετώπιση προβλημάτων.

Διαβάστε ολόκληρο το άρθρο

Το OpenCode είναι ένας ανοιχτού κώδικα AI coding agent για το τερματικό: το ίδιο το εργαλείο είναι δωρεάν (άδεια MIT) και μπορείτε να συνδέσετε οποιοδήποτε μοντέλο—από Claude και GPT μέχρι ένα τοπικό μέσω Ollama. Το αποθετήριο του έργου έχει ήδη ξεπεράσει τις διακόσιες χιλιάδες αστέρες στο GitHub. Η φράση «δωρεάν Claude Code με οποιοδήποτε μοντέλο» ακούγεται ελκυστική, αλλά χρειάζεται διευκρίνιση: το εργαλείο είναι δωρεάν· οι όροι χρήσης εξαρτώνται από το μοντέλο που θα επιλέξετε.

Παρακάτω θα βρείτε τα πάντα σύμφωνα με την επίσημη τεκμηρίωση: τι είναι το εργαλείο, πώς να το εγκαταστήσετε σε macOS, Linux ή Windows, πώς να συνδέσετε ένα μοντέλο και τι να κάνετε κατά την πρώτη εκκίνηση. Υπάρχει ξεχωριστή ενότητα για το κόστος, επειδή το «δωρεάν» εδώ αφορά μόνο το εργαλείο: τα μοντέλα κοστίζουν και αυτό προκαλεί συχνότερα σύγχυση.

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

Τι είναι το OpenCode με απλά λόγια;

Κύρια σημεία

Το OpenCode είναι ένας ανοιχτού κώδικα AI coding agent (άδεια MIT) από την ομάδα Anomaly. Λειτουργεί στο τερματικό και διατίθεται επίσης ως εφαρμογή για υπολογιστές, επέκταση επεξεργαστή και έκδοση ιστού. Του λέτε τι πρέπει να γίνει σε ένα έργο και ο agent διαβάζει αρχεία, επεξεργάζεται κώδικα και εκτελεί εντολές μόνος του. Το ίδιο το εργαλείο είναι δωρεάν· συνδέετε το δικό σας μοντέλο, είτε στο cloud είτε τοπικό.

Με λίγα λόγια, το OpenCode κάνει το ίδιο πράγμα με το Claude Code: δέχεται μια εργασία σε απλή γλώσσα και την εκτελεί στο έργο σας. Διαφέρουν σε δύο σημεία. Ο κώδικας είναι πλήρως ανοιχτός, επομένως μπορείτε να τον διαβάσετε και να τον επιθεωρήσετε. Και το εργαλείο δεν είναι δεμένο με έναν μόνο πάροχο μοντέλων: λειτουργεί με 75+ παρόχους, από την Anthropic και την OpenAI έως ένα τοπικό μοντέλο που εκτελείται στο δικό σας υλικό.

Το έργο αναπτύσσεται από την ομάδα Anomaly. Το αποθετήριο δημιουργήθηκε στις April 30, 2025 και, στις October 4, 2026, έχει περισσότερες από 211 χιλιάδες αστέρες και 28 χιλιάδες forks (επαληθεύτηκε με αίτημα στο GitHub API). Η γλώσσα είναι TypeScript. Η τεκμηρίωση ενημερώνεται συνεχώς, επομένως οι παρακάτω οδηγίες βασίζονται στην τρέχουσα έκδοση.

Μην μπερδεύετε τα ονόματα: το πακέτο npm για την τρέχουσα σειρά ονομάζεται opencode-ai, το αποθετήριο είναι το anomalyco/opencode και η εντολή του τερματικού είναι απλώς opencode. Παλαιότερα άρθρα μπορεί να χρησιμοποιούν τη διεύθυνση sst/opencode: ο οργανισμός άλλαξε όνομα και ο παλιός σύνδεσμος τώρα ανακατευθύνει στον νέο.

Ενημερώθηκε στις October 4, 2026: η ομάδα κυκλοφόρησε το OpenCode 2.0, την επόμενη μεγάλη γενιά του εργαλείου. Οι παρακάτω οδηγίες εγκατάστασης και σύνδεσης μοντέλου αφορούν ακόμη την τρέχουσα σειρά 1.x (εγκαθίσταται με την εντολή curl -fsSL https://opencode.ai/install | bash· η τρέχουσα έκδοση στις September 30, 2026 είναι 1.18.34): υποστηρίζεται ενεργά και είναι η έκδοση που εγκαθιστά η επίσημη τεκμηρίωση στο opencode.ai/docs. Το τι ακριβώς άλλαξε στη δεύτερη έκδοση και πότε να μεταβείτε σε αυτήν καλύπτεται σε ξεχωριστή ενότητα παρακάτω.

Σε τι διαφέρει το OpenCode από το Claude Code και το Codex;

Κύρια σημεία

Το Claude Code λειτουργεί μόνο με μοντέλα της Anthropic. Το Codex είναι agent της OpenAI που συνδέεται με το οικοσύστημα ChatGPT. Το OpenCode είναι ένα ανοιχτό εργαλείο χωρίς δέσμευση σε πάροχο: είναι δωρεάν και επιλέγετε μοντέλο από 75+ παρόχους, συμπεριλαμβανομένων των συνδρομών ChatGPT Plus και GitHub Copilot, καθώς και τοπικών μοντέλων.

ΧαρακτηριστικόOpenCodeClaude CodeCodex
ΚώδικαςΑνοιχτός, MITΚλειστόςΑνοιχτός
Μοντέλα75+ πάροχοι και τοπικά μοντέλαΜόνο ClaudeΜοντέλα OpenAI
Τιμή εργαλείουΔωρεάνΣυνδρομή ή tokensΣυνδρομή ChatGPT ή tokens
Πρόσβαση μέσω συνδρομήςChatGPT Plus, GitHub Copilot, GitLab DuoClaude Pro/Max (δική σας συνδρομή)ChatGPT (δική σας συνδρομή)
Πού εκτελείταιΤερματικό, υπολογιστής, επεξεργαστής, πρόγραμμα περιήγησηςΤερματικό και επεξεργαστήςΤερματικό, ιστός, επεξεργαστής
Διαμόρφωση έργουAGENTS.mdCLAUDE.mdAGENTS.md

Αν έχετε ήδη συνδρομή Claude, έχει νόημα να διατηρήσετε το Claude Code ως κύριο εργαλείο σας—έχουμε έναν αναλυτικό οδηγό εγκατάστασης γι’ αυτό. Το OpenCode έχει νόημα σε τρεις περιπτώσεις: θέλετε να εργάζεστε μέσω συνδρομής ChatGPT Plus ή GitHub Copilot, θέλετε να εκτελείτε τοπικό μοντέλο χωρίς χρεώσεις API ή θέλετε μία ενιαία διεπαφή για πολλά μοντέλα. Έχουμε επίσης έναν οδηγό αξιολόγησης και εγκατάστασης για το Codex.

Αν ακόμη επιλέγετε εργαλείο, ξεκινήστε με αυτήν την επισκόπηση: με τι προγραμματίζει ο κόσμος το 2026. Και αν έχετε ήδη εγκαταστήσει το OpenCode και πρέπει να το συνδέσετε με άλλους agents στο Devin Desktop μέσω ACP, δείτε τον οδηγό μας για αυτήν τη ρύθμιση.

Τι άλλαξε στο OpenCode 2.0;

Κύρια σημεία

Στις October 4, 2026, το OpenCode 2.0 είναι διαθέσιμο στο opencode.ai, με δικό του πρόγραμμα εγκατάστασης και το νέο πακέτο npm @opencode/cli. Η πρώτη έκδοση—αυτή που εγκαθιστά το άρθρο—δεν έχει εξαφανιστεί: είναι ξεχωριστός κλάδος V1 στην τεκμηρίωση, υποστηρίζεται ενεργά και παραμένει η προεπιλεγμένη επιλογή. Στην v2 υπάρχουν τρεις τομείς όπου οι προγραμματιστές δεν διατήρησαν σκόπιμα τη συμβατότητα με την πρώτη έκδοση: το API των πρόσθετων, το πρωτόκολλο διακομιστή και το αρχείο ρυθμίσεων του τερματικού.

Η δεύτερη έκδοση εγκαθίσταται με την εντολή curl -fsSL https://opencode.ai/v2/install | bash. Σύμφωνα με τον επίσημο οδηγό μετάβασης (opencode.ai/v2/docs/migrate-v1), και οι δύο εκδόσεις χρησιμοποιούν την ίδια εντολή opencode και δεν εγκαθίστανται πλέον παράλληλα από προεπιλογή: το πρόγραμμα εγκατάστασης της v2 αντικαθιστά το δυαδικό αρχείο της v1 και, πριν εγκαταστήσετε την v2 μέσω διαχειριστή πακέτων, η τεκμηρίωση ζητά ρητά να αφαιρέσετε πρώτα την έκδοση v1. Ωστόσο, οι ρυθμίσεις διαβάζονται από τα ίδια αρχεία—~/.config/opencode/ και <project>/.opencode/—οπότε οι ρυθμίσεις, οι agents και οι διακομιστές MCP μεταφέρονται χωρίς επανεγγραφή. Τρία πράγματα χρειάζονται επανεγγραφή: τα πρόσθετα (έχουν νέο API), οι ενσωματώσεις με το API διακομιστή (το πρωτόκολλο έχει αλλάξει) και οι ρυθμίσεις τερματικού (τώρα ένα κοινόχρηστο αρχείο cli.json αντί για πολλά αρχεία tui.json).

Τα δύο πιο αξιοσημείωτα νέα χαρακτηριστικά της v2 είναι τα εξής. Πρώτον, παρουσιάστηκε το Console—μια επί πληρωμή υπηρεσία για ομάδες με παρακολούθηση χρήσης, προϋπολογισμούς και κοινές πολιτικές για όλα τα μέλη. Δεύτερον, η ομάδα ανακοίνωσε επιτέλους την τιμή της συνδρομής Go: $10 τον μήνα για το Go και $40 τον μήνα για το Go Plus με υψηλότερα όρια (η σελίδα opencode.ai/go, επαληθεύτηκε στις October 4, 2026). Προηγουμένως, η τεκμηρίωση έλεγε απλώς «συνδρομή χαμηλού κόστους», χωρίς ποσό.

Αν είστε νέοι και απλώς θέλετε να εγκαταστήσετε τον agent, ακολουθήστε τις παρακάτω οδηγίες· καλύπτουν την τρέχουσα πρώτη έκδοση που συνιστά η ίδια η τεκμηρίωση. Εξετάστε τη v2 αν χρειάζεστε τις νέες δυνατότητες πρόσθετων ή το Console για ομάδες—αλλά να είστε έτοιμοι να επανεγγράψετε ορισμένα παλαιότερα πρόσθετα για το νέο API. Αν σας ενδιαφέρει περισσότερο μια εφαρμογή υπολογιστή ανοιχτού κώδικα που δεν απαιτεί τερματικό, έχουμε μια αξιολόγηση του ZCode, ενός ακόμη παρόμοιου agent με δική του διεπαφή.

Τι χρειάζεστε πριν από την εγκατάσταση;

Κύρια σημεία

Θα χρειαστείτε δύο πράγματα: έναν σύγχρονο εξομοιωτή τερματικού (η τεκμηρίωση αναφέρει τα WezTerm, Alacritty, Ghostty ή Kitty) και πρόσβαση σε ένα μοντέλο—ένα κλειδί API παρόχου, μια υποστηριζόμενη συνδρομή ή ένα τοπικό μοντέλο μέσω Ollama. Θα χρειαστείτε το μοντέλο μετά την εγκατάσταση: θα το συνδέσετε κατά την πρώτη εκκίνηση.

Λίγα περισσότερα για το τερματικό, επειδή είναι το μόνο σημείο όπου η εγκατάσταση μπορεί να μην πάει όπως σχεδιάστηκε. Το OpenCode εμφανίζει στο τερματικό ένα πλήρες περιβάλλον εργασίας με πλαίσια και επισήμανση, γι’ αυτό η τεκμηρίωση ζητά έναν σύγχρονο εξομοιωτή. Αν το περιβάλλον εργασίας δεν εμφανίζεται σωστά μετά την εκκίνηση, εγκαταστήστε πρώτα μία από τις τέσσερις αναφερόμενες επιλογές: WezTerm (λειτουργεί σε όλα τα συστήματα), Alacritty, Ghostty ή Kitty. Στα Windows, η βασική διαδρομή είναι μέσω WSL· υπάρχει ξεχωριστή ενότητα παρακάτω.

Το δεύτερο πράγμα είναι ένα μοντέλο. Το OpenCode λειτουργεί μέσω του μοντέλου που συνδέετε: από μόνο του δεν επεξεργάζεται αιτήματα. Υπάρχουν τέσσερις επιλογές: συνδρομή (ChatGPT Plus, GitHub Copilot, GitLab Duo), κλειδί API από οποιονδήποτε πάροχο, OpenCode Zen, ο aggregator της ίδιας της ομάδας, ή τοπικό μοντέλο μέσω Ollama. Και οι τέσσερις επιλογές καλύπτονται στην ενότητα για τη σύνδεση μοντέλου.

Χωρίς περιγραφή του έργου, ο agent πρέπει να μαντέψει τις εντολές κατασκευής, τη δομή των αρχείων και τις συμβάσεις που χρησιμοποιούνται—εξ ου και οι «παραισθήσεις». Το OpenCode χρησιμοποιεί γι’ αυτό ένα αρχείο AGENTS.md. Η ίδια προσέγγιση ισχύει για το Claude Code και κάθε άλλο agent· αλλάζει μόνο το όνομα του αρχείου οδηγιών.

Πώς εγκαθιστάτε το OpenCode σε macOS και Linux;

Κύρια σημεία

Μία εντολή στο τερματικό: curl -fsSL https://opencode.ai/install | bash. Η τεκμηρίωση την αποκαλεί την απλούστερη μέθοδο. Εναλλακτικές: brew install anomalyco/tap/opencode, npm install -g opencode-ai και, στο Arch Linux, pacman ή paru.

Η συνιστώμενη διαδρομή είναι το επίσημο πρόγραμμα εγκατάστασης:

  1. Εκτελέστε το πρόγραμμα εγκατάστασης

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

    Το script εντοπίζει το σύστημά σας και κατεβάζει το OpenCode. Αν η εντολή δεν αναγνωρίζεται μετά την εγκατάσταση, κλείστε και ανοίξτε ξανά το τερματικό· η διαδρομή θα εντοπιστεί στη νέα συνεδρία.

  2. Ελέγξτε ότι εγκαταστάθηκε σωστά

    opencode --version
    

    Η εντολή επιστρέφει έναν αριθμό έκδοσης, που σημαίνει ότι η εγκατάσταση πέτυχε. Η απάντηση «command not found» σας επιστρέφει στο πρώτο βήμα: ξεκινήστε νέα συνεδρία τερματικού ή επεξεργαστείτε χειροκίνητα το PATH.

Αν προτιμάτε να διαχειρίζεστε μόνοι σας τα πακέτα, ορίστε οι επιλογές:

brew install anomalyco/tap/opencode
npm install -g opencode-ai

Η εντολή Homebrew ξεκινά σκόπιμα με anomalyco/tap/: η τεκμηρίωση συνιστά το δικό τους tap, επειδή η ομάδα Homebrew ενημερώνει λιγότερο συχνά τη φόρμουλα για το brew install opencode. Το ίδιο όνομα πακέτου, opencode-ai, λειτουργεί επίσης με bun, pnpm και yarn (bun install -g opencode-ai, yarn global add opencode-ai). Στο Arch Linux, χρησιμοποιήστε sudo pacman -S opencode από το σταθερό αποθετήριο ή paru -S opencode-bin για την πιο πρόσφατη έκδοση από το AUR.

Ενημερώστε το OpenCode με opencode upgrade· όταν ξεκινά, κατεβάζει επίσης μόνο του ενημερώσεις αν είναι ενεργοποιημένη η αυτόματη ενημέρωση. Μετά την ενημέρωση, ελέγξτε την έκδοση με τη γνωστή εντολή opencode --version. Η απεγκατάσταση είναι επίσης ενσωματωμένη:

opencode uninstall

Η εντολή εμφανίζει ακριβώς τι θα διαγραφεί και ζητά επιβεβαίωση. Μπορείτε να διατηρήσετε τις ρυθμίσεις και τα δεδομένα συνεδρίας αν θέλετε: χρησιμοποιήστε τις σημαίες --keep-config και --keep-data.

Πώς εγκαθιστάτε το OpenCode στα Windows;

Κύρια σημεία

Η τεκμηρίωση συνιστά το WSL για απόδοση και πλήρη συμβατότητα: εγκαταστήστε το Windows Subsystem for Linux και μετά εγκαταστήστε το OpenCode μέσα σε αυτό με τη συνηθισμένη εντολή Linux. Χωρίς WSL, μπορείτε να χρησιμοποιήσετε το Chocolatey (choco install opencode), το Scoop (scoop install opencode), το npm ή την εφαρμογή για υπολογιστές.

Η πρώτη επιλογή που συνιστούν οι ίδιοι οι προγραμματιστές είναι το WSL. Εγκαταστήστε το με μία εντολή στο PowerShell που εκτελείται ως διαχειριστής:

wsl --install

Μετά την επανεκκίνηση, ανοίξτε το Ubuntu από το μενού Έναρξη και εκτελέστε μέσα του τη γνωστή εντολή:

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

Τα αρχεία στους δίσκους Windows είναι διαθέσιμα στο WSL μέσω του /mnt/—ο δίσκος C: βρίσκεται στο /mnt/c/ και ο δίσκος D: στο /mnt/d/. Έτσι, ένα έργο στο C:\Users\Name\project μπορεί να ανοιχτεί ως εξής:

cd /mnt/c/Users/Name/project
opencode

Η δεύτερη επιλογή είναι να παραλείψετε το WSL και να χρησιμοποιήσετε διαχειριστές πακέτων των Windows. Στο PowerShell:

choco install opencode
scoop install opencode

Η τρίτη επιλογή είναι η εφαρμογή για υπολογιστές και η έκδοση ιστού. Η εφαρμογή εγκαθίσταται ως κανονικό πρόγραμμα και εμφανίζει το περιβάλλον εργασίας σε παράθυρο, χωρίς τερματικό. Η έκδοση ιστού ξεκινά με την εντολή opencode web: ανοίγει το OpenCode σε πρόγραμμα περιήγησης και η τεκμηρίωση συνιστά να την εκκινείτε επίσης από WSL, για να αποφεύγετε προβλήματα πρόσβασης σε αρχεία. Η τεκμηρίωση αναφέρει επίσης λιγότερο συνηθισμένες επιλογές—mise, Docker και ένα έτοιμο δυαδικό αρχείο από τη σελίδα εκδόσεων του GitHub. Η εγκατάσταση μέσω bun στα Windows είναι ακόμη υπό εξέλιξη· αν το bun είναι ο κύριος διαχειριστής πακέτων σας, χρησιμοποιήστε την επιλογή npm.

Πώς συνδέετε ένα μοντέλο στο OpenCode;

Κύρια σημεία

Στη διεπαφή τερματικού, πληκτρολογήστε /connect και επιλέξτε πάροχο από τη λίστα: OpenCode Zen για να ξεκινήσετε χωρίς δικά σας κλειδιά, Anthropic ή OpenAI με κλειδί API, ChatGPT Plus ή GitHub Copilot με συνδρομή ή Ollama για τοπικό μοντέλο. Τα κλειδιά αποθηκεύονται στο αρχείο auth.json· επιλέξτε συγκεκριμένο μοντέλο με /models.

Το OpenCode υποστηρίζει 75+ παρόχους μέσω του AI SDK και του Models.dev, καθώς και τοπικά μοντέλα. Οι περισσότεροι συνδέονται με την εντολή /connect μέσα στη διεπαφή· για τα τοπικά μοντέλα, καθορίζετε επίσης τη διεύθυνση διακομιστή στις ρυθμίσεις. Οι επιλογές διαφέρουν ως προς τη μέθοδο πληρωμής και τις απαιτήσεις υπολογιστή:

ΕπιλογήΤι είναιΚόστος
OpenCode ZenAggregator μοντέλων που έχει εγκρίνει η ομάδα OpenCodeΠληρωμή ανά αίτημα, αναπλήρωση του υπολοίπου σας
OpenCode GoΣυνδρομητικό πρόγραμμα για ανοιχτά μοντέλα από την ομάδα$10 τον μήνα (Go) ή $40 τον μήνα (Go Plus, υψηλότερα όρια)
Κλειδί APIAnthropic, OpenAI, Google, DeepSeek και άλλοιΠληρώνετε τον πάροχο για τη χρήση
ΣυνδρομήChatGPT Plus, GitHub Copilot, GitLab DuoΈχει ήδη πληρωθεί
Ollama / LM StudioΤοπικό μοντέλο στο υλικό σαςΧωρίς χρεώσεις API, αλλά χρειάζεστε αξιοπρεπή υπολογιστή

Η τεκμηρίωση συνιστά στους αρχάριους να ξεκινήσουν με το OpenCode Zen. Η ομάδα επέλεξε μοντέλα που λειτουργούν καλά ειδικά ως agents και δοκίμασε τους συνδυασμούς τους με παρόχους στις δικές της εργασίες.

Η σύνδεση γίνεται ως εξής: πληκτρολογήστε /connect, επιλέξτε OpenCode Zen, συνδεθείτε και προσθέστε τρόπο πληρωμής στο opencode.ai/auth, λάβετε ένα κλειδί και επικολλήστε το. Έπειτα, το /models θα εμφανίσει τη λίστα των προτεινόμενων μοντέλων. Στις October 4, 2026, η λίστα περιλαμβάνει, για παράδειγμα, τα GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 και Kimi K2.5. Η τεκμηρίωση προειδοποιεί ειλικρινά ότι η λίστα δεν είναι εξαντλητική και γρήγορα παλιώνει, επειδή κυκλοφορούν νέα μοντέλα κάθε εβδομάδα.

Οι συνδρομές συνδέονται με την ίδια εντολή /connect: επιλέξτε ChatGPT Plus ή GitHub Copilot από τη λίστα και συνδεθείτε στον λογαριασμό σας—δεν χρειάζεται επιπλέον ρύθμιση.

Αν επιλέξετε Anthropic, το /connect προσφέρει δύο επιλογές: να εισαγάγετε χειροκίνητα ένα κλειδί API ή να επιλέξετε Claude Pro/Max και να συνδεθείτε μέσω προγράμματος περιήγησης. Ωστόσο, η Anthropic απαγορεύει πρόσθετα τρίτων για τη χρήση συνδρομής Claude Pro/Max και τα ενσωματωμένα πρόσθετα αυτού του είδους αφαιρέθηκαν από το OpenCode από την έκδοση 1.3.0. Αν συναντήσετε παλαιότερο άρθρο για το «OpenCode μέσω συνδρομής Claude», αναφέρεται σε αυτά τα αφαιρεμένα πρόσθετα και όχι σε επίσημη εξουσιοδότηση. Οι συνδρομές ChatGPT Plus, GitHub Copilot, GitLab Duo (με την ένδειξη πειραματικό) και Atomic Chat λειτουργούν χωρίς επιπλέον ρύθμιση.

Το OpenCode αποθηκεύει τα κλειδιά που εισάγετε μέσω του /connect στο αρχείο ~/.local/share/opencode/auth.json. Αν δεν θέλετε να επιλέγετε μοντέλο κάθε φορά, ορίστε το προεπιλεγμένο μοντέλο στο αρχείο ρυθμίσεων opencode.json στη ρίζα του έργου:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5"
}

Η μορφή είναι provider/model· και τα δύο αναγνωριστικά εμφανίζονται στην έξοδο του /models.

Πώς συνδέετε ένα τοπικό μοντέλο μέσω Ollama;

Κύρια σημεία

Εγκαταστήστε το Ollama από το ollama.com και κατεβάστε ένα μοντέλο με την εντολή ollama pull—το Ollama μπορεί να ρυθμιστεί αυτόματα για το OpenCode. Η χειροκίνητη διαδρομή είναι να προσθέσετε πάροχο στο opencode.json με τη διεύθυνση τοπικού διακομιστή http://localhost:11434/v1. Επιλέξτε το μοντέλο με /models. Αν ο agent δεν καλεί εργαλεία, αυξήστε το num_ctx στο Ollama σε 16k–32k.

Αυτή η επιλογή σημαίνει καθόλου χρεώσεις API: το μοντέλο εκτελείται στον υπολογιστή σας. Αν επιλέγετε γενικά ανάμεσα σε δωρεάν μοντέλα, έχουμε μια ξεχωριστή αξιολόγηση για το ποια λειτουργούν αρκετά καλά ως agents και ποια μόνο στα χαρτιά. Για το OpenCode, εγκαταστήστε το Ollama από τον επίσημο ιστότοπο και κατεβάστε ένα μοντέλο:

ollama pull qwen3-coder

Μια χρήσιμη λεπτομέρεια από την τεκμηρίωση: το Ollama μπορεί να ρυθμιστεί αυτόματα για το OpenCode· διαθέτει ξεχωριστό οδηγό ενσωμάτωσης. Αν θέλετε να ρυθμίσετε τα πάντα χειροκίνητα, προσθέστε έναν πάροχο με τη διεύθυνση του τοπικού διακομιστή Ollama στο opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3-coder": {
          "name": "Qwen3 Coder"
        }
      }
    }
  }
}

Έπειτα, το /models στη διεπαφή θα εμφανίσει το τοπικό μοντέλο στη λίστα. Επιλέξτε το και ξεκινήστε. Μια πρακτική επιφύλαξη από την τεκμηρίωση: αν ο agent σταματήσει να καλεί εργαλεία (να επεξεργάζεται αρχεία ή να εκτελεί εντολές), αυξήστε το num_ctx στις ρυθμίσεις του Ollama—ξεκινήστε με τιμές 16k–32k. Τα τοπικά μοντέλα είναι πιο αδύναμα από τα μοντέλα cloud ειδικά στην εργασία ως agents και το μικρό πλαίσιο συμφραζομένων το επιδεινώνει. Αν η τοπική έκδοση δεν επαρκεί, μπορείτε να συνδέσετε το Qwen από το cloud με κλειδί· ο οδηγός πώς να αποκτήσετε κλειδί API για το Qwen Code εξηγεί πού θα το βρείτε.

Πόσο κοστίζει το OpenCode και η χρήση του;

Κύρια σημεία

Το ίδιο το OpenCode είναι δωρεάν: ο πηγαίος κώδικάς του δημοσιεύεται με άδεια MIT. Πληρώνετε μόνο για το μοντέλο: ανάλογα με την πραγματική χρήση μέσω κλειδιού API ή Zen, με συνδρομή Go, μέσω της συνδρομής ChatGPT Plus ή Copilot που έχετε, ή καθόλου—τα αιτήματα σε τοπικό μοντέλο μέσω Ollama είναι δωρεάν.

Όλα τα κόστη εδώ αφορούν το μοντέλο και υπάρχουν τέσσερα σενάρια. Με κλειδί API ή Zen, πληρώνετε για την πραγματική χρήση και το ποσό εξαρτάται από το πόσο εργάζεται ο agent. Το Go είναι συνδρομητικό πρόγραμμα για ανοιχτά μοντέλα από την ομάδα OpenCode: $10 τον μήνα για το Go και $40 τον μήνα για το Go Plus με υψηλότερα όρια (επαληθεύτηκε στη σελίδα opencode.ai/go στις October 4, 2026). Το όριο εξαρτάται από το μοντέλο: για παράδειγμα, το Go επιτρέπει περίπου 110 αιτήματα ανά 5 ώρες (440 τον μήνα) για το Kimi K3 και περίπου 26,000 αιτήματα ανά 5 ώρες για το ελαφρύτερο DeepSeek V4.1 Flash. Για πρόσβαση σε συγκεκριμένο μοντέλο πέρα από το όριο, η τεκμηρίωση αναφέρει ξεχωριστή τιμή ($15 τον μήνα για το Kimi K3, $60 για το Go Plus). Δείτε τη σελίδα συνδρομών κατά τη σύνδεση για τον πλήρη κατάλογο μοντέλων και ορίων. Με ChatGPT Plus ή Copilot, τα αιτήματα καλύπτονται από τη συνδρομή που ήδη πληρώνετε· απλώς θυμηθείτε ότι οι συνδρομές έχουν τα δικά τους όρια έντασης χρήσης. Τέλος, τα αιτήματα σε τοπικό μοντέλο μέσω Ollama δεν κοστίζουν τίποτα—αλλά χρειάζεστε αρκετά ισχυρό υπολογιστή για να εκτελείται γρήγορα.

Τι πρέπει να κάνετε κατά την πρώτη εκκίνηση;

Κύρια σημεία

Μεταβείτε στον φάκελο του έργου σας, εκτελέστε το opencode και χρησιμοποιήστε την εντολή /init—ο agent θα επιθεωρήσει το έργο και θα δημιουργήσει ένα αρχείο AGENTS.md που το περιγράφει. Πριν κάνετε αλλαγές, πατήστε Tab για να μεταβείτε στη λειτουργία Plan: θα προτείνει μια λύση και θα εμφανίσει τις αλλαγές για έγκρισή σας. Αναιρέστε λανθασμένες ενέργειες με το /undo.

Πρώτη εκκίνηση—μέσα στον φάκελο του έργου σας:

cd path/to/project
opencode

Η διεπαφή ανοίγει με ένα πεδίο εισαγωγής. Πρώτα, χρησιμοποιήστε την εντολή /init: ο agent σαρώνει σημαντικά αρχεία του αποθετηρίου, κάνει μερικές ερωτήσεις αν χρειάζεται και γράφει ένα αρχείο AGENTS.md—έναν οδηγό για τη δομή του έργου, τις εντολές κατασκευής και δοκιμών και τις συμβάσεις που χρησιμοποιούνται. Η τεκμηρίωση συνιστά να υποβάλετε αυτό το αρχείο στο git· τότε το OpenCode το χρησιμοποιεί ως μόνιμη οδηγία έργου. Ως προς τον σκοπό, το AGENTS.md είναι άμεσο ισοδύναμο του CLAUDE.md στο οικοσύστημα OpenCode.

Δεύτερον, χρησιμοποιήστε τη λειτουργία Plan. Το πλήκτρο Tab εναλλάσσει ανάμεσα στους δύο κύριους agents: το Build εργάζεται με πλήρη πρόσβαση σε αρχεία και εντολές, ενώ το Plan προορίζεται για ανάλυση και σχεδιασμό—οι επεξεργασίες αρχείων και οι εντολές bash στη λειτουργία Plan απαιτούν έγκρισή σας από προεπιλογή. Για νέες εργασίες, η τεκμηρίωση συνιστά να ξεκινάτε με σχέδιο: διαβάστε τι σκοπεύει να κάνει ο agent, προσαρμόστε τη διατύπωση και μόνο τότε επιστρέψτε στο Build με Tab.

Η τεκμηρίωση δίνει αυτήν τη συμβουλή:

Βοηθά να του μιλάτε όπως θα μιλούσατε σε έναν junior developer της ομάδας σας.

— Επίσημη τεκμηρίωση OpenCode, https://opencode.ai/docs/

Όσο πιο συγκεκριμένη είναι η εργασία και όσο περισσότερο πλαίσιο παρέχετε, τόσο λιγότερη επανεργασία θα χρειαστείτε. Προσθέστε αρχεία σε ένα αίτημα με @—αρχίστε να πληκτρολογείτε ένα όνομα και η διεπαφή θα τα εντοπίσει με ασαφή αναζήτηση. Μπορείτε να σύρετε εικόνες απευθείας στο τερματικό, ενώ ένα μήνυμα που αρχίζει με ! εκτελείται ως εντολή shell· η έξοδός του προστίθεται στο πλαίσιο συμφραζομένων του agent. Αν κάνατε λάθος στην εργασία ή ο agent έκανε κάτι λανθασμένο, το /undo αναιρεί τις αλλαγές και μπορείτε να το εκτελέσετε αρκετές φορές στη σειρά. Αλλάξατε ξανά γνώμη; Το /redo επαναφέρει ό,τι αναιρέθηκε. Και το /share δημιουργεί σύνδεσμο προς μια συνομιλία για την ομάδα σας· χωρίς αυτήν την εντολή, η συνομιλία δεν δημοσιεύεται πουθενά.

Τι άλλο μπορεί να κάνει το OpenCode;

Κύρια σημεία

Προσαρμοσμένες εντολές από αρχεία markdown στον φάκελο .opencode/commands, subagents για παράλληλες εργασίες και ανάγνωση κώδικα, διακομιστές MCP για εξωτερικά εργαλεία, έκδοση ιστού στο πρόγραμμα περιήγησης και λειτουργία διακομιστή για απομακρυσμένη εργασία.

Προσαρμοσμένες εντολές. Κάθε επαναλαμβανόμενο αίτημα μπορεί να γίνει εντολή: βάλτε ένα αρχείο markdown στο .opencode/commands/, ορίστε τα description, agent και model στο frontmatter και γράψτε από κάτω ένα πρότυπο προτροπής. Έπειτα καλέστε την εντολή με /. Έλεγχοι έργου πριν από τη δημοσίευση, ανασκόπηση πρόσφατων σφαλμάτων, δημιουργία μετανάστευσης—οτιδήποτε ζητάτε τακτικά.

Subagents. Εκτός από τα Build και Plan, υπάρχουν ακόμη τρία: General για εργασίες πολλών βημάτων (πρόσβαση σε όλα τα εργαλεία εκτός από τη λίστα εργασιών), Explore για γρήγορη ανάγνωση κώδικα χωρίς άδεια επεξεργασίας και Scout για έρευνα εξωτερικών βιβλιοθηκών. Καλέστε τους αναφέροντάς τους με @ σε ένα μήνυμα.

Διακομιστές MCP. Συνδέστε εξωτερικά εργαλεία μέσω της ενότητας mcp της διαμόρφωσης opencode.json—υποστηρίζονται τοπικοί και απομακρυσμένοι διακομιστές. Κάθε διακομιστής MCP προσθέτει τα εργαλεία του στο πλαίσιο συμφραζομένων και ένας απαιτητικός διακομιστής όπως το GitHub μπορεί να το εξαντλήσει πολύ γρήγορα—συνδέστε επιλεκτικά μόνο ό,τι χρειάζεστε. Έχουμε έναν οδηγό με έτοιμες ρυθμίσεις για την έννοια MCP· είναι γραμμένος για το Claude Code, αλλά το πρωτόκολλο είναι κοινό.

Έκδοση ιστού και διακομιστής. Το opencode web ανοίγει τη διεπαφή σε πρόγραμμα περιήγησης. Για πρόσβαση από άλλο μηχάνημα, χρησιμοποιήστε opencode serve --hostname 0.0.0.0 --port 4096· όταν υπάρχει πρόσβαση μέσω δικτύου, ορίστε οπωσδήποτε κωδικό πρόσβασης με τη μεταβλητή OPENCODE_SERVER_PASSWORD. Χωρίς κωδικό πρόσβασης, ο διακομιστής είναι απροστάτευτος.

Τι πρέπει να κάνετε αν αποτύχει η εγκατάσταση;

Κύρια σημεία

Σχεδόν όλα τα προβλήματα καταλήγουν σε τρία πράγματα: δεν εντοπίζεται η εντολή opencode (ξεκινήστε νέα συνεδρία τερματικού ή επεξεργαστείτε το PATH), το μοντέλο δεν αποκρίνεται (ελέγξτε το κλειδί στο /connect και το αρχείο auth.json) ή η διεπαφή εμφανίζεται λανθασμένα (χρησιμοποιήστε ένα σύγχρονο τερματικό όπως το WezTerm). Ξεκινήστε την αντιμετώπιση προβλημάτων από τα αρχεία καταγραφής στο ~/.local/share/opencode/log/.

«opencode: command not found» μετά την εγκατάσταση. Το τερματικό δεν γνωρίζει ακόμη τη νέα διαδρομή. Αρχικά, απλώς κλείστε και ανοίξτε ξανά το τερματικό. Αν αυτό δεν βοηθήσει, βρείτε πού τοποθέτησε το πρόγραμμα εγκατάστασης το δυαδικό αρχείο και προσθέστε εκείνον τον φάκελο στο PATH του τερματικού σας.

Το μοντέλο δεν απαντά ή αναφέρει σφάλμα εξουσιοδότησης. Ελέγξτε ότι ο πάροχος είναι συνδεδεμένος: πληκτρολογήστε /connect και επαληθεύστε ξανά. Τα κλειδιά αποθηκεύονται στο ~/.local/share/opencode/auth.json—αν μεταφέρατε την εγκατάσταση από άλλο μηχάνημα ή διαγράψατε φακέλους, το αρχείο μπορεί να λείπει. Η τεκμηρίωση καλύπτει ξεχωριστά τα σφάλματα ProviderInitError και AI_APICallError: για το πρώτο, εξουσιοδοτήστε ξανά τον πάροχο· για το δεύτερο, διαγράψτε τον φάκελο ~/.cache/opencode και επανεκκινήστε.

Η διεπαφή είναι χαλασμένη: τα πλαίσια είναι διασκορπισμένα ή εμφανίζονται δυσανάγνωστοι χαρακτήρες αντί για σύμβολα. Αρχίστε ελέγχοντας το τερματικό σας. Εγκαταστήστε μία από τις προτεινόμενες επιλογές—το WezTerm λειτουργεί και στα τρία συστήματα—και εκκινήστε το OpenCode από εκεί.

Αν τίποτα δεν βοηθήσει, ελέγξτε τα αρχεία καταγραφής: σε macOS και Linux βρίσκονται στο ~/.local/share/opencode/log/· στα Windows, πατήστε Win+R και πληκτρολογήστε %USERPROFILE%\.local\share\opencode\log. Διατηρούνται τα δέκα πιο πρόσφατα αρχεία· ενεργοποιήστε λεπτομερή καταγραφή με τη σημαία opencode --log-level DEBUG. Με αυτά τα αρχεία μπορείτε να υποβάλετε αναφορά σφάλματος στο αποθετήριο του έργου στο GitHub.

Τι άλλο ρωτούν για το OpenCode;

Κύρια σημεία

Γρήγορες απαντήσεις σε συνήθεις ερωτήσεις: το OpenCode είναι δωρεάν ως εργαλείο· πληρώνετε μόνο για το μοντέλο. Το Claude Pro/Max συνδέεται μέσω /connect και τα πρόσθετα τρίτων γι’ αυτό απαγορεύονται. Μπορείτε να έχετε πρόσβαση από τηλέφωνο μέσω της έκδοσης ιστού. Το OpenCode ενημερώνεται με την εντολή opencode upgrade.

Συχνές ερωτήσεις

Είναι δωρεάν το OpenCode;

Ναι, ο πηγαίος κώδικάς του δημοσιεύεται με άδεια MIT. Μπορεί να πληρώνετε για το μοντέλο· όλες οι επιλογές καλύπτονται παραπάνω στην ενότητα για το κόστος.

Μπορώ να συνδέσω συνδρομή Claude Pro/Max;

Ναι, η Anthropic διαθέτει επίσημη επιλογή Claude Pro/Max στο /connect, με έλεγχο ταυτότητας μέσω προγράμματος περιήγησης. Παλαιότερα άρθρα για χρήση συνδρομής Claude μέσω πρόσθετων είναι ξεπερασμένα: η Anthropic απαγορεύει αυτά τα πρόσθετα και έχουν αφαιρεθεί από το OpenCode από την έκδοση 1.3.0.

Είναι διαθέσιμο το OpenCode σε τηλέφωνο;

Η διαθέσιμη επιλογή είναι η έκδοση ιστού: εκτελέστε το opencode serve σε υπολογιστή ή διακομιστή και έπειτα συνδεθείτε από το πρόγραμμα περιήγησης του τηλεφώνου σας. Απαιτείται κωδικός πρόσβασης, OPENCODE_SERVER_PASSWORD, για κάθε πρόσβαση μέσω δικτύου.

Σε τι είναι καλύτερο το OpenCode από το Claude Code;

Εξαρτάται από τα μοντέλα και τις συνδρομές σας: το Claude Code ενσωματώνεται με μοντέλα Anthropic, ενώ το OpenCode προσφέρει 75+ παρόχους, ανοιχτού κώδικα και τοπικά μοντέλα. Δείτε τον παραπάνω πίνακα για πλήρη σύγκριση.

Πρέπει να εγκαταστήσω αμέσως το OpenCode 2.0;

Όχι απαραίτητα. Η τεκμηρίωση συνιστά από προεπιλογή την τρέχουσα πρώτη έκδοση—δηλαδή αυτή που εγκαθίσταται με την εντολή curl -fsSL https://opencode.ai/install | bash σε αυτόν τον οδηγό. Η δεύτερη έκδοση είναι διαθέσιμη από τις October 4, 2026, αλλά τα πρόσθετα και οι ενσωματώσεις με το API διακομιστή λειτουργούν διαφορετικά σε αυτήν και θα χρειαστεί να επανεγγραφεί μέρος του κώδικα.

Μεταβείτε στο Ailoot.

Περισσότερες λεπτομέρειες

Ερωτήσεις και απαντήσεις: OpenCode: εγκατάσταση, μοντέλα και πρώτη εκκίνηση

Γιατί η εγκατάσταση OpenCode δεν δίνει λειτουργικό μοντέλο;

Το εργαλείο και η πρόσβαση μοντέλου είναι χωριστά. Συνδέστε πάροχο ή υποστηριζόμενη συνδρομή στο /connect ή ρυθμίστε τοπικό μοντέλο και επιλέξτε το στο /models· επαληθεύστε μία οριοθετημένη εργασία έργου.

Τι ελέγχω πριν μεταβώ από OpenCode 1.x σε 2.0;

Ελέγξτε συμβατότητα plugins, ενσωματώσεων server API και ρυθμίσεων τερματικού. Ο οδηγός τις ορίζει ως περιοχές μεταφοράς· επαληθεύστε εγκατεστημένη έκδοση και διασώστε διαμόρφωση και συνεδρίες πριν αντικαταστήσετε το εκτελέσιμο.

Όλα τα άρθρα