Permissões e sandbox do GitHub Copilot CLI
VPS Agêntica
30% off na sua VPS Agêntica nos 2 primeiros meses
A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.
Link de parceiro da Promovaweb.
Black Friday até 30/11
30%off
nos 2 primeiros meses do plano mensal da VPS
- Backup diário grátis para sempre
- Servidores em São Paulo no datacenter da Ascenty
- Datacenter Tier III manutenção sem parada
- Acesso root com disco SSD NVMe
- Réplica do backup em Ashburn, nos EUA
As permissões do GitHub Copilot CLI decidem quais ferramentas o agente usa sem esperar a sua aprovação, como comandos de shell, edição de arquivos e servidores MCP. A sandbox local e a sandbox na nuvem acrescentam uma barreira em volta da execução, para limitar o alcance do agente quando você libera mais ações.
Sumário da página
A primeira pergunta é sobre a pasta
Ao abrir uma sessão, o Copilot CLI pergunta se você confia nos arquivos da pasta atual e das pastas abaixo dela. Essa resposta define onde o agente pode ler, modificar e executar arquivos. A documentação do GitHub recomenda iniciar o CLI só em pastas que você conhece e evitar a sua pasta pessoal. Ali ficam chaves, configurações e arquivos que o agente não precisa ver para corrigir um projeto.
O próprio GitHub avisa que esse escopo é heurístico. Ele não garante que todo arquivo fora das pastas confiáveis fique protegido. A confiança na pasta funciona como um primeiro filtro, completado pelas camadas seguintes. O changelog da versão 1.0.112 mostra o mesmo cuidado em outro ponto: a configuração de servidores MCP de uma pasta não confiável fica de fora, com um aviso sobre a pasta que você precisa confiar para carregar essa configuração.
Três respostas para cada solicitação de aprovação
No modo de aprovação manual, o agente pergunta antes de usar uma ferramenta ainda não liberada, como um comando de shell ou uma edição. A tela oferece três respostas. A primeira aprova só aquela execução. A segunda aprova a ferramenta até o fim da sessão em andamento. A terceira recusa e abre espaço para você dizer o que o Copilot deve fazer de outro jeito.
A segunda resposta tem um alcance maior que o aparente. A documentação usa um exemplo direto: o agente solicita rodar rm ./this-file.txt e você aprova o rm para a sessão. A partir daí, ele pode rodar qualquer rm até o fim dela, inclusive rm -rf ./*, sem perguntar de novo. A liberação vale para a ferramenta inteira. Numa sessão nova, ou ao retomar a sessão depois, o agente volta a solicitar aprovação.
Ferramenta solicitada
O agente quer rodar um comando, editar um arquivo ou chamar um servidor MCP.
Deny
Uma opção
--deny-toolque corresponde à ferramenta recusa a ação, mesmo com allow liberado.Allow
Uma opção
--allow-toolou a liberação da sessão deixa a ação rodar sem perguntar.Aprovação
Sem opção aplicável, a tela pergunta e você aprova, libera ou recusa.
As opções allow e deny pela linha de comando
Três opções definem o que roda sem pergunta, tanto na conversa quanto no modo programático. A --allow-all-tools libera qualquer ferramenta. A --allow-tool libera uma ferramenta específica. A --deny-tool proíbe uma ferramenta e tem precedência sobre as outras duas. Por isso a combinação copilot --allow-all-tools --deny-tool='shell(rm)' --deny-tool='shell(git push)' libera todo o resto e mantém o rm e o git push fora do alcance do agente.
Cada opção aponta para um tipo de ferramenta. A forma shell(COMANDO) cobre comandos de terminal. Para git e gh, ela aceita o primeiro subcomando, como shell(git push). A palavra write cobre as ferramentas que modificam arquivos, fora o shell. O nome de um servidor MCP cobre as ferramentas daquele servidor. Com o nome da ferramenta entre parênteses, a opção vale para uma só. O comando /mcp mostra o nome exato de cada servidor configurado.
Dentro da conversa, os comandos /allow-all e /yolo liberam todas as permissões da sessão. Digitar de novo não desliga a liberação. A opção --allow-all, com o apelido --yolo, faz o mesmo na linha de comando e libera ferramentas, caminhos e URLs. Em organizações com política de dispositivo, o administrador pode desativar essas opções. Nesse caso, o CLI mostra o link de suporte da organização.
Permissões assistidas reduzem as perguntas
Entre perguntar tudo e liberar tudo, o GitHub oferece as permissões assistidas, ligadas pelo comando /permissions assisted. Um modelo de linguagem avalia as solicitações elegíveis e aprova sozinho as que julga seguras. As liberações que você já definiu e as políticas da empresa continuam valendo. As solicitações que ainda exigem aprovação chegam a você. No modo programático, a opção correspondente é --assisted-approval. Nele, essas solicitações são negadas, porque não há ninguém para responder.
A sandbox limita o que o comando alcança
As permissões escolhem as ferramentas. A sandbox limita o ambiente em volta delas. A sandbox local liga com /sandbox enable dentro da sessão e restringe o acesso do agente ao sistema de arquivos, à rede e a recursos do sistema. Com ela ligada no Autopilot, o agente completa tudo que consegue dentro da sandbox sem interrupção. Qualquer passo que precise sair dela, como gravar fora da pasta de trabalho, é negado.
A sandbox na nuvem vai além. A opção --cloud inicia a sessão num ambiente isolado hospedado pelo GitHub, sem usar a sua máquina. Como a sessão roda na nuvem, você acompanha e orienta o trabalho de qualquer cliente do Copilot, inclusive pelo GitHub Mobile. Depois, retoma a sessão no terminal. A documentação também aceita outra barreira: rodar o CLI numa máquina virtual, num container ou num sistema dedicado com permissões e rede controladas.
O que a liberação total significa
Com --allow-all-tools, o Copilot tem o mesmo acesso que você aos arquivos do computador. Ele pode rodar qualquer comando que você rodaria, sem solicitar aprovação. A documentação registra a consequência sem rodeio: aumenta a chance de ações não intencionais que causam perda ou corrupção de arquivos e outros problemas de segurança. O ganho é real em scripts e pipelines, onde ninguém acompanha a tela. Mesmo assim, a recomendação oficial é liberar o mínimo necessário para a tarefa e usar a liberação total só dentro de uma sandbox.
Nos planos Copilot Business e Copilot Enterprise, o CLI respeita as exclusões de conteúdo configuradas na empresa, na organização e no repositório. Os arquivos excluídos não entram na conversa. Duas políticas de MCP da organização ainda não valem no CLI: a que liga ou desliga servidores MCP no Copilot e a que define a URL do registro de servidores permitido. Confira essa limitação antes de distribuir o CLI numa organização que depende dessas políticas.