Πώς να Προσθέσεις Flags στα Slash Commands του Claude Code: 4 Patterns που Δουλεύουν Πραγματικά

Πώς να Προσθέσετε Flags στις Slash Εντολές του Claude Code: 4 Μοτίβα που Πραγματικά Λειτουργούν

Το Claude Code στην πραγματικότητα δεν αναλύει τα --flags όπως θα περιμένατε για τις προσαρμοσμένες slash εντολές, αλλά τέσσερα μοτίβα σάς δίνουν το ίδιο UX, και τρία από αυτά είναι πιο καθαρά από ό,τι ήταν ποτέ η ανάλυση CLI. Δείτε πώς να προσθέσετε flags στις slash εντολές του Claude Code σωστά, με λειτουργικά αρχεία .md που μπορείτε να αντιγράψετε σήμερα.

Γρήγορη Απάντηση:

• Το Claude Code δεν αναλύει CLI flags (--json, --verbose) για προσαρμοσμένες εντολές, η χρήση δεν διαθέτει parser flags.
• Για UX στυλ CLI, γράψτε τα flags μέσα στο $ARGUMENTS και αφήστε το LLM να τα ερμηνεύσει ως φυσική γλώσσα.
• Για τυποποιημένα ορίσματα, χρησιμοποιήστε τα θεσιακά $1/$2 ή επώνυμα ορίσματα που δηλώνονται στο πεδίο frontmatter arguments:.
• Τεκμηριώστε τα αναμενόμενα flags στο argument-hint: ώστε η αυτόματη συμπλήρωση / να τα εμφανίζει στον χρήστη.

Πώς Λειτουργούν στην Πραγματικότητα τα Ορίσματα των Slash Commands του Claude Code;

Ο μηχανισμός του Claude Code αντικαθιστά τρία είδη tokens πριν στείλει την εντολή σας στο LLM: $ARGUMENTS (ολόκληρο το string μετά το όνομα της εντολής), τα θεσιακά $0/$1/$2 (τμήματα με εισαγωγικά σε στυλ shell) και τα ονομαστικά $variableName που δηλώνονται στο frontmatter. Δεν υπάρχει ενσωματωμένος parser για CLI flags — το --dry-run καταλήγει στο $ARGUMENTS ως κυριολεκτικό κείμενο.

Εδώ είναι το σημείο που μπερδεύει τους πάντες. Όταν πληκτρολογείτε /deploy --staging --dry-run, το Claude Code δεν τρέχει το argparse ενάντια στο --staging --dry-run. Ο μηχανισμός επικολλά ολόκληρο αυτό το string στο σημείο όπου το αρχείο .md σας αναφέρεται στο $ARGUMENTS και μετά στέλνει το rendered prompt στο μοντέλο. Το LLM βλέπει το --staging --dry-run ως απλό αγγλικό κείμενο και αποφασίζει τι θα κάνει.

Αυτό δεν είναι bug, είναι ο σχεδιασμός. Ο μηχανισμός είναι ένα στρώμα αντικατάστασης, όχι parser. Οι ενσωματωμένες εντολές όπως το /clear και το /help (δείτε την επίσημη αναφορά CLI) έχουν όντως flags, αλλά οι προσαρμοσμένες εντολές που δημιουργείτε εσείς ακολουθούν διαφορετικούς κανόνες.

Ο μηχανισμός του Claude Code αντικαθιστά τα tokens και μετά παραδίδει το rendered prompt στο LLM. Δεν υπάρχει parser για flags.

Στη δική μας δουλειά με το Claude Code, η πιο συχνή σύγχυση είναι ακριβώς αυτή — οι developers ξοδεύουν μία ώρα προσπαθώντας να καταλάβουν γιατί το --verbose «δεν ανιχνεύεται», πριν συνειδητοποιήσουν ότι το LLM είναι ο parser. Από το Claude Code v2.1.126 (Μάιος 2026), αυτή η συμπεριφορά τεκμηριώνεται στην επίσημη τεκμηρίωση των slash-commands και δεν πρόκειται να αλλάξει σύντομα. Τα slash commands είναι ένα συγγενές primitive με τα hooks του Claude Code — και τα δύο επεκτείνουν τον μηχανισμό, αλλά οι εντολές ενεργοποιούνται από την εισαγωγή του χρήστη, ενώ τα hooks ενεργοποιούνται από συμβάντα εργαλείων.

Ακολουθεί η μικρότερη δυνατή προσαρμοσμένη εντολή που αποδεικνύει το μοντέλο αντικατάστασης:

