Skip to main content
Глубокая ссылка — это URL claude-cli://, который открывает Claude Code в новом окне терминала. URL может содержать рабочий каталог и приглашение для предварительного заполнения. Это позволяет вам поделиться однокликовой точкой входа для задачи: любой, у кого установлен Claude Code и кто нажимает на ссылку, видит открытый сеанс с уже введённым приглашением. Приглашение заполняется, но не отправляется до тех пор, пока вы не нажмёте Enter. Поскольку глубокая ссылка — это URL, вы можете поместить её везде, где может быть ссылка:
  • Шаг в runbook’е инцидента, который открывает репозиторий затронутого сервиса с диагностическим приглашением
  • Оповещение мониторинга или панель мониторинга, которая ссылается на приглашение для расследования конкретной метрики
  • Страница README или wiki, которая открывает проект с приглашением для адаптации
  • Уведомление об ошибке CI, которое предварительно заполняет имя неудачного задания
На этой странице рассказывается, как построить ссылку, встроить её в runbook или запустить из shell, а также управлять или отключить регистрацию обработчика на каждой платформе. Префикс claude-cli:// — это пользовательская схема URL, которую Claude Code регистрирует в вашей операционной системе, подобно тому, как ссылки mailto: открывают ваш почтовый клиент. Когда вы нажимаете на глубокую ссылку:
  1. Браузер или приложение передаёт URL вашей операционной системе.
  2. Операционная система распознаёт префикс claude-cli:// и запускает Claude Code на вашем компьютере.
  3. Открывается новое окно терминала с Claude Code, работающим в каталоге, указанном в ссылке, и текстом приглашения ссылки уже в поле ввода.
  4. Вы читаете приглашение, при необходимости редактируете его и нажимаете Enter для отправки.
Сама ссылка может быть размещена где угодно, но сеанс всегда открывается локально на компьютере, где вы нажали. Смотрите Регистрация и поддерживаемые платформы, чтобы узнать, какой эмулятор терминала открывается на каждой операционной системе. Платформа, которая отображает ссылку, должна разрешать пользовательские схемы URL. Для информации о том, что GitHub делает с ними и обходного решения, смотрите Ссылка отображается как простой текст вместо того, чтобы быть кликабельной.

​
Что показывает запущенный сеанс

Глубокая ссылка никогда ничего не выполняет самостоятельно. Ссылка только выбирает каталог и заполняет поле приглашения. Если вы нажмёте на ссылку со страницы, которой вы не доверяете, приглашение всё равно остаётся инертным: ничего не достигает модель до тех пор, пока вы не прочитаете, что было заполнено, и не нажмёте Enter. Когда сеанс открывается, строка предупреждения под полем ввода читает Prompt from an external link и остаётся видимой до тех пор, пока вы не отправите или не очистите приглашение. Для приглашений более 1000 символов предупреждение включает количество символов и говорит вам прокрутить и просмотреть полный текст перед нажатием Enter, так как длинные приглашения могут сдвинуть инструкции за пределы экрана. Правила разрешений, CLAUDE.md и приглашения доверия для выбранного каталога применяются так же, как для любого другого сеанса. Каждая глубокая ссылка начинается с claude-cli://open, что является единственным путём, который принимает обработчик, за которым следуют необязательные параметры запроса. Минимальная форма открывает Claude Code в вашем домашнем каталоге с пустым приглашением:
Чтобы попробовать ссылку без размещения её на странице, вставьте её в адресную строку браузера или откройте её из оболочки. Добавьте параметры для управления тем, где начинается сеанс и что содержит поле приглашения: cwd и repo — это два способа установить рабочий каталог. Если вы передадите оба, cwd имеет приоритет и repo игнорируется, даже если путь cwd не существует. Следующая ссылка указывает на репозиторий под названием acme/payments с двухстрочным диагностическим приглашением. Замените acme/payments на слаг owner/name вашего репозитория при создании собственной ссылки:
При нажатии на неё открывается новое окно терминала, запускается Claude Code в вашем локальном клоне acme/payments и заполняется поле приглашения декодированным текстом:
Вы можете отредактировать приглашение перед нажатием Enter для отправки. Смотрите Выбор между cwd и repo, чтобы узнать, как выбирается локальный путь, когда у вас есть несколько клонов или worktrees.

​
Выбор между cwd и repo

Используйте cwd, когда все, кто нажимает на ссылку, имеют проект по одному и тому же абсолютному пути, например в стандартизированном devcontainer или образе VM. Используйте repo, когда ссылка общая и каждый человек клонирует в другое место. Claude Code разрешает слаг в локальный путь следующим образом:
  • repo открывает клон или worktree связанного репозитория, где вы недавно запустили claude. Каждый раз, когда вы запускаете claude в Git репозитории, Claude Code записывает путь этого каталога для слага GitHub owner/name репозитория. Claude Code отслеживает клоны и worktrees отдельно.
  • Ссылка не меняет, какая ветка проверена. Сеанс открывается в том состоянии, в котором этот каталог находится в данный момент.
Заголовок приветствия показывает, какой путь он выбрал, чтобы вы могли подтвердить, что открылся правильный клон.

​
Примеры

