Γρήγορη εκκίνηση

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

Χρειάζεστε Git, λογαριασμό GitHub και είτε λογαριασμό παρόχου μοντέλων (Anthropic, OpenAI, Codex, Cursor, Kimi Code ή οποιονδήποτε πάροχο με κλειδί API) είτε το CLI του Claude Code ήδη εγκατεστημένο. Όλα τα υπόλοιπα ρυθμίζονται στην πορεία.

Βήμα 1: Εγκατάσταση και εκκίνηση

Εγκαταστήστε το Control Center όπως περιγράφεται στην Εγκατάσταση και έπειτα ανοίξτε το.

Στην πρώτη εκκίνηση, η επιτραπέζια εφαρμογή ρωτά «Πώς να εκτελείται το Control Center;». Επιλέξτε Εκτέλεση σε αυτή την εφαρμογή. Το Control Center εκκινεί έναν cc_server headless σε αυτό το μηχάνημα, ο οποίος κατέχει τα δεδομένα σας και κάνει όλη τη δουλειά. Δεν τον βλέπετε ποτέ· αντί γι’ αυτόν ανοίγει η οθόνη της αρχικής διαμόρφωσης.

Προτιμάτε να μην εγκαταστήσετε τίποτα;

Η ίδια εφαρμογή εκτελείται στο πρόγραμμα περιήγησης στη διεύθυνση app.usectrl.dev με τις ίδιες δυνατότητες. Ωστόσο, μια καρτέλα του προγράμματος περιήγησης δεν μπορεί να φιλοξενήσει τον διακομιστή, οπότε τον παρέχετε εσείς — εκτελέστε το cc_server τοπικά και συνδεθείτε στο ws://localhost:9030 ή δείξτε το σε έναν διακομιστή σε άλλο μηχάνημα. Αυτή η γρήγορη εκκίνηση ακολουθεί τη διαδρομή της επιτραπέζιας εφαρμογής, επειδή δεν απαιτεί ρύθμιση διακομιστή· δείτε την Εγκατάσταση για τη διαδρομή του προγράμματος περιήγησης.

Βήμα 2: Ολοκληρώστε την αρχική διαμόρφωση

Η αρχική διαμόρφωση έχει πέντε βήματα και εκτελούνται με τη σειρά — δεν μπορείτε να παραλείψετε κανένα.

1. Σύνδεση: συνδεθείτε με το GitHub ή επικολλήστε ένα προσωπικό token πρόσβασης με repo και read:org. Το διαπιστευτήριο αποθηκεύεται στον διακομιστή, προσαρτημένο στον λογαριασμό σας.
2. Χώρος εργασίας: δώστε όνομα στον πρώτο σας χώρο εργασίας και προαιρετικά επιλέξτε λογότυπο. Η δημιουργία του εφοδιάζει πέντε πράκτορες — έναν CEO και τους qa, architect, engineer και librarian — καθώς και τα ενσωματωμένα πρότυπα pipeline.
3. Sandbox: καταγράφει μια προτίμηση sandbox. Οποιαδήποτε από τις δύο επιλογές σάς επιτρέπει να συνεχίσετε.
4. Προσαρμογέας: επιλέξτε τον προσαρμογέα και το μοντέλο που θα χρησιμοποιούν οι πράκτορες από προεπιλογή. Επιλέξτε Control Center (built-in) και έπειτα χρησιμοποιήστε τον επιλογέα παρόχου που εμφανίζεται για να συνδεθείτε σε έναν πάροχο μοντέλων — η λίστα μοντέλων παραμένει κενή μέχρι να συνδεθεί ένας. Η ολοκλήρωση αυτού του βήματος αποτυπώνει επίσης τον προσαρμογέα και το μοντέλο στον πράκτορα CEO του χώρου εργασίας.
5. Φωνή (προαιρετικά): εγκαταστήστε ένα μοντέλο ομιλίας στη συσκευή για υπαγόρευση ή παραλείψτε το.

Έπειτα, το Control Center ανοίγει τα εισερχόμενα του χώρου εργασίας σας.

Τι περιορίζει μια εκτέλεση πράκτορα

Οι εντολές των πρακτόρων περιτυλίγονται στο εγγενές sandbox του λειτουργικού συστήματος του κεντρικού υπολογιστή, όταν υπάρχει διαθέσιμο — Seatbelt στο macOS, bubblewrap στο Linux. Τα Windows δεν έχουν υποσύστημα, οπότε οι εκτελέσεις εκεί περιορίζονται μόνο από τα υπόλοιπα επίπεδα: το δικό της worktree της συνομιλίας (git worktree στα Windows· copy-on-write όπου παρέχεται το rift), τα διαπιστευτήρια που μεσιτεύονται ανά εκκίνηση και ανακαλούνται στη διάλυση, και τους περιορισμούς ενεργειών. Δείτε Sandbox και ασφάλεια.

Βήμα 3: Προσθήκη αποθετηρίου

Μεταβείτε στις Ρυθμίσεις → Χώρος εργασίας → Αποθετήρια και πατήστε Προσθήκη αποθετηρίου.