---
description: Echo whatever the user types after the command
argument-hint: [anything]
---

The user passed these arguments: $ARGUMENTS

Repeat them back verbatim, then describe what the user probably meant.

Αποθηκεύστε το ως .claude/commands/echo-args.md, πληκτρολογήστε /echo-args hello world --foo και το LLM θα δει το κυριολεκτικό string hello world --foo να αντικαθίσταται στο prompt. Αυτό είναι ολόκληρο το νοητικό μοντέλο. Για μια πιο εμπεριστατωμένη ανάλυση του πώς τα αρχεία εντολών σχετίζονται με το ευρύτερο σύστημα skills, δείτε τον Οδηγό Skills.

Φτιάξτε την Πρώτη Σας Παραμετρική Slash Εντολή σε 5 Λεπτά

Δημιουργήστε το .claude/commands/greet.md με τρεις γραμμές frontmatter και μία γραμμή prompt που αναφέρεται στο $ARGUMENTS. Επανεκκινήστε το Claude Code, πληκτρολογήστε /greet World και δείτε το World να αντικαθίσταται στο prompt πριν καν το δει το LLM. Αυτή είναι όλη η διαδικασία — πέντε βήματα, χωρίς εργαλεία build.

Ορίστε η συνταγή από την αρχή μέχρι το τέλος:

1. Δημιουργήστε τον κατάλογο. Από τη ρίζα του project σας, τρέξτε mkdir -p .claude/commands. Ο φάκελος .claude/ βρίσκεται δίπλα στον κώδικά σας· οι εντολές μέσα σε αυτόν ανακαλύπτονται αυτόματα όταν το Claude Code ξεκινά μια συνεδρία.
2. Γράψτε το αρχείο εντολής. Αποθηκεύστε το παρακάτω απόσπασμα ως .claude/commands/greet.md.
3. Επαναφορτώστε τη συνεδρία σας. Κλείστε και επανεκκινήστε το Claude Code (ή τρέξτε /reload αν η έκδοσή σας το υποστηρίζει). Οι εντολές διαβάζονται μία φορά κατά την έναρξη της συνεδρίας.
4. Καλέστε την. Πληκτρολογήστε /greet World στη συνομιλία.
5. Επαληθεύστε την αντικατάσταση. Ανοίξτε το transcript και επιβεβαιώστε ότι το LLM είδε το World να παρεμβάλλεται στο σώμα του prompt, και όχι το κυριολεκτικό token $ARGUMENTS.

Ορίστε το πλήρες αρχείο:

---
description: Greet someone enthusiastically
argument-hint: <name>
---

You are a friendly assistant. Greet the person named "$ARGUMENTS" with one short, warm sentence. Then ask them what they're working on today.

Και η αλληλεπίδραση στο τερματικό:

> /greet World
Hey World, great to see you! What are you working on today?

Αυτό ήταν. Τώρα έχετε μια παραμετρική slash εντολή. Το πεδίο argument-hint είναι αυτό που κάνει το μενού αυτόματης συμπλήρωσης του / να εμφανίζει το <name> δίπλα στην εντολή σας — μικρή πινελιά UX, μεγάλο όφελος.

Αν το $ARGUMENTS δεν αντικαθίσταται, στις 9 από τις 10 περιπτώσεις φταίει το ότι πληκτρολογήσατε $args ή $ARGS — το token είναι κυριολεκτικά κεφαλαίο.

Το token είναι ευαίσθητο στην πεζοκεφαλαιοποίηση και ακριβές. Το $ARGUMENTS λειτουργεί. Τα $arguments, $args, $ARGS, ${ARGUMENTS} αποτυγχάνουν όλα σιωπηλά — αποστέλλονται στο LLM ως κυριολεκτικό κείμενο και το μοντέλο απλώς βλέπει σκουπίδια. Ελέγξτε τρεις φορές την ορθογραφία πριν υποθέσετε κάποιο βαθύτερο bug.

Ποια πεδία Frontmatter ελέγχουν τη διαχείριση ορισμάτων;

Πέντε πεδία frontmatter καθορίζουν τον τρόπο με τον οποίο μια εντολή slash διαχειρίζεται τα ορίσματα: argument-hint (τι εμφανίζει η αυτόματη συμπλήρωση), allowed-tools (τι μπορεί να καλέσει η εντολή), arguments (δήλωση ονομαστικών ορισμάτων), model (ποια παραλλαγή του Claude την εκτελεί) και disable-model-invocation (κλειδώνει την εντολή ώστε να καλείται μόνο από τον χρήστη). Μαζί καλύπτουν πρακτικά κάθε παραμετρικό μοτίβο που θα χρειαστείτε.