Разделы ниже показывают два распространённых способа использования глубокой ссылки: как ссылка Markdown в документе и как команда в скрипте или alias shell. Глубокая ссылка в runbook’е даёт тому, кто занимается сортировкой, однокликовый способ начать расследование в нужном репозитории с подготовленным приглашением. Платформа, которая отображает runbook, должна разрешать пользовательские схемы URL. GitHub-отрендеренный Markdown не разрешает claude-cli://, поэтому глубокая ссылка в GitHub README, issue или wiki показывает только её метку без кликабельной ссылки. Смотрите примечание troubleshooting для обхода. Приглашение является частью URL и должно быть URL-кодировано. Чтобы получить закодированное значение, передайте текст вашего приглашения через encodeURIComponent в консоль браузера или любой кодировщик URL. Пример ниже добавляет точку входа расследования в runbook инцидента для сервиса под названием web-gateway:
Чтобы использовать это в вашем собственном runbook’е, замените acme/web-gateway на слаг репозитория вашего сервиса. Это позволяет инженерам с установленным Claude Code и локальным клоном этого репозитория нажать на шаг 2 и начать расследование с готовым приглашением для отправки. Вы также можете открыть глубокую ссылку из скрипта shell, alias или автоматизации, а не нажимая на неё. Вызовите команду открытия URL вашей операционной системы со ссылкой в качестве аргумента. Эти команды полагаются на обработчик, который Claude Code регистрирует, когда вы отправляете свой первый prompt интерактивной сессии на машине.
Встроенная команда open передаёт URL зарегистрированному обработчику claude-cli://:
При успехе открывается новое окно терминала с запущенным Claude Code и предзаполненным prompt’ом.

​
Регистрация и поддерживаемые платформы

Claude Code регистрирует обработчик claude-cli:// в вашей операционной системе на macOS, Linux и Windows при отправке первого запроса интерактивного сеанса. Запуск claude и выход без отправки запроса не регистрирует обработчик. Вы не запускаете отдельную команду установки. Регистрация записывает только в пользовательские местоположения: Обработчик запускает Claude Code в обнаруженном эмуляторе терминала. На macOS Claude Code запоминает терминал из вашего последнего интерактивного сеанса и переиспользует его, поддерживая iTerm2, Ghostty, kitty, Alacritty, WezTerm и Terminal.app. На Linux он соблюдает переменную окружения $TERMINAL, затем x-terminal-emulator, затем список распространённых эмуляторов. На Windows он предпочитает Windows Terminal, затем PowerShell, затем cmd.exe. Чтобы полностью предотвратить регистрацию, установите disableDeepLinkRegistration на "disable" в settings.json. Чтобы обеспечить это во всей организации, чтобы пользователи не могли переактивировать это, установите это в управляемых параметрах вместо этого.

​
Открыть вкладку VS Code вместо терминала

Расширение VS Code регистрирует свой собственный обработчик в vscode://anthropic.claude-code/open, который открывает вкладку редактора Claude Code вместо окна терминала. Смотрите Запуск вкладки VS Code из других инструментов для параметров этого URL.

​
Troubleshooting

Обработчик, вероятно, ещё не зарегистрирован. Регистрация происходит при отправке первого запроса в интерактивном сеансе, а не при запуске сеанса. Запустите интерактивный сеанс claude на этой машине, отправьте любой запрос, выйдите и попробуйте ссылку снова. Если вы находитесь на Linux без окружения рабочего стола, xdg-open может не иметь ничего для отправки.

​
xdg-open не найден на Linux

Команда xdg-open является частью пакета xdg-utils, который минимальные образы серверов, контейнеры и дистрибутивы WSL часто исключают. Установите xdg-utils с помощью менеджера пакетов вашего дистрибутива, например sudo apt install xdg-utils, затем выполните команду снова. Если команда затем выполняется, но ничего не открывается, xdg-open может не иметь окружения рабочего стола для отправки; см. Нажатие на ссылку ничего не делает.

​
Ссылка отображается как простой текст вместо того, чтобы быть кликабельной

Некоторые средства отрендеринга Markdown разрешают только ссылки http и https и удаляют другие схемы URL. GitHub делает это в README, issues, pull requests и wikis: [label](claude-cli://...) отображается как просто label, без ссылки и удалённого URL. На этих платформах поместите глубокую ссылку в блок кода, чтобы читатели могли видеть URL и вставить его в адресную строку браузера.

​
Сеанс открывается в моём домашнем каталоге вместо репозитория

Параметр repo разрешает только клоны, которые Claude Code уже видел. Запустите claude внутри клона один раз, чтобы Claude Code записал его путь, или переключите ссылку на использование cwd с абсолютным путём. На macOS запустите claude в вашем предпочитаемом терминале один раз, и следующая глубокая ссылка будет использовать его. На Linux установите переменную окружения $TERMINAL на имя команды вашего предпочитаемого эмулятора. На Windows порядок фиксирован: установите Windows Terminal, если вы хотите, чтобы ссылки открывались там вместо окна PowerShell или cmd.exe.

​
Узнать больше

Эти страницы охватывают связанные способы запуска или расширения сеансов Claude Code:
  • Skills: сохраните длинное приглашение runbook’а как /skill в репозитории, чтобы параметр q глубокой ссылки должен был только назвать его
  • Non-interactive mode: запустите Claude из скрипта и захватите вывод без открытия терминала