{"meta":{"title":"Alterando as configurações com o /settings comando","intro":"Veja e altere suas configurações pessoais de GitHub Copilot CLI com o comando de barra /settings.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/how-tos","title":"Instruções"},{"href":"/pt/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/pt/copilot/how-tos/copilot-cli/customize-copilot","title":"Personalizar Copilot CLI"},{"href":"/pt/copilot/how-tos/copilot-cli/customize-copilot/change-settings","title":"Alterar configurações"}],"documentType":"article"},"body":"# Alterando as configurações com o `/settings` comando\n\nVeja e altere suas configurações pessoais de GitHub Copilot CLI com o comando de barra /settings.\n\nVocê 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 Copilot CLI se atualiza automaticamente, qual paleta de cores a interface usa, o que é exibido no rodapé e muitas outras opções.\n\nUse `/settings` para:\n\n* **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.\n* **Alterar uma configuração com um único comando** – Executar `/settings KEY VALUE` para alterar uma configuração específica sem abrir o editor.\n* **Verificar o valor de uma configuração** — Execute `/settings show KEY` para exibir o valor atual de uma configuração.\n\nVocê também pode usar `/config`, que é um alias de `/settings`.\n\nAs 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.\n\n## Abrindo o editor de configurações\n\nPara navegar e editar as configurações interativamente, insira o comando barra sem argumentos:\n\n```copilot copy\n/settings\n```\n\nO 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.\n\nPara obter mais informações sobre as configurações disponíveis, consulte [Diretório de configuração do GitHub Copilot CLI](/pt/copilot/reference/copilot-cli-reference/cli-config-dir-reference#user-settings-copilotsettingsjson).\n\nEnquanto o editor estiver aberto, você pode usar os seguintes atalhos de teclado:\n\n<!-- Force table-layout: auto so the first column shrinks to its content width on all viewports. The site applies table-layout: fixed below 544px, which would otherwise collapse the first column and make its keys overflow. -->\n\n<table style=\"table-layout: auto;\">\n  <thead>\n    <tr>\n      <th style=\"white-space: nowrap;\">Chave</th>\n      <th style=\"width: 100%;\">Action</th>\n    </tr>\n  </thead>\n  <tbody>\n    <tr>\n      <td style=\"white-space: nowrap;\">\n<kbd>\n</kbd>\n/ ↑<kbd>↓</kbd></td>\n      <td>Mova-se entre as configurações.</td>\n    </tr>\n    <tr>\n      <td style=\"white-space: nowrap;\"><kbd>/</kbd></td>\n      <td>Pesquise e filtre a lista pelo nome ou descrição de uma configuração.</td>\n    </tr>\n    <tr>\n      <td style=\"white-space: nowrap;\">\n<kbd>Enter</kbd></td>\n      <td>Alterne uma configuração booliana ou edite outros tipos de valores.</td>\n    </tr>\n    <tr>\n      <td style=\"white-space: nowrap;\">\n<kbd>Ctrl</kbd>+<kbd>R</kbd></td>\n      <td>Restaure a configuração destacada para o valor padrão.</td>\n    </tr>\n    <tr>\n      <td style=\"white-space: nowrap;\">\n<kbd>Ctrl</kbd>+<kbd>E</kbd></td>\n      <td>Abra <code>settings.json</code> no editor de terminal configurado para fazer alterações avançadas.</td>\n    </tr>\n    <tr>\n      <td style=\"white-space: nowrap;\">\n<kbd>Esc</kbd></td>\n      <td>Limpe a pesquisa atual ou feche o editor.</td>\n    </tr>\n  </tbody>\n</table>\n\nA maioria das alterações tem efeito imediato — por exemplo, alternar a paleta de cores atualiza a interface assim que você seleciona um novo valor.\n\n## Alterando uma única configuração embutida\n\nSe você já souber qual configuração deseja alterar, poderá defini-la diretamente na caixa de prompt da CLI, sem abrir o editor:\n\n```copilot\n/settings KEY VALUE\n```\n\nPor exemplo:\n\n```copilot copy\n/settings autoUpdate off\n```\n\nCopilot grava o valor e o confirma, por exemplo: `Set autoUpdate = false.`\n\n> \\[!NOTE]\n> \\*\n> **As configurações boolianas** aceitam `on`/`off` ou .`true`/`false` Por exemplo, `/settings renderMarkdown on`.\n> \\*\n> **As configurações com um conjunto fixo de opções** aceitam um desses valores. Por exemplo, `/settings theme dim` ou `/settings banner never`.\n> \\*\n> **As configurações aninhadas** usam um caminho pontilhado. Por exemplo, `/settings footer.showBranch off` oculta a branch do Git no rodapé.\n\nVocê 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 <kbd>Enter</kbd> . Por exemplo, para impedir que o agente faça perguntas esclarecedoras:\n\n1. Digite `/settings`, sem pressionar <kbd>Enter</kbd>, para exibir uma lista de opções.\n2. Use a tecla <kbd>↓</kbd> para mover para baixo na lista até `❯` apontar para `/settings askUser  Allow the agent to ask clarifying questions`e pressione <kbd>Enter</kbd>.\n3. Use a tecla <kbd>↓</kbd> para percorrer para baixo a lista de opções desta configuração até que `❯` aponte para `/settings askUser off`, depois pressione <kbd>Enter</kbd>.\n4. Pressione <kbd>Enter</kbd> novamente para enviar o `/settings askUser off` comando.\n\n   A CLI confirma a alteração: `Set askUser = false.`\n\n## Exibindo valores válidos para uma configuração\n\nPara 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`:\n\n```copilot copy\n/settings theme\n```\n\n## Exibindo o valor atual de uma configuração\n\nPara exibir o valor atual de uma configuração, use `show`. Por exemplo:\n\n```copilot copy\n/settings show theme\n```\n\nIsso gera uma linha como `theme = high-contrast`. O `show` formulário é útil para verificar rapidamente um valor ou para capturar configurações em logs.\n\n## Alterando as configurações que exigem uma reinicialização\n\nA maioria das configurações entra em vigor imediatamente, mas algumas só passam a valer plenamente após Copilot CLI 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ê.\n\n## Configurações que você não pode alterar da linha de comando\n\nNem todas as configurações podem ser editadas por meio do método embutido `/settings KEY VALUE` :\n\n* **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.\n* **Configurações de lista e configurações estruturadas** não podem ser definidas na mesma linha. Insira `/settings` e pressione <kbd>Ctrl</kbd>+<kbd>E</kbd> para abrir `settings.json` no editor de terminal configurado e edite a configuração lá.\n* **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.\n\nEm cada um desses casos, Copilot explica por que a alteração não foi aplicada e aponta para o lugar certo para fazer isso.\n\n## Comandos substituídos por `/settings`\n\nAlguns comandos com barra mais antigos foram incorporados ao `/settings`. Eles ainda funcionam, mas exibem um aviso informando sobre o comando equivalente `/settings` .\n\n## Configurações que talvez você queira alterar\n\nAlgumas configurações comumente usadas incluem:\n\n* `autoUpdate` — Baixe automaticamente as versões da CLI atualizadas.\n* `theme`— Paleta de cores (`default`, `github`, , `dim``high-contrast`ou `colorblind`).\n* `renderMarkdown` — Exiba Markdown no terminal.\n* `banner` — Com que frequência mostrar o banner de inicialização (`always`, `once` ou `never`).\n* `beep` — Emitir bipe quando Copilot precisar de sua atenção.\n* `includeCoAuthoredBy` — Adicione um `Co-authored-by` trailer aos commits.\n* `footer.showBranch` — Mostrar a branch atual do Git no rodapé.\n\nPara 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](/pt/copilot/reference/copilot-cli-reference/cli-config-dir-reference).\n\n## Leitura adicional\n\n* [Configurando GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli)\n* [Visão geral da personalização GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/overview)"}