Перейти к основному содержанию

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.

Глубокая ссылка — это URL claude-cli://, который открывает Claude Code в новом окне терминала. URL может содержать рабочий каталог и приглашение для предварительного заполнения. Это позволяет вам поделиться однокликовой точкой входа для задачи: любой, у кого установлен Claude Code и кто нажимает на ссылку, видит открытый сеанс с уже введённым приглашением. Приглашение заполняется, но не отправляется до тех пор, пока вы не нажмёте Enter. Поскольку глубокая ссылка — это URL, вы можете поместить её везде, где может быть ссылка:
  • Шаг в runbook’е инцидента, который открывает репозиторий затронутого сервиса с диагностическим приглашением
  • Оповещение мониторинга или панель мониторинга, которая ссылается на приглашение для расследования конкретной метрики
  • Страница README или wiki, которая открывает проект с приглашением для адаптации
  • Уведомление об ошибке CI, которое предварительно заполняет имя неудачного задания
На этой странице рассказывается, как построить ссылку, встроить её в runbook или запустить из shell, а также управлять или отключить регистрацию обработчика на каждой платформе.
Глубокие ссылки требуют Claude Code v2.1.91 или более поздней версии.

​
Как это работает

Префикс claude-cli:// — это пользовательская схема URL, которую Claude Code регистрирует в вашей операционной системе, подобно тому, как ссылки mailto: открывают ваш почтовый клиент. Ссылка может находиться на веб-странице, в wiki, в сообщении Slack или в любом приложении, которое отображает ссылки. Когда вы нажимаете на неё:
  1. Браузер или приложение передаёт URL вашей операционной системе.
  2. Операционная система распознаёт префикс claude-cli:// и запускает Claude Code на вашем компьютере.
  3. Открывается новое окно терминала с Claude Code, работающим в каталоге, указанном в ссылке, и текстом приглашения ссылки уже в поле ввода.
  4. Вы читаете приглашение, при необходимости редактируете его и нажимаете Enter для отправки.
Сама ссылка может быть размещена где угодно, но сеанс всегда открывается локально на компьютере, где вы нажали. Смотрите Регистрация и поддерживаемые платформы, чтобы узнать, какой эмулятор терминала открывается на каждой операционной системе.
Платформа, которая отображает ссылку, должна разрешать пользовательские схемы URL. GitHub-отрендеренный Markdown разрешает http и https, но удаляет схемы вроде claude-cli:// в README, issues, pull requests и wikis. Отображается только текст ссылки, без самой ссылки и скрытого URL. Смотрите Troubleshooting для обхода.

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

Глубокая ссылка никогда ничего не выполняет самостоятельно. Ссылка только выбирает каталог и заполняет поле приглашения. Если вы нажмёте на ссылку со страницы, которой вы не доверяете, приглашение всё равно остаётся инертным: ничего не достигает модель до тех пор, пока вы не прочитаете, что было заполнено, и не нажмёте Enter. Когда сеанс открывается, баннер над вводом показывает, что внешняя ссылка запустила его и какой каталог она выбрала. Для приглашений более 1000 символов баннер говорит вам прокрутить и просмотреть полный текст перед нажатием Enter, так как длинные приглашения могут сдвинуть инструкции за пределы экрана. Правила разрешений, CLAUDE.md и приглашения доверия для выбранного каталога применяются так же, как для любого другого сеанса.

​
Построить ссылку

Каждая глубокая ссылка начинается с claude-cli://open, что является единственным путём, который принимает обработчик, за которым следуют необязательные параметры запроса. Минимальная форма открывает Claude Code в вашем домашнем каталоге с пустым приглашением: 
claude-cli://open
Добавьте параметры для управления тем, где начинается сеанс и что содержит поле приглашения:
ПараметрОписание
qТекст для предварительного заполнения в поле приглашения. URL-кодируйте значение. Используйте %0A для разрывов строк в многострочных приглашениях. Максимум 5000 символов.
cwdАбсолютный путь для использования в качестве рабочего каталога. Сетевые пути и пути UNC отклоняются.
repoСлаг GitHub owner/name. Claude Code разрешает его в локальный клон, который он видел раньше, и начинает там. Если у вас нет соответствующего клона, сеанс открывается в вашем домашнем каталоге.
cwd и repo — это два способа установить рабочий каталог. Если вы передадите оба, cwd имеет приоритет и repo игнорируется, даже если путь cwd не существует. Следующая ссылка указывает на репозиторий под названием acme/payments с двухстрочным диагностическим приглашением. Замените acme/payments на слаг owner/name вашего репозитория при создании собственной ссылки: 
claude-cli://open?repo=acme/payments&q=Investigate%20the%20failed%20deploy%20of%20payments-api.%0ACheck%20recent%20commits%20to%20main%20and%20the%20last%20successful%20build.
При нажатии на неё открывается новое окно терминала, запускается Claude Code в вашем локальном клоне acme/payments и заполняется поле приглашения декодированным текстом: 
Investigate the failed deploy of payments-api.
Check recent commits to main and the last successful build.
Вы можете отредактировать приглашение перед нажатием Enter для отправки. Если у вас нет локального клона репозитория, сеанс открывается в вашем домашнем каталоге. Смотрите Выбор между cwd и repo, чтобы узнать, как выбирается локальный путь, когда у вас есть несколько клонов или worktrees.

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

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

​
Примеры

Разделы ниже показывают два распространённых способа использования глубокой ссылки: как ссылка Markdown в документе и как команда в скрипте или alias shell.

​
Встроить ссылку в runbook

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

​
Открыть ссылку из shell

Вы также можете открыть глубокую ссылку из скрипта shell, alias или автоматизации, а не нажимая на неё. Вызовите команду открытия URL вашей операционной системы со ссылкой в качестве аргумента.
Встроенная команда open передаёт URL зарегистрированному обработчику claude-cli://:
open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"

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

Claude Code регистрирует обработчик claude-cli:// в вашей операционной системе при первом запуске интерактивного сеанса на macOS, Linux и Windows. Вы не запускаете отдельную команду установки. Регистрация записывает только в пользовательские местоположения:
ПлатформаМестоположение обработчика
macOS~/Applications/Claude Code URL Handler.app
Linuxclaude-code-url-handler.desktop под $XDG_DATA_HOME/applications, по умолчанию ~/.local/share/applications
WindowsHKEY_CURRENT_USER\Software\Classes\claude-cli
Обработчик запускает 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 может не иметь ничего для отправки.

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

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

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

Параметр repo разрешает только клоны, которые Claude Code уже видел. Запустите claude внутри клона один раз, чтобы его путь был записан, или переключите ссылку на использование cwd с абсолютным путём.

​
Ссылка открывает неправильный терминал

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

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

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