Você quer escrever código mais rápido com assistência de IA em um ambiente de desenvolvimento baseado em nuvem. O GitHub Copilot combinado com o GitHub Codespaces oferece sugestões de código inline diretamente no seu IDE baseado em navegador. Essa combinação elimina a necessidade de instalar ferramentas localmente, enquanto ainda oferece conclusões em tempo real, geração de funções e suporte por chat. Este artigo explica como configurar o Copilot no Codespaces, configurar a extensão e usar seus recursos principais de forma eficaz.
Principais conclusões: Habilitando e usando o GitHub Copilot no Codespaces
- Extensão do GitHub Copilot no Codespaces: Instalada automaticamente quando você ativa o Copilot nas configurações da sua conta do GitHub para o serviço Codespaces.
- Ctrl+Enter ou Cmd+Enter: Abre o painel de conclusões do Copilot para navegar por várias alternativas de sugestão no editor do Codespaces.
- devcontainer.json > array
extensions: Garante que a extensão do Copilot seja pré-instalada em cada novo Codespace do seu repositório.
Como o GitHub Copilot funciona no Codespaces
O GitHub Copilot é um programador parceiro de IA que sugere código enquanto você digita. Ele usa o modelo OpenAI Codex treinado em repositórios de código público. No Codespaces, o Copilot é executado como uma extensão do Visual Studio Code dentro do editor baseado em navegador. A extensão se comunica com o serviço de backend do Copilot por meio da sua conta do GitHub. Não é necessária nenhuma instalação local na sua máquina. Todo o processamento acontece na nuvem e as sugestões aparecem inline na janela do editor.
Para usar o Copilot no Codespaces, você precisa de uma assinatura ativa do GitHub Copilot. Os planos Individual, Business ou Enterprise funcionam. Você também precisa de uma conta do GitHub com pelo menos um repositório. O Codespaces deve estar ativado para sua conta ou organização. A extensão do Copilot está disponível no Visual Studio Code Marketplace e pode ser adicionada à configuração do seu Codespace.
Pré-requisitos
Antes de começar, verifique se os seguintes itens estão em ordem:
- Uma conta do GitHub com uma assinatura ativa do Copilot. Verifique seu status em github.com/settings/copilot.
- Codespaces ativado para sua conta. Acesse github.com/settings/codespaces e certifique-se de que o recurso está ativo.
- Um repositório que você possa abrir no Codespaces. Qualquer repositório público ou privado funciona.
- Um navegador compatível com Codespaces. Chrome, Firefox, Edge e Safari funcionam.
Passos para configurar o GitHub Copilot no Codespaces
Siga estes passos para começar a usar o Copilot dentro de um Codespace. O processo envolve ativar a extensão na sua conta e depois criar um Codespace.
- Ative o Copilot para sua conta do GitHub
Acesse github.com/settings/copilot e clique no botão Enable Copilot se ele ainda não estiver ativo. Selecione seu tipo de plano. Para usuários Business ou Enterprise, o administrador da sua organização pode precisar conceder acesso primeiro. - Abra um repositório no Codespaces
Navegue até qualquer repositório no GitHub. Clique no botão verde Code e selecione a guia Codespaces. Clique em Create codespace on main para iniciar um novo ambiente. Aguarde o carregamento do editor baseado em navegador. - Instale a extensão do Copilot
No editor do Codespaces, abra a visualização de Extensões clicando no ícone de Extensões na barra lateral esquerda ou pressionando Ctrl+Shift+X. Pesquise por GitHub Copilot e clique em Install. A extensão é ativada automaticamente após a instalação. - Faça login no Copilot
Após a instalação, um prompt de autenticação do GitHub aparece no canto inferior direito. Clique em Sign in e siga o fluxo de autorização baseado em navegador. Permita as permissões solicitadas. O ícone do Copilot na barra de status muda de cinza para laranja para indicar que está ativo. - Teste o Copilot com um comentário de código
Abra um novo arquivo clicando em File > New File. Digite um comentário descrevendo uma função, como// função para calcular fatorial. Pressione Enter. O Copilot sugere um bloco de código. Pressione Tab para aceitar a sugestão.
Configure o Copilot no devcontainer.json
Para disponibilizar a extensão do Copilot em todos os Codespaces de um repositório, adicione-a ao arquivo de configuração devcontainer.json. Este arquivo fica na pasta .devcontainer na raiz do seu repositório. Se a pasta não existir, crie-a.
- Crie ou abra o devcontainer.json
No seu repositório, navegue até .devcontainer/devcontainer.json. Se o arquivo não existir, crie-o com um objeto JSON vazio. - Adicione o array extensions
Insira o seguinte JSON no arquivo:{"extensions": ["GitHub.copilot"]}. Salve o arquivo e faça commit no repositório. - Reconstrua o Codespace
Abra a paleta de comandos com Ctrl+Shift+P, digite Rebuild Container e selecione a opção. O Codespace é reconstruído com a extensão do Copilot pré-instalada.
Padrões comuns de uso do Copilot no Codespaces
Depois que o Copilot estiver ativo, você pode usar vários padrões de interação para obter os melhores resultados.
Conclusões de código inline
Enquanto você digita código, o Copilot sugere conclusões em texto cinza. Pressione Tab para aceitar a sugestão completa. Pressione Ctrl+Seta para a direita para aceitar uma única palavra. Pressione Escape para descartar a sugestão. Para percorrer várias sugestões, pressione Alt+] para a próxima sugestão e Alt+[ para a anterior. Abra o painel de conclusões pressionando Ctrl+Enter para ver uma lista de até dez alternativas.
Copilot Chat
A extensão Copilot Chat fornece uma interface conversacional. Instale a extensão GitHub Copilot Chat na visualização de Extensões. Abra o painel de chat clicando no ícone de Chat na barra lateral esquerda ou pressionando Ctrl+Shift+I. Digite perguntas sobre sua base de código, como Explique esta função ou Gere um teste de unidade para esta classe. O chat usa o contexto do arquivo atual para fornecer respostas relevantes.
Transformações de código com chat inline
Selecione um bloco de código no editor. Pressione Ctrl+I para abrir o prompt de chat inline. Digite um comando de transformação, como Converta isso para async/await ou Adicione tratamento de erros. O Copilot modifica o código selecionado diretamente no editor. Revise a alteração e aceite ou rejeite.
Se o Copilot não estiver funcionando no Codespaces
Vários problemas podem impedir o Copilot de funcionar corretamente em um Codespace. Verifique esses problemas comuns e suas correções.
Extensão do Copilot não instalada
A causa mais comum é a falta da extensão. Abra a visualização de Extensões e verifique se o GitHub Copilot aparece na lista. Se estiver faltando, instale-o manualmente. Se você usa uma configuração devcontainer.json, certifique-se de que o array extensions inclua GitHub.copilot e reconstrua o container.
Falha na autenticação
Se o ícone do Copilot na barra de status estiver cinza, você não está logado. Clique no ícone e siga o fluxo de autenticação. Se a autorização baseada em navegador falhar, abra a paleta de comandos com Ctrl+Shift+P, digite GitHub Copilot: Sign In e conclua o processo novamente. Verifique se sua assinatura do Copilot está ativa nas configurações do GitHub.
Sugestões não aparecem
O Copilot pode parar de sugerir código se o tipo de arquivo não for suportado. O Copilot suporta a maioria das linguagens de programação, incluindo Python, JavaScript, TypeScript, Ruby, Go, Java e C#. Se você estiver trabalhando em um arquivo Markdown ou YAML, o Copilot pode não fornecer conclusões. Verifique também se a extensão do Copilot está ativada verificando o ícone na barra de status. Se o ícone estiver laranja, o Copilot está ativo.
Limites de recursos do Codespace
Os Codespaces do plano gratuito têm horas de núcleo limitadas por mês. Se você atingir o limite, os Codespaces param e o Copilot não pode funcionar. Verifique seu uso em github.com/settings/billing. Faça upgrade para um plano pago ou aguarde a reinicialização mensal.
GitHub Copilot no Codespaces vs VS Code local: principais diferenças
| Item | Codespaces | VS Code local |
|---|---|---|
| Instalação | Extensão instalada via visualização de Extensões do navegador ou devcontainer.json | Extensão instalada do VS Code Marketplace na sua máquina |
| Desempenho | Depende das especificações da VM do Codespace e da latência da rede | Depende da CPU, RAM e velocidade da internet locais |
| Persistência | Configuração compartilhada via devcontainer.json no repositório | Configuração armazenada nas configurações locais do usuário |
| Autenticação | Requer fluxo OAuth do GitHub no navegador | Requer fluxo OAuth do GitHub no VS Code |
| Custo | Usa horas de computação do Codespace mais assinatura do Copilot | Apenas assinatura do Copilot necessária |
Coisas a evitar ao usar o Copilot no Codespaces
Evite estes erros para manter o Copilot funcionando sem problemas.
Esquecer de adicionar o Copilot ao devcontainer.json
Se você não adicionar a extensão do Copilot ao devcontainer.json, cada novo Codespace exigirá instalação manual. Isso perde tempo e pode causar confusão entre os membros da equipe. Sempre inclua GitHub.copilot no array extensions.
Usar o Copilot com arquivos não salvos
O Copilot usa o contexto do arquivo atual para gerar sugestões. Se você trabalhar em um arquivo não salvo, o Copilot terá menos contexto e pode produzir sugestões de qualidade inferior. Salve seu arquivo com uma extensão adequada antes de escrever código.
Ignorar sugestões do Copilot que contenham problemas de licenciamento
O Copilot pode sugerir código que corresponda a repositórios públicos. Revise as sugestões em busca de possíveis conflitos de licenciamento, especialmente em projetos comerciais. Use as configurações do Copilot para bloquear sugestões que correspondam a código público, ativando a opção Block suggestions matching public code nas configurações do GitHub Copilot.
Conclusão
Agora você pode configurar o GitHub Copilot no Codespaces e usar conclusões inline, chat e transformações inline. Comece ativando o Copilot na sua conta do GitHub, criando um Codespace e instalando a extensão. Adicione a extensão ao devcontainer.json para automatizar a configuração para sua equipe. Para geração de código mais rápida, pratique o uso de Ctrl+Enter para navegar por várias sugestões e Ctrl+I para transformações de código inline.