Skip to main content

Quickstart for GitHub Copilot

GitHub Copilot can help you work, by offering inline suggestions as you code.

GitHub Copilot está disponível para clientes GitHub com uma conta pessoal em GitHub.com. O GitHub Copilot é gratuito para uso para estudantes verificados e mantenedores de projetos de código aberto populares. Se você não for estudante nem mantenedor de projeto de código aberto popular, poderá experimentar o GitHub Copilot gratuitamente com uma avaliação única de 60 dias. Após a avaliação gratuita, você precisará de uma assinatura paga para uso contínuo. Para ver mais informações, confira "Sobre a cobrança do GitHub Copilot".

Introduction

GitHub Copilot is an AI pair programmer. You can use GitHub Copilot to get suggestions for whole lines or entire functions right inside your editor.

This guide will show you how to sign up for GitHub Copilot, install the GitHub Copilot extension in Visual Studio Code, and get your first suggestion. For more information on GitHub Copilot, see "About GitHub Copilot." For more in-depth information on how to use GitHub Copilot in a variety of environments, see "Getting Started."

Prerequisites

  • O GitHub Copilot é gratuito para uso para alunos verificados e mantenedores de código aberto.
  • Se você não for um aluno ou mantenedor de código aberto, poderá experimentar o GitHub Copilot gratuitamente com uma avaliação única de 60 dias. Após a avaliação gratuita, você precisará de uma assinatura paga para uso contínuo. Você deve fornecer informações de cobrança para iniciar uma avaliação gratuita. Para obter mais informações, confira "Sobre a cobrança do GitHub Copilot".
  • To use GitHub Copilot in Visual Studio Code, you must have Visual Studio Code installed. For more information, see the Visual Studio Code documentation.

Signing up for GitHub Copilot

Antes de começar a usar GitHub Copilot, você precisará configurar uma avaliação ou assinatura gratuita.

  1. No canto superior direito de qualquer página, clique na foto do seu perfil e em Configurações.

    Ícone Settings (Configurações) na barra de usuário

  2. Na seção "Código, planejamento e automação" da barra lateral, clique em GitHub Copilot .

  3. Na página de configurações de GitHub Copilot, clique em Habilitar GitHub Copilot .

    Captura de tela das configurações do GitHub Copilot com o botão Habilitar GitHub Copilot enfatizado

  4. Escolha se deseja pagar mensal ou anualmente e clique em Continuar para obter acesso ao Copilot.

    • Se sua conta pessoal atender aos critérios para uma assinatura gratuita do GitHub Copilot em vez de uma avaliação, você será direcionado automaticamente para a etapa 6.

    Captura de tela da configuração de teste com o botão Continuar para obter acesso ao Copilot enfatizado

  5. Siga as etapas para confirmar seus detalhes de pagamento e clique em Enviar.

  6. Selecione suas preferências e clique em Salvar e começar.

    Captura de tela das configurações do GitHub Copilot com o botão Salvar e começar

    Você pode alterar essas preferências posteriormente retornando às suas configurações do GitHub Copilot. Para ver mais informações, confira "Como configurar o GitHub Copilot no Visual Studio Code".

Installing the GitHub Copilot extension for Visual Studio Code

To use GitHub Copilot, you must first install the Visual Studio Code extension.

  1. In the Visual Studio Code Marketplace, go to the GitHub Copilot extension page and click Install. Install GitHub Copilot extension Visual Studio Code
  2. A popup will appear, asking to open Visual Studio Code. Click Open Visual Studio Code.
  3. In the "Extension: GitHub Copilot" tab in Visual Studio Code, click Install. Install button in Visual Studio Code
  4. If you have not previously authorized Visual Studio Code in your GitHub account, you will be prompted to sign in to GitHub in Visual Studio Code.
    • If you have previously authorized Visual Studio Code in your GitHub account, GitHub Copilot will be automatically authorized. Screen shot of Visual Studio Code authorization screen
  5. In your browser, GitHub will request the necessary permissions for GitHub Copilot. To approve these permissions, click Authorize Visual Studio Code.
  6. In Visual Studio Code, in the "Visual Studio Code" dialogue box, to confirm the authentication, click Open.

Getting your first suggestion

Note: If you have duplication detection enabled for GitHub Copilot, you may receive limited suggestions, or no suggestions, when using the code examples provided. As an alternative, you can start by typing your own code to see suggestions from GitHub Copilot. For more information on duplication detection, see "Enabling or disabling duplication detection."

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++. The following samples are in JavaScript, but other languages will work similarly.

  1. Open Visual Studio Code.

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

  3. No arquivo JavaScript, digite o cabeçalho da função a seguir.

    JavaScript
    function calculateDaysBetweenDates(begin, end) {

    GitHub Copilot will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. First suggestion Visual Studio Code

  4. Para aceitar a sugestão, pressione Tab.

Next Steps

You successfully installed GitHub Copilot and received your first suggestion, but that's just the beginning! Here are some helpful resources for taking your next steps with GitHub Copilot.

  • Getting Started: You've learned how to get your first suggestion in Visual Studio Code. These guides show you how to set up and navigate the various functions of GitHub Copilot across all of the supported environments.
  • GitHub Copilot: See practical examples of how GitHub Copilot can help you work.
  • Configuring GitHub Copilot: These guides provide details on how to configure GitHub Copilot to your personal preferences.

Further reading