> ## 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.

# Запуск сеансов по ссылкам

> Откройте сеанс терминала Claude Code по URL. Встраивайте ссылки `claude-cli://` в runbook'и, оповещения и панели мониторинга, чтобы при клике открывался Claude Code в нужном репозитории с нужным приглашением.

Глубокая ссылка — это URL `claude-cli://`, который открывает Claude Code в новом окне терминала. URL может содержать рабочий каталог и приглашение для предварительного заполнения.

Это позволяет вам поделиться однокликовой точкой входа для задачи: любой, у кого установлен Claude Code и кто нажимает на ссылку, видит открытый сеанс с уже введённым приглашением. Приглашение заполняется, но не отправляется до тех пор, пока вы не нажмёте Enter.

Поскольку глубокая ссылка — это URL, вы можете поместить её везде, где может быть ссылка:

* Шаг в runbook'е инцидента, который открывает репозиторий затронутого сервиса с диагностическим приглашением
* Оповещение мониторинга или панель мониторинга, которая ссылается на приглашение для расследования конкретной метрики
* Страница README или wiki, которая открывает проект с приглашением для адаптации
* Уведомление об ошибке CI, которое предварительно заполняет имя неудачного задания

На этой странице рассказывается, как [построить ссылку](#build-a-link), [встроить её в runbook или запустить из shell](#examples), а также [управлять или отключить регистрацию обработчика](#registration-and-supported-platforms) на каждой платформе.

<h2 id="how-it-works">
  Как это работает
</h2>

Префикс `claude-cli://` — это пользовательская схема URL, которую Claude Code регистрирует в вашей операционной системе, подобно тому, как ссылки `mailto:` открывают ваш почтовый клиент. Ссылка может находиться на веб-странице, в wiki, в сообщении Slack или в любом приложении, которое отображает ссылки. Когда вы нажимаете на неё:

1. Браузер или приложение передаёт URL вашей операционной системе.
2. Операционная система распознаёт префикс `claude-cli://` и запускает Claude Code на вашем компьютере.
3. Открывается новое окно терминала с Claude Code, работающим в каталоге, указанном в ссылке, и текстом приглашения ссылки уже в поле ввода.
4. Вы читаете приглашение, при необходимости редактируете его и нажимаете Enter для отправки.

Сама ссылка может быть размещена где угодно, но сеанс всегда открывается локально на компьютере, где вы нажали. Смотрите [Регистрация и поддерживаемые платформы](#registration-and-supported-platforms), чтобы узнать, какой эмулятор терминала открывается на каждой операционной системе.

<Note>
  Платформа, которая отображает ссылку, должна разрешать пользовательские схемы URL. GitHub-отрендеренный Markdown разрешает `http` и `https`, но удаляет схемы вроде `claude-cli://` в README, issues, pull requests и wikis. Отображается только текст ссылки, без самой ссылки и скрытого URL. Смотрите [Troubleshooting](#the-link-renders-as-plain-text-instead-of-being-clickable) для обхода.
</Note>

<h3 id="what-a-launched-session-shows">
  Что показывает запущенный сеанс
</h3>

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

Когда сеанс открывается, строка предупреждения под полем ввода читает `Prompt from an external link` и остаётся видимой до тех пор, пока вы не отправите или не очистите приглашение. Для приглашений более 1000 символов предупреждение включает количество символов и говорит вам прокрутить и просмотреть полный текст перед нажатием Enter, так как длинные приглашения могут сдвинуть инструкции за пределы экрана. Правила разрешений, `CLAUDE.md` и приглашения доверия для выбранного каталога применяются так же, как для любого другого сеанса.

<h2 id="build-a-link">
  Построить ссылку
</h2>

Каждая глубокая ссылка начинается с `claude-cli://open`, что является единственным путём, который принимает обработчик, за которым следуют необязательные параметры запроса. Минимальная форма открывает Claude Code в вашем домашнем каталоге с пустым приглашением:

```text theme={null}
claude-cli://open
```

Добавьте параметры для управления тем, где начинается сеанс и что содержит поле приглашения:

| Параметр | Описание                                                                                                                                                                                                                                                                            |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `q`      | Текст для предварительного заполнения в поле приглашения. [URL-кодируйте](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent) значение. Используйте `%0A` для разрывов строк в многострочных приглашениях. Максимум 5000 символов. |
| `cwd`    | Абсолютный путь для использования в качестве рабочего каталога. Сетевые пути и пути UNC отклоняются, как и пути, содержащие невидимые или двунаправленные управляющие символы.                                                                                                      |
| `repo`   | Слаг GitHub `owner/name`. Claude Code разрешает его в локальный клон, который он видел раньше, и начинает там. Если у вас нет соответствующего клона, сеанс открывается в вашем домашнем каталоге.                                                                                  |

`cwd` и `repo` — это [два способа установить рабочий каталог](#choose-between-cwd-and-repo). Если вы передадите оба, `cwd` имеет приоритет и `repo` игнорируется, даже если путь `cwd` не существует.

Следующая ссылка указывает на репозиторий под названием `acme/payments` с двухстрочным диагностическим приглашением. Замените `acme/payments` на слаг `owner/name` вашего репозитория при создании собственной ссылки:

```text theme={null}
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` и заполняется поле приглашения декодированным текстом:

```text theme={null}
Investigate the failed deploy of payments-api.
Check recent commits to main and the last successful build.
```

Вы можете отредактировать приглашение перед нажатием Enter для отправки. Если у вас нет локального клона репозитория, сеанс открывается в вашем домашнем каталоге. Смотрите [Выбор между `cwd` и `repo`](#choose-between-cwd-and-repo), чтобы узнать, как выбирается локальный путь, когда у вас есть несколько клонов или worktrees.

<h3 id="choose-between-cwd-and-repo">
  Выбор между `cwd` и `repo`
</h3>

Используйте `cwd`, когда все, кто нажимает на ссылку, имеют проект по одному и тому же абсолютному пути, например в стандартизированном devcontainer или образе VM.

Используйте `repo`, когда ссылка общая и каждый человек клонирует в другое место. Claude Code разрешает слаг в локальный путь следующим образом:

* Каждый раз, когда вы запускаете `claude` в Git репозитории, путь файловой системы этого каталога записывается для слага GitHub `owner/name` репозитория.
* Когда приходит глубокая ссылка, `repo` открывает любой соответствующий путь, который вы использовали недавно. Несколько клонов и worktrees отслеживаются отдельно, поэтому выбирается тот, в котором вы работали в последний раз.
* Поиск находит только пути, где вы уже запустили Claude Code хотя бы один раз.
* Ссылка не меняет, какая ветка проверена. Сеанс открывается в том состоянии, в котором этот каталог находится в данный момент.

Заголовок приветствия показывает, какой путь он выбрал, чтобы вы могли подтвердить, что открылся правильный клон.

<h2 id="examples">
  Примеры
</h2>

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

<h3 id="embed-a-link-in-a-runbook">
  Встроить ссылку в runbook
</h3>

Глубокая ссылка в runbook'е даёт тому, кто занимается сортировкой, однокликовый способ начать расследование в нужном репозитории с подготовленным приглашением. Платформа, которая отображает runbook, должна разрешать пользовательские схемы URL. GitHub-отрендеренный Markdown не разрешает `claude-cli://`, поэтому глубокая ссылка в GitHub README, issue или wiki показывает только её метку без кликабельной ссылки. Смотрите [примечание troubleshooting](#the-link-renders-as-plain-text-instead-of-being-clickable) для обхода.

Приглашение является частью URL и должно быть URL-кодировано. Чтобы получить закодированное значение, передайте текст вашего приглашения через `encodeURIComponent` в консоль браузера или любой кодировщик URL.

Пример ниже добавляет точку входа расследования в runbook инцидента для сервиса под названием `web-gateway`:

```markdown theme={null}
## 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 и начать расследование с готовым приглашением для отправки.

<h3 id="open-a-link-from-the-shell">
  Открыть ссылку из shell
</h3>

Вы также можете открыть глубокую ссылку из скрипта shell, alias или автоматизации, а не нажимая на неё. Вызовите команду открытия URL вашей операционной системы со ссылкой в качестве аргумента.

<Tabs>
  <Tab title="macOS">
    Встроенная команда `open` передаёт URL зарегистрированному обработчику `claude-cli://`:

    ```bash theme={null}
    open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
    ```
  </Tab>

  <Tab title="Linux">
    Большинство окружений рабочего стола предоставляют `xdg-open`, которая передаёт URL зарегистрированному обработчику:

    ```bash theme={null}
    xdg-open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
    ```
  </Tab>

  <Tab title="Windows">
    В PowerShell `Start-Process` передаёт URL зарегистрированному обработчику:

    ```powershell theme={null}
    Start-Process "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
    ```

    В `cmd.exe` `start` рассматривает свой первый цитируемый аргумент как заголовок окна, поэтому передайте пустой заголовок перед URL:

    ```cmd theme={null}
    start "" "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
    ```
  </Tab>
</Tabs>

<h2 id="registration-and-supported-platforms">
  Регистрация и поддерживаемые платформы
</h2>

Claude Code регистрирует обработчик `claude-cli://` в вашей операционной системе при первом запуске интерактивного сеанса на macOS, Linux и Windows. Вы не запускаете отдельную команду установки. Регистрация записывает только в пользовательские местоположения:

| Платформа | Местоположение обработчика                                                                                      |
| --------- | --------------------------------------------------------------------------------------------------------------- |
| macOS     | `~/Applications/Claude Code URL Handler.app`                                                                    |
| Linux     | `claude-code-url-handler.desktop` под `$XDG_DATA_HOME/applications`, по умолчанию `~/.local/share/applications` |
| Windows   | `HKEY_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`](/docs/ru/settings) на `"disable"` в `settings.json`. Чтобы обеспечить это во всей организации, чтобы пользователи не могли переактивировать это, установите это в [управляемых параметрах](/docs/ru/server-managed-settings) вместо этого.

<h2 id="open-a-vs-code-tab-instead-of-a-terminal">
  Открыть вкладку VS Code вместо терминала
</h2>

Расширение VS Code регистрирует свой собственный обработчик в `vscode://anthropic.claude-code/open`, который открывает вкладку редактора Claude Code вместо окна терминала. Смотрите [Запуск вкладки VS Code из других инструментов](/docs/ru/vs-code#launch-a-vs-code-tab-from-other-tools) для параметров этого URL.

<h2 id="troubleshooting">
  Troubleshooting
</h2>

<h3 id="clicking-the-link-does-nothing">
  Нажатие на ссылку ничего не делает
</h3>

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

<h3 id="the-link-renders-as-plain-text-instead-of-being-clickable">
  Ссылка отображается как простой текст вместо того, чтобы быть кликабельной
</h3>

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

<h3 id="the-session-opens-in-my-home-directory-instead-of-the-repo">
  Сеанс открывается в моём домашнем каталоге вместо репозитория
</h3>

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

<h3 id="the-link-opens-the-wrong-terminal">
  Ссылка открывает неправильный терминал
</h3>

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

<h2 id="learn-more">
  Узнать больше
</h2>

Эти страницы охватывают связанные способы запуска или расширения сеансов Claude Code:

* [Skills](/docs/ru/skills): сохраните длинное приглашение runbook'а как `/skill` в репозитории, чтобы параметр `q` глубокой ссылки должен был только назвать его
* [Non-interactive mode](/docs/ru/headless): запустите Claude из скрипта и захватите вывод без открытия терминала