Talvez você precise desabilitar o GitHub Copilot para um projeto específico enquanto o mantém ativo em todos os outros. Isso é comum ao trabalhar com código confidencial, algoritmos proprietários ou projetos onde sugestões de IA não são permitidas pela política da empresa. O Visual Studio Code permite configurações por workspace que substituem a configuração global. Este artigo mostra como desabilitar o Copilot para um único workspace usando o arquivo settings.json e a paleta de comandos do VS Code.
Principais Pontos: Desabilitar o GitHub Copilot em um Workspace
- settings.json do workspace: Adicione
"github.copilot.enable": falsepara desabilitar o Copilot apenas no projeto atual. - Paleta de Comandos > Developer: Reload Window: Aplique a alteração sem reiniciar o VS Code.
- Ícone da barra de status: Clique no ícone do Copilot na barra de status e selecione “Disable for Workspace” para uma alternância rápida.
Como as Configurações de Workspace do VS Code Funcionam para Extensões
O VS Code separa as configurações em três níveis: usuário, workspace e pasta. As configurações de usuário se aplicam a todos os projetos. As configurações de workspace se aplicam apenas à pasta do projeto atual. Quando ambas existem, a configuração do workspace substitui a configuração do usuário para aquele projeto. Essa hierarquia permite desabilitar uma extensão como o GitHub Copilot em um workspace sem afetar outros.
A configuração que controla o Copilot é github.copilot.enable. Ela aceita um valor booleano: true habilita o Copilot, false o desabilita. Ao colocar essa configuração no arquivo settings.json do workspace, você restringe a alteração a esse projeto específico.
Antes de começar, verifique se a extensão GitHub Copilot está instalada e você está conectado. O workspace deve estar aberto no VS Code. Você não precisa de direitos de administrador na máquina para alterar as configurações do workspace.
Passos para Desabilitar o GitHub Copilot em um Único Workspace
Existem dois métodos para desabilitar o Copilot por workspace. Use o editor de configurações para uma abordagem visual ou a paleta de comandos para um fluxo de trabalho mais rápido.
Método 1: Usando o Editor de Configurações
- Abra a Paleta de Comandos
Pressione Ctrl+Shift+P no Windows ou Linux, ou Cmd+Shift+P no macOS. - Abra as Configurações do Workspace
Digite Preferences: Open Workspace Settings (JSON) e selecione. Isso abre o arquivo settings.json específico do workspace. - Adicione a Configuração para Desabilitar o Copilot
Insira a seguinte linha dentro do objeto JSON:"github.copilot.enable": false
Se o arquivo estiver vazio, coloque entre chaves:{ "github.copilot.enable": false } - Salve o Arquivo
Pressione Ctrl+S ou Cmd+S para salvar. O VS Code aplica a configuração imediatamente. - Recarregue a Janela
Abra a Paleta de Comandos novamente, digite Developer: Reload Window e pressione Enter. Isso garante que a extensão releia as configurações.
Método 2: Usando o Ícone da Barra de Status
- Localize o Ícone do Copilot na Barra de Status
Olhe no canto inferior direito da janela do VS Code. O ícone do Copilot aparece como um pequeno balão de chat ou o logotipo do Copilot. - Clique no Ícone
Um menu aparece com opções para habilitar ou desabilitar o Copilot. - Selecione Disable for Workspace
Clique em Disable for Workspace. O VS Code adiciona a configuraçãogithub.copilot.enableao arquivo settings.json do workspace automaticamente. - Recarregue a Janela
Abra a Paleta de Comandos com Ctrl+Shift+P ou Cmd+Shift+P, digite Developer: Reload Window e pressione Enter.
Problemas Comuns ao Desabilitar o Copilot por Workspace
Copilot Ainda Aparece no Workspace Após Desabilitar
Se as sugestões do Copilot ainda aparecerem, a configuração do workspace pode não ter sido salva corretamente. Abra o arquivo settings.json do workspace novamente e verifique se a linha "github.copilot.enable": false existe. Verifique também se não há uma configuração de usuário conflitante. Vá em File > Preferences > Settings, pesquise por github.copilot.enable e certifique-se de que a configuração de nível de usuário não está forçando como true. A configuração do workspace deve substituí-la, mas um bug em versões antigas do VS Code pode causar conflitos. Atualize o VS Code para a versão mais recente se isso ocorrer.
Copilot Desabilitado para Todos os Workspaces em Vez de Apenas Um
Isso acontece quando você edita acidentalmente o arquivo global de configurações do usuário (settings.json) em vez do arquivo de configurações do workspace. Para confirmar se está no arquivo correto, verifique o título da aba no VS Code. Deve dizer settings.json (Workspace), não settings.json (User). Se você vir o arquivo do usuário, feche-o e reabra as configurações do workspace usando o método descrito acima.
O Arquivo Settings.json Não Existe para o Workspace
O VS Code cria o arquivo settings.json do workspace na primeira vez que você usa o editor de configurações do workspace. Se você abrir o arquivo e ele estiver vazio ou ausente, use o método da Paleta de Comandos para abrir Preferences: Open Workspace Settings (JSON). Isso força o VS Code a criar o arquivo na pasta .vscode na raiz do seu projeto.
Desabilitar no Workspace vs Desabilitar a Extensão: O que Muda
| Item | Desabilitar no Workspace | Desabilitar Extensão Globalmente |
|---|---|---|
| Efeito | Copilot desliga apenas em um projeto | Copilot desliga em todos os projetos |
| Método | Adicionar configuração ao settings.json do workspace | Desabilitar extensão no painel de Extensões |
| Reabilitar | Remover a configuração ou alterar para true | Habilitar extensão no painel de Extensões |
| Impacto na equipe | A configuração pode ser commitada na pasta .vscode | Afeta apenas a configuração local do usuário |
Desabilitar o Copilot para um workspace não desinstala a extensão. Apenas impede que a extensão forneça sugestões e conclusões. Todos os outros recursos do Copilot, como o painel Copilot Chat, também param de funcionar nesse workspace. A extensão permanece ativa em segundo plano, mas não executa nenhuma análise de código ou lógica de sugestão.
Agora você pode desabilitar o GitHub Copilot para um único workspace do VS Code usando o arquivo settings.json ou o ícone da barra de status. A alteração persiste entre sessões do VS Code até que você remova a configuração. Para equipes, considere adicionar a configuração do workspace à pasta .vscode do projeto e commitá-la no controle de versão para que todos os contribuidores usem a mesma configuração. Um próximo passo concreto é testar a desabilitação abrindo um arquivo no workspace e digitando código para confirmar que nenhuma sugestão de texto fantasma aparece.