Ακολουθεί η πλήρης αναφορά frontmatter για τις προσαρμοσμένες εντολές του Claude Code v2.1.x:

Δύο παγίδες που αξίζει να κολλήσετε στην οθόνη σας. Πρώτον, το allowed-tools είναι διαχωρισμένο με κενά, όχι με κόμματα. Αν γράψετε Bash(git:*), Read, Edit, δεν θα μπει τίποτα στη λευκή λίστα χωρίς καμία ειδοποίηση· ο parser αντιμετωπίζει ολόκληρο το string ως μία κακοσχηματισμένη εγγραφή. Χρησιμοποιήστε Bash(git:*) Read Edit. Το μάθαμε αυτό με τον δύσκολο τρόπο· για περισσότερα τέτοια μοτίβα, δείτε τις βέλτιστες πρακτικές CLAUDE.md σχετικά με τις συμβάσεις αρχείων διαμόρφωσης.

Δεύτερον, το πεδίο model: παρακάμπτει οποιοδήποτε μοντέλο έχει επιλέξει ο χρήστης για τη συνεδρία. Χρήσιμο όταν μια εντολή είναι υπολογιστικά ελαφριά και θέλετε να την αναγκάσετε να τρέξει σε μια μικρότερη παραλλαγή· δείτε τον οδηγό μας για την επιλογή μοντέλου για να διαλέξετε μεταξύ Opus 4.7 και Sonnet για διαφορετικούς τύπους εντολών.

Το πεδίο disable-model-invocation: true είναι το δίχτυ ασφαλείας σας για τις καταστροφικές εντολές. Ορίστε το στο /deploy-prod ή στο /drop-database και οι άλλοι agents δεν θα μπορούν να καλούν αυτές τις εντολές προγραμματιστικά· μόνο ένας άνθρωπος που πληκτρολογεί στο chat μπορεί να τις ενεργοποιήσει.

Ποια Είναι τα 4 Πρότυπα Ορισμάτων που Θα Χρησιμοποιήσετε Στην Πράξη;

Τέσσερα πρότυπα καλύπτουν περίπου το 95% των πραγματικών slash commands του Claude Code: (1) boolean flag όπως /deploy --dry-run, που το LLM αναλύει από το $ARGUMENTS, (2) value flag όπως /test --filter auth, που εξάγεται από το $ARGUMENTS, (3) υποχρεωτικό positional + προαιρετικό flag όπως /fix-issue 123 --priority high, που συνδυάζει το $1 με το $ARGUMENTS, και (4) αυστηρά τυποποιημένο positional όπως /migrate-component SearchBar React Vue, που χρησιμοποιεί τα $0/$1/$2.

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

Pattern 1: Boolean Flag (--dry-run)

Όταν θέλετε την εμπειρία χρήσης μιας σημαίας CLI και η σημαία είναι απλώς on/off, αφήστε το LLM να την εντοπίσει μέσα στο $ARGUMENTS. Χωρίς λογική parsing, χωρίς ελιγμούς με τις θέσεις, απλώς περιγράψτε τον κανόνα στο prompt.

---
description: Deploy to staging or production
argument-hint: [--dry-run]
allowed-tools: Bash(git:*) Bash(npm:*) Read
---

Deploy the current branch to staging.

Arguments passed: $ARGUMENTS

If "$ARGUMENTS" contains "--dry-run", DO NOT actually deploy. Instead, print the deployment plan: which files would change, which env vars would be set, and which commands would run. Stop after printing the plan.

Otherwise, proceed with the real deployment using `git push staging main` and `npm run deploy:staging`.

Πληκτρολογήστε /deploy --dry-run και το LLM βλέπει τη σημαία, εμφανίζει το πλάνο και σταματά. Πληκτρολογήστε /deploy και το στέλνει. Ο χρήστης δεν έκανε καθόλου parsing, το LLM έκανε όλη τη δουλειά, που είναι ακριβώς αυτό στο οποίο είναι καλό.

Pattern 2: Value Flag (--filter <pattern>)

Η ίδια ιδέα, αλλά τώρα η σημαία (flag) μεταφέρει μια τιμή. Το LLM διαβάζει το --filter auth μέσα από το $ARGUMENTS και χρησιμοποιεί το substring που ακολουθεί.

