Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Introdução ao GitHub Copilot

Você pode começar a usar o GitHub Copilot instalando a extensão em seu ambiente preferido.

GitHub Copilot pode ser gerenciado por meio de contas pessoais com o GitHub Copilot for Individuals ou por meio de contas da organização com GitHub Copilot for Business.

O GitHub Copilot é gratuito para uso de alunos, professores e mantenedores verificados de projetos populares de software livre. Se você não for aluno, professor nem mantenedor de um projeto popular de software livre, experimente o GitHub Copilot gratuitamente com uma avaliação única de 30 dias. Após a avaliação gratuita, você precisará de uma assinatura paga para uso contínuo. Para obter mais informações, confira "Sobre a cobrança para o GitHub Copilot".

Experimente o GitHub Copilot

Sobre o GitHub Copilot e IDEs JetBrains

O GitHub Copilot oferece sugestões de preenchimento automático de um programador de par de IA à medida que você cria o código. Para obter mais informações, confira "Sobre o GitHub Copilot for Individuals".

Se você usar um IDE JetBrains, poderá exibir e incorporar sugestões do GitHub Copilot diretamente no editor. Este guia demonstra como usar o GitHub Copilot dentro de um IDE JetBrains para macOS, Windows ou Linux.

Pré-requisitos

  • Para usar o GitHub Copilot, é preciso ter uma assinatura ativa do GitHub Copilot. Para obter mais informações, confira "Sobre a cobrança para o GitHub Copilot".

  • Para usar o GitHub Copilot no JetBrains, você deverá ter um IDE do JetBrains compatível instalado. O GitHub Copilot é compatível com as seguintes IDEs:

    • IntelliJ IDEA (Ultimate, Community, Educational)
    • Android Studio
    • AppCode
    • CLion
    • Code With Me Guest
    • DataGrip
    • DataSpell
    • GoLand
    • JetBrains Client
    • MPS
    • PhpStorm
    • PyCharm (Professional, Community, Educational)
    • Rider
    • RubyMine
    • WebStorm

    Para obter mais informações, confira o localizador de ferramentas JetBrains IDEs.

Instalar a extensão do GitHub Copilot no seu IDE JetBrains

Para usar o GitHub Copilot em um IDE JetBrains, você deverá instalar a extensão do GitHub Copilot. O procedimento a seguir guiará você pela instalação do plug-in do GitHub Copilot no IntelliJ IDEA. As etapas para instalar o plug-in em outro IDE com suporte podem ser diferentes.

  1. No IDE JetBrains, no menu Arquivo do Windows, ou sob o nome do IDE para Mac (por exemplo, PyCharm ou IntelliJ), clique em Configurações para o Windows ou em Preferências para o Mac.

  2. No menu esquerdo da caixa de diálogo Configurações/Preferências, clique em Plug-ins.

  3. Na parte superior da caixa de diálogo Configurações/Preferências, clique em Marketplace. Na barra de pesquisa, pesquise GitHub Copilot e clique em Instalar.

    Captura de tela da pesquisa do Marketplace

  4. Depois que o GitHub Copilot estiver instalado, clique em Reiniciar IDE.

  5. Depois que o IDE JetBrains for reiniciado, clique no menu Ferramentas. Clique em GitHub Copilot e clique Logon no GitHub .

    Captura de tela do menu de ferramentas do JetBrains.

  6. Na caixa de diálogo "Entrar no GitHub", para copiar o código do dispositivo e abrir a janela de ativação do dispositivo, clique em Copiar e Abrir.

    Captura de tela da cópia e abertura do código do dispositivo

  7. Uma janela de ativação do dispositivo será aberta no navegador. Cole o código do dispositivo e clique em Continuar.

  8. O GitHub solicitará as permissões necessárias para o GitHub Copilot. Para aprovar essas permissões, clique em Autorizar o plug-in do GitHub Copilot .

  9. Depois que as permissões forem aprovadas, o IDE JetBrains mostrará uma confirmação. Para começar a usar o GitHub Copilot, clique em OK.

Como ver a primeira sugestão

