Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Ein Deep Link ist eine claude-cli://-URL, die Claude Code in einem neuen Terminalfenster öffnet. Die URL kann ein Arbeitsverzeichnis und eine Eingabeaufforderung zum Vorausfüllen enthalten. Dies ermöglicht es Ihnen, einen One-Click-Startpunkt für eine Aufgabe freizugeben: Jeder, der Claude Code installiert hat und auf den Link klickt, sieht eine Sitzung mit der bereits eingegebenen Eingabeaufforderung. Die Eingabeaufforderung wird ausgefüllt, aber nicht gesendet, bis Sie die Eingabetaste drücken. Da ein Deep Link eine URL ist, können Sie ihn überall dort platzieren, wo ein Link möglich ist:
  • Ein Schritt in einem Incident-Runbook, der das betroffene Service-Repository mit einer Diagnose-Eingabeaufforderung öffnet
  • Eine Überwachungsmeldung oder ein Dashboard, das auf eine Untersuchungs-Eingabeaufforderung für eine bestimmte Metrik verlinkt
  • Eine README- oder Wiki-Seite, die das Projekt mit einer Onboarding-Eingabeaufforderung öffnet
  • Eine CI-Fehlerbenachrichtigung, die den Namen des fehlgeschlagenen Jobs vorausfüllt
Diese Seite behandelt, wie Sie einen Link erstellen, ihn in ein Runbook einbetten oder von der Shell aus auslösen und die Handler-Registrierung auf jeder Plattform verwalten oder deaktivieren.
Deep Links erfordern Claude Code v2.1.91 oder später.

​
Funktionsweise

Das claude-cli://-Präfix ist ein benutzerdefiniertes URL-Schema, das Claude Code bei Ihrem Betriebssystem registriert, ähnlich wie mailto:-Links Ihren E-Mail-Client öffnen. Der Link kann auf einer Webseite, in einem Wiki, in einer Slack-Nachricht oder in jeder App vorhanden sein, die Links rendert. Wenn Sie auf einen klicken:
  1. Der Browser oder die App übergibt die URL an Ihr Betriebssystem.
  2. Das Betriebssystem erkennt das claude-cli://-Präfix und startet Claude Code auf Ihrem Computer.
  3. Ein neues Terminalfenster öffnet sich mit Claude Code, das im vom Link angegebenen Verzeichnis ausgeführt wird, und der Eingabeaufforderungstext des Links befindet sich bereits im Eingabefeld.
  4. Sie lesen die Eingabeaufforderung, bearbeiten sie bei Bedarf und drücken die Eingabetaste, um sie zu senden.
Der Link selbst kann überall gehostet werden, aber die Sitzung öffnet sich immer lokal auf dem Computer, auf dem Sie geklickt haben. Siehe Registrierung und unterstützte Plattformen, um zu erfahren, welcher Terminal-Emulator auf jedem Betriebssystem geöffnet wird.
Die Plattform, die den Link anzeigt, muss benutzerdefinierte URL-Schemas zulassen. Von GitHub gerendertes Markdown erlaubt http und https, entfernt aber Schemas wie claude-cli:// in READMEs, Issues, Pull Requests und Wikis. Nur der Link-Text wird angezeigt, ohne Link dahinter und die URL ist verborgen. Siehe Fehlerbehebung für eine Problemumgehung.

​
Was eine gestartete Sitzung anzeigt