---
description: Run the test suite, optionally filtered
argument-hint: [--filter <pattern>]
allowed-tools: Bash(npm:*) Read
---

Run the project's test suite.

Arguments: $ARGUMENTS

If "$ARGUMENTS" contains "--filter <pattern>", run only tests matching <pattern>. Use `npm test -- --grep <pattern>` for the actual command.

If no `--filter` is present, run the full suite with `npm test`.

Report pass/fail counts at the end.

Το /test --filter auth εκτελεί μόνο τα auth tests. Το /test εκτελεί τα πάντα. Το LLM εξάγει το pattern μετά το --filter με αξιοπιστία, επειδή το Claude είναι πραγματικά καλό σε αυτό το είδος εξαγωγής από δομημένο κείμενο — πολύ πιο αξιόπιστα από όσο περιμένουν οι περισσότεροι.

Μοτίβο 3: Απαιτούμενο Θέσης + Προαιρετική Σημαία

Αυτό είναι το υβριδικό που χρησιμοποιούμε περισσότερο στη δική μας βιβλιοθήκη εντολών. Το $1 μεταφέρει το απαιτούμενο όρισμα, το $ARGUMENTS μεταφέρει τα πάντα (ώστε το LLM να μπορεί να εντοπίζει προαιρετικές σημαίες). Είναι ο πιο καθαρός συνδυασμός όταν ένα όρισμα είναι μη διαπραγματεύσιμο και τα υπόλοιπα είναι ελεύθερο κείμενο πλαισίου.

---
description: Fix a GitHub issue
argument-hint: <issue-number> [--priority high|medium|low] [context...]
allowed-tools: Bash(gh:*) Bash(git:*) Read Edit
---

Fix GitHub issue #$1.

Full arguments: $ARGUMENTS

Steps:
1. Run `gh issue view $1` to load the issue body.
2. Read the codebase to locate the relevant file(s).
3. If "$ARGUMENTS" contains "--priority high", create a hotfix branch off main. Otherwise branch off develop.
4. Apply the fix, run tests, and open a PR linked to the issue.

Anything else in $ARGUMENTS after the issue number is freeform context — fold it into your understanding of the bug.

Κλήση ως /fix-issue 1234 --priority high the login form blanks the email field after a failed attempt. Το $1 επιλύεται σε 1234. Το $ARGUMENTS επιλύεται σε ολόκληρη την υπόλοιπη συμβολοσειρά, την οποία το LLM αναλύει ευχαρίστως τόσο για τη σημαία προτεραιότητας όσο και για την ελεύθερη περιγραφή.

Χρησιμοποιούμε αυτόν ακριβώς τον συνδυασμό $1 + $ARGUMENTS στην εντολή /fix-issue, το $1 για τον αριθμό του issue, τα υπόλοιπα για ελεύθερο πλαίσιο που αναλύει το LLM. Ήταν το μοτίβο με τη μεγαλύτερη απόδοση επένδυσης σε έναν χρόνο καθημερινής χρήσης του Claude Code.

Pattern 4: Αυστηρά Θέσεως (Τυποποιημένο)

Όταν κάθε όρισμα είναι υποχρεωτικό και η σειρά έχει σημασία, παραλείψτε εντελώς το $ARGUMENTS. Χρησιμοποιήστε $0/$1/$2 (ή επώνυμα ορίσματα μέσω του πεδίου frontmatter arguments:) για σαφείς τυποποιημένες θέσεις.

---
description: Migrate a component between frameworks
argument-hint: <component> <from-framework> <to-framework>
arguments: [component, fromFramework, toFramework]
allowed-tools: Read Edit Write
---

Migrate the component named "$component" from $fromFramework to $toFramework.

1. Read the existing component file (search for `$component.{jsx,tsx,vue,svelte}`).
2. Translate the component idioms from $fromFramework to $toFramework: lifecycle methods, state handling, prop syntax, event binding.
3. Write the new file in the matching extension for $toFramework.
4. Print a diff summary at the end.

If $fromFramework or $toFramework is unsupported, abort and tell the user which frameworks ARE supported (React, Vue, Svelte, Solid).

Καλέστε το ως /migrate-component SearchBar React Vue. Η δήλωση επώνυμων ορισμάτων καθιστά την αυτόματη συμπλήρωση και το σώμα του prompt αυτοτεκμηριούμενα· οποιοσδήποτε διαβάζει το migrate-component.md μπορεί να καταλάβει με μια ματιά ποια θέση αντιστοιχεί σε τι. Αυτό το μοτίβο λάμπει για εντολές με τρία ή περισσότερα υποχρεωτικά ορίσματα. Μπορείτε επίσης να δείτε αυτό το στυλ σε βιβλιοθήκες της κοινότητας όπως το wshobson/commands στο GitHub.