Observação: quando a detecção de duplicação está habilitada para o GitHub Copilot, há a possibilidade de você receber sugestões limitadas ou nenhuma sugestão ao usar os exemplos de código fornecidos. Como alternativa, é possível começar digitando seu próprio código a fim de ver sugestões do GitHub Copilot. Para obter mais informações sobre a detecção de duplicação, confira "Como definir as configurações do GitHub Copilot no GitHub.com".

O GitHub Copilot oferece sugestões para várias linguagens e uma ampla variedade de estruturas, mas funciona melhor para Python, JavaScript, TypeScript, Ruby, Go, C# e C++. Os exemplos a seguir estão em Java, mas outras linguagens funcionarão da mesma forma.

  1. No IDE da JetBrains, crie um arquivo Java ( *.java).
  2. No arquivo Java, crie uma classe digitando class Test. GitHub Copilot vai sugerir automaticamente um corpo de classe em texto esmaecido. A sugestão exata pode variar.
  3. Para aceitar a sugestão, pressione Tab.
  4. Para solicitar que o GitHub Copilot sugira um corpo de função, digite a linha a seguir abaixo do colchete da função main. A sugestão exata pode variar.
    Java
    int calculateDaysBetweenDates(
    ``` 1. Para aceitar a sugestão, pressione <kbd>Tab</kbd>.

O GitHub Copilot tentará fazer a correspondência entre o contexto e o estilo do seu código. Você sempre poderá editar o código sugerido.

Como ver sugestões alternativas

Para qualquer entrada fornecida, GitHub Copilot podem oferecer várias sugestões. Você pode selecionar qual sugestão usar ou rejeitar todas as sugestões.

  1. No IDE da JetBrains, crie um arquivo Java ( *.java).

  2. Para solicitar que o GitHub Copilot mostre uma sugestão, digite a linha a seguir no arquivo Java.

    Java
    int calculateDaysBetweenDates(
    ``` 1. Opcionalmente, você pode ver sugestões alternativas, quando há alguma disponível.
    
    | Sistema operacional | Ver a próxima sugestão | Ver a sugestão anterior |
    | :- | :- | :- |
    | macOS | <kbd>Opção</kbd>+<kbd>]</kbd> | <kbd>Opção</kbd>+<kbd>[</kbd> |
    | Windows | <kbd>Alt</kbd>+<kbd>]</kbd> | <kbd>Alt</kbd>+<kbd>[</kbd> |
    | Linux | <kbd>Alt</kbd>+<kbd>]</kbd> | <kbd>Alt</kbd>+<kbd>[</kbd> |
  3. Para aceitar uma sugestão, pressione Tab. Para rejeitar todas as sugestões, pressione Esc.

Como ver várias sugestões em uma nova guia

Você pode não querer nenhuma das sugestões iniciais que o GitHub Copilot oferece. Você pode usar um atalho de teclado para solicitar que GitHub Copilot mostre várias sugestões em uma nova guia.

  1. No IDE da JetBrains, crie um arquivo Java ( *.java).

  2. Para solicitar que o GitHub Copilot mostre uma sugestão, digite a linha a seguir no arquivo Java.

    Java
    int calculateDaysBetweenDates(
  3. Abra uma nova guia com várias sugestões adicionais.

    • No macOS, pressione Command+Shift+A e clique em Abrir o GitHub Copilot ou pressione Command+Shift+\ para abrir a nova guia imediatamente.
    • No Windows ou Linux, pressione Ctrl+Enter e clique em Abrir o GitHub Copilot.
  4. Para aceitar uma sugestão, acima da sugestão, clique em Aceitar Solução. Para rejeitar todas as sugestões, feche a guia.

Como gerar sugestões de código por meio de comentários

Você pode descrever algo que deseja fazer usando linguagem natural em um comentário e o GitHub Copilot sugerirá o código para atingir sua meta.

  1. No IDE da JetBrains, crie um arquivo Java ( *.java).
  2. Para solicitar que o GitHub Copilot sugira uma implementação de uma função no arquivo Java, digite as linhas a seguir.
    Java
    // find all images without alternate text
    // and give them a red border
    void process () {

Como habilitar e desabilitar o GitHub Copilot

Você pode habilitar ou desabilitar o GitHub Copilot para todas as linguagens ou para linguagens individuais. O ícone de status do GitHub Copilot no painel inferior da janela do IDE JetBrains indica se o GitHub Copilot está habilitado ou desabilitado. Quando habilitado, o ícone fica realçado. Quando desabilitado, o ícone fica esmaecido.

  1. Para habilitar ou desabilitar o GitHub Copilot, clique no ícone de status no painel inferior da janela JetBrains.

    Captura de tela do ícone de status no IntelliJ IDEA

  2. Se você estiver desabilitando o GitHub Copilot, será perguntado se deseja desabilitá-lo globalmente ou para a linguagem do arquivo que está editando no momento.

    • Para desabilitar as sugestões do GitHub Copilot globalmente, clique em Desabilitar Preenchimentos.
    • Para desabilitar as sugestões do GitHub Copilot para a linguagem especificada, clique em Desabilitar Preenchimentos para LINGUAGEM.

    Captura de tela da opção para desabilitar o GitHub Copilot globalmente ou para a linguagem atual

Leitura adicional

Sobre o GitHub Copilot no Visual Studio

O GitHub Copilot oferece sugestões de preenchimento automático de um programador de par de IA à medida que você cria o código. Para obter mais informações, confira "Sobre o GitHub Copilot for Individuals".

Usando o Visual Studio, você pode ver e incorporar sugestões do GitHub Copilot diretamente no editor. Este guia demonstra como usar o GitHub Copilot dentro do Visual Studio para Windows.

Pré-requisitos

  • Para usar o GitHub Copilot, é preciso ter uma assinatura ativa do GitHub Copilot. Para obter mais informações, confira "Sobre a cobrança para o GitHub Copilot".

  • Para usar o GitHub Copilot no Visual Studio, é preciso ter o Visual Studio 2022 17.4.4 ou posterior instalado. Para obter mais informações, confira a documentação do IDE do Visual Studio.

Observação: o GitHub Copilot não está disponível no momento para uso com Visual Studio para Mac.

Como instalar a extensão Visual Studio

Para usar o GitHub Copilot, você primeiro deve instalar a extensão Visual Studio.

  1. Na barra de ferramentas do Visual Studio, clique em Extensões e em Gerenciar Extensões.

    Captura de tela da barra de ferramentas do Visual Studio

  2. Na janela "Gerenciar Extensões", clique no Visual Studio Marketplace, pesquise a extensão do GitHub Copilot e clique em Baixar.

    Captura de tela da extensão do GitHub Copilot para Visual Studio com o botão de download enfatizado

  3. Feche a janela "Gerenciar Extensões", saia e inicie Visual Studio.

  4. Opcionalmente, para verificar se o GitHub Copilot está instalado e habilitado, volte para Gerenciar Extensões, clique em Instalado para exibir suas extensões instaladas no momento e clique em GitHub Copilot para ver informações de status.

    Captura de tela das extensões instaladas no Visual Studio com o GitHub Copilot destacado

  5. Abra ou crie um novo projeto no Visual Studio.

  6. Na caixa de diálogo "Microsoft Visual Studio", para copiar o código de ativação do dispositivo, clique em OK.

  7. Uma janela de ativação do dispositivo será aberta no navegador. Cole o código do dispositivo e clique em Continuar.

  8. O GitHub solicitará as permissões necessárias para o GitHub Copilot. Para aprovar essas permissões, clique em Autorizar o plugin do GitHub Copilot .

  9. Depois de aprovar as permissões, o Visual Studio mostrará uma confirmação.

Como ver a primeira sugestão

Observação: quando a detecção de duplicação está habilitada para o GitHub Copilot, há a possibilidade de você receber sugestões limitadas ou nenhuma sugestão ao usar os exemplos de código fornecidos. Como alternativa, é possível começar digitando seu próprio código a fim de ver sugestões do GitHub Copilot. Para obter mais informações sobre a detecção de duplicação, confira "Como definir as configurações do GitHub Copilot no GitHub.com".

O GitHub Copilot oferece sugestões para várias linguagens e uma ampla variedade de estruturas, mas funciona melhor para Python, JavaScript, TypeScript, Ruby, Go, C# e C++. Os exemplos a seguir estão em C#, mas as outras linguagens funcionarão da mesma forma.
  1. No Visual Studio, crie um arquivo C# ( *.cs).

  2. No arquivo #C, digite a seguinte assinatura de função. O GitHub Copilot sugerirá automaticamente um corpo inteiro da função em texto esmaecido, como é mostrado abaixo. A sugestão exata pode variar.

    C#
    int CalculateDaysBetweenDates(
  3. Para aceitar a sugestão, pressione Tab.

Como ver sugestões alternativas

Para qualquer entrada fornecida, GitHub Copilot podem oferecer várias sugestões. Você pode selecionar qual sugestão usar ou rejeitar todas as sugestões. 1. No Visual Studio, crie um arquivo C# ( *.cs).

  1. No arquivo #C, digite a seguinte assinatura de função. GitHub Copilot will show you a suggestion.

    C#
    int CalculateDaysBetweenDates(
  2. Se sugestões alternativas estiverem disponíveis, você poderá ver essas alternativas pressionando Alt+] (ou Alt+[).

  3. Como opção, você pode focalizar a sugestão para ver a paleta de comandos do GitHub Copilot e escolher sugestões.

  4. Para aceitar uma sugestão, pressione Tab. Para rejeitar todas as sugestões, pressione Esc.

Gerar sugestões de código por meio de comentários

Você pode descrever algo que deseja fazer usando linguagem natural em um comentário e o GitHub Copilot sugerirá o código para atingir sua meta.

  1. No Visual Studio, crie um arquivo C# ( *.cs).

  2. No arquivo C#, digite o comentário a seguir. O GitHub Copilot sugerirá uma implementação da função.

    C#
    using System.Xml.Linq;
    
    var doc = XDocument.Load("index.xhml");
    
    // find all images
  3. Para aceitar a sugestão, pressione Tab.

Como habilitar ou desabilitar o GitHub Copilot

O ícone de status do GitHub Copilot no painel inferior da janela do Visual Studio indica se o GitHub Copilot está habilitado ou desabilitado. Quando ele estiver habilitado, a cor da tela de fundo do ícone corresponderá à cor da barra de status. Quando desabilitado, haverá uma linha diagonal ao longo dele.

  1. Para habilitar ou desabilitar o GitHub Copilot, clique no ícone GitHub Copilot no painel inferior da janela do Visual Studio.

    Captura de tela da margem do editor no Visual Studio com o ícone do GitHub Copilot enfatizado

  2. Quando você estiver desabilitando o GitHub Copilot, será perguntado se deseja desabilitar as sugestões globalmente ou para a linguagem do arquivo em edição no momento.

    • Para desabilitar as sugestões do GitHub Copilot globalmente, clique em Habilitar Globalmente.
    • Para desabilitar as sugestões do GitHub Copilot para a linguagem especificada, clique em Habilitar para LINGUAGEM.

Leitura adicional

Sobre o GitHub Copilot e o Visual Studio Code

O GitHub Copilot oferece sugestões de preenchimento automático de um programador de par de IA à medida que você cria o código. Para obter mais informações, confira "Sobre o GitHub Copilot for Individuals".

Usando o Visual Studio Code, você pode ver e incorporar sugestões do GitHub Copilot diretamente no editor. Este guia demonstra como usar o GitHub Copilot dentro do Visual Studio Code para macOS, Windows ou Linux.

Pré-requisitos

Como instalar a extensão Visual Studio Code

Para usar o GitHub Copilot, primeiro você precisa instalar a extensão Visual Studio Code.

  1. No Visual Studio Code Marketplace, acesse a página Extensão do GitHub Copilot e clique em Instalar.

  2. Um pop-up será exibido, solicitando que você abra o Visual Studio Code. Clique em Abrir o Visual Studio Code .

  3. Na guia "Extensão: GitHub Copilot" no Visual Studio Code, clique em Instalar.

  4. Se você ainda não tiver autorizado o Visual Studio Code na conta do GitHub, será solicitado que você entre no GitHub no Visual Studio Code.

    • Se você já tiver autorizado o Visual Studio Code para sua conta no GitHub, o GitHub Copilot será autorizado automaticamente.
  5. No navegador, o GitHub solicitará as permissões necessárias para o GitHub Copilot. Para aprovar essas permissões, clique em Autorizar o Visual Studio Code .

  6. Para confirmar a autenticação, no Visual Studio Code, na caixa de diálogo "Visual Studio Code", clique em Abrir.

Como ver a primeira sugestão

Observação: quando a detecção de duplicação está habilitada para o GitHub Copilot, há a possibilidade de você receber sugestões limitadas ou nenhuma sugestão ao usar os exemplos de código fornecidos. Como alternativa, é possível começar digitando seu próprio código a fim de ver sugestões do GitHub Copilot. Para obter mais informações sobre a detecção de duplicação, confira "Como definir as configurações do GitHub Copilot no GitHub.com".

O GitHub Copilot oferece sugestões para várias linguagens e uma ampla variedade de estruturas, mas funciona melhor para Python, JavaScript, TypeScript, Ruby, Go, C# e C++. Os exemplos a seguir estão em JavaScript, mas as outras linguagens funcionarão da mesma forma.

  1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).

  2. No arquivo JavaScript, digite o cabeçalho da função a seguir. O GitHub Copilot vai sugerir automaticamente um corpo inteiro da função em texto esmaecido, como é mostrado abaixo. A sugestão exata pode variar.

    JavaScript
    function calculateDaysBetweenDates(begin, end) {
  3. Para aceitar a sugestão, pressione Tab.

Como ver sugestões alternativas

Para qualquer entrada fornecida, GitHub Copilot podem oferecer várias sugestões. Você pode selecionar qual sugestão usar ou rejeitar todas as sugestões.

  1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).

  2. No arquivo JavaScript, digite o cabeçalho da função a seguir. GitHub Copilot mostrará uma sugestão.

    JavaScript
    function calculateDaysBetweenDates(begin, end) {
  3. Opcionalmente, você pode ver sugestões alternativas, quando há alguma disponível.

    Sistema operacionalVer a próxima sugestãoVer a sugestão anterior
    macOSOpção (⌥) ou Alt+]Opção (⌥) ou Alt+[
    WindowsAlt+]Alt+[
    LinuxAlt+]Alt+[
  4. Como alternativa, você pode focalizar a sugestão para ver a paleta de comandos do GitHub Copilot e escolher sugestões.

  5. Para aceitar uma sugestão, pressione Tab. Para rejeitar todas as sugestões, pressione Esc.

Como ver várias sugestões em uma nova guia

Você pode não querer nenhuma das sugestões iniciais que o GitHub Copilot oferece. Você pode usar um atalho de teclado para solicitar que GitHub Copilot mostre várias sugestões em uma nova guia.

  1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).
  2. No arquivo JavaScript, digite o cabeçalho da função a seguir. GitHub Copilot mostrará uma sugestão.
    JavaScript
    function calculateDaysBetweenDates(begin, end) {
  3. Para abrir uma nova guia com várias opções adicionais, pressione Ctrl+Enter.
  4. Para aceitar uma sugestão, acima da sugestão, clique em Aceitar Solução. Para rejeitar todas as sugestões, feche a guia.

Como gerar sugestões de código por meio de comentários

Você pode descrever algo que deseja fazer usando linguagem natural em um comentário e o GitHub Copilot sugerirá o código para atingir sua meta.

  1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).
  2. No arquivo JavaScript, digite o comentário a seguir. O GitHub Copilot vai sugerir uma implementação da função.
    JavaScript
    // find all images without alternate text
    // and give them a red border
    function process() {

Como usar uma estrutura

Você também pode usar o GitHub Copilot para gerar sugestões de APIs e estruturas. O exemplo a seguir usa o GitHub Copilot para criar um servidor Express simples que retorna a hora atual.

  1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).
  2. No arquivo JavaScript, digite o comentário a seguir e pressione Enter. O GitHub Copilot vai sugerir uma implementação do aplicativo Express.
    JavaScript
    // Express server on port 3000
  3. To accept each line, press Tab, then Enter.
  4. Type the following comment and then press Enter. GitHub Copilot will suggest an implementation for the default handler.
    JavaScript
    // Return the current time
  5. Para aceitar cada linha, pressione Tab.

Como habilitar ou desabilitar o GitHub Copilot

Você pode habilitar ou desabilitar o GitHub Copilot de dentro do Visual Studio Code. O ícone de status do GitHub Copilot no painel inferior da janela do Visual Studio Code indica se o GitHub Copilot está habilitado ou desabilitado. Quando ele estiver habilitado, a cor da tela de fundo do ícone corresponderá à cor da barra de status. Quando ele estiver desabilitado, a cor da tela de fundo do ícone se contrastará com a cor da barra de status.

  1. Para habilitar ou desabilitar o GitHub Copilot, clique no ícone de status no painel inferior da janela do Visual Studio Code.

    Captura de tela no painel inferior em Visual Studio Code. O ícone GitHub Copilot é contornado em laranja escuro.

  2. Quando você estiver desabilitando o GitHub Copilot, será perguntado se deseja desabilitar as sugestões globalmente ou para a linguagem do arquivo em edição no momento.

    • Para desabilitar as sugestões do GitHub Copilot globalmente, clique em Desabilitar Globalmente.
    • Para desabilitar as sugestões do GitHub Copilot para a linguagem especificada, clique em Desabilitar para LINGUAGEM. Captura de tela da opção para desabilitar o GitHub Copilot globalmente ou para a linguagem atual

Leitura adicional

Sobre o GitHub Copilot e o Neovim

O GitHub Copilot oferece sugestões de preenchimento automático de um programador de par de IA à medida que você cria o código. Para obter mais informações, confira "Sobre o GitHub Copilot for Individuals".

Ao usar o Neovim, é possível exibir e incorporar sugestões do GitHub Copilot diretamente no editor.

Pré-requisitos

Como instalar a extensão Neovim no macOS

  1. O GitHub recomenda que você instale o plug-in do GitHub Copilot com o gerenciador de plug-ins interno do Neovim. Como alternativa, você pode usar um gerenciador de plug-ins de sua escolha para instalar o github/copilot.vim.

    • Para instalar o GitHub Copilot com o gerenciador de plug-ins interno do Neovim, insira o seguinte comando no terminal:

      git clone https://github.com/github/copilot.vim \
         ~/.config/nvim/pack/github/start/copilot.vim
      
  2. Para configurar o GitHub Copilot, abra o Neovim e insira o comando a seguir.

    :Copilot setup
    
  3. Habilite o GitHub Copilot na configuração do Neovim ou com o comando Neovim.

    :Copilot enable
    

Como instalar a extensão Neovim no Windows

  1. O GitHub recomenda que você instale o plug-in do GitHub Copilot com o gerenciador de plug-ins interno do Neovim. Como alternativa, você pode usar um gerenciador de plug-ins de sua escolha para instalar o github/copilot.vim.

    • Para instalar o GitHub Copilot com o gerenciador de plug-ins interno do Neovim, insira o seguinte comando no Git Bash:

        git clone https://github.com/github/copilot.vim.git \
         $HOME/AppData/Local/nvim/pack/github/start/copilot.vim
      
  2. Para configurar o GitHub Copilot, abra o Neovim e insira o comando a seguir.

    :Copilot setup
    
  3. Habilite o GitHub Copilot na configuração do Neovim ou com o comando Neovim.

    :Copilot enable
    

Como instalar a extensão Neovim no Linux

  1. O GitHub recomenda que você instale o plug-in do GitHub Copilot com o gerenciador de plug-ins interno do Neovim. Como alternativa, você pode usar um gerenciador de plug-ins de sua escolha para instalar o github/copilot.vim.

    • Para instalar o GitHub Copilot com o gerenciador de plug-in interno do Neovim, insira o seguinte comando:

      git clone https://github.com/github/copilot.vim \
         ~/.config/nvim/pack/github/start/copilot.vim
      
  2. Para configurar o GitHub Copilot, abra o Neovim e insira o comando a seguir.

    :Copilot setup
    
  3. Habilite o GitHub Copilot na configuração do Neovim ou com o comando Neovim.

    :Copilot enable
    

Aprendendo a usar o GitHub Copilot no Neovim

Para obter diretrizes sobre como usar o GitHub Copilot no Neovim, exiba a documentação do plug-in. Para ver a documentação, abra o Neovim e execute o seguinte comando:

:help copilot

Leitura adicional