{"meta":{"title":"Diretório de configuração do GitHub Copilot CLI","intro":"Encontre informações sobre o ~/.copilot diretório, onde Copilot CLI armazena configuração, dados de sessão e personalizações.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/pt/enterprise-cloud@latest/copilot/reference","title":"Referência"},{"href":"/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference","title":"Copilot CLI referência"},{"href":"/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference","title":"Diretório de configuração da CLI"}],"documentType":"article"},"body":"# Diretório de configuração do GitHub Copilot CLI\n\nEncontre informações sobre o ~/.copilot diretório, onde Copilot CLI armazena configuração, dados de sessão e personalizações.\n\nCopilot CLI armazena sua configuração, histórico de sessão, logs e personalizações em um único diretório em seu computador. Por padrão, esse diretório é `~/.copilot` (ou seja, `$HOME/.copilot`).\n\nEste artigo descreve o conteúdo deste diretório e como você pode usá-los.\n\n## Visão geral do diretório\n\nO `~/.copilot` diretório contém os seguintes itens de nível superior.\n\n| Caminho | Tipo | Descrição |\n| ------------------------- | --------- | ----------------------------------------------------------------------------------------------------------- |\n| `agents/` | Diretório | Definições de agente personalizado pessoal |\n| `config.json` | Arquivo | Estado do aplicativo gerenciado automaticamente (autenticação, plug-ins instalados e outros dados internos) |\n| `copilot-instructions.md` | Arquivo | Instruções personalizadas pessoais (aplicadas a todas as sessões) |\n| `extensions/` | Diretório | Extensões pessoais carregadas pela CLI |\n| `hooks/` | Diretório | Scripts de gancho no nível do usuário |\n| `ide/` | Diretório | Estado de integração do IDE |\n| `installed-plugins/` | Diretório | Arquivos de plug-in instalados |\n| `instructions/` | Diretório | Arquivos pessoais adicionais `*.instructions.md` |\n| `logs/` | Diretório | Arquivos de log de sessão |\n| `lsp-config.json` | Arquivo | Definições de servidor LSP no nível do usuário |\n| `mcp-config.json` | Arquivo | Definições de servidor MCP no nível do usuário |\n| `mcp-oauth-config/` | Diretório | Armazenamento de fallback de registro e token OAuth do MCP |\n| `mcp-secrets/` | Diretório | Armazenamento de fallback local e índice para espaços reservados secretos do MCP |\n| `permissions-config.json` | Arquivo | Permissões de ferramenta e diretório salvas por projeto |\n| `plugin-data/` | Diretório | Dados persistentes para plug-ins instalados |\n| `session-state/` | Diretório | Histórico de sessão e dados do workspace |\n| `command-history-state/` | Diretório | Dados do histórico de comandos |\n| `session-store.db` | Arquivo | Banco de dados SQLite para dados entre sessões |\n| `settings.json` | Arquivo | Suas configurações pessoais |\n| `skills/` | Diretório | Definições de habilidades personalizadas pessoais |\n\n> \\[!NOTE]\n> Nem todos esses itens aparecem imediatamente. Alguns são criados sob demanda na primeira vez que você usa um recurso específico— por exemplo, `installed-plugins/` aparece somente depois de instalar seu primeiro plug-in.\n\n## Arquivos editáveis pelo usuário\n\nOs arquivos a seguir foram projetados para serem editados diretamente por você ou gerenciados por meio de comandos da CLI.\n\n### `settings.json`\n\nEste é o arquivo de configuração principal para Copilot CLI. Em uma sessão, você pode usar o comando interativo `/settings` para alterar valores específicos ou executar `/settings KEY VALUE` para definir um único valor. Consulte [Alterando as configurações com o \\`/settings\\` comando](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/change-settings). Como alternativa, você pode editar o `settings.json` arquivo diretamente em um editor de texto. O arquivo dá suporte a JSON com comentários (JSONC).\n\nPor padrão, esse arquivo está localizado no `~/.copilot` diretório, que é o diretório de configuração no nível do usuário. Ele contém padrões globais de nível de usuário para todos os repositórios. Você pode alterar o local desse diretório definindo a variável de `COPILOT_HOME` ambiente para um caminho diferente.\n\n> \\[!NOTE]\n> As configurações editáveis pelo usuário foram armazenadas originalmente em `config.json`. Eles foram transferidos para `settings.json`. Todas as configurações de usuário presentes na `config.json` inicialização são migradas automaticamente para `settings.json`.\n\nSe `settings.json` não puder ser lido, analisado ou validado, Copilot CLI ignorará os valores inválidos (os valores `config.json` reconhecidos ainda serão mesclados) e mostrará um aviso de inicialização na linha do tempo, orientando você para a guia **Problemas** do comando `/settings`. Abra essa guia para ver o erro específico e, em seguida, corrija o problema relatado para restaurar as configurações afetadas.\n\nSe `settings.json` contiver uma chave de nível superior que não seja uma configuração reconhecida (por exemplo, um erro de digitação), Copilot CLI liste-a na guia **Problemas** do `/settings` comando em vez de na linha do tempo ou no stderr. O rótulo da aba exibe uma contagem (por exemplo, `Problems (2)`) quando qualquer escopo de configuração apresenta um problema. `$schema` é tolerado e nunca relatado.\n\nSe `~/.copilot/settings.json` for um link simbólico — por exemplo, para sincronizar configurações usando um repositório de dotfiles —, as gravações do comando `/settings` seguem o link simbólico e atualizam seu destino, em vez de substituir o link simbólico por um arquivo comum.\n\nPara obter a lista completa de configurações e como elas interagem com a configuração no nível do repositório, consulte [configurações de arquivo](#configuration-file-settings) mais adiante neste artigo.\n\n> \\[!TIP]\n> Execute `copilot help config` em seu terminal para obter uma referência rápida.\n\n### `copilot-instructions.md`\n\nInstruções personalizadas pessoais que se aplicam a todas as suas sessões, independentemente de em qual projeto você está trabalhando. Esse arquivo funciona da mesma maneira que um nível `copilot-instructions.md` de repositório, mas se aplica globalmente.\n\nPara obter mais informações, consulte [Adicionando instruções personalizadas do repositório para GitHub Copilot](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions).\n\n### `instructions/`\n\nArmazene aqui arquivos de instrução pessoal adicionais como arquivos `*.instructions.md`. Elas são carregadas junto com `copilot-instructions.md` e se aplicam a todas as suas sessões. Você pode organizar instruções por tópico, por exemplo, `~/.copilot/instructions/code-style.instructions.md`.\n\n### `mcp-config.json`\n\nDefine os servidores MCP (Protocolo de Contexto de Modelo) disponíveis no nível do usuário. Esses servidores estão disponíveis em todas as suas sessões, independentemente de qual diretório de projeto você esteja. As configurações MCP de nível de projeto (em `.mcp.json` ou `.github/mcp.json`) têm precedência sobre definições no nível do usuário quando os nomes de servidor entram em conflito.\n\nPara obter mais informações, consulte [Adicionando servidores MCP para GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers).\n\n### `lsp-config.json`\n\nDefine servidores LSP (Language Server Protocol) disponíveis no nível do usuário. Esses servidores fornecem inteligência de linguagem (diagnóstico, conclusões etc.) para o agente. Gerencie este arquivo usando o `/lsp` comando de barra, ou edite-o diretamente.\n\nPara obter mais informações, consulte [Adicionando servidores LSP para GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli/set-up-copilot-cli/add-lsp-servers).\n\n### `agents/`\n\nArmazene as definições de agente personalizado pessoal aqui como `.agent.md` arquivos. Os agentes colocados neste diretório estão disponíveis em todas as suas sessões. Agentes de nível de projeto (dentro de `.github/agents/`) têm precedência sobre agentes pessoais se compartilharem o mesmo nome.\n\nPara obter mais informações, consulte [Criando e usando agentes personalizados para GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli).\n\n### `skills/`\n\nArmazene as definições de habilidades personalizadas pessoais aqui. Cada habilidade reside em um subdiretório que contém um `SKILL.md` arquivo, por exemplo, `~/.copilot/skills/my-skill/SKILL.md`. As habilidades pessoais estão disponíveis em todas as suas sessões. Habilidades de nível de projeto têm prioridade sobre habilidades pessoais caso compartilhem o mesmo nome.\n\nPara obter mais informações, consulte [Adicionando habilidades de agente para GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-skills).\n\n### `hooks/`\n\nArmazene os scripts de gancho no nível do usuário aqui. Esses ganchos se aplicam a todas as suas sessões. Você também pode definir ganchos em linha no arquivo de configuração do usuário (`~/.copilot/settings.json`) usando a chave `hooks`. Os ganchos no nível do repositório (in `.github/hooks/`) são carregados junto com ganchos no nível do usuário.\n\nPara obter mais informações, consulte [Usando ganchos com GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/use-hooks).\n\n### `extensions/`\n\nArmazene arquivos de extensão no nível do usuário aqui. As extensões neste diretório estão disponíveis entre sessões.\n\nVocê pode criar arquivos neste diretório manualmente ou criar uma extensão e editar o arquivo gerado.\n\n## Arquivos gerenciados automaticamente\n\nOs itens a seguir são gerenciados pela CLI. Você geralmente não deve editá-los manualmente.\n\n### `config.json`\n\nArmazena o estado do aplicativo interno que é gerenciado automaticamente pela CLI, incluindo dados de autenticação, metadados de plug-in instalados e outras informações de runtime. Normalmente, não é necessário editar esse arquivo.\n\n> \\[!NOTE]\n> Versões anteriores de Copilot CLI armazenavam tanto as configurações do usuário quanto o estado do aplicativo em `config.json`. As configurações editáveis pelo usuário agora estão localizadas em `settings.json`. Todas as configurações de usuário na `config.json` inicialização são migradas automaticamente para `settings.json`. Os campos de estado do aplicativo, como `loggedInUsers`, `installedPlugins`, `firstLaunchAt`, e `staff`, permanecem em `config.json` e não são migrados.\n\n### `permissions-config.json`\n\nArmazena as suas decisões de permissão de ferramenta e diretório salvas, organizadas pelo local do projeto. Quando você aprova uma ferramenta ou concede acesso a um diretório para o local atual, a CLI registra a decisão aqui para que você não seja solicitado novamente no mesmo repositório ou diretório.\n\n> \\[!NOTE]\n> Se você quiser redefinir permissões para um projeto, poderá excluir a entrada relevante desse arquivo. No entanto, editar o arquivo enquanto uma sessão está em execução pode causar um comportamento inesperado. A CLI remove automaticamente as entradas cujo caminho de localização não existe mais no disco.\n\n#### Local do arquivo\n\nCopilot CLI resolve o arquivo do diretório de configuração.\n\n| Prioridade | Fonte | Arquivo usado |\n| ---------- | ------------------------ | --------------------------------------- |\n| 1 | `--config-dir=DIRECTORY` | `DIRECTORY/permissions-config.json` |\n| 2 | `COPILOT_HOME` | `$COPILOT_HOME/permissions-config.json` |\n| 3 | Default | `~/.copilot/permissions-config.json` |\n\nA CLI usa apenas o primeiro diretório de configuração aplicável nesta ordem. Ele também não carrega `permissions-config.json` dos locais de menor prioridade.\n\nA `--config-dir` opção é uma opção herdada. Prefira `COPILOT_HOME` quando precisar alterar o diretório de configuração.\n\nNo Windows, o arquivo padrão normalmente é:\n\n```text\nC:\\Users\\YOUR-USER\\.copilot\\permissions-config.json\n```\n\nBuilds mais antigos usavam um arquivo sem extensão chamado `permissions-config`. Se `permissions-config.json` não existir, mas o arquivo sem extensão existir, a CLI ainda continuará usando o arquivo legado. Use `permissions-config.json` para novas edições.\n\nOs locais anteriores de configuração baseados em XDG são migrados para `~/.copilot` na inicialização quando `COPILOT_HOME` não está definido.\n\n#### Chaves de localização\n\nO objeto de nível `locations` superior é chaveado por um caminho absoluto.\n\n* Para um repositório Git, use a raiz do Git como base para definir o escopo das permissões.\n* As árvores de trabalho vinculadas apontam para a raiz do repositório principal; portanto compartilham permissões com a árvore de trabalho principal.\n* Os submódulos usam seu próprio diretório de trabalho.\n* Para um diretório que não esteja em um repositório Git, use o diretório de trabalho atual normalizado.\n\nA chave deve corresponder ao local em que Copilot CLI está em execução. Se a chave não corresponder, as aprovações salvas não serão aplicadas.\n\nA CLI carrega as aprovações do local correspondente quando uma sessão é iniciada e quando o diretório de trabalho ativo é alterado.\n\n#### Schema\n\nO arquivo deve conter um objeto JSON.\n\n| Campo | Tipo | Obrigatório | Default | Valores permitidos | Descrição |\n| ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- | --------------------------------------- | ------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `locations` | Objeto | No | `{}` | Chaves de caminho absolutas | Mapa de chaves de localização para aprovações salvas. |\n| `locations.` | Objeto | No | `{}` | Qualquer chave de localização absoluta | Aprovações salvas para um repositório ou diretório. |\n| `locations..tool_approvals` | Array | No | `[]` | Objetos de aprovação | Ferramentas aprovadas para esse local. |\n| `locations..allowed_directories` | Matriz de cadeias de caracteres | No | `[]` | Caminhos absolutos de diretório | Diretórios extras que a porta de caminho pode acessar para esse local. Cada diretório deve existir quando a CLI aplica a configuração. |\n| `locations..tool_approvals[].kind` | String | Sim | None | | |\n| `commands`, `read`, `write`, `mcp`, , `mcp-sampling`, `memory`, `custom-tool`, , `extension-management``extension-permission-access` | Seleciona o tipo de aprovação. | | | | |\n| `commandIdentifiers` | Matriz de cadeias de caracteres | Sim, para `commands` | None | Identificadores de comando | Identificadores de comando do Shell a serem aprovados. |\n| `serverName` | String | Sim, para `mcp` e `mcp-sampling` | None | Nome do servidor MCP | Servidor MCP para aprovação. |\n| `toolName` | String ou `null` | Sim, para `mcp` | None | Nome da ferramenta MCP ou `null` | Ferramenta MCP para aprovação. Use `null` para aprovar todas as ferramentas no servidor. |\n| `toolName` | String | Sim, para `custom-tool` | None | Nome da ferramenta personalizada | Ferramenta personalizada para aprovar pelo nome exato. |\n| `operation` | String | Não, para `extension-management` | Omitido | Nome da operação de extensão | Operação de gerenciamento de extensões a ser aprovada. Deixe este campo em branco para aprovar todas as operações de gerenciamento de extensões. |\n| `extensionName` | String | Sim, para `extension-permission-access` | None | Nome da extensão | Extensão cujo acesso a recursos fechados por permissão é aprovado. |\n\n`permissions-config.json` não dá suporte a regras de negação, regras de \"pergunta\", modos padrão, regras de URL, filtragem de ferramentas ou política compartilhada local do repositório. Para esses comportamentos, use opções de linha de comando, como `--deny-tool`, `--available-tools`, , `--excluded-tools`e `--allow-url``--deny-url`. As regras de URL salvas são armazenadas em `settings.json`, não em `permissions-config.json`.\n\nCampos desconhecidos não fazem parte do esquema. A CLI pode ignorá-las, e operações de gravação subsequentes podem removê-las.\n\n#### Tipos de aprovação\n\nCada item em `tool_approvals` deve ser um dos seguintes objetos.\n\n| `kind` | Campos obrigatórios | Campos opcionais | Meaning |\n| ----------------------------- | -------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `commands` | `commandIdentifiers` | None | Aprova identificadores de comandos do shell correspondentes. |\n| `read` | None | None | Aprova solicitações de leitura da ferramenta. As sessões interativas da CLI já aprovam leituras automaticamente, portanto, isso geralmente é desnecessário. |\n| `write` | None | None | Aprova solicitações de ferramenta de criação e modificação de arquivo. Uma solicitação de caminho ainda pode ser aplicada a caminhos fora dos diretórios permitidos. |\n| `mcp` | | | |\n| `serverName`, `toolName` | None | Aprova uma ferramenta MCP ou todas as ferramentas no servidor quando `toolName` é `null`. | |\n| `mcp-sampling` | `serverName` | None | Aprova solicitações de amostragem do MCP para um servidor. |\n| `memory` | None | None | Aprova solicitações de gravação de memória e de voto. |\n| `custom-tool` | `toolName` | None | Aprova uma ferramenta personalizada pelo nome exato. |\n| `extension-management` | None | `operation` | Aprova o gerenciamento de extensões. Se houver omissão de `operation`, todas as operações de gerenciamento de extensão serão correlacionadas. |\n| `extension-permission-access` | `extensionName` | None | Aprova o acesso de uma extensão a recursos fechados por permissão. |\n\nPara aprovações do MCP, `serverName` deve corresponder exatamente ao nome do servidor MCP configurado. Use o nome original do servidor da sua configuração do MCP, não um prefixo de nome de ferramenta sanitizado.\n\n#### Correlação de comandos do Shell\n\n`permissions-config.json` não oferece suporte a expressões regulares nem a padrões glob em geral. Os valores da cadeia de caracteres são comparados literalmente, exceto que um `:*` à direita em um valor `commandIdentifiers` do Shell se correlaciona ao texto antes de `:*`, isoladamente ou seguido por um espaço e mais texto. Um `*` simples não tem nenhum significado especial, portanto `git*` não corresponde a `git status`.\n\n| Pattern | Partidas | Não corresponde |\n| -------------- | ------------ | -------------------- |\n| `git status` | `git status` | `git status --short` |\n| `git:*` | | |\n| `git` | | |\n| `git status` | | |\n| `git push` | | |\n| `gitea` | | |\n| `gh pr:*` | | |\n| `gh pr` | | |\n| `gh pr view` | | |\n| `gh pr create` | | |\n| `gh repo view` | | |\n\n#### Correlação de diretórios\n\nAs entradas de `allowed_directories` permitem que a Copilot CLI acesse os caminhos dentro desses diretórios sem um prompt de caminho separado. Eles não aprovam a operação da ferramenta em si. Por exemplo, editar um arquivo em um diretório permitido ainda pode exigir uma `write` aprovação.\n\nCada `allowed_directories` entrada deve ser um diretório absoluto, não vazio e acessível. A CLI resolve os symlinks antes de comparar caminhos, bloqueia os caminhos de rede UNC, a menos que sejam caminhos locais de comprimento estendido, compara caminhos sem diferenciar maiúsculas de minúsculas no Windows e compara os caminhos diferenciando maiúsculas de minúsculas em outras plataformas. Se uma entrada não puder ser aplicada, a CLI registrará um aviso e ignorará essa entrada.\n\n#### Examples\n\nPermitir todos os subcomandos git e acessar um diretório local extra:\n\n```json copy\n{\n \"locations\": {\n \"C:\\\\src\\\\my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"commands\",\n \"commandIdentifiers\": [\"git:*\"]\n }\n ],\n \"allowed_directories\": [\"C:\\\\src\\\\shared-docs\"]\n }\n }\n}\n```\n\nPermita comandos selecionados enquanto ainda pede a confirmação antes de gravações de arquivos:\n\n```json copy\n{\n \"locations\": {\n \"/Users/YOUR-USER/src/my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"commands\",\n \"commandIdentifiers\": [\n \"git status\",\n \"git diff\",\n \"git log\",\n \"npm test\",\n \"npm run build\"\n ]\n }\n ]\n }\n }\n}\n```\n\nAprove as gravações de arquivo e um servidor MCP para um repositório:\n\n```json copy\n{\n \"locations\": {\n \"/home/YOUR-USER/src/my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"write\"\n },\n {\n \"kind\": \"mcp\",\n \"serverName\": \"github-mcp-server\",\n \"toolName\": null\n }\n ]\n }\n }\n}\n```\n\nAprove uma ferramenta MCP, gravações de memória e acesso às permissões da extensão:\n\n```json copy\n{\n \"locations\": {\n \"C:\\\\src\\\\my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"mcp\",\n \"serverName\": \"github-mcp-server\",\n \"toolName\": \"search_code\"\n },\n {\n \"kind\": \"memory\"\n },\n {\n \"kind\": \"extension-permission-access\",\n \"extensionName\": \"my-extension\"\n }\n ]\n }\n }\n}\n```\n\n### `session-state/`\n\nContém dados de histórico de sessão, organizados por ID de sessão em subdiretórios. Cada diretório de sessão armazena um log de eventos (`events.jsonl`) e artefatos de workspace (planos, pontos de verificação, arquivos rastreados). Esses dados permitem que a sessão seja retomada (`--resume` ou `--continue`).\n\nExcluir arquivos desse diretório remove apenas cópias locais. Se você tiver sincronizado sessões com sua GitHub conta, os dados sincronizados serão armazenados separadamente e não serão afetados pela exclusão de arquivo local. Você pode excluir ou ocultar sessões sincronizadas de GitHub.com. Para obter mais informações, consulte [Sobre os dados de sessão GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/chronicle#managing-your-session-data).\n\n### `command-history-state/`\n\nContém dados de histórico de comandos usados para pesquisa reversa (Ctrl+R) e navegação de histórico na interface interativa. Esse diretório é gerenciado automaticamente e não deve ser editado.\n\n### `session-store.db`\n\nUm banco de dados SQLite usado pela CLI para armazenamento de dados entre sessões, como indexação e buscas de checkpoints. Esse arquivo é gerenciado automaticamente e não deve ser editado.\n\nSe você excluir esse arquivo, poderá recompilá-lo usando o `/chronicle reindex` comando. A reindexação também sincroniza seus dados de sessão com sua conta.\n\n### `logs/`\n\nContém arquivos de log para sessões da CLI. Cada sessão cria um arquivo de log chamado `process-{timestamp}-{pid}.log`. Esses arquivos são úteis na depuração de problemas.\n\nA CLI também pode criar logs específicos de extensão em `logs/extensions/`.\n\nIsso é separado do `~/.copilot/extensions/`, que armazena o código de extensão criado pelo usuário.\n\n> \\[!TIP]\n> Para localizar o arquivo de log da sessão atual, insira `/session` em uma sessão interativa. A saída inclui o caminho completo para o arquivo de log, juntamente com outros detalhes da sessão, como a ID da sessão, a duração e o diretório de trabalho.\n\n### `installed-plugins/`\n\nContém os arquivos para plug-ins instalados. Os plug-ins instalados de um marketplace são armazenados em `installed-plugins/{marketplace-name}/{plugin-name}/`. Os plug-ins instalados diretamente são armazenados em `installed-plugins/_direct/`. Gerencie plug-ins usando os `copilot plugin` comandos em vez de editar esse diretório diretamente.\n\nPara obter mais informações, consulte [referência de plugin da CLI GitHub Copilot](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-plugin-reference).\n\n### `plugin-data/`\n\nContém dados persistentes para plug-ins instalados, organizados pelo marketplace e pelo nome do plug-in. Esses dados são gerenciados pelos próprios plug-ins e não devem ser editados manualmente.\n\n### `ide/`\n\nContém arquivos de bloqueio e estado para integrações de IDE (por exemplo, quando Copilot CLI se conecta a Visual Studio Code). Esse diretório é gerenciado automaticamente.\n\n### `mcp-oauth-config/`\n\nContém arquivos de fallback do token OAuth do MCP, de registro e de PKCE quando o armazenamento com suporte do keychain não está disponível. Esse diretório é gerenciado automaticamente.\n\n### `mcp-secrets/`\n\nInclui armazenamento de arquivos de fallback e um índice para espaços reservados de segredos do MCP quando o armazenamento baseado em keychain não está disponível. Esse diretório é gerenciado automaticamente.\n\n## Alterando o local do diretório de configuração\n\nPara substituir o local padrão `~/.copilot` , defina a `COPILOT_HOME` variável de ambiente para o caminho do diretório que você deseja usar.\n\n```bash copy\nexport COPILOT_HOME=/path/to/my/copilot-config\n```\n\n### Coisas que devem ser observadas\n\n* `COPILOT_HOME` substitui todo o caminho `~/.copilot`. O valor definido deve ser o caminho completo para o diretório que você deseja usar para os arquivos de configuração e subdiretórios.\n* Alterar o diretório significa que a configuração existente, o histórico de sessão, os plug-ins instalados e as permissões salvas não serão encontrados no novo local. Copie ou mova o conteúdo de `~/.copilot` para o novo local, para preservá-los.\n* O **diretório de cache** (usado para caches do marketplace, pacotes de atualização automática e outros dados efêmeros) segue as convenções da plataforma e não é afetado por `COPILOT_HOME`. Ele está localizado em:\n\n * **macOS**: `~/Library/Caches/copilot`\n * **Linux**: `$XDG_CACHE_HOME/copilot` ou `~/.cache/copilot`\n * **Windows**:`%LOCALAPPDATA%/copilot`\n\n Para substituir o diretório de cache separadamente, defina `COPILOT_CACHE_HOME`.\n\n## O que você pode excluir com segurança\n\n| Item | É seguro excluir? | Efeito |\n| ------------------------------------------ | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `agents/` | | |\n| `skills/` | | |\n| `hooks/` | | |\n| Não recomendado | Você perderá suas personalizações pessoais. Faça backup primeiro. | |\n| `config.json` | Com cuidado | Redefine o estado do aplicativo, incluindo a autenticação. Você precisará se autenticar novamente e a CLI detectará novamente o estado interno na próxima inicialização. |\n| `copilot-instructions.md`, `instructions/` | Não recomendado | Você perderá suas instruções personalizadas pessoais. Faça backup primeiro. |\n| `extensions/` | Não recomendado | Você perderá suas extensões pessoais. Faça backup primeiro. |\n| `installed-plugins/` | Não recomendado | Em vez disso, use `copilot plugin uninstall` para garantir que os metadados de plug-in `config.json` permaneçam precisos. |\n| `logs/` | Sim | Os arquivos de log são recriados a cada sessão. Excluí-los não tem nenhum impacto funcional. |\n| `lsp-config.json` | Não recomendado | Você perderá suas definições de servidor LSP no nível do usuário. Faça backup primeiro. |\n| `mcp-config.json` | Não recomendado | Você perderá suas definições de servidor MCP no nível do usuário. Faça backup primeiro. |\n| `mcp-oauth-config/` | Com cuidado | Limpa o estado local de fallback do OAuth do MCP. Talvez seja necessário autenticar novamente os servidores MCP. |\n| `mcp-secrets/` | Com cuidado | Limpa o estado de fallback do segredo local do MCP e os mapeamentos. Os servidores MCP com backup secreto podem precisar de reconfiguração. |\n| `permissions-config.json` | Com cuidado | Redefine todas as permissões salvas. A CLI solicitará novamente as aprovações de ferramentas e diretórios. |\n| `plugin-data/` | Sim | Os dados persistentes de plug-in são recriados conforme necessário. |\n| `session-state/` | Com cuidado | A exclusão remove o histórico da sessão. Você não poderá mais retomar as sessões anteriores. |\n| `command-history-state/` | Com cuidado | Excluir remove o histórico de comandos. Você não poderá mais pesquisar comandos anteriores com Ctrl+R. |\n| `session-store.db` | Com cuidado | A exclusão remove dados entre sessões. O arquivo é recriado automaticamente. |\n| `settings.json` | Com cuidado | Redefine todas as preferências do usuário para padrões. Você precisará reconfigurar suas configurações. |\n\n## Configurações do arquivo de configuração\n\nAs configurações são aplicadas nesta ordem (as posteriores substituem as anteriores):\n\n\n\n1. Padrões internos\n2. Configurações gerenciadas por MDM (gerenciamento de dispositivos móveis)\n3. Configurações do usuário (`~/.copilot/settings.json`)\n4. Configurações do repositório (`.github/copilot/settings.json`)\n5. Configurações locais (`.github/copilot/settings.local.json`)\n6. Variáveis de ambiente\n7. Sinalizadores de linha de comando\n\n\n\nAs configurações gerenciadas por MDM são carregadas durante a inicialização e mescladas com as configurações do usuário como linha de base da política. Para a maioria das chaves, as configurações do usuário podem substituir essa linha de base. Para `permissions.disableBypassPermissionsMode`, um valor MDM de `\"disable\"` sempre prevalece. Para obter mais informações, consulte [as configurações gerenciadas do MDM](#mdm-managed-settings).\n\n| Scope | Localidade | Propósito |\n| ----------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |\n| Usuário | `~/.copilot/settings.json` | Padrões globais para todos os repositórios. Use a variável de `COPILOT_HOME` ambiente para especificar um caminho alternativo. |\n| Repositório | `.github/copilot/settings.json` | Configuração do repositório compartilhado (confirmada no repositório). |\n| Local | `.github/copilot/settings.local.json` | Substituições pessoais (adicione-as a `.gitignore`). |\n\nA interface de linha de comando também lê `.claude/settings.json` e `.claude/settings.local.json` para o subconjunto compartilhado entre ferramentas das configurações do repositório (como `companyAnnouncements`, `disableAllHooks`, `enabledPlugins`, `extraKnownMarketplaces` e `hooks`).\n\n### Configurações do usuário (`~/.copilot/settings.json`)\n\nEssas configurações se aplicam em todas as suas sessões e repositórios. Você pode usar o `/settings` comando barra para executar uma caixa de diálogo interativa ou usar comandos de barra específicos para atualizar valores individuais ou editar esse arquivo diretamente.\n\n| Chave | Tipo | Default | Descrição |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `allowedUrls` | `string[]` | `[]` | URLs ou domínios permitidos sem solicitação. Dá suporte a URLs exatas, padrões de domínio e subdomínios curinga (por exemplo, `\"*.github.com\"`). |\n| `askUser` | `boolean` | `true` | Permitir que o agente faça perguntas esclarecedoras. Defina para `false` para operação totalmente autônoma. Também pode ser definido com `--no-ask-user`. |\n| `autoUpdate` | `boolean` | `true` | Baixe automaticamente as atualizações da CLI e atualize os plug-ins de primeira parte no início de cada sessão. |\n| `autoUpdatesChannel` | | | |\n| `\"stable\"` | | | |\n| \\| | | | |\n| `\"prerelease\"` | | | |\n| `\"stable\"` | Atualizar canal. Defina para `\"prerelease\"` receber atualizações de pré-lançamento. | | |\n| `banner` | | | |\n| `\"always\"` | | | |\n| \\| | | | |\n| `\"once\"` | | | |\n| \\| | | | |\n| `\"never\"` | | | |\n| `\"once\"` | Frequência de exibição de banner animado. | | |\n| `bashEnv` | `boolean` | `false` | Habilitar o suporte de `BASH_ENV` para shells bash. Também pode ser definido com `--bash-env` ou `--no-bash-env`. |\n| `beep` | `boolean` | `true` | Reproduza um bipe audível quando a atenção é necessária. |\n| `beepOnSchedule` | `boolean` | `true` | Emita um sinal sonoro quando uma execução agendada `/every` ou `/after` terminar. |\n| `builtInAgents.rubberDuck` | `boolean` | `true` | Ative o subagente rubber duck que fornece feedback adversarial sobre os planos do agente. |\n| `builtInAgents.rubberDuckAutoInvoke` | `boolean` | `false` | Inclua solicitações proativas para invocação automática de pato de borracha. Defina como `true` para ativar lembretes adicionais do tipo “pato de borracha” durante os turnos do agente. |\n| `colorMode` | | | |\n| `\"default\"` | | | |\n| \\| | | | |\n| `\"github\"` | | | |\n| \\| | | | |\n| `\"dim\"` | | | |\n| \\| | | | |\n| `\"high-contrast\"` | | | |\n| \\| | | | |\n| `\"colorblind\"` | | | |\n| `\"github\"` | Alias obsoleto para `theme`. Prefira `theme`. | | |\n| `commandHistoryMaxSize` | `number` | `50` | Número máximo de comandos recentes retidos para histórico de entrada e pesquisa inversa. Deve ser um inteiro entre `1` e `1000`. |\n| `compactPaste` | `boolean` | `true` | Recolher colagens grandes (mais de 10 linhas) em tokens compactos. |\n| `companyAnnouncements` | `string[]` | `[]` | Mensagens personalizadas mostradas aleatoriamente na inicialização. Uma mensagem é selecionada aleatoriamente sempre que a CLI é iniciada. Útil para anúncios ou lembretes da equipe. |\n| `continueOnAutoMode` | `boolean` | `false` | Alterne automaticamente para o modo automático quando limitado por taxa. Quando `true`, os erros de limite de taxa elegíveis disparam uma troca automática para o modo automático e tentam novamente. Não se aplica a limites de taxa globais ou provedores BYOK. |\n| `copyOnSelect` | `boolean` | | |\n| `true` (macOS), `false` (outros) | Copie automaticamente o texto selecionado pelo mouse para a área de transferência do sistema. | | |\n| `customAgents.defaultLocalOnly` | `boolean` | `false` | Use apenas agentes personalizados locais (nenhuma organização remota ou agentes empresariais). |\n| `deniedUrls` | `string[]` | `[]` | URLs ou domínios que sempre são negados. As regras de negação têm precedência sobre as regras de permissão. |\n| `disableAllHooks` | `boolean` | `false` | Desabilite todos os ganchos (nível de repositório e nível de usuário). |\n| `disabledMcpServers` | `string[]` | `[]` | Nomes de servidor MCP para desabilitar. Os servidores listados são configurados, mas não iniciados. |\n| `disabledSkills` | `string[]` | `[]` | Nomes de habilidade para desabilitar. As habilidades listadas foram identificadas, mas não carregadas. |\n| `dynamicRetrieval` | `{ skills?: boolean }` | remover definição | Controle por categoria da recuperação dinâmica de instruções baseada em embeddings. Defina `skills` como `false` para desabilitar a recuperação de habilidades. |\n| `effortLevel` | `string` | `\"medium\"` | Nível de esforço de raciocínio para o pensamento estendido: `\"low\"`, `\"medium\"`, ou `\"high\"``\"xhigh\"`. Níveis mais altos usam mais computação. |\n| `enabledMcpServers` | `string[]` | `[]` | Habilite servidores MCP internos desabilitados por padrão. |\n| `enabledPlugins` | `Record` | `{}` | Instalação automática do plug-in declarativo. As chaves são especificações de plug-in; os valores são `true` (habilitados) ou `false` (desabilitados). |\n| `experimental` | `boolean` | `false` | Habilitar recursos experimentais. Também pode ser habilitado com a opção `--experimental` de linha de comando ou o comando de barra `/experimental`. |\n| `extraKnownMarketplaces` | `Record` | `{}` | Marketplaces de plug-in adicionais. Cada chave é um nome do marketplace; o valor especifica o necessário `source` (`\"directory\"`ou `\"git\"``\"github\"`). Defina `autoUpdate: true` em uma entrada para incluir os plug-ins instalados desse marketplace na atualização automática ao iniciar a sessão, assim como os plug-ins primários. Essa adesão se aplica somente a sessões interativas e `-p` — as sessões de SDK e de servidor não são atualizadas automaticamente. A aceitação é respeitada quando definida nas suas próprias configurações de usuário ou em configurações gerenciadas (MDM/servidor). Em um conflito entre nomes idênticos, um marketplace interno primário prevalece. Em seguida, uma entrada gerenciada (que substitui toda a entrada do usuário com o mesmo nome, de modo que uma entrada gerenciada sem `\"autoUpdate\": true` remove a aceitação do usuário) e, por fim, a entrada do próprio usuário. |\n| `footer` | `object` | — | Controla quais itens aparecem na linha de status. As subchaves incluem `showModelEffort`, `showDirectory`, `showBranch`, `showContextWindow`, `showQuota`, `showAgent`, `showAiUsed`, `showCodeChanges`, `showUsername`, `showSandbox`, `showYolo` e `showCustom` (todas `boolean`). Gerenciado pelo comando de barra `/statusline`. |\n| `hooks` | `object` | — | Definições inline de ganchos no nível do usuário, chaveadas pelo nome do evento. Usa o mesmo esquema que os arquivos `.github/hooks/*.json`. Consulte [Usando ganchos com GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/use-hooks). |\n| `ide.autoConnect` | `boolean` | `true` | Conecte-se automaticamente a um workspace do IDE na inicialização. Quando `false`, você ainda pode se conectar manualmente usando o comando `/ide`. |\n| `ide.openDiffOnEdit` | `boolean` | `true` | Abra as diferenças de edição nos arquivos no IDE conectado para aprovação. Quando `false`, as aprovações de edição de arquivo são mostradas somente no terminal. |\n| `includeCoAuthoredBy` | `boolean` | `true` | Adicione um trailer `Co-authored-by` às confirmações do git feitas pelo agente. |\n| `keepAlive` | | | |\n| `\"on\"` | | | |\n| \\| | | | |\n| `\"off\"` | | | |\n| \\| | | | |\n| `\"busy\"` | | | |\n| `\"off\"` | Modo keep-alive aplicado na inicialização da CLI. | | |\n| `\"on\"` sempre impede que o sistema entre em modo de suspensão, `\"busy\"` impede a suspensão somente enquanto o agente está em execução, e `\"off\"` desabilita a funcionalidade de manter ativo. Também configurável com o comando de barra `/keep-alive`. | | | |\n| `logLevel` | | | |\n| `\"none\"` | | | |\n| \\| | | | |\n| `\"error\"` | | | |\n| \\| | | | |\n| `\"warning\"` | | | |\n| \\| | | | |\n| `\"info\"` | | | |\n| \\| | | | |\n| `\"debug\"` | | | |\n| \\| | | | |\n| `\"all\"` | | | |\n| \\| | | | |\n| `\"default\"` | | | |\n| `\"default\"` | Verbosidade de registro em log. | | |\n| `mergeStrategy` | | | |\n| `\"rebase\"` | | | |\n| \\| | | | |\n| `\"merge\"` | | | |\n| — | Estratégia de resolução de conflitos para `/pr fix conflicts`. Quando definido como `\"rebase\"`, os conflitos são resolvidos fazendo o rebasamento para a ramificação de base. Quando definido como `\"merge\"`, o ramo base é mesclado no ramo de funcionalidade. Se não estiver configurado, uma caixa de diálogo de seleção será mostrada. | | |\n| `model` | `string` | varies | Modelo de IA a ser usado. Defina para `\"auto\"` para que Copilot selecione automaticamente o melhor modelo disponível. Gerenciado pelo comando de barra `/model`. |\n| `mouse` | `boolean` | `true` | Habilite o suporte ao mouse. Também pode ser definido com `--mouse` ou `--no-mouse`. |\n| `permissions.disableBypassPermissionsMode` | `string` | — | Defina como `--allow-all-tools` para suprimir todos os sinalizadores “permitir tudo” (`--allow-all-paths`, `--allow-all-urls`, `--allow-all`, `--yolo`, `\"disable\"`) na inicialização, para que não possam ser usados para conceder permissões elevadas. Defina como `\"allow-auto-only\"` para continuar bloqueando a opção de permitir tudo, sem deixar de permitir `/allow-all auto` (aprovação automática assistida por LLM). Consulte [referência de comando da CLI GitHub Copilot](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#restricting-the---allow-all-options). |\n| `pinnedPrompts` | `boolean` | `true` | Fixe o prompt do usuário da seção atual logo abaixo da barra superior ao rolar a linha do tempo, para que fique claro a qual solicitação o conteúdo exibido pertence. Apenas interface de linha de comando (CLI) — não afeta os prompts enviados ao modelo. |\n| `powershellFlags` | `string[]` | `[\"-NoProfile\", \"-NoLogo\"]` | Sinalizadores passados para o PowerShell na inicialização. Em Windows, a CLI prefere o PowerShell 7+ (`pwsh`) e volta para Windows PowerShell (`powershell.exe`) quando `pwsh` não está disponível. Apenas para Windows. |\n| `proxyKerberosServicePrincipal` | `string` | remover definição | Nome principal de serviço (SPN) para autenticação de proxy Kerberos/Negotiate, substituindo o `HTTP/` derivado. |\n| `proxyUrl` | `string` | remover definição | URL de proxy para solicitações HTTP(S) (por exemplo, `http://proxy.corp.example:3128`). Substituição pelas variáveis de ambiente `HTTP_PROXY` ou `HTTPS_PROXY` (qualquer uso de maiúsculas/minúsculas). |\n| `remote` | | | |\n| `\"on\"` | | | |\n| \\| | | | |\n| `\"off\"` | | | |\n| `\"on\"` | Controla a sincronização de sessão e o acesso remoto. Defina para `\"off\"` manter apenas os dados de sessão locais e desabilitar o controle remoto. Também pode ser definido com `--remote` ou `--no-remote`. | | |\n| `renderHexColors` | `boolean` | `true` | Mostrar códigos de cor hexadecimais de seis dígitos escritos como código embutido (por exemplo, `` `#FF0000` ``) como amostras de cores. |\n| `renderMarkdown` | `boolean` | `true` | Renderizar Markdown na saída do terminal. |\n| `remoteExport` | `boolean` | `true` | Exporte sessões remotamente quando a sincronização de sessão estiver disponível. Defina como `false` para desativar a exportação remota por padrão. A configuração `remoteSessions`, quando definida como `true`, ou o sinalizador `--remote`, ainda habilita a exportação e o roteamento, independentemente dessa configuração. |\n| `respectGitignore` | `boolean` | `true` | Exclua os arquivos gitignored do seletor de menções de arquivos `@`. Quando `false`, o seletor inclui arquivos normalmente excluídos por `.gitignore`. |\n| `sandbox.allowBypass` | `boolean` | `true` | Permitir que comandos em área restrita solicitem uma exceção para operações específicas (exibe uma solicitação de permissão), para que ferramentas como `grep` e `glob` continuem funcionando quando, de outra forma, a área restrita as bloquearia. Defina como `false` para desativar. |\n| `sandbox.enabled` | `boolean` | `false` | Restrinja comandos de shell, servidores MCP/LSP e ferramentas integradas de arquivos/web a um ambiente isolado com acesso limitado ao sistema de arquivos e à rede. Habilite-o na `/sandbox` caixa de diálogo ou com `/sandbox enable`. |\n| `sandbox.auth.git` | `boolean` | `true` | Insira credenciais do Git na área restrita para que os comandos em execução dentro dele possam se autenticar com o Git. Defina como `false` para desativar. Renomeado de `sandbox.gitAuth`. Não há migração para a chave antiga, e ela é ignorada em qualquer lugar em que ainda aparece. |\n| `sandbox.auth.gh` | `boolean` | `true` | Injeta credenciais GitHub CLI (`gh`) no sandbox para que os comandos executados dentro dele possam autenticar com o GitHub CLI. Defina como `false` para desativar. Renomeado de `sandbox.ghAuth`. Não há migração para a chave antiga, e ela é ignorada em qualquer lugar em que ainda aparece. |\n| `sandbox.userPolicy.network.allowLocalNetwork` | `boolean` | `true` | Permitir que os comandos em área restrita alcancem endereços de rede locais (por exemplo, servidores de desenvolvimento locais). Defina como `false` para desativar. |\n| `sandbox.userPolicy.network.proxy` | `object` | remover definição | Rotear o tráfego de rede em área restrita por meio de um proxy HTTP. Campos: `url` (obrigatório), `username` (opcional), `password` (opcional). Configure isso na guia **Rede** da caixa de diálogo `/sandbox`, que mascara o campo de senha. A senha em si é armazenada no chaveiro do sistema operacional, em vez de em `settings.json`, portanto não pode ser editada por meio de `/settings`. No Linux e no macOS, o proxy é cooperativo (não estritamente imposto); Windows impõe isso. |\n| `sandbox.userPolicy.deniedPaths` | `string[]` | `[]` | Caminhos aos quais comandos em sandbox têm o acesso negado. No Windows, o back-end de sandbox ProcessContainer não consegue impor regras de negação por caminho específico, portanto as entradas não têm efeito — por isso, não confie em `deniedPaths` para proteger um diretório confidencial no Windows. |\n| `sandbox.userPolicy.seatbelt.keychainAccess` | `boolean` | `false` | Somente macOS. Concede acesso ao chaveiro do sistema aos comandos em sandbox. Também pode ser ativado/desativado na caixa de diálogo `/sandbox`. |\n| `screenReader` | `boolean` | `false` | Habilitar otimizações de leitor de tela. |\n| `scrollbar` | `boolean` | `true` | Mostrar a barra de rolagem em exibições roláveis. Defina para `false` para ocultá-lo e usar a largura completa do terminal. |\n| `shellShortcut` | `boolean` | `true` | Permita que um `$` sozinho no prompt, seguido de Enter, abra um shell interativo enraizado no diretório de trabalho da sessão (isso só é ativado para uma sessão local, confiável e ociosa em um TTY real). Apenas com escopo de usuário ou gerenciado — não pode ser substituído pelo repositório. |\n| `showTimestamps` | `boolean` | `true` | Exibe carimbos de data/hora `HH:mm` discretos ao lado das mensagens do usuário na linha do tempo. |\n| `showTipsOnStartup` | `boolean` | `true` | Mostrar uma dica de comando aleatória quando a CLI for iniciada. |\n| `skillDirectories` | `string[]` | `[]` | Diretórios adicionais para pesquisar definições de habilidade personalizadas (além de `~/.copilot/skills/`). |\n| `statusLine` | `object` | — | Exibição da linha de status personalizada. |\n| `type`: deve ser `\"command\"`. | | | |\n| `command`: caminho para um script executável que recebe JSON de sessão no stdin e imprime o conteúdo de status para o stdout. | | | |\n| `padding`: quantidade opcional de espaços de preenchimento à esquerda. | | | |\n| `refreshInterval`: número inteiro opcional de segundos (`1`–`2147483`) para executar novamente o comando em um temporizador em vez de apenas em eventos; omita-o para atualizar somente quando o estado da sessão for alterado. Se o comando falhar ao gerar, sair fora de zero ou não receber o JSON de status no stdin, a CLI registrará um aviso uma vez por episódio de falha contínua e deixará a linha de status em branco, em vez de falhar silenciosamente. Execute com `--log-level all` para ver os detalhes do erro subjacente. | | | |\n| `stayInAutopilot` | `boolean` | `true` | Permaneça no modo de piloto automático após a conclusão de cada tarefa. Quando habilitado, o próximo prompt que você inserir após a conclusão de uma tarefa também é tratado no modo de piloto automático. Para obter mais informações, consulte [Permitindo que GitHub Copilot CLI funcione de forma autônoma](/pt/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/autopilot#staying-in-autopilot-mode-between-tasks). |\n| `storeTokenPlaintext` | `boolean` | `false` | Permitir que os tokens de autenticação sejam armazenados em texto `config.json` sem formatação quando nenhum conjunto de chaves do sistema estiver disponível. |\n| `stream` | `boolean` | `true` | Habilitar respostas de streaming. |\n| `streamerMode` | `boolean` | `false` | Ocultar nomes de modelos de pré-visualização, detalhes de cotas, carimbos de data/hora de prompts e o aviso de atualização disponível. Útil ao demonstrar Copilot CLI ou ao compartilhar a tela. |\n| `subagents.agents` | `object` | `{}` | Configuração de modelo por agente, com chave pelo nome do agente. Cada valor é um objeto com campos opcionais `model` (cadeia de caracteres), `effortLevel` (cadeia de caracteres) e `contextTier` (`\"default\"`, `\"long_context\"`ou `\"inherit\"`) . Defina qualquer campo como `\"inherit\"` para usar o valor da sessão pai no momento da expedição. Use o `/subagents` comando barra para definir essas configurações interativamente. |\n| `subagents.disabledSubagents` | `string[]` | `[]` | Nomes de agente para impedir a expedição. Somente o `rubber-duck` agente não pode ser desabilitado por meio dessa configuração. Todos os outros agentes internos , incluindo `explore`, `task`, `code-review`, `general-purpose`e `research``security-review`- podem ser desabilitados. |\n| `subagents.maxConcurrency` | `number` | baseado em plano | Número máximo de subagentes simultâneos para esta sessão. Aplicável somente a usuários com cobrança baseada em uso; ignorado nos demais planos. Limitado a `32`. Consulte [referência de comando da CLI GitHub Copilot](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#subagent-limits). |\n| `subagents.maxDepth` | `number` | `6` | Profundidade máxima de aninhamento de subagente. Aplicável somente a usuários com cobrança baseada em uso; ignorado nos demais planos. Limitado a `256`. Consulte [referência de comando da CLI GitHub Copilot](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#subagent-limits). |\n| `tabs.enabled` | `boolean` | `true` | Mostrar a barra de abas da tela inicial. Defina como `false` para ocultá-lo completamente. |\n| `tabs.hide` | `string[]` | `[]` | Identificadores de tabulação a serem ocultados. Valores aceitos: `\"copilot\"`, `\"agents\"`, `\"issues\"`, `\"pull-requests\"`, `\"gists\"` (correspondência sem diferenciar maiúsculas de minúsculas). |\n| `tabs.sort` | `string[]` | `[]` | Ordem de exibição das abas. As guias não listadas mantêm sua ordem relativa padrão após as listadas. Identificadores desconhecidos são ignorados. |\n| `terminalProgress` | `boolean` | `true` | Emita indicadores de progresso do terminal OSC 9;4 enquanto o agente está em execução. Os terminais com suporte incluem Terminal do Windows, iTerm2, Ghostty e ConEmu. |\n| `theme` | | | |\n| `\"default\"` | | | |\n| \\| | | | |\n| `\"github\"` | | | |\n| \\| | | | |\n| `\"dim\"` | | | |\n| \\| | | | |\n| `\"high-contrast\"` | | | |\n| \\| | | | |\n| `\"colorblind\"` | | | |\n| `\"github\"` | Paleta de cores para saída do terminal. Gerenciado pelos comandos de barra `/settings` e `/theme`. | | |\n| `colorMode` é um alias preterido para essa configuração. | | | |\n| `toolSearch` | `boolean` | dependente do modelo e da funcionalidade | Controla a busca de ferramentas (carregamento adiado de ferramentas). Defina `toolSearch: false` para desativar a busca de ferramentas. |\n| `updateTerminalTitle` | `boolean` | `true` | Mostrar a intenção atual na guia do terminal ou no título da janela. |\n| `worktreeBaseRef` | | | |\n| `\"head\"` | | | |\n| \\| | | | |\n| `\"defaultBranch\"` | | | |\n| `\"head\"` | Ponto de partida para novas árvores de trabalho criadas por `/worktree`, `/worktree new`e `--worktree`. `\"defaultBranch\"` inicia da ramificação padrão remota, e não no check-out atual. | | |\n\n> \\[!TIP]\n> Execute `copilot help sandbox` para ver a referência completa do sandbox, incluindo os hosts compatíveis e todas as chaves de configuração de `sandbox`.\n\nA caixa de diálogo `/sandbox` agrupa `git`, `gh` e o acesso ao keychain na guia dedicada **Auth** e mostra o caminho `settings.json` onde a configuração atual do sandbox está armazenada. Pressione Ctrl+E na `/sandbox` caixa de diálogo para salvar as alterações pendentes e abrir `settings.json` no editor (`COPILOT_EDITOR``VISUAL`ou`EDITOR`), correspondendo ao mesmo atalho em `/settings`. A caixa de diálogo recarrega seu estado a partir do disco após editar e salvar o arquivo.\n\nO sandboxing é viabilizado por [Microsoft eXecution Container (MXC)](https://github.com/microsoft/mxc), que fornece mecanismos de isolamento específicos da plataforma.\nCopilot CLIusa o Seatbelt no macOS, o Bubblewrap no Linux e o ProcessContainer no Windows.\n\n### Configurações do repositório (`.github/copilot/settings.json`)\n\nAs configurações do repositório se aplicam a todos que trabalham no repositório. Eles são comprometidos com o repositório e compartilhados com colaboradores.\n\n> \\[!NOTE]\n> As chaves relacionadas ao plug-in no arquivo de configuração do repositório (`enabledPlugins` e `extraKnownMarketplaces`) também são lidas por Copilot cloud agent, não apenas Copilot CLI. Isso permite habilitar os mesmos plug-ins para ambos os clientes de um único arquivo. Para obter mais informações sobre plug-ins, consulte [Sobre plug-ins GitHub Copilot](/pt/enterprise-cloud@latest/copilot/concepts/agents/about-plugins).\n\nSomente as chaves listadas na tabela a seguir têm suporte no nível do repositório. Todas as outras chaves, incluindo chaves válidas no arquivo de configuração do usuário, são ignoradas silenciosamente. Cada chave compatível tem uma política de mesclagem direcional que mantém a substituição fechada em caso de falha e segura.\n\n| Chave | Tipo | Comportamento de mesclagem | Descrição |\n| ---------------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `companyAnnouncements` | `string[]` | Substituído — o repositório assume precedência | Mensagens mostradas aleatoriamente na inicialização. |\n| `contextTier` | | | |\n| `\"default\"` | | | |\n| \\| | | | |\n| `\"long_context\"` | | | |\n| Substituído — o repositório assume precedência | Fixar a camada de contexto padrão. | | |\n| `deniedUrls` | `string[]` | União: o repositório pode adicionar entradas, nunca removê-las | URLs ou domínios bloqueados. |\n| `disableAllHooks` | `boolean` | Repositório tem precedência | Desabilite todos os ganchos. |\n| `disabledMcpServers` | `string[]` | União: o repositório pode adicionar entradas, nunca removê-las | Servidores MCP configurados, mas não iniciados. |\n| `disabledSkills` | `string[]` | União: o repositório pode adicionar entradas, nunca removê-las | Habilidades descobertas, mas não carregadas. |\n| `effortLevel` | `string` | Substituído — o repositório assume precedência | Fixe o esforço de raciocínio padrão. |\n| `enabledPlugins` | `Record` | Mesclado — o repositório tem prioridade sobre o usuário para a mesma chave | Instalação automática do plug-in declarativo. |\n| `extraKnownMarketplaces` | `Record` | Mesclado — o repositório tem prioridade sobre o usuário para a mesma chave | Marketplaces de plug-in disponíveis neste repositório. O campo `source` de cada entrada é obrigatório. Uma `autoUpdate: true` em uma entrada é aceita no nível do repositório, mas atualmente é ignorada. A opção de adesão à atualização automática só é respeitada quando definida nas configurações do próprio usuário ou em configurações gerenciadas (MDM/do servidor). |\n| `hooks` | `object` | Mesclado — o repositório tem prioridade sobre o usuário para a mesma chave | Definições de gancho destinadas a este repositório. Consulte [Usando ganchos com GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/use-hooks). |\n| `includeCoAuthoredBy` | `boolean` | Substituído — o repositório assume precedência | Adicionar um trailer `Co-authored-by` aos commits. |\n| `mergeStrategy` | | | |\n| `\"rebase\"` | | | |\n| \\| | | | |\n| `\"merge\"` | | | |\n| Substituído — o repositório assume precedência | Estratégia de resolução de conflitos para `/pr fix conflicts`. | | |\n| `model` | `string` | Substituído — o repositório assume precedência | Fixe o modelo padrão para este repositório. |\n| `respectGitignore` | `boolean` | Apenas restringir — o repositório pode habilitar, nunca desabilitar | Exclua os arquivos gitignored do seletor de menções de arquivos `@`. |\n\nAs substituições `model`, `effortLevel` e`contextTier` só se aplicam quando o diretório de trabalho é [confiável](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools).\n\nUm plug-in habilitado somente por meio do `enabledPlugins` de um repositório fica restrito a esse repositório: ele é instalado e ativado automaticamente no repositório em que é declarado, mas permanece desabilitado globalmente, de modo que nunca é ativado em projetos não relacionados. Sair do repositório ou o repositório desativar o plugin encerra seu servidor MCP e desativa seus agentes e habilidades para a sessão.\n\n### Lista de permissões de modelos no nível do repositório (`.github/allowed_models.txt`)\n\nRestrinja quais modelos integrados um repositório pode usar com uma lista de permissões em texto simples em `.github/allowed_models.txt`, resolvida a partir da raiz do repositório no diretório de trabalho atual (ou do próprio diretório de trabalho fora de um repositório).\n\nCada linha é um padrão glob comparado com IDs de modelo ou uma diretiva `fallback:` que nomeia o modelo a ser usado quando o modelo configurado ou solicitado não for permitido:\n\n```text\n# .github/allowed_models.txt\nfallback: gpt-5.2\ngpt-5.2\ngpt-5.4\nclaude-sonnet-*\n```\n\n| Regra | Descrição |\n| -------------------- | ----------------------------------------------------------------------------------------------- |\n| `*` | Permitir todos os modelos (padrão quando nenhum arquivo estiver presente). |\n| `MODEL-ID` | Permitir um ID de modelo exato. |\n| `GLOB-PATTERN` | Permitir IDs de modelo correspondentes ao glob (por exemplo, `claude-sonnet-*`). |\n| `fallback: MODEL-ID` | Obrigatório exatamente uma vez. O modelo Copilot é usado quando o modelo ativo não é permitido. |\n| `#` | Linha de comentário. |\n\nPadrões negados (`!pattern`) não são suportados; o modelo de fallback deve ser um ID exato (não um padrão glob) e o próprio modelo de fallback deve corresponder a um dos padrões glob configurados.\nCopilot CLI reavalia a política `/cd` e rejeita um arquivo inválido com um erro antes de executar.\n\nA lista de permissões se aplica apenas aos modelos integrados de Copilot. Ele não pode filtrar modelos personalizados adicionados usando o método BYOK (traga suas próprias chaves de API). Os modelos BYOK permanecem listados e selecionáveis independentemente dos padrões configurados e a `fallback:` diretiva nunca se aplica a eles. Para obter mais informações, consulte [Habilitar modelos personalizados para GitHub Copilot em sua empresa](/pt/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models) e [Habilitar modelos personalizados para GitHub Copilot em sua organização](/pt/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models).\n\n### Configurações locais (`.github/copilot/settings.local.json`)\n\nCrie `.github/copilot/settings.local.json` no repositório para configurações pessoais que não devem ser confirmadas. Adicione este arquivo a `.gitignore`.\n\nO arquivo de configuração local usa o mesmo esquema que o arquivo de configuração do repositório (`.github/copilot/settings.json`) e tem precedência sobre ele.\n\n## Configurações gerenciadas de MDM\n\nOs administradores de TI podem implantar a política de base por meio de configurações gerenciadas por MDM (Mobile Gerenciamento de Dispositivos), em vez de exigir configuração individual por usuário. Essas configurações aplicam padrões no nível do dispositivo para chaves compatíveis e são carregadas antes das configurações do usuário.\n\nCopilot CLI também carrega configurações gerenciadas pelo servidor na inicialização, além do MDM. As configurações gerenciadas pelo dispositivo (MDM) e pelo servidor são resolvidas **por chave**: o valor do MDM prevalece para qualquer chave que ele defina, e o valor do servidor preenche as chaves que o MDM deixa não definidas. Isso permite que uma organização defina alguma política por meio do MDM (por exemplo, `permissions`) enquanto ainda recebe outros padrões gerenciados (por exemplo, `model`) do servidor.\n\nSessões de longa duração buscam e reaplicam as configurações gerenciadas a cada hora, portanto, as alterações de política — por exemplo, uma organização habilitando `permissions.disableBypassPermissionsMode` — entram em vigor sem reiniciar a sessão.\n\n### Fontes de configurações gerenciadas do MDM\n\nA Copilot CLI lê as configurações gerenciadas de localizações específicas de plataforma baseadas em arquivo ou MDM.\n\n| Platform | Tipo de origem | Localidade |\n| -------- | -------------- | ------------------------------------------------------------------ |\n| macOS | Plist de MDM | `com.github.copilot` |\n| macOS | Arquivo | `/Library/Application Support/GitHubCopilot/managed-settings.json` |\n| Windows | Registro MDM | `HKLM\\SOFTWARE\\Policies\\GitHubCopilot` |\n| Windows | Arquivo | `%ProgramFiles%\\GitHubCopilot\\managed-settings.json` |\n| Linux | Arquivo | `/etc/github-copilot/managed-settings.json` |\n\n> \\[!NOTE]\n> Nos sistemas POSIX, a Copilot CLI rejeita as configurações gerenciadas baseadas em arquivos que sejam symlinks, que não sejam de propriedade da raiz nem universalmente graváveis.\n\n### Formato de arquivo\n\nEscreva configurações gerenciadas baseadas em arquivo como JSON.\n\n```json\n{\n \"model\": \"auto\",\n \"permissions\": {\n \"disableBypassPermissionsMode\": \"disable\"\n }\n}\n```\n\n> \\[!NOTE]\n> `model` é uma chave de nível superior. Configurações mais antigas que o aninhavam como `permissions.model` ainda funcionam — o runtime recorre a esse local quando a chave `model` de nível superior está ausente — mas grave novas configurações com `model` no nível superior.\n\n### Chaves com suporte\n\nSomente as chaves a seguir têm suporte nas configurações gerenciadas do MDM.\n\n| Chave | Descrição |\n| --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `allowedMcpServers` | Lista de permissões de servidores MCP que os usuários podem carregar, correspondentes a `serverUrl`, `serverCommand` ou `serverName`. Servidores de primeira parte confiáveis (por exemplo, o servidor MCP interno GitHub ) são sempre isentos. Deixar esta chave sem configuração permite o uso de todos os servidores não padrão; um array vazio bloqueia todos eles. Consulte [a lista de permissões/negações do servidor MCP gerenciado](#managed-mcp-server-allowdeny-list). |\n| `deniedMcpServers` | Lista de bloqueio de servidores MCP que nunca devem ser carregados, correspondida da mesma forma que `allowedMcpServers`. Um servidor não padrão correspondente é bloqueado independentemente da lista de permissões — negar sempre vence. Consulte [a lista de permissões/negações do servidor MCP gerenciado](#managed-mcp-server-allowdeny-list). |\n| `enabledPlugins` | Habilitar ou desabilitar plug-ins específicos |\n| `extraKnownMarketplaces` | Adicionar marketplaces de plug-in confiáveis |\n| `forceRemoteSettingsRefresh` | Exigir uma nova busca de configurações gerenciadas pelo servidor na inicialização, mesmo quando houver uma nova política armazenada em cache. A entrada armazenada em cache ainda será mantida como um fallback se a busca falhar. O valor do dispositivo (MDM) tem precedência sobre um valor de servidor armazenado em cache. |\n| `model` | Definir um modelo padrão para todos os usuários (substituído pelo `--model` sinalizador ou por um modelo de sessão retomada) |\n| `permissions` | Defina permissões gerenciadas, incluindo `disableBypassPermissionsMode` e`deny` / `ask` / `allow`matrizes de regras. Consulte [as regras de permissão gerenciadas](#managed-permission-rules). |\n| `policyHelper` | Registre um executável que forneça a camada de configurações gerenciadas de prioridade mais baixa. Campos: `path` (obrigatório), mais opcional `args`, `timeoutMs`e `refreshIntervalMs`. Se um dispositivo (MDM) e uma política de servidor registrarem um `policyHelper`, o registro do dispositivo vencerá. |\n| `remoteControl` | Controlar se as sessões neste dispositivo podem ser controladas de outros dispositivos. |\n| `mode` é `\"enabled\"`, `\"disabled\"`ou `\"requireSSO\"` (requer `githubDotComOrganizations` quando definido). | |\n| `shellShortcut` | Forçar a ativação ou desativação do atalho interativo do shell `$` para todos os usuários. Um valor gerenciado sempre substitui a `shellShortcut` configuração do próprio usuário. |\n| `strictKnownMarketplaces` | Restringir plug-ins a marketplaces conhecidos |\n| `telemetry` | Enviar a configuração básica de exportação do OpenTelemetry: `enabled`, `endpoint`, `protocol`, `headers`, `resourceAttributes`, `captureContent`, `lockCaptureContent` e `serviceName`. Consulte [referência de comando da CLI GitHub Copilot](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#opentelemetry-monitoring). |\n\n> \\[!NOTE]\n> `policyHelper.path` aceita um caminho absoluto, um caminho relativo ao diretório inicial (`~/...`) ou um nome simples do programa resolvido a partir de `PATH`. Outras formas relacionadas são rejeitadas. O registro é aceito e validado, mas o runtime ainda não invoca o helper — a execução do helper será disponibilizada em uma versão futura.\n\n> \\[!NOTE]\n> Quando `remoteControl.mode` for `\"requireSSO\"`, listar as organizações permitidas em `remoteControl.githubDotComOrganizations`. O cliente deve ser autorizado via SSO para pelo menos uma das organizações listadas GitHub.com — não é mais necessário que seja autorizado para todas elas.\n\n> \\[!NOTE]\n> Defina `permissions.disableBypassPermissionsMode` como `\"disable\"` nas configurações gerenciadas do MDM para impor a restrição no nível do dispositivo. A alternância de contas não pode ignorar esta política. Defina-a como `\"allow-auto-only\"` para bloquear o escalonamento irrestrito do tipo “permitir tudo”, ainda permitindo `/permissions assisted` (aprovação de permissões assistida por LLM). Se um valor não reconhecido for definido, a CLI registrará o problema e aplicará `\"disable\"` como padrão de negação, de modo que uma política gerenciada malformada ainda restringirá as opções de permitir tudo, em vez de permiti-las silenciosamente. Consulte [referência de comando da CLI GitHub Copilot](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#restricting-the---allow-all-options).\n\n> \\[!NOTE]\n> A maioria das chaves gerenciadas bloqueia toda a linha: uma edição local é silenciosamente substituída pelo valor gerenciado na próxima carga.\n> `enabledPlugins` e `extraKnownMarketplaces` são a exceção: a camada gerenciada mescla esses mapas com as entradas definidas por você, campo a campo, em vez de substituí-los por completo. Isso significa que o bloqueio se aplica **por entrada**, não à chave como um todo: um plug-in ou marketplace fixado por uma política gerenciada não pode ser reativado, desativado nem ter seu apontamento alterado localmente, mas outras entradas no mesmo mapa continuam totalmente sob controle do usuário.\n\n### Regras de permissão gerenciada\n\nEnvie as listas de regras `deny`, `ask` e `allow` na chave gerenciada `permissions` para aplicar uma política de permissões a todos os usuários, independentemente de `permissions.disableBypassPermissionsMode`.\n\n```json\n{\n \"permissions\": {\n \"deny\": [\"Shell(rm -rf *)\", \"Domain(*.evil.example)\"],\n \"ask\": [\"Shell(git push *)\"],\n \"allow\": [\"Read(**)\"]\n }\n}\n```\n\n| Família de regras | Partidas |\n| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `Bash(...)`, `Shell(...)` | Comandos do Shell. Use ` *` (por exemplo, `git push *`) para corresponder a um prefixo de comando; caso contrário, a regra corresponderá ao texto exato. |\n| `PowerShell(...)` | Os comandos do PowerShell corresponderam da mesma maneira que `Shell(...)`. |\n| `Read(...)` | Caminhos de leitura/exibição de arquivo. Oferece suporte a padrões glob: `/` para a raiz do espaço de trabalho, `~/` para o diretório pessoal e `./` para o diretório de trabalho atual. |\n| `Edit(...)`, `Write(...)` | Os caminhos de gravação/edição de arquivo corresponderam da mesma maneira que `Read(...)`. |\n| `Domain(...)` | Nomes de host de URL correspondentes, como [regras de URL](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#tool-permission-patterns). |\n\nAs regras são combinadas entre as fontes gerenciadas com uma precedência fixa: negar sempre vence, depois perguntar e, por fim, permitir — a correspondência com uma regra `deny` bloqueia a solicitação, mesmo que uma regra `allow` também corresponda.\n`deny` e `ask` são combinados entre todas as fontes gerenciadas (servidor, MDM). `allow` requer que todas as fontes que declaram uma lista `allow` admitam a operação — uma interseção, não uma união. Quando qualquer um de `deny`, `ask` ou `allow` é definido, uma operação que não corresponde a nenhum deles assume `ask` como padrão, em vez de prosseguir silenciosamente.\n\n## Lista de permissões/negações do servidor MCP gerenciado\n\nOs administradores podem controlar servidores MCP diretamente por meio de configurações gerenciadas de MDM, independentemente da [lista de permissões do MCP corporativo](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#enterprise-mcp-allowlist).\n\nDefinir `allowedMcpServers` e/ou `deniedMcpServers` em uma fonte de configurações gerenciadas:\n\n```json\n{\n \"allowedMcpServers\": [\n { \"serverUrl\": \"https://mcp.example.com/*\" },\n { \"serverCommand\": [\"npx\", \"-y\", \"@example/mcp-server\"] }\n ],\n \"deniedMcpServers\": [\n { \"serverName\": \"untrusted-server\" }\n ]\n}\n```\n\nCada entrada identifica um servidor por exatamente um dos seguintes critérios de correspondência.\n\n| Comparador | Partidas | Notes |\n| --------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `serverUrl` | Um servidor remoto (HTTP/SSE) via URL | Suporta curingas `*`; a correspondência de esquema e host ignora maiúsculas e minúsculas, a correspondência de caminho diferencia maiúsculas de minúsculas. As referências `${VAR}` se expandem antes da correspondência. |\n| `serverCommand` | Um servidor stdio por seu comando e argumentos exatos, em ordem. | As referências `${VAR}` se expandem antes da correspondência. |\n| `serverName` | Um servidor por seu rótulo atribuído. | Entradas de lista de permissões são restritas a `[A-Za-z0-9_-]+` (sem curingas); as entradas de lista de negação aceitam qualquer cadeia de caracteres não vazia. |\n\nRéguas:\n\n* **Servidores de primeira parte confiáveis** (por exemplo, o servidor MCP interno GitHub ) são sempre isentos de ambas as listas.\n* **Unset `allowedMcpServers`** permite todos os servidores não padrão; uma **matriz vazia** bloqueia todos eles (negar-tudo).\n* **Não definido ou vazio `deniedMcpServers`** não bloqueia nada.\n* **A negação sempre prevalece**—um servidor que corresponde a `deniedMcpServers` é bloqueado mesmo que também corresponda a `allowedMcpServers`.\n* Para servidores remotos, uma correspondência deve vir de uma entrada `serverUrl`; `serverName` só conta quando não existem entradas `serverUrl`. Para servidores stdio, uma correspondência deve vir de uma entrada `serverCommand`; `serverName` só conta quando não existem entradas `serverCommand`.\n\n## Leitura adicional\n\n* [GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli)\n* [referência de comando da CLI GitHub Copilot](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [referência programática do GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-programmatic-reference)\n* [referência de plugin da CLI GitHub Copilot](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-plugin-reference)\n* [Referência de ganchos do GitHub Copilot](/pt/enterprise-cloud@latest/copilot/reference/hooks-reference)"}