Μετάβαση στο περιεχόμενο

Για χρήστες Claude Code

Το Claude ξεκινά κάθε συνεδρία τυφλό.

Το CLAUDE.md λέει στο Claude πώς να συμπεριφέρεται. Δεν λέει στο Claude τι υπάρχει στο αποθετήριό σας. Το Maguyva ευρετηριάζει τη βάση κώδικα και την προσφέρει πίσω μέσω MCP, ώστε το Claude να επεξεργάζεται σαν να έχει ήδη διαβάσει τον κώδικα.

Ξεκινήστε δωρεάνΔιαβάστε τη ρύθμιση για το Claude Code

Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς κάρτα.

Χρησιμοποιήστε το CLAUDE.md για τη συμπεριφορά. Χρησιμοποιήστε το Maguyva για τρέχοντα δεδομένα βάσης κώδικα.

Το CLAUDE.md είναι βέλτιστη πρακτική. Χρησιμοποιήστε το.

> cat CLAUDE.md
# συμβάσεις έργου, εντολές, κανόνες με εμβέλεια

Οι μόνιμες οδηγίες ανήκουν στο CLAUDE.md. Είναι το σωστό μέρος για:

  • Εντολές κατασκευής, δοκιμών και λίντινγκ που πρέπει να τρέχει ο πράκτορας.
  • Κανόνες στιλ κώδικα και συμβάσεις ονοματοδοσίας.
  • Κανόνες “πάντα κάνε X / ποτέ μην κάνεις Y” με εμβέλεια έναν φάκελο.
  • Παραπομπές στα κανονικά έγγραφα και τα αρχεία αποφάσεων.

Τα έγγραφα μνήμης της Anthropic το περιγράφουν καλά. Κρατήστε το συνοπτικό. Δώστε του εμβέλεια. Κάντε υποβολή του.

Όμως το CLAUDE.md δεν προοριζόταν ποτέ να είναι χάρτης της βάσης κώδικά σας.

Πού το CLAUDE.md σταματά να είναι αρκετό

Τέσσερις τρόποι αστοχίας που το markdown από μόνο του δεν μπορεί να διορθώσει.

// το αρχείο δεν είναι η βάση κώδικα

Το να λέτε στο Claude πώς να συμπεριφέρεται δεν του λέει τι υπάρχει. Η πρώτη επεξεργασία σε ένα άγνωστο αποθετήριο είναι μαντεψιά για διαδρομές αρχείων, ονόματα συναρτήσεων και σημεία κλήσης. Το CLAUDE.md δεν μπορεί να απαριθμήσει κάθε σύμβολο, και δεν θα το θέλατε ούτως ή άλλως.

// τα έγγραφα ξεπερνιούνται, ο κώδικας όχι

Ένα τμήμα του CLAUDE.md που περιγράφει τη ροή αυθεντικοποίησής σας είναι σωστό μέχρι κάποιος να αναδιαμορφώσει την αυθεντικοποίηση. Ο κώδικας είναι πλέον η πηγή αλήθειας και τα έγγραφα είναι με σιγουριά λάθος. Το Claude διαβάζει το λάθος.

// οι εξαρτήσεις δεν είναι σε markdown

Το «Τι θα χαλάσει αν αλλάξω αυτή τη συνάρτηση;» είναι ερώτημα γραφήματος. Δεν μπορεί να απαντηθεί από ένα αρχείο εγγράφου. Το Claude είτε κάνει grep-και-εύχεται, είτε σας ζητά να επικολλήσετε αρχεία στη συνομιλία.

// τα παράθυρα πλαισίου έχουν προϋπολογισμό

Το να παραγεμίζετε το CLAUDE.md μέχρι το Claude να «ξέρει αρκετά» καταναλώνει διακριτικά που θα έπρεπε να πληρώνουν τη συλλογιστική. Πέρα από λίγα KB, ανταλλάσσετε ποιότητα απάντησης με όγκο πλαισίου.

Το Maguyva είναι το επίπεδο που δεν καλύπτει το CLAUDE.md

