Slash-Befehle im SDK

Slash-Befehle bieten eine Möglichkeit, Claude Code-Sitzungen mit speziellen Befehlen zu steuern, die mit / beginnen. Diese Befehle können über das SDK gesendet werden, um Aktionen wie das Löschen des Gesprächsverlaufs, das Komprimieren von Nachrichten oder das Abrufen von Hilfe auszuführen.

Verfügbare Slash-Befehle entdecken

Das Claude Agent SDK stellt Informationen über verfügbare Slash-Befehle in der Systeminitialisierungsnachricht bereit. Greifen Sie auf diese Informationen zu, wenn Ihre Sitzung beginnt:

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Hello Claude",
  options: { maxTurns: 1 }
})) {
  if (message.type === "system" && message.subtype === "init") {
    console.log("Available slash commands:", message.slash_commands);
    // Example output: ["/compact", "/clear", "/help"]
  }
}

Slash-Befehle senden

Senden Sie Slash-Befehle, indem Sie sie in Ihre Eingabeaufforderung aufnehmen, genau wie normalen Text:

Häufige Slash-Befehle

/compact - Gesprächsverlauf komprimieren

Der /compact-Befehl reduziert die Größe Ihres Gesprächsverlaufs, indem er ältere Nachrichten zusammenfasst und dabei wichtigen Kontext bewahrt:

/clear - Gespräch löschen

Der /clear-Befehl startet ein neues Gespräch, indem er den gesamten vorherigen Verlauf löscht:

Benutzerdefinierte Slash-Befehle erstellen

Zusätzlich zur Verwendung integrierter Slash-Befehle können Sie Ihre eigenen benutzerdefinierten Befehle erstellen, die über das SDK verfügbar sind. Benutzerdefinierte Befehle werden als Markdown-Dateien in bestimmten Verzeichnissen definiert, ähnlich wie Subagenten konfiguriert werden.

Dateispeicherorte

Benutzerdefinierte Slash-Befehle werden in designierten Verzeichnissen basierend auf ihrem Umfang gespeichert:

• Projektbefehle: .claude/commands/ - Nur im aktuellen Projekt verfügbar
• Persönliche Befehle: ~/.claude/commands/ - Über alle Ihre Projekte hinweg verfügbar

Dateiformat

Jeder benutzerdefinierte Befehl ist eine Markdown-Datei, bei der:

• Der Dateiname (ohne .md-Erweiterung) wird zum Befehlsnamen
• Der Dateiinhalt definiert, was der Befehl tut
• Optionale YAML-Frontmatter bietet Konfiguration

Grundlegendes Beispiel

Erstellen Sie .claude/commands/refactor.md:

Refactor the selected code to improve readability and maintainability.
Focus on clean code principles and best practices.

Dies erstellt den /refactor-Befehl, den Sie über das SDK verwenden können.

Mit Frontmatter

Erstellen Sie .claude/commands/security-check.md:

---
allowed-tools: Read, Grep, Glob
description: Run security vulnerability scan
model: claude-opus-4-6
---

Analyze the codebase for security vulnerabilities including:
- SQL injection risks
- XSS vulnerabilities
- Exposed credentials
- Insecure configurations

Benutzerdefinierte Befehle im SDK verwenden

Sobald sie im Dateisystem definiert sind, sind benutzerdefinierte Befehle automatisch über das SDK verfügbar:

Erweiterte Funktionen

Argumente und Platzhalter

Benutzerdefinierte Befehle unterstützen dynamische Argumente mit Platzhaltern:

Erstellen Sie .claude/commands/fix-issue.md:

---
argument-hint: [issue-number] [priority]
description: Fix a GitHub issue
---

Fix issue #$1 with priority $2.
Check the issue description and implement the necessary changes.

Verwendung im SDK:

Bash-Befehlsausführung

Benutzerdefinierte Befehle können Bash-Befehle ausführen und deren Ausgabe einbeziehen:

Erstellen Sie .claude/commands/git-commit.md:

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Create a git commit
---

## Context

- Current status: !`git status`
- Current diff: !`git diff HEAD`

## Task

Create a git commit with appropriate message based on the changes.

Dateiverweise

Fügen Sie Dateiinhalte mit dem @-Präfix ein:

Erstellen Sie .claude/commands/review-config.md:

---
description: Review configuration files
---

Review the following configuration files for issues:
- Package config: @package.json
- TypeScript config: @tsconfig.json
- Environment config: @.env

Check for security issues, outdated dependencies, and misconfigurations.

Organisation mit Namensräumen

Organisieren Sie Befehle in Unterverzeichnissen für bessere Struktur:

.claude/commands/
├── frontend/
│   ├── component.md      # Creates /component (project:frontend)
│   └── style-check.md     # Creates /style-check (project:frontend)
├── backend/
│   ├── api-test.md        # Creates /api-test (project:backend)
│   └── db-migrate.md      # Creates /db-migrate (project:backend)
└── review.md              # Creates /review (project)

Das Unterverzeichnis erscheint in der Befehlsbeschreibung, beeinflusst aber nicht den Befehlsnamen selbst.

Praktische Beispiele

Code-Review-Befehl

Erstellen Sie .claude/commands/code-review.md:

---
allowed-tools: Read, Grep, Glob, Bash(git diff:*)
description: Comprehensive code review
---

## Changed Files
!`git diff --name-only HEAD~1`

## Detailed Changes
!`git diff HEAD~1`

## Review Checklist

Review the above changes for:
1. Code quality and readability
2. Security vulnerabilities
3. Performance implications
4. Test coverage
5. Documentation completeness

Provide specific, actionable feedback organized by priority.

Test-Runner-Befehl

Erstellen Sie .claude/commands/test.md:

---
allowed-tools: Bash, Read, Edit
argument-hint: [test-pattern]
description: Run tests with optional pattern
---

Run tests matching pattern: $ARGUMENTS

1. Detect the test framework (Jest, pytest, etc.)
2. Run tests with the provided pattern
3. If tests fail, analyze and fix them
4. Re-run to verify fixes

Verwenden Sie diese Befehle über das SDK:

Siehe auch

• Slash Commands - Vollständige Dokumentation zu Slash-Befehlen
• Subagenten im SDK - Ähnliche dateisystembasierte Konfiguration für Subagenten
• TypeScript SDK-Referenz - Vollständige API-Dokumentation
• SDK-Übersicht - Allgemeine SDK-Konzepte
• CLI-Referenz - Befehlszeilenschnittstelle