# Использование расширений GitHub CLI

Узнайте, как использовать пользовательские расширения, написанные другими пользователями GitHub CLI.

## Сведения о расширениях GitHub CLI

> [!NOTE]
> Расширения за пределами GitHub и GitHub CLI не сертифицированы GitHub и регулируются отдельными условиями использования, политикой конфиденциальности и поддерживающей документацией. Чтобы снизить риск при использовании сторонних расширений, выполните аудит исходного кода расширения перед установкой или обновлением расширения.

Расширения GitHub CLI — это пользовательские команды GitHub CLI, которые может создавать и применять любой пользователь. Для получения дополнительной информации о создании расширений GitHub CLI см. [Создание расширений GitHub CLI](/ru/enterprise-server@3.20/github-cli/github-cli/creating-github-cli-extensions).

Расширения устанавливаются локально и ограничены пользователем. Таким образом, если вы access GitHub CLI с другой машины или другой пользователь получает доступ к GitHub CLI с той же машины, расширение будет недоступно.

## Поиск расширений

Расширения можно найти, просматривая [репозитории с темой `gh-extension`](https://github.com/topics/gh-extension).

## Установка расширений

Чтобы установить расширение, используйте подкоманду `extensions install`. Замените параметр `repo` на репозиторий расширения. Вы можете использовать полный URL, например `https://github.com/octocat/gh-whoami`, или только владельца и репозиторий, например `octocat/gh-whoami`.

Если используется владелец и репозиторий, `gh`установит расширение с использованием имени узла, к которому `gh` в настоящее время выполняет проверку подлинности. Формат полного URL-адреса полезен при установке расширений с другого узла. Например, пользователи на GitHub Enterprise Server должны использовать полный URL-адрес репозитория, чтобы установить расширения с GitHub.com или любого другого узла.

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

```shell
gh extension install REPO
```

Если у вас уже установлено расширение с тем же именем, команда завершится ошибкой. Например, если вы уже установили `octocat/gh-whoami`, то необходимо его удалить перед установкой `hubot/gh-whoami`.

## Запуск расширения

При установке расширения вы запускаете расширение, выполнив собственную команду GitHub CLI с помощью `gh EXTENSION-NAME`команды . Имя `EXTENSION-NAME` репозитория, содержащего расширение, минус `gh-` префикс.

Например, если вы установили расширение из `octocat/gh-whoami` репозитория, выполните расширение с помощью следующей команды.

```shell
gh whoami
```

Обычно можно найти конкретные сведения об использовании расширения в README репозитория, содержащего расширение.

## Отображение установленных расширений

Чтобы просмотреть все установленные расширения, используйте подкоманду `extensions list`. В выходных данных также будет указано, для каких расширений доступны обновления.

```shell
gh extension list
```

## Обновление расширений

Чтобы обновить расширение, используйте подкоманду `extensions upgrade`. Замените параметр `extension` на имя расширения.

```shell
gh extension upgrade EXTENSION
```

Чтобы обновить все установленные расширения, используйте флаг `--all`.

```shell
gh extension upgrade --all
```

## Удаление расширений

Чтобы удалить расширение, используйте подкоманду `extensions remove`. Замените параметр `extension` на имя расширения.

```shell
gh extension remove EXTENSION
```