Uruchamianie sesji z linku
Link claude-cli:// otwiera Claude Code w nowym oknie terminala i może przekazać katalog roboczy oraz prompt do wstępnego wypełnienia. Prompt jest przygotowany w polu tekstowym, ale nie zostaje wysłany, dopóki nie naciśniesz Enter. Takie linki pozwalają udostępnić gotowy punkt startowy do zadania osobom, które mają zainstalowany Claude Code.
Link zaczyna się od claude-cli://open, po którym można dodać opcjonalne parametry zapytania. Parametr q wypełnia prompt; jego wartość trzeba zakodować w URL, a %0A służy do oznaczania łamań linii w promptach wielowierszowych o maksymalnej długości 5,000 znaków. Katalog roboczy można wskazać przez cwd lub repo; jeśli podasz oba parametry, pierwszeństwo ma cwd, a repo zostaje zignorowane. Parametr repo przyjmuje identyfikator GitHub owner/name i wybiera wcześniej widziany lokalny klon; bez pasującego klonu sesja otworzy się w katalogu domowym.
Po kliknięciu przeglądarka lub aplikacja przekazuje URL systemowi operacyjnemu, który rozpoznaje prefiks claude-cli:// i uruchamia Claude Code. Następnie otwiera się nowe okno terminala z Claude Code uruchomionym w katalogu wskazanym przez link, a tekst promptu pojawia się w polu wejściowym. Przed wysłaniem promptu możesz go przeczytać i zmienić, a następnie nacisnąć Enter.
Claude Code rejestruje obsługę claude-cli:// na macOS, Linuxie i Windows po wysłaniu pierwszego promptu interaktywnej sesji; samo uruchomienie claude i wyjście bez wysłania promptu nie wystarczy. Do rejestracji nie jest potrzebna osobna komenda instalacyjna, a wpisy są zapisywane wyłącznie w lokalizacjach użytkownika. Platforma wyświetlająca link musi dopuszczać niestandardowe schematy URL; Markdown renderowany przez GitHub nie udostępnia klikalnych linków claude-cli://. Aby całkowicie wyłączyć rejestrację, ustaw disableDeepLinkRegistration na "disable" w settings.json; ustawienie w zarządzanych ustawieniach może uniemożliwić użytkownikom ponowne włączenie tej funkcji.
open, aby uruchomić sesję w lokalnym klonie repozytorium z przygotowanym promptem.open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
xdg-open, aby przekazać link z repozytorium i promptem do zarejestrowanej obsługi adresów URL.xdg-open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
Start-Process przekazuje link do zarejestrowanego handlera.Start-Process "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
Zastosowanie w praktyce
W runbooku incydentu możesz dodać link, który otwiera właściwe repozytorium z przygotowanym promptem do rozpoczęcia analizy. Alert monitoringu lub dashboard może prowadzić do promptu analitycznego dotyczącego konkretnej metryki. Powiadomienie o błędzie CI może wstępnie uzupełnić prompt nazwą nieudanego zadania. Link z parametrem repo jest przydatny, gdy osoba klikająca ma lokalny klon wskazanego repozytorium; bez pasującego klonu sesja rozpocznie się w katalogu domowym.
cwd i repo, cwd ma pierwszeństwo nawet wtedy, gdy wskazana ścieżka nie istnieje.