Ένας απομακρυσμένος διακομιστής MCP που δίνει στο Claude Code:

  • Σημασιολογική, AST, γραφήματος και αναζήτηση κειμένου στο ευρετηριασμένο αποθετήριό σας, με αποτελέσματα διαδρομών αρχείων και αριθμών γραμμής.
  • Αναζητήσεις εξαρτήσεων, τύπων και σημείων κλήσης τις ερωτήσεις που απαντά ένα γράφημα και ένα αρχείο εγγράφου δεν μπορεί.
  • Αποτελέσματα με επίγνωση κλάδου ώστε το Claude να βλέπει την έκδοση του κώδικα που πραγματικά επεξεργάζεται.
  • Τιμολόγηση ανά χώρο εργασίας όχι ανά θέση. Ευρετηριάστε 1 αποθετήριο ή 50· οι πράκτορες δεν πληρώνουν θέσεις.

Το CLAUDE.md λέει στο Claude πώς να συμπεριφέρεται.

Το Maguyva δίνει στο Claude έναν χάρτη του κώδικα με δυνατότητα ερωτημάτων.

Τρεις ροές εργασίας

Αριθμημένες, με έμφαση σε μπλοκ κώδικα. Οι ερωτήσεις που ήδη κάνετε στο Claude, τεκμηριωμένες πάνω σε πραγματικές γραμμές.

// workflow 01

Βρείτε την πραγματική υλοποίηση, όχι την ψευδοϋλοποίηση δοκιμής

Εσείς: "Πώς λειτουργεί το retry στον πελάτη πληρωμών μας;"

Χωρίς Maguyva → Το Claude κάνει grep για retry, βρίσκει 14 αποτελέσματα, διαλέγει ένα (συχνά μια ψευδοϋλοποίηση δοκιμής).
Με Maguyva    → Το Maguyva επιστρέφει τον ορισμό συμβόλου, τα σημεία κλήσης, και το
                   file:line της πραγματικής υλοποίησης, κατατεταγμένα.

// workflow 02

Ελέγξτε την ακτίνα επίδρασης πριν κάνετε αναδιαμόρφωση

Εσείς: "Τι καλεί το normalizePhoneNumber;"

Το Maguyva επιστρέφει: 7 σημεία κλήσης σε 4 πακέτα, συμπεριλαμβανομένου ενός σε μια υπηρεσία Python
που το εισάγει μέσω της ψευδοϋλοποίησης gRPC. Το Claude προτείνει την αλλαγή με τη λίστα
μετάβασης ενσωματωμένη, όχι αφού το CI γίνει κόκκινο.

// workflow 03

Επαληθεύστε τον πράκτορα πριν αποδεχτείτε τη διαφορά

Claude: "Επεξεργάστηκα το src/auth/session.ts:142 για να διορθώσω την ανανέωση του διακριτικού."

Ρωτήστε το Maguyva: "Δείξε μου το session.ts:130-160 και οτιδήποτε εισάγει το session."

Το Maguyva επιστρέφει το ζωντανό τμήμα αρχείου + 3 εισαγωγείς. Η διαφορά είναι τώρα τεκμηριωμένη
πάνω σε πραγματικές γραμμές, όχι στην ανάμνηση του Claude από το διακριτικό #11.000.

Ρύθμιση στο Claude Code

Τρία βήματα. Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς κάρτα.

  1. // step 01

    Ευρετηριάστε ένα αποθετήριο στο maguyva.ai

    Επιλέξτε ένα που γνωρίζετε καλά, ώστε να μπορείτε να επαληθεύσετε τις απαντήσεις. Το επίπεδο Free καλύπτει 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου.

  2. // step 02

    Εγκαταστήστε το πρόσθετο Maguyva στο Claude Code

    /plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

# the plugin reads your key from the environment
export MAGUYVA_API_KEY=mgv_xxxx

  3. // step 03

    Κάντε μία ερώτηση της οποίας την απάντηση ήδη γνωρίζετε

    Ξεκινήστε με ένα αποθετήριο και μία επαληθεύσιμη ερώτηση, όχι με ολόκληρη την εταιρεία σας. Αν η απάντηση ταιριάζει με αυτό που θα λέγατε εσείς, είστε έτοιμοι.

Πλήρεις οδηγίες βρίσκονται στα έγγραφα του Maguyva.

Οι εγγραφές αυτοεξυπηρέτησης είναι ανοιχτές.

Ευρετηριάστε ένα αποθετήριο που ήδη γνωρίζετε.

Δοκιμάστε μία ερώτηση της οποίας την απάντηση μπορείτε να επαληθεύσετε. Αυτή είναι όλη η ενσωμάτωση.

Ευρετηριάστε το πρώτο σας αποθετήριοΔείτε την τεκμηρίωση συμβατότητας

πλάνο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς κάρτα.