Οι σημαίες boolean και τιμών λειτουργούν επειδή το LLM είναι ένας ευέλικτος αναλυτής. Το αυστηρά θέσεως λειτουργεί επειδή δεν απαιτείται νοημοσύνη από το LLM. Ο συνδυασμός των δύο είναι το μυστικό.

Πότε πρέπει να χρησιμοποιείτε το $ARGUMENTS σε σχέση με τα ορίσματα θέσης ή τα ονομαστικά;

Χρησιμοποιήστε το $ARGUMENTS όταν τα ορίσματα είναι σε στυλ σημαίας CLI και θέλετε ευέλικτη ανάλυση από το LLM. Χρησιμοποιήστε ορίσματα θέσης $1/$2 όταν τα ορίσματα είναι τυποποιημένα, διατεταγμένα και θέλετε μηδενική ασάφεια από το LLM. Χρησιμοποιήστε ονομαστικά arguments: όταν υπάρχουν 3+ ορίσματα και η σαφήνεια στην αυτόματη συμπλήρωση έχει μεγαλύτερη σημασία από τη συντομία. Ορίστε ο πίνακας απόφασης:

Το ένστικτο που έχουν οι περισσότεροι προγραμματιστές είναι να επιλέξουν πρώτα το $ARGUMENTS, επειδή μοιάζει πιο κοντινό στον κόσμο της bash που γνωρίζουν. Αυτό είναι μια χαρά για πρωτότυπα, αλλά τα τυποποιημένα ορίσματα θέσης είναι πραγματικά καλύτερα όταν το συμβόλαιο είναι σταθερό. Το LLM δεν χρειάζεται να αναλύσει το $1, είναι ήδη μια καθαρή συμβολοσειρά.

Ένας πρόχειρος εμπειρικός κανόνας: αν μπορείτε να περιγράψετε την υπογραφή της εντολής σε μία πρόταση χωρίς να χρησιμοποιήσετε τις λέξεις «ή» και «προαιρετικά», επιλέξτε ορίσματα θέσης. Αν χρειάζεστε αυτές τις λέξεις, επιλέξτε $ARGUMENTS.

Είναι πλέον τα Slash Commands το ίδιο με τα Skills;