Ein Deep Link führt niemals etwas von selbst aus. Der Link wählt nur ein Verzeichnis und füllt das Eingabefeld. Wenn Sie auf einen Link von einer Seite klicken, der Sie nicht vertrauen, ist die Eingabeaufforderung immer noch inert: Nichts erreicht das Modell, bis Sie lesen, was ausgefüllt wurde, und die Eingabetaste drücken. Wenn die Sitzung öffnet, zeigt ein Banner über der Eingabe, dass ein externer Link sie gestartet hat und welches Verzeichnis er ausgewählt hat. Bei Eingabeaufforderungen über 1.000 Zeichen teilt das Banner Ihnen mit, dass Sie scrollen und den vollständigen Text überprüfen sollten, bevor Sie die Eingabetaste drücken, da lange Eingabeaufforderungen Anweisungen vom Bildschirm schieben können. Berechtigungsregeln, CLAUDE.md und Vertrauensaufforderungen für das ausgewählte Verzeichnis gelten genauso wie für jede andere Sitzung. Jeder Deep Link beginnt mit claude-cli://open, das ist der einzige Pfad, den der Handler akzeptiert, gefolgt von optionalen Abfrageparametern. Die minimale Form öffnet Claude Code in Ihrem Home-Verzeichnis mit einer leeren Eingabeaufforderung: 
claude-cli://open
Fügen Sie Parameter hinzu, um zu steuern, wo die Sitzung startet und was das Eingabefeld enthält:
ParameterBeschreibung
qText zum Vorausfüllen im Eingabefeld. URL-kodieren Sie den Wert. Verwenden Sie %0A für Zeilenumbrüche in mehrzeiligen Eingabeaufforderungen. Maximal 5.000 Zeichen.
cwdAbsoluter Pfad, der als Arbeitsverzeichnis verwendet werden soll. Netzwerk- und UNC-Pfade werden abgelehnt.
repoEin GitHub owner/name-Slug. Claude Code löst ihn zu einem lokalen Klon auf, den es zuvor gesehen hat, und startet dort. Wenn Sie keinen passenden Klon haben, öffnet sich die Sitzung stattdessen in Ihrem Home-Verzeichnis.
cwd und repo sind zwei Möglichkeiten, um das Arbeitsverzeichnis festzulegen. Wenn Sie beide übergeben, hat cwd Vorrang und repo wird ignoriert, auch wenn der cwd-Pfad nicht existiert. Der folgende Link verweist auf ein Repository namens acme/payments mit einer zweilinigen Diagnose-Eingabeaufforderung. Ersetzen Sie acme/payments durch den owner/name-Slug Ihres Repositorys, wenn Sie Ihren eigenen erstellen: 
claude-cli://open?repo=acme/payments&q=Investigate%20the%20failed%20deploy%20of%20payments-api.%0ACheck%20recent%20commits%20to%20main%20and%20the%20last%20successful%20build.
Wenn Sie darauf klicken, öffnet sich ein neues Terminalfenster, startet Claude Code in Ihrem lokalen Klon von acme/payments und füllt das Eingabefeld mit dem dekodierten Text: 
Investigate the failed deploy of payments-api.
Check recent commits to main and the last successful build.
Sie können die Eingabeaufforderung bearbeiten, bevor Sie die Eingabetaste drücken, um sie zu senden. Wenn Sie keinen lokalen Klon des Repositorys haben, öffnet sich die Sitzung stattdessen in Ihrem Home-Verzeichnis. Siehe Wählen Sie zwischen cwd und repo, um zu erfahren, wie der lokale Pfad ausgewählt wird, wenn Sie mehrere Klone oder Worktrees haben.

​
Wählen Sie zwischen cwd und repo

Verwenden Sie cwd, wenn jeder, der auf den Link klickt, das Projekt unter demselben absoluten Pfad hat, z. B. in einem standardisierten DevContainer oder VM-Image. Verwenden Sie repo, wenn der Link freigegeben wird und jede Person zu einem anderen Ort klont. Claude Code löst den Slug wie folgt zu einem lokalen Pfad auf:
  • Jedes Mal, wenn Sie claude in einem Git-Repository ausführen, wird der Dateisystempfad dieses Verzeichnisses gegen den owner/name-Slug des Repositorys auf GitHub aufgezeichnet.
  • Wenn ein Deep Link ankommt, öffnet repo den zuletzt verwendeten passenden Pfad. Mehrere Klone und Worktrees werden separat nachverfolgt, daher wird derjenige ausgewählt, in dem Sie zuletzt gearbeitet haben.
  • Die Suche findet nur Pfade, in denen Sie Claude Code mindestens einmal ausgeführt haben.
  • Der Link ändert nicht, welcher Branch ausgecheckt ist. Die Sitzung öffnet sich in dem Zustand, in dem sich dieses Verzeichnis derzeit befindet.
Die gestartete Sitzung zeigt, welchen Pfad sie ausgewählt hat und wann dieser Klon zuletzt vom Remote abgerufen hat, damit Sie erkennen können, ob Sie veralteten Code betrachten.

​
Beispiele

Die folgenden Abschnitte zeigen zwei häufige Möglichkeiten, einen Deep Link zu verwenden: als Markdown-Link in einem Dokument und als Befehl in einem Skript oder Shell-Alias. Ein Deep Link in einem Runbook gibt demjenigen, der einen Incident triagiert, eine One-Click-Möglichkeit, im richtigen Repository mit einer vorbereiteten Eingabeaufforderung zu untersuchen. Die Plattform, die das Runbook rendert, muss benutzerdefinierte URL-Schemas zulassen. Von GitHub gerendertes Markdown erlaubt claude-cli:// nicht, daher zeigt ein Deep Link in einer GitHub README, einem Issue oder einem Wiki nur sein Label ohne klickbaren Link. Siehe die Fehlerbehebungsnotiz für eine Problemumgehung. Die Eingabeaufforderung ist Teil der URL und muss URL-kodiert sein. Um den kodierten Wert zu erzeugen, übergeben Sie Ihren Eingabeaufforderungstext durch encodeURIComponent in einer Browser-Konsole oder einem beliebigen URL-Encoder. Das folgende Beispiel fügt einen Untersuchungs-Einstiegspunkt zu einem Incident-Runbook für einen Service namens web-gateway hinzu: 
## High 5xx rate on web-gateway