Ο διάλογος περιηγείται στους φακέλους του μηχανήματος που εκτελεί τον διακομιστή, όχι του πελάτη σας, και παραμένει εντός των ριζών που έχει ρυθμιστεί να εκθέτει ο διακομιστής (ο αρχικός κατάλογος του χρήστη του, από προεπιλογή). Μόνο τα checkouts του git αποκτούν πλαίσιο επιλογής. Επιλέξτε το δικό σας και καταχωρίστε το.

Ένα checkout γίνεται δεκτό μόνο αν βρίσκεται μέσα σε ένα worktree του git, έχει ένα remote origin και αυτό το remote δείχνει σε υποστηριζόμενο κεντρικό υπολογιστή κώδικα — github.com, gitlab.com ή bitbucket.org. Κάθε άλλη περίπτωση απορρίπτεται με την αιτιολογία της.

Τα αποθετήρια έχουν εύρος χώρου εργασίας: η καταχώριση ενός checkout εδώ το τοποθετεί σε αυτόν τον χώρο εργασίας. Δεν υπάρχει ξεχωριστό βήμα σύνδεσης.

Βήμα 4: Δώστε σε έναν πράκτορα προσαρμογέα και μοντέλο

Μεταβείτε στις Ρυθμίσεις → Χώρος εργασίας → Πράκτορες. Επιλέξτε τον πράκτορα engineer στον κατάλογο.

Στην καρτέλα Ρυθμίσεις, ορίστε:

• Προσαρμογέας: Control Center (built-in)
• Μοντέλο: επιλέξτε ένα από τον πάροχο που συνδέσατε στην αρχική διαμόρφωση

Πατήστε Αποθήκευση αλλαγών.

Αυτό το βήμα δεν είναι προαιρετικό στην πράξη. Μόνο ο πράκτορας CEO κληρονομεί τον προσαρμογέα που επιλέχθηκε κατά την αρχική διαμόρφωση· οι τέσσερις ειδικοί δημιουργούνται χωρίς αυτόν. Καταφεύγουν στο Control Center (built-in) με το προεπιλεγμένο μοντέλο της Anthropic, οπότε εκτελούνται μόνο αν έχετε συνδέσει λογαριασμό Anthropic — και σε μοντέλο που δεν επιλέξατε εσείς, αν έχετε.

Βήμα 5: Στείλτε στον πράκτορα μια εργασία

1. Στην πλαϊνή στήλη, βρείτε την ενότητα Χώροι και πατήστε το κουμπί +.
2. Δώστε όνομα στον χώρο, προσθέστε τον πράκτορα engineer στην Προσθήκη πρακτόρων και δημιουργήστε τον.
3. Πληκτρολογήστε μια συγκεκριμένη, μικρή εργασία πάνω στο αποθετήριο που καταχωρίσατε και πατήστε Enter.

Το Control Center προετοιμάζει ένα worktree copy-on-write των αποθετηρίων του χώρου εργασίας για αυτή τη συνομιλία, συναρμολογεί μια προτροπή από τον ρόλο, την περσόνα και τις δεξιότητες του πράκτορα και το πλαίσιο του χώρου, και αποστέλλει την εκτέλεση. Το checkout του πηγαίου κώδικα σας δεν θίγεται ποτέ.

Βήμα 6: Παρακολουθήστε το να εργάζεται

Θα πρέπει να δείτε, με τη σειρά:

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

Έπειτα ανοίξτε τις Ρυθμίσεις → Χώρος εργασίας → Πράκτορες, επιλέξτε τον πράκτορα και ελέγξτε την καρτέλα Αρχεία καταγραφής: μία γραμμή εκτέλεσης, με την κατάσταση, τη διάρκεια, τις ώρες έναρξης και λήξης και τον προσαρμογέα στον οποίο εκτελέστηκε.

Αυτός είναι ο βρόχος. Όλα τα υπόλοιπα στο Control Center — ο έλεγχος pull requests, τα pipeline, τα εισιτήρια, οι συσκέψεις, το Slack — κρέμονται από αυτόν.

Επόμενα βήματα

• Ο πρώτος σας χώρος εργασίας: το ίδιο έδαφος, πιο αργά, με εξήγηση του μοντέλου απομόνωσης
• Ελέγξτε το πρώτο σας pull request: περάστε τη διακλάδωση ενός πράκτορα από έλεγχο και συγχώνευση
• Το μοντέλο πρακτόρων: από τι αποτελείται ένας πράκτορας
• Δημιουργία και ρύθμιση πράκτορα: τα υπόλοιπα πεδία της φόρμας του πράκτορα
• Εκτέλεση ενορχήστρωσης: ένας στόχος, μία έγκριση, ένα παραγόμενο pipeline
• Σύζευξη συσκευής: παρακολουθήστε τον στόλο από οπουδήποτε
• Ανάπτυξη και πελάτες: πώς σχετίζονται οι πελάτες υπολογιστή, web και τηλεφώνου με τον διακομιστή