Definições de programador

O ChatGPT na Web guarda as preferências do produto e do espaço de trabalho nas definições do ChatGPT. Os chats do ChatGPT Work são executados num ambiente gerido e não leem ficheiros locais de configuração do Codex. Utilize os controlos disponibilizados pelo seu espaço de trabalho nas definições do ChatGPT; os administradores do espaço de trabalho podem gerir algumas definições por si.

A página geral de Definições abrange as preferências da aplicação, incluindo perfil, atalhos de teclado, notificações, aparência, personalização, memórias e conversas arquivadas.

Comportamento do projeto e do terminal

Escolha onde os ficheiros são abertos, quanto conteúdo da saída dos comandos aparece nas conversas e onde os separadores do terminal são abertos por predefinição.

Revisão de código

Em Definições > Git, utilize Entrega da revisão para escolher Em linha para executar /review na conversa atual quando possível ou Separada para iniciar uma conversa de revisão distinta.

Sincronização com a extensão do IDE

Quando a aplicação ChatGPT para computador e a extensão do IDE estão abertas no mesmo projeto, partilham as conversas ativas e o contexto do editor. Ative Contexto do IDE no compositor da aplicação para permitir que o Codex utilize os ficheiros atualmente abertos no editor. Desative esta opção quando pretender que o pedido da aplicação exclua esse contexto do editor.

Pode abrir uma conversa da aplicação a partir da extensão do IDE e continuar uma conversa do IDE na aplicação. Ambas as interfaces utilizam o mesmo projeto para determinar que conversas e contexto devem partilhar.

Configuração dos agentes

Os agentes Codex na aplicação herdam a mesma configuração que a extensão do IDE e a CLI. Utilize os controlos na aplicação para as definições comuns ou edite config.toml para opções avançadas. Consulte Aprovações e segurança dos agentes e Noções básicas de configuração para obter detalhes.

Git

Utilize as definições do Git para normalizar a nomenclatura dos ramos e escolher se o Codex utiliza envios forçados. Também pode definir instruções que o Codex utiliza para gerar mensagens de commit e descrições de pull requests.

Integrações e MCP

Ligue ferramentas externas através do Model Context Protocol (MCP). Ative os servidores recomendados ou adicione os seus. Se um servidor exigir OAuth, a aplicação inicia o fluxo de autenticação. Estas definições também se aplicam à CLI do Codex e à extensão do IDE, porque a configuração do MCP se encontra em config.toml. Consulte Model Context Protocol para obter detalhes.

Modo de programador do navegador

Em Modo de programador, ative Ativar acesso CDP completo para permitir que o ChatGPT utilize o Chrome DevTools Protocol para a análise de desempenho e uma depuração mais aprofundada do navegador. Se a sua organização tiver desativado o acesso CDP completo, não pode ativá-lo localmente. Consulte Modo de programador para conhecer os requisitos de configuração, risco, aprovação e administração.

O Codex CLI lê as suas predefinições pessoais de ~/.codex/config.toml. Adicione um ficheiro .codex/config.toml a um projeto ou uma subpasta de confiança quando precisar de substituições específicas do projeto. A CLI e a extensão do IDE partilham estas camadas de configuração.

Consulte as suas definições

Utilize estes comandos para compreender as definições efetivas da sessão atual:

• Execute /status para ver o modelo ativo, a política de aprovação, as raízes com permissão de escrita e a utilização de tokens.
• Execute /debug-config para ver as camadas de configuração por ordem de precedência e a origem dos requisitos da política gerida.
• Inicie o Codex com --strict-config para tratar as chaves config.toml não reconhecidas como erros, em vez de as ignorar.

Consulte Comandos de programador para obter a referência completa dos comandos interativos.

Altere as definições para uma única execução

Utilize uma opção dedicada quando existir. Alguns exemplos comuns são --model, --sandbox, --ask-for-approval, --profile e --search. Utilize -c ou --config para substituir o valor de qualquer chave de configuração suportada numa única execução.

A substituição do modelo abaixo requer acesso ao GPT-6.1 Sol. Se não estiver disponível para a sua conta ou espaço de trabalho, omita --model ou escolha um modelo listado por /model. Consulte Disponibilidade do GPT-6.1 Sol por plano.

codex --model gpt-6.1-sol
codex --profile deep-review
codex --config model_reasoning_effort='"medium"'

As opções da linha de comandos e os valores de --config têm a precedência mais elevada. Para obter a lista completa de opções, consulte Comandos de programador.

Camadas de configuração

A CLI aplica as opções da linha de comandos e as substituições de --config antes das definições do projeto, do perfil, do utilizador, do sistema e incorporadas. Utilize esta precedência para manter as predefinições partilhadas nos ficheiros de configuração e as alterações pontuais na linha de comandos.

Para consultar a ordem completa e as opções comuns, consulte Noções básicas de configuração.

Altere as definições na TUI

A interface de terminal interativa disponibiliza seletores para definições comuns da sessão e de apresentação:

Alguns comandos aplicam-se apenas à sessão atual, enquanto alguns seletores permitem guardar a escolha. Defina a chave de configuração relacionada quando pretender uma predefinição para sessões futuras. Para conhecer os fluxos de trabalho relativos ao tema do terminal, editor, preenchimento automático e atalhos, consulte Personalização da CLI.

Referências sobre as definições

• Configuração avançada abrange perfis, substituições pontuais e outros fluxos de trabalho avançados.
• Referência de configuração apresenta as chaves e os valores disponíveis.
• Exemplo de configuração disponibiliza um ficheiro de exemplo completo.
• Variáveis de ambiente documenta as variáveis utilizadas pela CLI e pelo instalador.

A extensão Codex para IDE tem duas camadas de definições:

• As definições do Codex controlam o comportamento do agente partilhado com o Codex CLI, incluindo o modelo, o esforço de raciocínio, as permissões, a sandbox, os MCP servers e a personalização. O Codex lê estas definições de config.toml.
• As definições do editor controlam o comportamento da extensão no VS Code e em editores compatíveis. Estas definições utilizam chaves chatgpt.* no sistema de definições do editor.

Abra as definições do Codex

Selecione o ícone de engrenagem na barra lateral do Codex e, em seguida, selecione Definições do Codex. Utilize o painel de definições para os controlos comuns do agente ou selecione Abrir config.toml para editar diretamente a camada de configuração ativa.

Para consultar a ordem das camadas de configuração e as chaves comuns, consulte Noções básicas de configuração. Para ver todas as chaves config.toml suportadas, consulte a Referência de configuração.

Altere uma definição do editor

Para alterar uma definição, siga estes passos:

1. Abra as definições do editor.
2. Procure @ext:openai.chatgpt, Codex ou o nome da definição.
3. Atualize o valor.

A extensão também respeita as definições de tipo de letra do chat incorporadas no VS Code nas superfícies de chat do Codex.

Referência das definições do editor

As chaves chatgpt.* acima pertencem à extensão do IDE e não devem ser incluídas em config.toml. Para definições partilhadas do agente, consulte Noções básicas de configuração, Configuração avançada e a Referência de configuração.