1. Acknowledge the page in PagerDuty.
2. [Open Claude Code in the gateway repo](claude-cli://open?repo=acme/web-gateway&q=5xx%20rate%20is%20elevated%20on%20web-gateway.%20Check%20recent%20deploys%2C%20error%20logs%20from%20the%20last%2030%20minutes%2C%20and%20open%20incidents%20in%20Linear.)
3. Post initial findings in #incident.
Um dies in Ihrem eigenen Runbook zu verwenden, ersetzen Sie acme/web-gateway durch den Repository-Slug Ihres Service. Dies ermöglicht es Ingenieuren mit installiertem Claude Code und einem lokalen Klon dieses Repositorys, auf Schritt 2 zu klicken und mit der Eingabeaufforderung zum Senden zu beginnen. Sie können einen Deep Link auch von einem Shell-Skript, Alias oder einer Automatisierung aus öffnen, anstatt ihn anzuklicken. Rufen Sie den URL-Öffnungsbefehl Ihres Betriebssystems mit dem Link als Argument auf.
Der integrierte open-Befehl übergibt die URL an den registrierten claude-cli://-Handler:
open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"

​
Registrierung und unterstützte Plattformen

Claude Code registriert den claude-cli://-Handler bei Ihrem Betriebssystem, wenn Sie zum ersten Mal eine interaktive Sitzung auf macOS, Linux und Windows starten. Sie führen keinen separaten Installationsbefehl aus. Die Registrierung schreibt nur in Benutzer-Level-Speicherorte:
PlattformHandler-Speicherort
macOS~/Applications/Claude Code URL Handler.app
Linuxclaude-code-url-handler.desktop unter $XDG_DATA_HOME/applications, Standard ist ~/.local/share/applications
WindowsHKEY_CURRENT_USER\Software\Classes\claude-cli
Der Handler startet Claude Code in einem erkannten Terminal-Emulator. Auf macOS merkt sich Claude Code den Terminal aus Ihrer letzten interaktiven Sitzung und verwendet ihn erneut, unterstützt iTerm2, Ghostty, kitty, Alacritty, WezTerm und Terminal.app. Auf Linux respektiert es die $TERMINAL-Umgebungsvariable, dann x-terminal-emulator, dann eine Liste häufiger Emulatoren. Auf Windows bevorzugt es Windows Terminal, dann PowerShell, dann cmd.exe. Um die Registrierung vollständig zu verhindern, setzen Sie disableDeepLinkRegistration auf "disable" in settings.json. Um dies organisationsweit durchzusetzen, damit Benutzer es nicht erneut aktivieren können, setzen Sie es stattdessen in verwalteten Einstellungen.

​
Öffnen Sie einen VS Code-Tab statt eines Terminals

Die VS Code-Erweiterung registriert ihren eigenen Handler unter vscode://anthropic.claude-code/open, der einen Claude Code-Editor-Tab statt eines Terminalfensters öffnet. Siehe Starten Sie einen VS Code-Tab von anderen Tools für die Parameter dieser URL.

​
Fehlerbehebung

Der Handler ist wahrscheinlich noch nicht registriert. Starten Sie einmal eine interaktive claude-Sitzung auf diesem Computer, beenden Sie sie und versuchen Sie den Link erneut. Wenn Sie unter Linux ohne Desktop-Umgebung sind, hat xdg-open möglicherweise nichts zum Verteilen.

​
Der Link wird als einfacher Text angezeigt, anstatt klickbar zu sein

Einige Markdown-Renderer erlauben nur http- und https-Links und entfernen andere URL-Schemas. GitHub tut dies in READMEs, Issues, Pull Requests und Wikis: [label](claude-cli://...) wird nur als label gerendert, ohne Link und die URL wird entfernt. Auf diesen Plattformen platzieren Sie den Deep Link in einem Code-Block, damit Leser die URL sehen und in die Adressleiste ihres Browsers einfügen können.

​
Die Sitzung öffnet sich in meinem Home-Verzeichnis statt im Repo

Der repo-Parameter löst nur zu Klonen auf, die Claude Code bereits gesehen hat. Führen Sie claude einmal im Klon aus, damit sein Pfad aufgezeichnet wird, oder wechseln Sie den Link zu cwd mit einem absoluten Pfad. Auf macOS starten Sie claude einmal in Ihrem bevorzugten Terminal und der nächste Deep Link wird es verwenden. Auf Linux setzen Sie die $TERMINAL-Umgebungsvariable auf den Befehlsnamen Ihres bevorzugten Emulators. Auf Windows ist die Reihenfolge festgelegt: Installieren Sie Windows Terminal, wenn Sie möchten, dass Links dort statt in einem PowerShell- oder cmd.exe-Fenster geöffnet werden.

​
Weitere Informationen

Diese Seiten behandeln verwandte Möglichkeiten, Claude Code-Sitzungen zu starten oder zu erweitern:
  • Skills: Speichern Sie eine lange Runbook-Eingabeaufforderung als /skill im Repo, damit der q-Parameter des Deep Links nur seinen Namen angeben muss
  • Non-interactive mode: Führen Sie Claude von einem Skript aus und erfassen Sie die Ausgabe, ohne ein Terminal zu öffnen