Η Anthropic ενσωμάτωσε τα προσαρμοσμένα commands στο ευρύτερο σύστημα skills την άνοιξη του 2026, ωστόσο τα αρχεία .claude/commands/*.md εξακολουθούν να λειτουργούν και χρησιμοποιούν το ίδιο frontmatter. Ένα skill είναι ένας κατάλογος (.claude/skills/foo/SKILL.md μαζί με υποστηρικτικά αρχεία) με επιπλέον έλεγχο κλήσης, όπως το disable-model-invocation. Ένα command είναι ένα μεμονωμένο αρχείο .md. Ίδιοι κανόνες αντικατάστασης, διαφορετική συσκευασία.

Να η πρακτική διαφορά:

Άρα όχι, το .claude/commands/ δεν έχει καταργηθεί. Η Anthropic διατήρησε ρητά τη λειτουργία της μορφής αρχείου όταν ενοποίησε τα συστήματα, καθώς πάρα πολλά έργα έχουν βιβλιοθήκες commands καθηλωμένες στον έλεγχο εκδόσεων. Αν θέλετε υποστηρικτικά αρχεία (όπως μια αναφορά CONTRIBUTING.md που φορτώνει το skill σας, ή ένα template.json που αντιγράφει), προτιμήστε τα skills. Διαφορετικά, μείνετε στα commands.

Η ενοποίηση αποτελεί μέρος μιας ευρύτερης ώθησης προς το ανοιχτό πρότυπο agentskills.io, και είναι μία από τις αρκετές αλλαγές της v2.1.x που αξίζει να γνωρίζετε· δείτε τη σύνοψή μας για τα χαρακτηριστικά του Claude Code v2.1 για το πλήρες τοπίο των χαρακτηριστικών και το φροντιστήριο skills μας για μια πιο εμπεριστατωμένη περιήγηση στα skills.

Γιατί δεν αντικαθίσταται το $ARGUMENTS μου; Συνηθισμένα σφάλματα διορθωμένα

Πέντε συνηθισμένοι λόγοι για τους οποίους το $ARGUMENTS δεν αντικαθίσταται: (1) το token είναι γραμμένο με πεζά ή σε συντομογραφία ($args, $ARGS, $arguments — πρέπει να είναι κυριολεκτικά $ARGUMENTS), (2) τα ορίσματα πολλών λέξεων δεν είναι σε εισαγωγικά (το /cmd hello world διαχωρίζεται, ενώ το /cmd "hello world" το διατηρεί ενιαίο), (3) το allowed-tools είναι διαχωρισμένο με κόμματα αντί για κενά, (4) το αρχείο εντολής δεν βρίσκεται στο .claude/commands/ ή στο .claude/skills/, (5) η συνεδρία του Claude Code χρειάζεται επαναφόρτωση μετά την επεξεργασία του αρχείου.

Το $ARGUMENTS εμφανίζεται κυριολεκτικά στο prompt του LLM

Σύμπτωμα: Το prompt σας εμφανίζει το $ARGUMENTS ως απλό κείμενο στην απόκριση του μοντέλου, σαν να το αγνόησε. Αιτία: Λάθος πεζά/κεφαλαία ή λάθος ορθογραφία. Το token είναι κυριολεκτικά $ARGUMENTS, οκτώ χαρακτήρες, όλα κεφαλαία. Διόρθωση: Ανοίξτε το .md, κάντε grep για $args, $ARGS, $arguments, ${ARGUMENTS} και αντικαταστήστε με $ARGUMENTS. Το bug με το τυπογραφικό λάθος $args έχει χτυπήσει κάθε προγραμματιστή στην ομάδα μας τουλάχιστον μία φορά· είναι μακράν το πιο συχνό bug στην οικογένεια «άγνωστη εντολή slash».

Το όρισμα πολλών λέξεων διαχωρίζεται απρόσμενα

Σύμπτωμα: Εκτελέσατε /migrate-component Search Bar React Vue και το $1 είναι Search, το $2 είναι Bar. Αιτία: Τα κενά διαχωρίζουν τα θέσηκα ορίσματα. Διόρθωση: Περικλείστε το όρισμα πολλών λέξεων σε εισαγωγικά: /migrate-component "Search Bar" React Vue. Τώρα το $1 είναι Search Bar. Αυτό αντιστοιχεί στη συμπεριφορά του shell, το οποίο είναι το νοητικό μοντέλο που η χρήση αντικατοπτρίζει σκόπιμα.

Το allowed-tools δεν τηρείται

Σύμπτωμα: Η εντολή εκτελείται, αλλά ο Claude αρνείται να καλέσει τα εργαλεία που πιστεύατε ότι έχετε επιτρέψει, ή καλεί εργαλεία που δεν έχετε καταχωρίσει. Αιτία: Χρησιμοποιήθηκαν κόμματα αντί για κενά ως διαχωριστικά. Διόρθωση: Αλλάξτε το allowed-tools: Bash, Read, Edit σε allowed-tools: Bash Read Edit. Για υπο-μοτίβα εργαλείων, χρησιμοποιήστε τη μορφή Bash(git:*) Bash(npm:*) Read.

Η εντολή δεν εμφανίζεται στην αυτόματη συμπλήρωση του /

Σύμπτωμα: Πληκτρολογείτε / και η εντολή σας δεν εμφανίζεται στη λίστα. Αιτία: Η τοποθεσία του αρχείου, η απουσία frontmatter ή η λανθασμένη ρύθμιση του disable-model-invocation. Λύση: Επιβεβαιώστε ότι το αρχείο βρίσκεται στο .claude/commands/yourcmd.md (ή .claude/skills/yourcmd/SKILL.md) σε σχέση με τη ρίζα του έργου σας. Επιβεβαιώστε ότι το frontmatter περιέχει τουλάχιστον ένα πεδίο description:. Αν ορίσετε disable-model-invocation: true, η εντολή δεν θα εμφανίζεται σε άλλους πράκτορες, αλλά θα εξακολουθεί να εμφανίζεται στο μενού / που πληκτρολογείται από τον χρήστη.

Επεξεργαστήκατε το αρχείο .md αλλά τίποτα δεν άλλαξε

Σύμπτωμα: Διορθώσατε το σφάλμα, αποθηκεύσατε το αρχείο, τρέξατε ξανά την εντολή, αλλά η ίδια προβληματική συμπεριφορά παραμένει. Αιτία: Το Claude Code αποθηκεύει προσωρινά τα αρχεία εντολών κατά την έναρξη της συνεδρίας. Διόρθωση: Κλείστε και επανεκκινήστε το Claude Code ή εκτελέστε /reload αν η έκδοσή σας το υποστηρίζει.

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

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

Συχνές Ερωτήσεις: Ορίσματα εντολών Slash του Claude Code

Πώς περνάω ορίσματα σε μια slash εντολή του Claude Code;

Πληκτρολογήστε τη συμβολοσειρά ορισμάτων μετά το όνομα της εντολής: /greet World. Μέσα στο αρχείο .md της εντολής σας, αναφερθείτε στην τιμή ως $ARGUMENTS (ολόκληρη η συμβολοσειρά), $1 (πρώτο ορισματικό) ή $variableName (αν έχετε δηλώσει arguments: [variableName] στο frontmatter). Το token αντικαθίσταται πριν από την αποστολή του prompt στο LLM.

Τι είναι το $ARGUMENTS στο Claude Code;

Το $ARGUMENTS είναι ένα διακριτικό αντικατάστασης στα αρχεία προσαρμοσμένων εντολών slash, το οποίο το Claude Code αντικαθιστά με ολόκληρη τη συμβολοσειρά ορισμάτων που πληκτρολόγησε ο χρήστης μετά το όνομα της εντολής. Αν ένας χρήστης εκτελέσει το /deploy --staging --dry-run, τότε το $ARGUMENTS γίνεται η κυριολεκτική συμβολοσειρά --staging --dry-run μέσα στο διαμορφωμένο prompt, προτού καν το δει το LLM.

Μπορούν οι slash εντολές του Claude Code να δέχονται σημαίες τύπου CLI όπως --json;

Όχι εγγενώς, η χρήση δεν διαθέτει parser σημαίων για προσαρμοσμένες εντολές. Γράφετε --json μέσα στο $ARGUMENTS και το prompt σας δίνει οδηγίες στο LLM να το εντοπίζει και να συμπεριφέρεται ανάλογα. Αυτό λειτουργεί επειδή ο Claude είναι ένας ευέλικτος parser δομημένου κειμένου. Οι ενσωματωμένες εντολές όπως /clear και /help διαθέτουν πράγματι κανονικές σημαίες, αλλά οι προσαρμοσμένες εντολές που δημιουργείτε εσείς υπόκεινται σε κανόνες αποκλειστικά αντικατάστασης.

Ποια είναι η διαφορά μεταξύ $1, $ARGUMENTS και $name στο Claude Code;

Το $1 είναι το πρώτο οριακό όρισμα που διαχωρίζεται με κενό διάστημα (το $2 είναι το δεύτερο, και ούτω καθεξής). Το $ARGUMENTS είναι ολόκληρη η συμβολοσειρά ορισμάτων αυτούσια, συμπεριλαμβανομένων όλων των οριακών τμημάτων και τυχόν σημαιών. Το $name είναι ένα επώνυμο όρισμα που δηλώνεται στο πεδίο arguments: [name] του frontmatter, χρήσιμο όταν θέλετε αυτοτεκμηριούμενες οριακές θέσεις χωρίς αριθμητική δεικτοδότηση.

Πώς λειτουργεί το argument-hint στο Claude Code;

Το argument-hint είναι ένα πεδίο frontmatter που ελέγχει τι εμφανίζει το μενού αυτόματης συμπλήρωσης / δίπλα στο όνομα της εντολής σας. Αν ορίσετε argument-hint: <issue-number> [--priority high], εμφανίζεται ακριβώς αυτό το πρότυπο μόλις ο χρήστης πληκτρολογήσει /. Αφορά αποκλειστικά την εμπειρία χρήστη — δεν επικυρώνει ούτε αναλύει τα ορίσματα. Παρ' όλα αυτά αξίζει να το ορίσετε, γιατί είναι η φθηνότερη τεκμηρίωση που θα γράψετε ποτέ.

Πώς δημιουργώ μια προσαρμοσμένη εντολή slash με πολλά ορίσματα;

Δύο καθαρές επιλογές. Για ορίσματα θέσης: αναφέρετε τα $1, $2, $3 στο σώμα του prompt σας. Για ονομαστικά: δηλώστε arguments: [first, second, third] στο frontmatter και αναφέρετε τα $first, $second, $third. Τα ονομαστικά είναι πιο ευανάγνωστα για τρία ή περισσότερα ορίσματα. Χρησιμοποιήστε το $ARGUMENTS μόνο όταν θέλετε το LLM να αναλύσει μια ελεύθερης μορφής συμβολοσειρά που ακολουθεί μετά τις απαιτούμενες θέσεις.

Έχει καταργηθεί το .claude/commands/ υπέρ του .claude/skills/;

Όχι. Η Anthropic συγχώνευσε τα δύο συστήματα την άνοιξη του 2026, αλλά διατήρησε ρητά τη λειτουργία του .claude/commands/*.md με πανομοιότυπους κανόνες αντικατάστασης. Χρησιμοποιήστε τα commands για αυτοματοποιήσεις ενός αρχείου και τα skills για πακέτα πολλαπλών αρχείων (SKILL.md συν πρότυπα ή αναφορές). Ίδιο frontmatter, ίδια συμπεριφορά $ARGUMENTS, διαφορετική συσκευασία. Και τα δύο είναι πρώτης κατηγορίας από την έκδοση v2.1.126.

Γιατί δεν αντικαθίσταται το $ARGUMENTS στην εντολή μου;

Οι τρεις κυριότερες αιτίες, κατά σειρά συχνότητας: σφάλμα πεζών-κεφαλαίων (πρέπει να είναι κεφαλαία $ARGUMENTS, όχι $args ή $arguments), λάθος τοποθεσία αρχείου (πρέπει να βρίσκεται στο .claude/commands/ ή στο .claude/skills/), ή παρωχημένη συνεδρία (το Claude Code διαβάζει τα αρχεία εντολών κατά την έναρξη της συνεδρίας, οπότε κάντε επανεκκίνηση μετά την επεξεργασία). Αν και τα τρία είναι σωστά, εκτελέστε /echo-args foo με το ελάχιστο παράδειγμα από την H2 #1 για να απομονώσετε το πρόβλημα.

Μπορώ να απαιτήσω ορισμένα ορίσματα;

Όχι σε επίπεδο χρήσης· δεν υπάρχει εγγενής επικύρωση υποχρεωτικών ορισμάτων. Το μοτίβο είναι να δώσεις οδηγίες στο LLM μέσα στο prompt σου: «Αν το $1 είναι κενό, σταμάτα και πες στον χρήστη να δώσει έναν αριθμό issue.» Το μοντέλο επιβάλλει τη σύμβαση. Δεν είναι αλάνθαστο, αλλά στην πράξη είναι αρκετά αξιόπιστο για καθημερινή χρήση, ειδικά όταν συνδυάζεται με ένα σαφές argument-hint.

Το model: στο frontmatter παρακάμπτει τις σημαίες CLI;

Ναι, το frontmatter υπερισχύει. Αν το αρχείο εντολής σας δηλώνει model: claude-haiku-4, η εντολή αυτή εκτελείται στο Haiku ανεξάρτητα από το ποιο μοντέλο έχει επιλέξει ο χρήστης για τη συνεδρία. Αυτό είναι χρήσιμο για φθηνές εντολές που καλούνται συχνά και θέλετε να κρατήσετε μακριά από το Opus. Δείτε τον οδηγό μας για την εναλλαγή μοντέλων Claude για να επιλέξετε τη σωστή παραλλαγή για κάθε τύπο εντολής.

Σύνοψη

Τέσσερα μοτίβα. Διαλέξτε αυτό που ταιριάζει στη μορφή της εντολής σας:

• Σημαία boolean (--dry-run), γράψτε την στο $ARGUMENTS και αφήστε το LLM να την εντοπίσει.
• Σημαία τιμής (--filter <pattern>), ίδια προσέγγιση, το LLM εξάγει την τιμή.
• Απαραίτητο ορισμένο θέσης + προαιρετική σημαία, $1 για το απαραίτητο, $ARGUMENTS για τα υπόλοιπα.
• Αυστηρά ορισμένα θέσης, $0/$1/$2 (ή με ονόματα μέσω arguments:) όταν κάθε θέση είναι απαραίτητη και ταξινομημένη.

Τώρα που οι εντολές σας είναι παραμετρικές, το επόμενο βήμα είναι να τις ενσωματώσετε σε ροές εργασίας agent· ξεκινήστε με τον οδηγό Claude Skills για την αναβάθμιση πακεταρίσματος πολλαπλών αρχείων, ή περιηγηθείτε στα εναλλακτικά εργαλεία κωδικοποίησης AI αν συγκρίνετε harnesses. Όπως και να 'χει, ο φάκελος .claude/commands/ σας μόλις έγινε πολύ πιο χρήσιμος.