{"meta":{"title":"Localizando e instalando plug-ins para GitHub Copilot CLI","intro":"Estenda Copilota funcionalidade instalando plug-ins criados pela comunidade ou pela sua equipe.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/how-tos","title":"Instruções"},{"href":"/pt/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/pt/copilot/how-tos/copilot-cli/customize-copilot","title":"Personalizar Copilot CLI"},{"href":"/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing","title":"Plug-ins: Localizar e instalar"}],"documentType":"article"},"body":"# Localizando e instalando plug-ins para GitHub Copilot CLI\n\nEstenda Copilota funcionalidade instalando plug-ins criados pela comunidade ou pela sua equipe.\n\n## Introdução\n\nPlug-ins são pacotes que estendem a funcionalidade de Copilot CLI. Você pode instalar um plug-in de um marketplace registrado na CLI.\n\nPara saber mais, confira [Sobre plug-ins GitHub Copilot](/pt/copilot/concepts/agents/about-plugins).\n\n> \\[!NOTE]\n> Você pode encontrar ajuda para usar plug-ins entrando `copilot plugin [SUBCOMMAND] --help` no terminal.\n\n## Localizando plug-ins\n\nEsses plug-ins são organizados em marketplaces. Um marketplace é um registro de plug-ins dos quais você pode navegar e instalar. É possível adicionar um marketplace à sua configuração da CLI, o que permite usar a CLI para navegar e instalar plugins desse marketplace—consulte [Adicionando marketplaces de plugins](#adding-plugin-marketplaces).\nCopilot vem com dois marketplaces já registrados por padrão: `copilot-plugins` e `awesome-copilot`.\n\nPara usar a CLI para navegar pelos plug-ins em um de seus marketplaces registrados:\n\n1. **Verifique quais marketplaces estão registrados no momento.**\n\n   No terminal, liste os marketplaces disponíveis inserindo:\n\n   ```shell copy\n   copilot plugin marketplace list\n   ```\n\n   Como alternativa, em uma sessão interativa, insira:\n\n   ```copilot copy\n   /plugin marketplace list\n   ```\n\n2. **Navegue pelos plug-ins em um marketplace registrado.**\n\n   Na lista de marketplaces registrados, copie o nome do marketplace que você deseja procurar, por exemplo, `awesome-copilot`insira o seguinte comando, substituindo `MARKETPLACE-NAME`:\n\n   ```shell copy\n   copilot plugin marketplace browse MARKETPLACE-NAME\n\n   ```\n\n## Instalando plug-ins\n\nVocê pode instalar plug-ins de um marketplace registrado. Para obter informações sobre como registrar marketplaces adicionais, consulte [Adicionando marketplaces de plug-in](#adding-plugin-marketplaces).\n\nPara instalar um plug-in, insira:\n\n```shell copy\ncopilot plugin install PLUGIN-NAME@MARKETPLACE-NAME\n```\n\nPor exemplo, para instalar o `database-data-management` plug-in do `awesome-copilot` marketplace, insira:\n\n```shell copy\ncopilot plugin install database-data-management@awesome-copilot\n```\n\nComo alternativa, em uma sessão interativa, insira:\n\n```copilot copy\n/plugin install PLUGIN-NAME@MARKETPLACE-NAME\n```\n\n## Gerenciando plug-ins instalados\n\n```bash\ncopilot plugin list                    # View installed plugins\ncopilot plugin update PLUGIN-NAME      # Update plugin to latest version\ncopilot plugin uninstall PLUGIN-NAME   # Remove plugin completely\n```\n\n## Adicionando marketplaces de plugins\n\nPara adicionar um marketplace à lista de marketplaces registrados, insira o seguinte comando no terminal:\n\n```shell copy\ncopilot plugin marketplace add OWNER/REPO\n```\n\nO formato OWNER/REPO identifica um repositório em GitHub.com configurado como um marketplace de plug-ins para a CLI.\n\nPor exemplo, para adicionar o `claude-code-plugins` marketplace, hospedado em <https://github.com/anthropics/claude-code>, insira:\n\n```shell copy\ncopilot plugin marketplace add anthropics/claude-code\n```\n\nComo alternativa, em uma sessão interativa, insira:\n\n```copilot copy\n/plugin marketplace add OWNER/REPO\n```\n\nSe um marketplace estiver localizado no sistema de arquivos local, em vez de em GitHub.com, use o caminho para o diretório do marketplace ao invés de OWNER/REPO. Por exemplo:\n\n```shell copy\ncopilot plugin marketplace add /PATH/TO/MARKETPLACE-DIRECTORY\n```\n\nSe um marketplace estiver localizado em um repositório Git que não está hospedado no GitHub.com, use a URL do repositório Git. Por exemplo:\n\n```shell copy\ncopilot plugin marketplace add https://gitlab.com/OWNER/REPO.git\n```\n\n## Removendo marketplaces de plugins\n\nPara remover um marketplace da CLI, insira:\n\n```shell copy\ncopilot plugin marketplace remove MARKETPLACE-NAME\n```\n\nOu, em uma sessão interativa:\n\n```copilot copy\n/plugin marketplace remove MARKETPLACE-NAME\n```\n\n> \\[!NOTE]\n>\n> * Ao adicionar um marketplace, você faz referência ao marketplace usando o OWNER/REPO do GitHub repositório que foi configurado como um marketplace. Ao remover um marketplace, no entanto, você faz referência ao nome do marketplace como ele aparece em sua lista de marketplaces registrados.\n> * Se você tentar remover um marketplace que tenha plug-ins instalados, o comando falhará com uma mensagem de erro que lista os plug-ins instalados no momento desse marketplace. Adicione a opção `--force` ao comando para remover o marketplace e desinstalar todos os plug-ins que foram instalados desse marketplace.\n\n## Leitura adicional\n\n* [Criando um plug-in para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating)\n* [Criando um marketplace de plugin para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace)"}