Claude Code Σειρά Εκμάθησης 5: Πώς να εγκαταστήσετε το Claude Code;

Πώς να εγκαταστήσετε το Claude Code

Η εγκατάσταση του Claude Code δεν έχει γραφικό περιβάλλον με "Επόμενο", γίνεται εξ ολοκλήρου στη γραμμή εντολών. Αν χρησιμοποιείτε συνήθως npm, η όλη διαδικασία δεν θα διαρκέσει περισσότερο από δύο λεπτά.

Προϋποθέσεις

Πριν ξεκινήσετε, βεβαιωθείτε ότι έχετε τα εξής:

Node.js 18 ή νεότερη έκδοση
Τρόπος ελέγχου: εκτελέστε node -v στο τερματικό. Αν η έκδοση είναι κάτω από 18, αναβαθμίστε χρησιμοποιώντας nvm, fnm ή μεταβαίνοντας στο nodejs.org.
Ένας λογαριασμός Anthropic
Η διεύθυνση εγγραφής είναι https://console.anthropic.com. Ο λογαριασμός παρέχει ένα API Key, το οποίο θα χρειαστεί μετά την εγκατάσταση. Η εγγραφή είναι δωρεάν, το πραγματικό κόστος υπολογίζεται βάσει χρήσης.
Το δίκτυο έχει πρόσβαση στο τελικό σημείο API του Anthropic
Το προεπιλεγμένο domain είναι api.anthropic.com. Αν το περιβάλλον χρειάζεται ρύθμιση proxy, θυμηθείτε να ορίσετε HTTP_PROXY ή HTTPS_PROXY στο τερματικό.

Τρόπος εγκατάστασης 1: Καθολική εγκατάσταση npm

Αυτός είναι ο πιο συνηθισμένος τρόπος. Εγκαθιστάτε μία φορά και το χρησιμοποιείτε παντού.

npm install -g @anthropic-ai/claude-code

Μετά την ολοκλήρωση, εκτελέστε claude --version. Αν εμφανιστεί ένας αριθμός έκδοσης, η εγκατάσταση ήταν επιτυχής. Μετά την καθολική εγκατάσταση, η εντολή claude μπορεί να κληθεί απευθείας από οποιονδήποτε κατάλογο.

Αν αντιμετωπίσετε σφάλμα αδειών (συνηθισμένο στον κατάλογο /usr/local/lib σε macOS), δύο τρόποι αντιμετώπισης:

Χρησιμοποιήστε sudo για την εγκατάσταση (εύκολο αλλά έχει θέματα ασφάλειας).
Ρυθμίστε το npm να χρησιμοποιεί τον κατάλογο χρήστη για αποφυγή sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Στη συνέχεια, προσθέστε το ~/.npm-global/bin στο PATH και ανοίξτε ξανά το τερματικό.

Τρόπος εγκατάστασης 2: npx on-the-fly

Αν δεν θέλετε να εγκαταστήσετε τίποτα καθολικά ή απλά θέλετε να το δοκιμάσετε προσωρινά, χρησιμοποιήστε npx.

npx @anthropic-ai/claude-code

Το npx θα κατεβάσει προσωρινά την τελευταία έκδοση, θα την εκτελέσει και δεν θα αφήσει καθολικές εντολές. Κάθε χρήση ελέγχει για ενημερώσεις, οπότε παραμένει πάντα στην τελευταία έκδοση. Το μειονέκτημα είναι ότι είναι λίγο πιο αργό (πρέπει να κατεβάζει κάθε φορά) και δεν είναι κατάλληλο για συχνή κλήση σε αυτοματοποιημένα σενάρια.

Κατάλληλο για: πρώτη δοκιμή, προσωρινή χρήση σε ξένο μηχάνημα ή σπάνια χρήση.

Επαλήθευση ότι μπορεί να ξεκινήσει κανονικά

Μετά την εγκατάσταση, μη βιαστείτε να κάνετε πιστοποίηση. Εκτελέστε μια απλή εντολή για να δείτε αν το εργαλείο εκκινεί:

claude --help

Αν εμφανιστεί βοήθεια, σημαίνει ότι το δυαδικό αρχείο είναι εντάξει. Το επόμενο βήμα είναι να συνδέσετε τον λογαριασμό σας, το οποίο θα εξηγηθεί αργότερα.

Μετά την εγκατάσταση και με τις δύο μεθόδους, το πρόγραμμα είναι το ίδιο. Η επακόλουθη πιστοποίηση και χρήση είναι πανομοιότυπες. Επιλέξτε αυτή που σας βολεύει.

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

Πολύ χαμηλή έκδοση Node
Κάτω από 18 θα δώσει σφάλμα, όχι προειδοποίηση. Η αναβάθμιση του Node είναι η πιο άμεση λύση.
Χρονική υπέρβαση δικτύου
Είτε κατά τη λήψη του πακέτου npm είτε κατά τη σύνδεση με το API, μπορεί να προκληθεί από proxy ή τείχος προστασίας. Πρώτα επιβεβαιώστε ότι curl https://api.anthropic.com λειτουργεί και στη συνέχεια προχωρήστε.
Χρήση εγγενούς cmd στα Windows
Αν και θεωρητικά είναι δυνατό, συνιστάται η χρήση Git Bash, WSL2 ή Windows Terminal για αποφυγή περίεργων προβλημάτων μετατροπής διαδρομών.