Alterando as configurações com o /settings comando

Você pode usar o /settings comando barra para exibir e alterar suas configurações de dentro de uma sessão interativa da CLI. Esse comando controla as configurações no nível do usuário, como se CLI do Copilot se atualiza automaticamente, qual paleta de cores a interface usa, o que é exibido no rodapé e muitas outras opções.

Use /settings para:

• Procurar e editar configurações interativamente — execute /settings por conta própria para abrir um editor pesquisável que lista todas as configurações com uma descrição e seu valor atual.
• Alterar uma configuração com um único comando – Executar /settings KEY VALUE para alterar uma configuração específica sem abrir o editor.
• Verificar o valor de uma configuração — Execute /settings show KEY para exibir o valor atual de uma configuração.

Você também pode usar /config, que é um alias de /settings.

As alterações feitas com /settings ou /config são gravadas no arquivo de configurações pessoais (por padrão ~/.copilot/settings.json) e persistem entre as sessões.

Abrindo o editor de configurações

Para navegar e editar as configurações interativamente, insira o comando barra sem argumentos:

/settings

/settings

O editor lista todas as configurações que você pode alterar e o valor atual da configuração. Conforme você se move para cima ou para baixo na lista, uma breve descrição da configuração realçada é mostrada na parte inferior do editor. Isso permite que você navegue e edite configurações sem precisar saber seus nomes exatos.

Para obter mais informações sobre as configurações disponíveis, consulte Diretório de configuração do GitHub Copilot CLI.

Enquanto o editor estiver aberto, você pode usar os seguintes atalhos de teclado:

A maioria das alterações tem efeito imediato — por exemplo, alternar a paleta de cores atualiza a interface assim que você seleciona um novo valor.

Alterando uma única configuração embutida

Se você já souber qual configuração deseja alterar, poderá defini-la diretamente na caixa de prompt da CLI, sem abrir o editor:

/settings KEY VALUE

Por exemplo:

/settings autoUpdate off

/settings autoUpdate off

Copilot grava o valor e o confirma, por exemplo: Set autoUpdate = false.

Você pode definir configurações que usam valores definidos sem a necessidade de lembrar a chave exata ou o valor, apenas usando as teclas de navegação e Enter . Por exemplo, para impedir que o agente faça perguntas esclarecedoras:

1. Digite /settings, sem pressionar Enter, para exibir uma lista de opções.

2. Use a tecla ↓ para mover para baixo na lista até ❯ apontar para /settings askUser Allow the agent to ask clarifying questionse pressione Enter.

3. Use a tecla ↓ para percorrer para baixo a lista de opções desta configuração até que ❯ aponte para /settings askUser off, depois pressione Enter.

4. Pressione Enter novamente para enviar o /settings askUser off comando.

   A CLI confirma a alteração: Set askUser = false.

Exibindo valores válidos para uma configuração

Para exibir os valores válidos disponíveis para uma configuração, insira /settings KEY sem valor. Por exemplo, para ver os valores válidos para theme:

/settings theme

/settings theme

Exibindo o valor atual de uma configuração

Para exibir o valor atual de uma configuração, use show. Por exemplo:

/settings show theme

/settings show theme

Isso gera uma linha como theme = high-contrast. O show formulário é útil para verificar rapidamente um valor ou para capturar configurações em logs.

Alterando as configurações que exigem uma reinicialização

A maioria das configurações entra em vigor imediatamente, mas algumas só passam a valer plenamente após CLI do Copilot reiniciar — por exemplo, experimental e as configurações de proxy. Quando você altera um destes, Copilot informa que uma reinicialização é necessária e pode reiniciar a sessão para você.

Configurações que você não pode alterar da linha de comando

Nem todas as configurações podem ser editadas por meio do método embutido /settings KEY VALUE :

• As configurações sensíveis à segurança, como aquelas que alteram a forma como as credenciais são armazenadas ou que executam um comando de shell, são deliberadamente excluídas, porque invertê-las em uma única linha sem confirmação é arriscado.
• Configurações de lista e configurações estruturadas não podem ser definidas na mesma linha. Insira /settings e pressione Ctrl+E para abrir settings.json no editor de terminal configurado e edite a configuração lá.
• As configurações gerenciadas por seu repositório ou organização são mostradas para referência, mas seus valores vêm dessas fontes e substituem seu valor pessoal. Alterá-las nas configurações do usuário não tem efeito.

Em cada um desses casos, Copilot explica por que a alteração não foi aplicada e aponta para o lugar certo para fazer isso.

Comandos substituídos por /settings

Alguns comandos com barra mais antigos foram incorporados ao /settings. Eles ainda funcionam, mas exibem um aviso informando sobre o comando equivalente /settings .

Configurações que talvez você queira alterar

Algumas configurações comumente usadas incluem:

• autoUpdate — Baixe automaticamente as versões da CLI atualizadas.
• theme— Paleta de cores (default, github, , dim``high-contrastou colorblind).
• renderMarkdown — Exiba Markdown no terminal.
• banner — Com que frequência mostrar o banner de inicialização (always, once ou never).
• beep — Emitir bipe quando Copilot precisar de sua atenção.
• includeCoAuthoredBy — Adicione um Co-authored-by trailer aos commits.
• footer.showBranch — Mostrar a branch atual do Git no rodapé.

Para obter a lista completa de configurações disponíveis e como as configurações de usuário, repositório e organização se combinam, consulte Diretório de configuração do GitHub Copilot CLI.

Leitura adicional

• Configurando GitHub Copilot CLI
• Visão geral da personalização CLI do GitHub Copilot