Documentação do ChatGPT
Português
Contacto goolvyouyou@gmail.com

Comandos para programadores

Comandos para programadores

Referência de comandos e comandos de barra para o ChatGPT para computador, Codex CLI e a extensão Codex para IDE.

Comandos do ChatGPT na Web

O ChatGPT na Web tem o seu próprio menu de comandos na caixa de composição. Escreva / para ver as ações disponíveis na conversa atual. Este menu não disponibiliza o conjunto de comandos da aplicação ChatGPT para computador nem da CLI; os comandos de barra, os subcomandos da CLI e as opções do Codex incluídos nesta referência não se aplicam ao ChatGPT na Web.

Comandos da aplicação ChatGPT para computador

A página geral Comandos abrange a navegação na aplicação, os atalhos de conversa, a personalização do teclado e as ligações diretas para conversas, definições, competências, tarefas agendadas, plugins e mascotes.

A página Comandos de barra abrange os comandos disponíveis na caixa de composição da aplicação, incluindo /feedback, /goal, /init, /mcp, /plan, /review e /status.

Referência de comandos da Codex CLI

Como consultar esta referência

Esta página cataloga todos os comandos e opções documentados da Codex CLI. Utilize as tabelas interativas para pesquisar por chave ou descrição. Cada secção indica se a opção é estável ou experimental e assinala combinações de risco.

Opções globais

Chave Tipo/valores Detalhes
--add-dir path Concede acesso de escrita a diretórios adicionais, além do espaço de trabalho principal. Repita para vários caminhos.
--ask-for-approval, -a untrusted | on-request | never Controla quando o Codex interrompe a execução para solicitar aprovação humana antes de executar um comando.
--cd, -C path Define o diretório de trabalho do agente antes de este começar a processar o pedido.
--config, -c key=value Substitui valores de configuração. Sempre que possível, os valores são analisados como TOML; caso contrário, é utilizada a cadeia literal.
--dangerously-bypass-approvals-and-sandbox, --yolo boolean Executa todos os comandos sem aprovações nem isolamento. Utilize apenas num ambiente externo devidamente protegido.
--dangerously-bypass-hook-trust boolean Executa os hooks ativados sem exigir confiança persistente nos hooks para esta invocação. Destina-se apenas a automatizações que já validem as origens dos hooks.
--disable feature Desativa forçadamente uma opção de funcionalidade (corresponde a -c features.<name>=false). Pode ser repetida.
--enable feature Ativa forçadamente uma opção de funcionalidade (corresponde a -c features.<name>=true). Pode ser repetida.
--image, -i path[,path...] Anexa um ou mais ficheiros de imagem ao prompt inicial. Separe vários caminhos com vírgulas ou repita a opção.
--local-provider lmstudio | ollama Escolhe o fornecedor local utilizado com --oss, substituindo oss_provider nesta execução.
--model, -m string Substitui o modelo definido na configuração (por exemplo, gpt-5.6-terra).
--no-alt-screen boolean Desativa o modo de ecrã alternativo da TUI (substitui tui.alternate_screen nesta execução).
--oss boolean Utiliza um fornecedor local de modelos de código aberto. O Codex utiliza --local-provider, o oss_provider configurado ou solicita que escolha entre LM Studio e Ollama.
--profile, -p string Sobrepõe $CODEX_HOME/profile-name.config.toml à configuração base do utilizador.
--remote ws://host:port | wss://host:port | unix:// | unix://PATH Estabelece ligação a um ponto final app-server remoto através de WebSocket ou de um socket Unix. Compatível com codex, codex resume, codex fork, codex archive, codex delete e codex unarchive; os outros subcomandos rejeitam o modo remoto.
--remote-auth-token-env ENV_VAR Lê um token de portador desta variável de ambiente e envia-o ao estabelecer ligação com --remote. Requer --remote; os tokens só são enviados através de URLs wss:// ou URLs ws:// exclusivamente locais.
--sandbox, -s read-only | workspace-write | danger-full-access Seleciona a política de isolamento para comandos de shell gerados pelo modelo.
--search boolean Ativa a pesquisa em tempo real na Web (define web_search = "live" em vez do valor predefinido "cached").
--strict-config boolean Produz um erro quando config.toml contém campos que esta versão do Codex não reconhece. Compatível com comandos de execução como codex, exec, review, resume, fork, app-server, mcp-server e exec-server.
PROMPT string Instrução de texto opcional para iniciar a sessão. Omita-a para iniciar a TUI sem uma mensagem previamente preenchida.

Estas opções aplicam-se ao comando base codex. A maioria é propagada para outros comandos; consulte as notas acima ou a ajuda do comando relevante para conhecer as exceções. Para opções propagadas, consulte a ajuda do comando relevante. Por exemplo, codex exec --oss ... aplica --oss a exec.

Descrição geral dos comandos

Chave Maturidade Detalhes
codex Estável Inicia a interface de terminal. Aceita as opções globais acima, além de um prompt opcional ou anexos de imagem.
codex app Estável Inicia a aplicação ChatGPT para computador no macOS ou Windows. No macOS, o Codex pode abrir o caminho de um espaço de trabalho; no Windows, o Codex apresenta o caminho que deve ser aberto.
codex app-server Experimental Inicia o servidor da aplicação Codex para desenvolvimento local ou depuração através de stdio, WebSocket ou de um socket Unix.
codex apply Estável Aplica à árvore de trabalho local a diferença mais recente gerada por uma conversa na nuvem do Codex. Alias: codex a.
codex archive Estável Arquiva uma sessão interativa guardada através do ID ou nome da sessão.
codex cloud Experimental Permite consultar ou executar conversas na nuvem do Codex a partir do terminal sem abrir a TUI. Alias: codex cloud-tasks.
codex completion Estável Gera scripts de conclusão da shell para Bash, Zsh, Fish ou PowerShell.
codex debug app-server send-message-v2 Experimental Depura o app-server enviando uma única mensagem V2 através do cliente de teste incorporado.
codex debug models Experimental Apresenta o catálogo de modelos em bruto que o Codex vê, incluindo uma opção para inspecionar apenas o catálogo incluído.
codex debug prompt-input Experimental Compõe como JSON a lista de entradas do prompt visível para o modelo, opcionalmente com um prompt e imagens.
codex delete Estável Elimina permanentemente uma sessão interativa guardada através do ID ou nome da sessão.
codex doctor Estável Gera um relatório de diagnóstico sobre problemas de instalação local, configuração, autenticação, execução, Git, terminal, app-server e inventário de threads.
codex exec Estável Executa o Codex de forma não interativa. Alias: codex e. Transmite os resultados para stdout ou JSONL e permite, opcionalmente, retomar sessões anteriores.
codex execpolicy Experimental Avalia ficheiros de regras execpolicy e mostra se um comando seria permitido, exigiria confirmação ou seria bloqueado.
codex features Estável Apresenta opções de funcionalidades e ativa-as ou desativa-as de forma persistente em config.toml.
codex fork Estável Bifurca uma sessão interativa anterior para uma nova conversa, preservando a transcrição original.
codex login Estável Autentica o Codex através do OAuth do ChatGPT, autenticação do dispositivo, uma API key ou um token de acesso transmitido por stdin.
codex logout Estável Remove as credenciais de autenticação guardadas.
codex mcp Estável Gere servidores Model Context Protocol (listar, adicionar, remover e autenticar).
codex mcp-server Descontinuada Interface descontinuada para executar o Codex como servidor MCP através de stdio. Em alternativa, utilize o servidor da aplicação Codex. Para chamar o Codex a partir do Claude Code, utilize o plugin Codex para Claude Code.
codex plugin Estável Instala, apresenta e remove plugins de origens de marketplaces configuradas.
codex plugin marketplace Estável Adiciona, apresenta, atualiza ou remove marketplaces de plugins de origens Git ou locais.
codex remote-control Experimental Executa ou gere o controlo remoto do app-server local, ou cria um código de emparelhamento de curta duração.
codex resume Estável Continua uma sessão interativa anterior através do ID ou retoma a conversa mais recente.
codex review Estável Executa uma revisão não interativa de alterações sem commit, da diferença relativamente a um ramo base, de um commit ou de instruções de revisão personalizadas.
codex sandbox Estável Executa comandos arbitrários em ambientes isolados macOS, Linux ou Windows fornecidos pelo Codex.
codex unarchive Estável Restaura uma sessão interativa arquivada através do ID ou nome da sessão.
codex update Estável Procura e aplica uma atualização da Codex CLI quando a versão instalada é compatível com a atualização automática.

Detalhes dos comandos

codex (interativo)

A execução de codex sem um subcomando inicia a interface de terminal interativa (TUI). O agente aceita as opções globais acima e anexos de imagem. A pesquisa na Web utiliza por predefinição o modo em cache; utilize --search para mudar para a navegação em tempo real. Para trabalho local com pouca intervenção, utilize --sandbox workspace-write --ask-for-approval on-request.

Utilize --remote ws://host:port ou --remote wss://host:port para ligar a TUI a um servidor da aplicação iniciado com codex app-server --listen ws://IP:PORT. Para um socket Unix local, utilize --remote unix:// para o socket predefinido ou --remote unix://PATH para indicar um caminho explícito. Adicione --remote-auth-token-env <ENV_VAR> quando o servidor exigir um token de portador para autenticação WebSocket.

codex app-server

Inicia localmente o servidor da aplicação Codex. Destina-se principalmente ao desenvolvimento e à depuração e pode ser alterado sem aviso prévio.

Chave Tipo/valores Detalhes
--analytics-default-enabled boolean Ativa a análise por predefinição para clientes app-server próprios, a menos que o utilizador a desative na configuração.
--listen stdio:// | ws://IP:PORT | unix:// | unix://PATH | off URL do serviço de escuta do transporte. Utilize stdio:// para JSONL, ws://IP:PORT para um ponto final WebSocket TCP, unix:// para o socket Unix predefinido, unix://PATH para um socket Unix personalizado ou off para desativar o transporte local.
--stdio boolean Utiliza o transporte stdio. Equivale a --listen stdio:// e é mutuamente exclusivo com --listen.
--ws-audience string Declaração aud esperada para tokens de portador assinados. Requer --ws-auth signed-bearer-token.
--ws-auth capability-token | signed-bearer-token Modo de autenticação para clientes WebSocket do app-server. Se for omitido, a autenticação WebSocket fica desativada; os serviços de escuta que não sejam locais apresentam um aviso durante o arranque.
--ws-issuer string Declaração iss esperada para tokens de portador assinados. Requer --ws-auth signed-bearer-token.
--ws-max-clock-skew-seconds number Tolerância de desvio do relógio ao validar as declarações exp e nbf de tokens de portador assinados. Requer --ws-auth signed-bearer-token.
--ws-shared-secret-file absolute path Ficheiro que contém o segredo partilhado HMAC utilizado para validar tokens de portador JWT assinados. Obrigatório com --ws-auth signed-bearer-token.
--ws-token-file absolute path Ficheiro que contém o token de capacidade partilhado. Utilize com --ws-auth capability-token, salvo se fornecer --ws-token-sha256.
--ws-token-sha256 hexadecimal SHA-256 digest Resumo SHA-256 esperado para autenticação por token de capacidade. Utilize em vez de --ws-token-file quando o token do cliente provier de outra origem.

codex app-server --listen stdio:// mantém o comportamento predefinido de JSONL através de stdio e codex app-server --stdio é um alias desse transporte. --listen ws://IP:PORT ativa o transporte WebSocket para clientes app-server. O servidor aceita URLs de escuta ws://; utilize terminação TLS ou um proxy seguro quando os clientes estabelecerem ligação com wss://. Utilize --listen unix:// para aceitar handshakes WebSocket no socket Unix predefinido do Codex ou --listen unix:///absolute/path.sock para escolher um caminho de socket. Se gerar esquemas para ligações de clientes, adicione --experimental para incluir campos e métodos sujeitos a controlo de acesso.

Adicione --code-mode-host wss://code-mode.example.com/host para ligar o app-server a um anfitrião Code Mode remoto, em vez de iniciar um anfitrião local. Esta ligação de saída é distinta de --listen e é partilhada por todas as threads do processo app-server. Utilize ws:// apenas para um anfitrião localhost ou reencaminhado por SSH.

codex remote-control

Execute codex remote-control para iniciar o controlo remoto em primeiro plano. Utilize codex remote-control start para iniciar o daemon app-server local com o controlo remoto ativado e codex remote-control stop para o parar. Os clientes de controlo remoto geridos e os fluxos de trabalho SSH remotos utilizam estes comandos; estes não substituem codex app-server --listen quando estiver a criar um cliente de protocolo local.

Depois de o daemon estar em execução, utilize codex remote-control pair para criar e apresentar um código de emparelhamento manual de curta duração. Adicione --json a qualquer comando de controlo remoto para obter uma saída legível por máquina. Para pair, a resposta JSON inclui pairingCode, manualPairingCode, environmentId e expiresAt.

codex app

Inicia a aplicação ChatGPT para computador a partir do terminal no macOS ou Windows. No macOS, o Codex pode abrir o caminho de um espaço de trabalho específico; no Windows, o Codex apresenta o caminho que deve ser aberto.

Chave Tipo/valores Detalhes
--download-url url Substituição avançada do URL do instalador da aplicação ChatGPT para computador utilizado durante a instalação.
PATH path Caminho do espaço de trabalho para a aplicação ChatGPT para computador. No macOS, o Codex abre este caminho; no Windows, o Codex apresenta o caminho.

codex app abre uma aplicação ChatGPT para computador instalada ou inicia o instalador quando a aplicação não está instalada. No macOS, o Codex abre o caminho do espaço de trabalho fornecido; no Windows, apresenta o caminho que deve ser aberto após a instalação.

codex debug app-server send-message-v2

Envia uma mensagem através do fluxo V2 de thread/turno do app-server, utilizando o cliente de teste app-server incorporado.

Chave Tipo/valores Detalhes
USER_MESSAGE string Texto da mensagem enviado ao app-server através do fluxo do cliente de teste V2 incorporado.

Este fluxo de depuração é inicializado com experimentalApi: true, inicia uma thread, envia um turno e transmite notificações do servidor. Utilize-o para reproduzir e inspecionar localmente o comportamento do protocolo app-server.

codex debug models

Apresenta como JSON o catálogo de modelos em bruto que o Codex vê.

Chave Tipo/valores Detalhes
--bundled boolean Ignora a atualização e apresenta apenas o catálogo de modelos incluído no binário atual do Codex.

Utilize --bundled quando pretender inspecionar apenas o catálogo incluído no binário atual, sem o atualizar a partir do ponto final remoto de modelos.

codex debug prompt-input

Compõe como JSON a lista exata de entradas do prompt visível para o modelo. Utilize esta opção ao depurar a deteção de instruções, o contexto da sessão ou a construção de prompts.

Chave Tipo/valores Detalhes
--image, -i path[,path...] Anexa uma ou mais imagens ao prompt do utilizador. Separe vários caminhos com vírgulas ou repita a opção.
PROMPT string Prompt opcional do utilizador acrescentado após o contexto da sessão.

codex apply

Aplica ao repositório local a diferença mais recente de uma conversa na nuvem do Codex. É necessário autenticar-se e ter acesso à conversa.

Chave Tipo/valores Detalhes
TASK_ID string Identificador da conversa na nuvem do Codex cuja diferença deve ser aplicada.

O Codex apresenta os ficheiros corrigidos e termina com um código diferente de zero se git apply falhar (por exemplo, devido a conflitos).

codex review

Executa uma revisão de código de forma não interativa. Escolha exatamente um alvo de revisão ou transmita instruções de revisão personalizadas como prompt.

Chave Tipo/valores Detalhes
--base branch Revê as alterações relativamente ao ramo base especificado.
--commit SHA Revê as alterações introduzidas pelo commit especificado.
--strict-config boolean Produz um erro quando config.toml contém campos que esta versão do Codex não reconhece.
--title string Define o título do commit apresentado no resumo da revisão. Requer --commit.
--uncommitted boolean Revê alterações preparadas, não preparadas e não monitorizadas.
PROMPT string | - (read stdin) Instruções de revisão personalizadas. Utilize - para ler as instruções a partir de stdin.

--uncommitted, --base, --commit e um PROMPT personalizado são incompatíveis entre si. Utilize --title apenas com --commit.

codex archive e codex unarchive

Arquiva ou restaura uma sessão interativa guardada através do ID ou nome da sessão. Utilize estes comandos quando pretender organizar o seletor de sessões sem eliminar a transcrição. Os IDs de sessão têm precedência sobre os nomes de sessão.

codex archive <SESSION>
codex unarchive <SESSION>
Chave Tipo/valores Detalhes
--remote ws://host:port | wss://host:port | unix:// | unix://PATH Estabelece ligação a um ponto final app-server remoto antes de alterar o estado de arquivamento.
--remote-auth-token-env ENV_VAR Lê um token de portador desta variável de ambiente quando --remote exige autenticação.
SESSION session ID | session name Sessão guardada que deve ser arquivada ou restaurada. Os IDs de sessão têm precedência sobre os nomes de sessão.

codex delete

Elimina permanentemente uma sessão interativa guardada através do ID ou nome da sessão. Utilize esta opção apenas quando pretender remover a transcrição, em vez de a ocultar das listas de sessões ativas.

codex delete <SESSION>
codex delete <SESSION_UUID> --force
Chave Tipo/valores Detalhes
--force boolean Elimina sem solicitar confirmação. O argumento da sessão tem de ser um UUID; os nomes continuam a exigir confirmação interativa.
--remote ws://host:port | wss://host:port | unix:// | unix://PATH Estabelece ligação a um ponto final app-server remoto antes de eliminar a sessão.
--remote-auth-token-env ENV_VAR Lê um token de portador desta variável de ambiente quando --remote exige autenticação.
SESSION session ID | session name Sessão guardada que deve ser eliminada. Os IDs de sessão têm precedência sobre os nomes de sessão.

Utilize --force apenas com um UUID de sessão. As sessões com nome continuam a exigir confirmação, para que o Codex não elimine um nome repetido ou ambíguo sem solicitar confirmação.

codex cloud

Interaja com conversas na nuvem do Codex a partir do terminal. O comando predefinido abre um seletor interativo; codex cloud exec envia diretamente uma tarefa e codex cloud list devolve as conversas recentes para utilização em scripts ou inspeção rápida.

Chave Tipo/valores Detalhes
--attempts 1-4 Número de tentativas do assistente (melhor de N) que a nuvem do Codex deve executar.
--env ENV_ID Identificador do ambiente de destino da nuvem do Codex (obrigatório). Utilize codex cloud para apresentar as opções.
QUERY string Prompt da tarefa. Se for omitido, o Codex solicita os detalhes de forma interativa.

A autenticação utiliza as mesmas credenciais que a CLI principal. O Codex termina com um código diferente de zero se o envio da tarefa falhar.

codex cloud list

Apresenta conversas recentes na nuvem, com filtragem e paginação opcionais.

Chave Tipo/valores Detalhes
--cursor string Cursor de paginação devolvido por um pedido anterior.
--env ENV_ID Filtra tarefas por identificador de ambiente.
--json boolean Emite JSON legível por máquina em vez de texto simples.
--limit 1-20 Número máximo de tarefas a devolver.

A saída de texto simples apresenta um URL de tarefa seguido dos detalhes do estado. Utilize --json para automatização. O payload JSON contém uma matriz tasks e um valor cursor opcional. Cada tarefa inclui id, url, title, status, updated_at, environment_id, environment_label, summary, is_review e attempt_total.

codex completion

Gera scripts de conclusão da shell e redireciona a saída para a localização adequada, por exemplo, codex completion zsh > "${fpath[1]}/_codex".

Chave Tipo/valores Detalhes
SHELL bash | zsh | fish | power-shell | elvish Shell para a qual devem ser geradas conclusões. A saída é apresentada em stdout.

codex doctor

Gera um relatório de diagnóstico local antes de comunicar um problema ao suporte ou ao investigar uma instalação do Codex com problemas. O relatório verifica o estado da instalação, configuração, autenticação, execução, Git, terminal, app-server e inventário de threads.

Chave Tipo/valores Detalhes
--all boolean Expande listas longas no relatório detalhado legível por humanos.
--ascii boolean Utiliza etiquetas de estado e separadores ASCII na saída legível por humanos.
--json boolean Emite um relatório de suporte anonimizado e legível por máquina.
--no-color boolean Desativa as cores ANSI na saída legível por humanos.
--summary boolean Mostra apenas as linhas de verificação agrupadas e o resumo final das contagens.

codex features

Gere as opções de funcionalidades guardadas em $CODEX_HOME/config.toml. Os comandos enable e disable conservam as alterações para que sejam aplicadas a sessões futuras. O subcomando features não aceita --profile.

Chave Tipo/valores Detalhes
Disable subcommand codex features disable <feature> Desativa de forma persistente uma opção de funcionalidade em $CODEX_HOME/config.toml.
Enable subcommand codex features enable <feature> Ativa de forma persistente uma opção de funcionalidade em $CODEX_HOME/config.toml.
List subcommand codex features list Mostra as opções de funcionalidades conhecidas, a respetiva fase de maturidade e o estado efetivo.

codex exec

Utilize codex exec (ou a forma abreviada codex e) para execuções através de scripts ou ao estilo de CI que devam terminar sem interação humana.

Chave Tipo/valores Detalhes
--cd, -C path Define a raiz do espaço de trabalho antes de executar a tarefa.
--color always | never | auto Controla as cores ANSI em stdout.
--dangerously-bypass-approvals-and-sandbox, --yolo boolean Ignora os prompts de aprovação e o isolamento. É perigoso; utilize apenas num executor isolado.
--dangerously-bypass-hook-trust boolean Executa os hooks ativados sem exigir confiança persistente nos hooks para esta invocação. Destina-se apenas a automatizações que já validem as origens dos hooks.
--ephemeral boolean Executa sem conservar ficheiros de rollout da sessão no disco.
--full-auto boolean Opção de compatibilidade descontinuada. Dê preferência a --sandbox workspace-write; o Codex apresenta um aviso quando esta opção é utilizada.
--ignore-rules boolean Não carrega ficheiros execpolicy .rules do utilizador nem do projeto nesta execução.
--ignore-user-config boolean Não carrega $CODEX_HOME/config.toml. A autenticação continua a utilizar CODEX_HOME.
--image, -i path[,path...] Anexa imagens à primeira mensagem. Pode ser repetida e é compatível com listas separadas por vírgulas.
--json, --experimental-json boolean Apresenta eventos JSON delimitados por novas linhas, em vez de texto formatado.
--local-provider lmstudio | ollama Escolhe o fornecedor local utilizado com --oss, substituindo oss_provider nesta execução.
--model, -m string Substitui o modelo configurado nesta execução.
--oss boolean Utiliza um fornecedor local de código aberto. O Codex utiliza --local-provider ou o oss_provider configurado e termina com um erro se nenhum deles estiver definido.
--output-last-message, -o path Escreve a mensagem final do assistente num ficheiro. É útil para processamento posterior através de scripts.
--output-schema path Ficheiro JSON Schema que descreve a estrutura esperada da resposta final. O Codex valida a saída da ferramenta em relação ao mesmo.
--profile, -p string Sobrepõe $CODEX_HOME/profile-name.config.toml à configuração base do utilizador.
--sandbox, -s read-only | workspace-write | danger-full-access Política de isolamento para comandos gerados pelo modelo. Utiliza a configuração por predefinição.
--skip-git-repo-check boolean Permite a execução fora de um repositório Git (útil para diretórios pontuais).
-c, --config key=value Substituição de configuração inline para a execução não interativa (pode ser repetida).
PROMPT string | - (read stdin) Instrução inicial da tarefa. Utilize - para transmitir o prompt através de stdin.
Resume subcommand codex exec resume [SESSION_ID] Retoma uma sessão exec através do ID ou adiciona --last para continuar a sessão mais recente do diretório de trabalho atual. Adicione --all para considerar sessões de qualquer diretório. Aceita um prompt de seguimento opcional.

Por predefinição, o Codex escreve uma saída formatada. Adicione --json para receber eventos JSON delimitados por novas linhas (um por cada alteração de estado). O subcomando opcional resume permite continuar tarefas não interativas. Utilize --last para selecionar a sessão mais recente do diretório de trabalho atual ou adicione --all para pesquisar em todas as sessões:

Chave Tipo/valores Detalhes
--all boolean Inclui sessões fora do diretório de trabalho atual ao selecionar a sessão mais recente.
--image, -i path[,path...] Anexa uma ou mais imagens ao prompt de seguimento. Separe vários caminhos com vírgulas ou repita a opção.
--last boolean Retoma a conversa mais recente do diretório de trabalho atual.
PROMPT string | - (read stdin) Instrução de seguimento opcional enviada imediatamente após retomar.
SESSION_ID uuid | session name Retoma a sessão especificada. Omita e utilize --last para continuar a sessão mais recente.

codex execpolicy

Verifique os ficheiros de regras execpolicy antes de os guardar. codex execpolicy check aceita uma ou mais opções --rules (por exemplo, ficheiros em ~/.codex/rules) e emite JSON que mostra a decisão mais restritiva e quaisquer regras correspondentes. Adicione --pretty para formatar a saída. O comando execpolicy encontra-se atualmente em pré-visualização.

Chave Tipo/valores Detalhes
--pretty boolean Formata o resultado JSON para facilitar a leitura.
--rules, -r path (repeatable) Caminho de um ficheiro de regras execpolicy que deve ser avaliado. Forneça várias opções para combinar regras de vários ficheiros.
COMMAND... var-args Comando que deve ser verificado em relação às políticas especificadas.

codex login

Autentica a CLI com uma conta ChatGPT, API key ou token de acesso. Sem opções, o Codex abre um navegador para o fluxo OAuth do ChatGPT.

Chave Tipo/valores Detalhes
--device-auth boolean Utiliza o fluxo de código de dispositivo OAuth, em vez de abrir uma janela do navegador.
--with-access-token boolean Lê um token de acesso a partir de stdin (por exemplo, printenv CODEX_ACCESS_TOKEN | codex login --with-access-token).
--with-api-key boolean Lê uma API key a partir de stdin (por exemplo, printenv OPENAI_API_KEY | codex login --with-api-key).
status subcommand codex login status Apresenta o modo de autenticação ativo e termina com 0 quando existe uma sessão iniciada.

codex login status termina com 0 quando existem credenciais, o que é útil em scripts de automatização.

codex logout

Remove as credenciais guardadas para a API key e a autenticação do ChatGPT. Este comando não tem opções.

codex mcp

Gere as entradas de servidores Model Context Protocol guardadas em ~/.codex/config.toml.

Chave Tipo/valores Detalhes
add <name> -- <command...> | --url <value> Regista um servidor através de um comando de iniciação stdio ou de um URL HTTP com transmissão contínua. Compatível com --env KEY=VALUE para transportes stdio.
get <name> --json Mostra a configuração de um servidor específico. --json apresenta a entrada de configuração em bruto.
list --json Apresenta os servidores MCP configurados. Adicione --json para obter uma saída legível por máquina.
login <name> --scopes scope1,scope2 Inicia uma autenticação OAuth num servidor HTTP com transmissão contínua (apenas servidores compatíveis com OAuth).
logout <name> Remove as credenciais OAuth guardadas de um servidor HTTP com transmissão contínua.
remove <name> Elimina uma definição de servidor MCP guardada.

O subcomando add é compatível com transportes stdio e HTTP com transmissão contínua:

Chave Tipo/valores Detalhes
--bearer-token-env-var ENV_VAR Variável de ambiente cujo valor é enviado como token de portador ao estabelecer ligação a um servidor HTTP com transmissão contínua.
--env KEY=VALUE repeatable Atribuições de variáveis de ambiente aplicadas ao iniciar um servidor stdio.
--oauth-client-id CLIENT_ID Identificador de cliente OAuth de um servidor MCP HTTP com transmissão contínua. Requer --url.
--oauth-resource RESOURCE Parâmetro de recurso OAuth a incluir durante a autenticação num servidor MCP HTTP com transmissão contínua. Requer --url.
--url https://… Regista um servidor HTTP com transmissão contínua em vez de stdio. É mutuamente exclusivo com COMMAND....
COMMAND... stdio transport Executável e argumentos para iniciar o servidor MCP. Forneça-os após --.

As ações OAuth (login, logout) só funcionam com servidores HTTP com transmissão contínua (e apenas quando o servidor é compatível com OAuth).

codex plugin

Instala, apresenta e remove plugins de marketplaces configurados.

Chave Tipo/valores Detalhes
add <plugin[@marketplace]> [--marketplace, -m NAME] [--json] Instala um plugin de um marketplace configurado. Utilize --marketplace ou -m quando o argumento do plugin omitir @marketplace.
list [--marketplace, -m NAME] [--available --json] [--json] Apresenta os plugins instalados. Com --json, a saída contém as matrizes installed e available; --available inclui plugins do marketplace não instalados e requer --json.
marketplace Gere as origens de marketplaces configuradas. Consulte codex plugin marketplace abaixo.
remove <plugin[@marketplace]> [--marketplace, -m NAME] [--json] Remove um plugin instalado da configuração local e da cache. Utilize --json para obter uma saída adequada à automatização.

codex plugin add --json apresenta pluginId, name, marketplaceName, version, installedPath e authPolicy. codex plugin list --json apresenta as matrizes installed e available. As entradas incluem pluginId, name, marketplaceName, version, installed, enabled, source, installPolicy, authPolicy e, quando disponível, marketplaceSource com o tipo e o valor da origem de marketplace configurada. codex plugin remove --json apresenta pluginId, name e marketplaceName.

codex plugin marketplace

Gere as origens de marketplaces de plugins que o Codex pode consultar e a partir das quais pode instalar.

Chave Tipo/valores Detalhes
add <source> [--ref REF] [--sparse PATH] [--json] Instala um marketplace de plugins a partir de uma forma abreviada do GitHub, de um URL Git, de um URL SSH ou de um diretório raiz de marketplace local. --sparse só é compatível com origens Git e pode ser repetida.
list [--json] Mostra os marketplaces de plugins que o Codex está atualmente a considerar e o caminho raiz de cada marketplace.
remove <marketplace-name> [--json] Remove um marketplace de plugins configurado.
upgrade [marketplace-name] [--json] Atualiza um marketplace Git configurado ou todos os marketplaces Git configurados quando não é fornecido nenhum nome.

codex plugin marketplace add aceita formas abreviadas do GitHub, como owner/repo ou owner/repo@ref, URLs Git HTTP ou HTTPS, URLs Git SSH e diretórios raiz de marketplaces locais. Utilize --ref para fixar uma referência Git e repita --sparse PATH para utilizar um checkout parcial em repositórios de marketplaces baseados em Git.

codex plugin marketplace list apresenta os nomes e as raízes dos marketplaces abrangidos, incluindo marketplaces predefinidos detetados implicitamente e instantâneos de marketplaces configurados.

Adicione --json aos comandos de adição, apresentação, atualização ou remoção de marketplaces para obter uma saída adequada à automatização. O JSON de adição de marketplace inclui marketplaceName, installedRoot e alreadyAdded; o JSON de apresentação inclui uma matriz marketplaces com name, root e o valor opcional marketplaceSource; o JSON de atualização inclui selectedMarketplaces, upgradedRoots e errors; o JSON de remoção inclui marketplaceName e installedRoot.

codex mcp-server

Para integrações existentes, o comando executa o Codex como servidor MCP através de stdio, para que outras ferramentas possam estabelecer ligação. Herda as substituições da configuração global e termina quando o cliente a jusante encerra a ligação.

codex resume

Continua uma sessão interativa através do ID ou retoma a conversa mais recente. codex resume limita --last ao diretório de trabalho atual, salvo se transmitir --all. Aceita as mesmas opções globais que codex, incluindo substituições do modelo e do isolamento.

Se o diretório de trabalho atual for diferente do diretório guardado da sessão, o Codex pergunta qual deve utilizar. Defina tui.resume_cwd como "current" ou "session" para reutilizar essa escolha sem solicitar confirmação. Uma substituição explícita --cd (-C) tem precedência sobre tui.resume_cwd.

Chave Tipo/valores Detalhes
--all boolean Inclui sessões fora do diretório de trabalho atual ao selecionar a sessão mais recente.
--include-non-interactive boolean Inclui sessões não interativas no seletor e na seleção --last.
--last boolean Ignora o seletor e retoma a conversa mais recente do diretório de trabalho atual.
SESSION_ID uuid | session name Retoma a sessão especificada. Omita e utilize --last para continuar a sessão mais recente.

codex fork

Bifurca uma sessão interativa anterior para uma nova conversa. Por predefinição, codex fork abre o seletor de sessões; adicione --last para bifurcar a sessão mais recente.

Quando os diretórios atual e guardado da sessão forem diferentes, codex fork utiliza o mesmo prompt relativo ao diretório de trabalho e a mesma definição tui.resume_cwd que codex resume.

Chave Tipo/valores Detalhes
--all boolean Mostra no seletor sessões para além das do diretório de trabalho atual.
--last boolean Ignora o seletor e bifurca automaticamente a conversa mais recente.
SESSION_ID uuid Bifurca a sessão especificada. Omita e utilize --last para bifurcar a sessão mais recente.

codex sandbox

Utilize o auxiliar de isolamento para executar um comando ao abrigo das mesmas políticas que o Codex utiliza internamente.

Seatbelt do macOS
Chave Tipo/valores Detalhes
--allow-unix-socket path Permite que o comando isolado associe ou estabeleça ligação a sockets Unix cuja raiz seja este caminho. Repita para permitir vários caminhos.
--cd, -C DIR Diretório de trabalho utilizado para a resolução do perfil e a execução do comando. Requer --permission-profile.
--config, -c key=value Transmite substituições de configuração para a execução isolada (pode ser repetida).
--include-managed-config boolean Inclui requisitos geridos ao resolver um perfil de permissões explícito. Requer --permission-profile.
--log-denials boolean Regista as recusas do ambiente isolado do macOS com log stream durante a execução do comando e apresenta-as após a conclusão.
--permission-profile, -P NAME Aplica um perfil de permissões com nome da pilha de configuração ativa.
--profile, -p NAME Sobrepõe $CODEX_HOME/NAME.config.toml à configuração base do utilizador.
COMMAND... var-args Comando de shell que deve ser executado com o Seatbelt do macOS. Tudo o que estiver após -- é reencaminhado.
Landlock do Linux
Chave Tipo/valores Detalhes
--cd, -C DIR Diretório de trabalho utilizado para a resolução do perfil e a execução do comando. Requer --permission-profile.
--config, -c key=value Substituições de configuração aplicadas antes de iniciar o ambiente isolado (podem ser repetidas).
--include-managed-config boolean Inclui requisitos geridos ao resolver um perfil de permissões explícito. Requer --permission-profile.
--permission-profile, -P NAME Aplica um perfil de permissões com nome da pilha de configuração ativa.
--profile, -p NAME Sobrepõe $CODEX_HOME/NAME.config.toml à configuração base do utilizador.
COMMAND... var-args Comando que deve ser executado com Landlock + seccomp. Forneça o executável após --.
Windows
Chave Tipo/valores Detalhes
--cd, -C DIR Diretório de trabalho utilizado para a resolução do perfil e a execução do comando. Requer --permission-profile.
--config, -c key=value Substituições de configuração aplicadas antes de iniciar o ambiente isolado (podem ser repetidas).
--include-managed-config boolean Inclui requisitos geridos ao resolver um perfil de permissões explícito. Requer --permission-profile.
--permission-profile, -P NAME Aplica um perfil de permissões com nome da pilha de configuração ativa.
--profile, -p NAME Sobrepõe $CODEX_HOME/NAME.config.toml à configuração base do utilizador.
COMMAND... var-args Comando que deve ser executado no ambiente isolado nativo do Windows. Forneça o executável após --.

codex update

Procura e aplica uma atualização da Codex CLI quando a versão instalada é compatível com a atualização automática. As compilações de depuração apresentam uma mensagem a indicar que deve instalar uma compilação de lançamento.

Combinações de opções e sugestões de segurança

  • Utilize --sandbox workspace-write para trabalho local sem supervisão que possa permanecer no espaço de trabalho e evite --dangerously-bypass-approvals-and-sandbox, salvo se estiver numa VM dedicada e isolada.
  • Quando precisar de conceder ao Codex acesso de escrita a mais diretórios, dê preferência a --add-dir em vez de forçar --sandbox danger-full-access.
  • Combine --json com --output-last-message em CI para registar o progresso legível por máquina e um resumo final em linguagem natural.

Atalhos interativos

  • Escreva @ para procurar um ficheiro no espaço de trabalho e adicionar o respetivo caminho ao prompt.
  • Prima Seta para cima ou Seta para baixo para restaurar o histórico de rascunhos.
  • Prima Ctrl+R para pesquisar no histórico de prompts e, em seguida, prima Enter para utilizar uma correspondência ou Esc para cancelar.
  • Prima Ctrl+O ou execute /copy para copiar a saída concluída mais recente do Codex.
  • Coloque ! no início de uma linha para executar um comando de shell local com as definições atuais de aprovação e isolamento.
  • Prima Tab enquanto o Codex estiver a trabalhar para colocar em fila um prompt de seguimento, um comando de barra ou um comando de shell para o turno seguinte.
  • Prima Enter enquanto o Codex estiver a trabalhar para introduzir novas instruções no turno atual.
  • Prima Esc duas vezes com uma caixa de composição vazia para editar a mensagem anterior do utilizador e bifurcar a conversa a partir desse ponto.
  • Prima Ctrl+C ou execute /exit para encerrar a sessão.

Recursos relacionados

Os comandos de barra permitem controlar o Codex de forma rápida e centrada no teclado. Escreva / na caixa de composição para abrir o menu de barra, escolha um comando e o Codex executará ações como mudar de modelo, ajustar permissões ou resumir conversas longas sem sair do terminal.

Este guia mostra como:

  • Encontrar o comando de barra incorporado adequado a uma tarefa
  • Orientar uma sessão ativa com comandos como /model, /fast, /personality, /permissions, /approve, /raw, /agent e /status

Comandos de barra da Codex CLI

Comandos de barra incorporados

O Codex inclui os seguintes comandos. Abra o menu de barra e comece a escrever o nome do comando para filtrar a lista.

Quando já existir uma conversa em curso, pode escrever um comando de barra e premir Tab para o colocar em fila para o turno seguinte. O Codex analisa os comandos de barra em fila quando estes são executados, pelo que os menus de comandos e os erros aparecem após a conclusão do turno atual. A conclusão dos comandos de barra continua a funcionar antes de colocar o comando em fila.

Comando Finalidade Quando utilizar
/permissions Definir o que o Codex pode fazer sem pedir autorização primeiro. Aliviar ou reforçar os requisitos de aprovação durante a sessão, por exemplo, alternando entre Auto e Read Only.
/ide Incluir ficheiros abertos, a seleção atual e outro contexto do IDE. Incorporar o contexto do editor no prompt seguinte sem voltar a explicar o que está aberto no IDE.
/keymap Reatribuir os atalhos de teclado da TUI. Inspecionar e guardar associações de atalhos personalizadas em config.toml.
/vim Ativar ou desativar o modo Vim no compositor. Alternar entre o comportamento normal/inserção do Vim e o modo de edição predefinido do compositor.
/setup-default-sandbox Configurar a sandbox elevada do agente (apenas Windows). Substituir a sandbox limitada do Windows depois de o Codex propor a configuração elevada.
/sandbox-add-read-dir Conceder à sandbox acesso de leitura a um diretório adicional (apenas Windows). Desbloquear comandos que precisam de ler o caminho absoluto de um diretório fora das raízes atualmente legíveis.
/agent, /subagents Mudar a thread de agente ativa. Inspecionar ou continuar o trabalho numa thread de subagente iniciada.
/apps Explorar aplicações (conectores) e inseri-las no prompt. Anexar uma aplicação como $app-slug antes de pedir ao Codex que a utilize.
/plugins Explorar plugins instalados e detetáveis. Inspecionar ferramentas de plugins, instalar plugins sugeridos ou gerir a disponibilidade dos plugins.
/hooks Ver e gerir hooks do ciclo de vida. Inspecionar hooks configurados, confiar em hooks novos ou alterados, ou desativar hooks não geridos antes da execução.
/clear Limpar o terminal e iniciar uma nova conversa. Repor em simultâneo a IU visível e o contexto da conversa quando pretende começar de novo.
/rename Mudar o nome da conversa atual. Dar um nome reconhecível a uma sessão guardada sem sair da TUI.
/archive Arquivar a sessão atual e sair do Codex. Remover a sessão atual das listas de sessões ativas sem eliminar a respetiva transcrição.
/delete Eliminar permanentemente a sessão atual e sair do Codex. Remover a transcrição e as sessões descendentes quando arquivar não é suficiente.
/compact Resumir a conversa visível para libertar tokens. Utilizar após execuções longas para que o Codex retenha os pontos principais sem exceder a janela de contexto.
/copy Copiar o resultado concluído mais recente do Codex. Obter a resposta concluída ou o texto do plano mais recente sem o selecionar manualmente. Também pode premir Ctrl+O.
/diff Mostrar o diff do Git, incluindo ficheiros que o Git ainda não monitoriza. Rever as alterações do Codex antes de fazer commit ou executar testes.
/exit Sair da CLI (equivalente a /quit). Forma alternativa; ambos os comandos encerram a sessão.
/experimental Ativar ou desativar funcionalidades experimentais. Ativar opções como Network proxy ou Prevent sleep while running.
/approve Aprovar uma nova tentativa após uma recusa recente da revisão automática. Repetir um comando ou uma ação recusados pelo revisor automático.
/memories Configurar a utilização e a geração de memórias. Ativar ou desativar a injeção ou a geração de memórias sem sair da TUI.
/skills Explorar e utilizar skills. Melhorar o comportamento específico da tarefa selecionando uma skill local relevante.
/import Importar a configuração, os projetos e as conversas do Claude Code ou Cursor. Migrar artefactos suportados de agentes externos para a configuração e os ficheiros locais do Codex.
/feedback Enviar registos aos responsáveis pela manutenção do Codex. Comunicar problemas ou partilhar diagnósticos com o suporte.
/init Gerar uma estrutura AGENTS.md no diretório atual. Registar instruções persistentes para o repositório ou subdiretório em que está a trabalhar.
/logout Terminar sessão no Codex. Limpar as credenciais locais ao utilizar uma máquina partilhada.
/mcp Listar as ferramentas Model Context Protocol (MCP) configuradas. Verificar que ferramentas externas o Codex pode chamar durante a sessão; adicionar verbose para obter detalhes do servidor.
/mention Anexar um ficheiro à conversa. Indicar ao Codex ficheiros ou pastas específicos que pretende que inspecione a seguir.
/model Escolher o modelo ativo (e o esforço de raciocínio, quando disponível). Alternar entre modelos como gpt-5.6-luna e gpt-5.6-terra antes de executar uma tarefa.
/fast Ativar ou desativar um nível de serviço Fast quando o catálogo de modelos disponibiliza um. Ativar ou desativar o nível Fast do modelo atual e guardar a seleção.
/plan Mudar para o modo de planeamento e, opcionalmente, enviar um prompt. Pedir ao Codex que proponha um plano de execução antes de iniciar o trabalho de implementação.
/goal Definir, editar, colocar em pausa, retomar, ver ou limpar um objetivo de tarefa. Dar ao Codex um objetivo persistente para acompanhar durante a execução de uma tarefa maior.
/personality Escolher um estilo de comunicação para as respostas. Tornar o Codex mais conciso, explicativo ou colaborativo sem alterar as suas instruções.
/ps Mostrar terminais em segundo plano e o respetivo resultado recente. Verificar comandos de longa duração sem sair da transcrição principal.
/stop Parar todos os terminais em segundo plano. Cancelar o trabalho em terminais em segundo plano iniciado pela sessão atual.
/fork Bifurcar a conversa atual para uma nova conversa. Criar uma ramificação da sessão ativa para explorar uma nova abordagem sem perder a transcrição atual.
/app Continuar a sessão atual na aplicação de computador ChatGPT. Passar da TUI para a aplicação de computador no macOS ou Windows.
/side, /btw Iniciar uma conversa lateral temporária. Fazer uma pergunta complementar específica sem perturbar a transcrição da conversa principal.
/raw Ativar ou desativar o modo de histórico bruto. Simplificar a formatação da seleção e da cópia no terminal ao rever resultados extensos.
/resume Retomar uma conversa guardada a partir da lista de sessões. Continuar o trabalho de uma sessão anterior da CLI sem começar de novo.
/new Iniciar uma nova conversa na mesma sessão da CLI. Repor o contexto da conversa sem sair da CLI quando pretende um novo prompt no mesmo repositório.
/quit Sair da CLI. Sair imediatamente da sessão.
/review Pedir ao Codex que reveja a sua árvore de trabalho. Executar depois de o Codex concluir o trabalho ou quando pretende uma segunda avaliação das alterações locais.
/status Apresentar a configuração da sessão e a utilização de tokens. Confirmar o modelo ativo, a política de aprovação, as raízes graváveis e a capacidade de contexto restante.
/usage Ver a utilização de tokens da conta ou utilizar uma reposição do limite de utilização. Inspecionar a atividade diária, semanal ou acumulada de tokens do ChatGPT a partir da TUI.
/debug-config Apresentar diagnósticos das camadas de configuração e dos requisitos. Depurar precedências e requisitos de políticas, incluindo restrições experimentais de rede.
/statusline Configurar interativamente os campos da linha de estado da TUI. Escolher e reordenar itens do rodapé (modelo/contexto/limites/git/tokens/sessão) e guardá-los em config.toml.
/title Configurar interativamente os campos do título da janela ou separador do terminal. Escolher e reordenar itens do título, como projeto, estado, thread, ramo, modelo e progresso da tarefa.
/theme Escolher um tema de realce de sintaxe. Pré-visualizar e guardar um tema de realce de sintaxe do terminal.
/pets, /pet Escolher ou ocultar um animal de estimação do terminal. Personalizar a TUI com um animal de estimação ambiente integrado ou personalizado.

/quit e /exit encerram ambos a CLI. Utilize-os apenas depois de guardar ou fazer commit de qualquer trabalho importante.

Utilize /permissions para ajustar o que o Codex pode fazer sem pedir autorização primeiro. Utilize /approve apenas quando precisar de repetir uma ação recente que a revisão automática recusou.

Controlar a sessão com comandos de barra

Os fluxos de trabalho seguintes mantêm a sessão no rumo certo sem reiniciar o Codex.

Definir o modelo ativo com /model

  1. Inicie o Codex e abra o compositor.
  2. Escreva /model e prima Enter.
  3. Escolha um modelo como gpt-5.6-luna ou gpt-5.6-terra na janela de contexto.

Resultado esperado: o Codex confirma o novo modelo na transcrição. Execute /status para verificar a alteração.

Ativar ou desativar o modo Fast com /fast

  1. Escreva /fast para ativar o nível de serviço Fast do modelo atual.
  2. Escreva novamente /fast para o desativar.

Resultado esperado: o Codex alterna o nível e guarda a seleção. No rodapé da TUI, também pode mostrar um item de linha de estado do modo Fast com /statusline.

Os comandos do nível Fast são determinados pelo catálogo. Se o modelo atual não anunciar um nível Fast, o Codex não mostrará /fast.

Definir um estilo de comunicação com /personality

Utilize /personality para alterar a forma como o Codex comunica sem reescrever o prompt.

  1. Numa conversa ativa, escreva /personality e prima Enter.
  2. Escolha um estilo na janela de contexto.

Resultado esperado: o Codex confirma o novo estilo na transcrição e utiliza-o nas respostas posteriores da conversa.

O Codex suporta as personalidades friendly, pragmatic e none. Utilize none para desativar as instruções de personalidade.

Se o modelo ativo não suportar instruções específicas de personalidade, o Codex oculta este comando.

Mudar para o modo de planeamento com /plan

  1. Escreva /plan e prima Enter para mudar a conversa ativa para o modo de planeamento.
  2. Opcional: forneça texto do prompt na mesma linha (por exemplo, /plan Propose a migration plan for this service).
  3. Pode colar conteúdo ou anexar imagens ao utilizar argumentos /plan na mesma linha.

Resultado esperado: o Codex entra no modo de planeamento e utiliza o prompt opcional na mesma linha como o primeiro pedido de planeamento.

Enquanto o Codex já estiver a trabalhar, /plan fica temporariamente indisponível.

Definir ou ver um objetivo de tarefa com /goal

  1. Escreva /goal <objective> para definir o objetivo, por exemplo, /goal Finish the migration and keep tests green.
  2. Escreva /goal para ver o objetivo atual.
  3. Utilize /goal edit para rever o objetivo. Utilize /goal pause, /goal resume ou /goal clear para o colocar em pausa, retomar ou remover.

Resultado esperado: o Codex mantém o objetivo associado à conversa ativa enquanto o trabalho prossegue.

Os objetivos têm de conter texto e não podem exceder 4000 caracteres. Para instruções mais longas, coloque os detalhes num ficheiro e indique esse ficheiro no objetivo.

Ativar ou desativar funcionalidades experimentais com /experimental

  1. Escreva /experimental e prima Enter.
  2. Ative ou desative as funcionalidades pretendidas (por exemplo, Network proxy ou Prevent sleep while running) e, em seguida, reinicie o Codex se o pedido o indicar.

Resultado esperado: o Codex guarda na configuração as suas escolhas de funcionalidades e aplica-as ao reiniciar.

Aprovar uma recusa da revisão automática com /approve

Utilize /approve quando o revisor automático tiver recusado uma ação recente e pretender que o Codex a repita uma vez.

  1. Escreva /approve.
  2. Confirme a nova tentativa quando o Codex mostrar a ação recusada relevante.

Resultado esperado: o Codex repete uma vez essa ação recusada ao abrigo da política da sessão atual.

Configurar memórias com /memories

  1. Escreva /memories.
  2. Escolha se o Codex deve utilizar memórias existentes, gerar novas memórias ou manter o comportamento de memória desativado.

Resultado esperado: o Codex atualiza as definições de memória relevantes para sessões futuras.

Utilizar skills com /skills

  1. Escreva /skills.
  2. Escolha a skill que pretende que o Codex aplique.

Resultado esperado: o Codex insere o contexto da skill selecionada para que o prompt seguinte siga as instruções dessa skill.

Importar a configuração do Claude Code ou Cursor com /import

  1. Escreva /import.
  2. Escolha Claude Code ou Cursor.
  3. Selecione a configuração, os ficheiros de projeto ou as conversas recentes que pretende migrar.

Resultado esperado: o Codex abre o seletor de importação do agente externo e importa os artefactos suportados selecionados para a configuração e os ficheiros locais do Codex. A deteção de sessões inclui até 50 conversas dos últimos 30 dias.

Execute /import a partir de uma sessão TUI local. Não está disponível enquanto uma tarefa está em execução, em sessões remotas nem durante a ligação ao daemon local do app-server.

Para conhecer o fluxo de trabalho da aplicação de computador e os tipos de artefactos suportados, consulte Importar de outro agente.

Limpar o terminal e iniciar uma nova conversa com /clear

  1. Escreva /clear e prima Enter.

Resultado esperado: o Codex limpa o terminal, repõe a transcrição visível e inicia uma nova conversa na mesma sessão da CLI.

Para atribuir um nome à nova conversa ao criá-la, execute /clear release prep.

Ao contrário de Ctrl+L, /clear inicia uma nova conversa.

Ctrl+L apenas limpa a vista do terminal e mantém a conversa atual. O Codex desativa ambas as ações enquanto uma tarefa está em curso.

Arquivar a sessão atual com /archive

  1. Escreva /archive e prima Enter.
  2. Confirme que pretende arquivar a sessão atual e sair do Codex.

Resultado esperado: o Codex arquiva a sessão atual e fecha a TUI interativa. O Codex mantém a transcrição da sessão guardada localmente; restaure-a mais tarde com codex unarchive <SESSION>.

/archive não está disponível enquanto uma tarefa está em execução.

Eliminar a sessão atual com /delete

  1. Escreva /delete e prima Enter.
  2. Confirme que pretende eliminar a sessão atual e sair do Codex.

Resultado esperado: o Codex elimina a transcrição da sessão atual e fecha a TUI interativa. A eliminação é permanente e também remove as sessões descendentes iniciadas.

/delete não está disponível enquanto uma conversa está em execução nem numa conversa lateral.

Atualizar permissões com /permissions

  1. Escreva /permissions e prima Enter.
  2. Selecione a predefinição de aprovação adequada ao seu nível de conforto, por exemplo, Auto para execuções autónomas ou Read Only para rever alterações. Quando estão ativos perfis de permissões com nome, o seletor também mostra os perfis personalizados configurados e as respetivas descrições.

Resultado esperado: o Codex anuncia a política atualizada. As ações futuras respeitam o modo de aprovação atualizado até que volte a alterá-lo.

Incluir o contexto do IDE com /ide

  1. Escreva /ide.
  2. Adicione texto opcional na mesma linha se quiser explicar o que o Codex deve fazer com a seleção atual do IDE ou os ficheiros abertos.

Resultado esperado: o Codex inclui o contexto disponível do IDE no prompt seguinte.

Ativar ou desativar o modo Vim com /vim

  1. Escreva /vim.
  2. Continue a editar no compositor.

Resultado esperado: o Codex alterna o modo Vim do compositor para a sessão atual. Para tornar o modo Vim a predefinição em novas sessões, defina tui.vim_mode_default = true em config.toml.

Configurar a sandbox elevada do Windows com /setup-default-sandbox

Este comando só aparece no Windows quando o Codex está a utilizar a sandbox limitada de token restrito.

  1. Escreva /setup-default-sandbox.
  2. Siga o fluxo de configuração de administrador.

Resultado esperado: o Codex configura a sandbox elevada do Windows e seleciona a predefinição de aprovação automática correspondente.

Copiar a resposta mais recente com /copy

  1. Escreva /copy e prima Enter.

Resultado esperado: o Codex copia o resultado concluído mais recente do Codex para a área de transferência.

Se ainda estiver um turno em execução, /copy utiliza o resultado concluído mais recente em vez da resposta em curso. O comando não está disponível antes do primeiro resultado concluído do Codex nem imediatamente após uma reversão.

Também pode premir Ctrl+O na TUI principal para copiar a resposta concluída mais recente sem abrir o menu de comandos de barra.

Ativar ou desativar o histórico bruto com /raw

  1. Escreva /raw, /raw on ou /raw off.

Resultado esperado: o Codex alterna o modo de histórico bruto, que torna mais diretas a seleção e a cópia no terminal. Também pode utilizar a associação predefinida Alt+R ou guardar a predefinição com tui.raw_output_mode = true.

Conceder acesso de leitura à sandbox com /sandbox-add-read-dir

Este comando apenas está disponível ao executar nativamente a CLI no Windows.

  1. Escreva /sandbox-add-read-dir C:\absolute\directory\path e prima Enter.
  2. Confirme que o caminho é um diretório absoluto existente.

Resultado esperado: o Codex atualiza a política da sandbox do Windows e concede acesso de leitura a esse diretório para comandos posteriores executados na sandbox.

Inspecionar a sessão com /status

  1. Em qualquer conversa, escreva /status.
  2. Reveja no resultado o modelo ativo, a política de aprovação, as raízes graváveis e a utilização atual de tokens. Quando a TUI estabelece uma ligação remota, o resultado também mostra o endereço remoto e a versão do servidor.

Resultado esperado: o Codex apresenta um resumo que confirma que está a funcionar onde esperava.

Ver a utilização da conta com /usage

  1. Escreva /usage para abrir o menu de utilização.
  2. Escolha entre mostrar a atividade de tokens ou utilizar uma reposição acumulada disponível.
  3. Para abrir diretamente a atividade de tokens, escreva /usage daily, /usage weekly ou /usage cumulative.

Resultado esperado: o Codex abre as ações de utilização ou mostra a atividade de tokens da conta para a vista selecionada. Se a sessão não tiver autenticação da conta de serviço Codex, o Codex mostra um requisito de início de sessão.

Inspecionar as camadas de configuração com /debug-config

  1. Escreva /debug-config.
  2. Reveja no resultado a ordem das camadas de configuração (da precedência mais baixa para a mais alta), o estado de ativação e as origens das políticas.

Resultado esperado: o Codex apresenta diagnósticos das camadas e detalhes das políticas, como allowed_approval_policies, allowed_sandbox_modes, mcp_servers, rules e experimental_network, quando configurados.

Utilize este resultado para depurar por que motivo uma definição efetiva difere de config.toml.

Configurar itens do rodapé com /statusline

  1. Escreva /statusline.
  2. Utilize o seletor para ativar, desativar e reordenar itens e, em seguida, confirme.

Resultado esperado: a linha de estado do rodapé é atualizada imediatamente e guardada em tui.status_line em config.toml.

Os itens disponíveis da linha de estado incluem modelo, modelo+raciocínio, estatísticas de contexto, limites de taxa, ramo do Git, contadores de tokens, ID da sessão, diretório atual/raiz do projeto e versão do Codex.

Configurar itens do título do terminal com /title

  1. Escreva /title.
  2. Utilize o seletor para ativar, desativar e reordenar itens e, em seguida, confirme.

Resultado esperado: o título da janela ou do separador do terminal é atualizado imediatamente e guardado em tui.terminal_title em config.toml.

Os itens de título disponíveis incluem nome da aplicação, projeto, indicador de atividade, estado, thread, ramo do Git, modelo e progresso da tarefa.

Escolher um tema de sintaxe com /theme

  1. Escreva /theme.
  2. Pré-visualize um tema no seletor e, em seguida, confirme.

Resultado esperado: o Codex atualiza o realce de sintaxe e guarda a escolha em tui.theme em config.toml.

Escolher um animal de estimação do terminal com /pets

  1. Escreva /pets (ou /pet) para abrir o seletor de animais de estimação.
  2. Escolha um animal de estimação integrado ou personalizado, ou desative-os.

Resultado esperado: o Codex mostra o animal de estimação ambiente selecionado nos terminais suportados e guarda a seleção. Também pode escrever /pets off para o ocultar.

Reatribuir atalhos da TUI com /keymap

Utilize /keymap para inspecionar, atualizar e guardar associações de atalhos de teclado da TUI.

  1. Escreva /keymap.
  2. Escolha o contexto e a ação do atalho que pretende alterar.
  3. Introduza a nova associação ou remova a existente.

Resultado esperado: o Codex atualiza o mapa de teclas ativo e escreve a associação personalizada em tui.keymap em config.toml.

As associações de teclas utilizam nomes como ctrl-a, shift-enter e page-down. As associações específicas de um contexto substituem tui.keymap.global; uma lista de associações vazia desassocia a ação.

Verificar terminais em segundo plano com /ps

  1. Escreva /ps.
  2. Reveja a lista de terminais em segundo plano e o respetivo estado.

Resultado esperado: o Codex mostra o comando de cada terminal em segundo plano e até três linhas de resultado recentes e não vazias, para que possa avaliar rapidamente o progresso.

Os terminais em segundo plano aparecem quando unified_exec está a ser utilizado; caso contrário, a lista pode estar vazia.

Parar terminais em segundo plano com /stop

  1. Escreva /stop.
  2. Confirme se o Codex pedir autorização antes de parar os terminais listados.

Resultado esperado: o Codex para todos os terminais em segundo plano da sessão atual. /clean continua disponível como alias de /stop.

Manter as transcrições reduzidas com /compact

  1. Após uma conversa longa, escreva /compact.
  2. Confirme quando o Codex propuser resumir a conversa até ao momento.

Resultado esperado: o Codex substitui os turnos anteriores por um resumo conciso, libertando contexto e mantendo os detalhes essenciais.

Rever alterações com /diff

  1. Escreva /diff para inspecionar o diff do Git.
  2. Percorra o resultado na CLI para rever as alterações e os ficheiros adicionados.

Resultado esperado: o Codex mostra as alterações que colocou em staging, as alterações que ainda não colocou em staging e os ficheiros que o Git ainda não começou a monitorizar, para que possa decidir o que manter.

Destacar ficheiros com /mention

  1. Escreva /mention seguido de um caminho, por exemplo, /mention src/lib/api.ts.
  2. Selecione o resultado correspondente na janela de contexto.

Resultado esperado: o Codex adiciona o ficheiro à conversa, assegurando que os turnos seguintes o referenciam diretamente.

Iniciar uma nova conversa com /new

  1. Escreva /new e prima Enter.

Resultado esperado: o Codex inicia uma nova conversa na mesma sessão da CLI, para que possa mudar de conversa sem sair do terminal.

Para atribuir um nome à nova conversa ao criá-la, execute /new bug bash.

Ao contrário de /clear, /new não limpa primeiro a vista atual do terminal.

Mudar o nome da conversa atual com /rename

  1. Escreva /rename <name> ou escreva /rename para abrir o prompt de atribuição de nome.
  2. Introduza um nome curto que o ajude a encontrar a conversa mais tarde.

Resultado esperado: o Codex atualiza o nome guardado da conversa sem alterar a respetiva transcrição.

Retomar uma conversa guardada com /resume

  1. Escreva /resume e prima Enter.
  2. Escolha a sessão pretendida no seletor de sessões guardadas.

Resultado esperado: o Codex volta a carregar a transcrição da conversa selecionada para que possa retomar o trabalho onde o deixou, mantendo o histórico original intacto.

Bifurcar a conversa atual com /fork

  1. Escreva /fork e prima Enter.

Resultado esperado: o Codex clona a conversa atual numa nova conversa com um novo ID, mantendo a transcrição original inalterada para que possa explorar uma abordagem alternativa em paralelo.

Se precisar de bifurcar uma sessão guardada em vez da atual, execute codex fork no terminal para abrir o seletor de sessões.

Continuar na aplicação de computador com /app

No macOS e Windows, escreva /app para abrir a sessão atual na aplicação de computador ChatGPT. Se a aplicação não estiver instalada ou em execução, o Codex mostra um erro a pedir que a instale ou inicie.

Resultado esperado: a aplicação de computador abre a mesma conversa guardada para que possa continuar aí.

Iniciar uma conversa lateral com /side

Utilize /side para iniciar uma bifurcação temporária da conversa atual sem sair da conversa principal.

  1. Escreva /side para abrir uma conversa lateral.
  2. Opcionalmente, adicione texto na mesma linha, por exemplo, /side Check whether this plan has an obvious risk.
  3. Regresse à conversa principal após terminar o desvio específico.

Resultado esperado: o Codex abre uma conversa lateral cuja transcrição está separada da conversa principal. Enquanto estiver no modo lateral, a TUI continua a mostrar o estado da conversa principal para que possa ver se ainda está em execução.

/side não está disponível noutra conversa lateral nem durante o modo de revisão.

Gerar AGENTS.md com /init

  1. Execute /init no diretório onde pretende que o Codex procure instruções persistentes.
  2. Reveja o AGENTS.md gerado e, em seguida, edite-o para corresponder às convenções do repositório.

Resultado esperado: o Codex cria uma estrutura AGENTS.md que pode aperfeiçoar e incluir num commit para sessões futuras.

Pedir uma revisão da árvore de trabalho com /review

  1. Escreva /review.
  2. Continue com /diff se pretender inspecionar as alterações exatas dos ficheiros.

Resultado esperado: o Codex resume os problemas encontrados na árvore de trabalho, com ênfase nas alterações de comportamento e nos testes em falta. Utiliza o modelo da sessão atual, exceto se definir review_model em config.toml.

Listar ferramentas MCP com /mcp

  1. Escreva /mcp.
  2. Reveja a lista para confirmar que servidores e ferramentas MCP estão disponíveis.

Resultado esperado: vê as ferramentas Model Context Protocol (MCP) configuradas que o Codex pode chamar nesta sessão.

Utilize /mcp verbose para incluir diagnósticos detalhados dos servidores. Se transmitir algo diferente de verbose, o Codex mostra a utilização do comando.

Explorar aplicações com /apps

  1. Escreva /apps.
  2. Escolha uma aplicação na lista.

Resultado esperado: o Codex insere a menção da aplicação no compositor como $app-slug, para que possa pedir imediatamente ao Codex que a utilize.

Explorar plugins com /plugins

  1. Escreva /plugins.
  2. Escolha um separador do marketplace e, em seguida, escolha um plugin para inspecionar as suas capacidades ou ações disponíveis.

Resultado esperado: o Codex abre o explorador de plugins para que possa rever os plugins instalados, os plugins detetáveis permitidos pela sua configuração e o estado dos plugins instalados. Prima Space num plugin instalado para alternar o respetivo estado de ativação.

Ver e gerir hooks do ciclo de vida com /hooks

  1. Escreva /hooks.
  2. Escolha um evento de hook para inspecionar os processadores correspondentes.
  3. Confie, desative ou reative hooks não geridos conforme necessário.

Resultado esperado: o Codex abre o explorador de hooks para que possa rever os hooks do ciclo de vida configurados. Os hooks geridos são apresentados como tal e não podem ser desativados no explorador de hooks do utilizador.

Mudar de thread de agente com /agent

  1. Escreva /agent ou /subagents e prima Enter.
  2. Selecione no seletor a thread pretendida.

Resultado esperado: o Codex muda a thread ativa para que possa inspecionar ou continuar o trabalho desse agente.

Enviar comentários com /feedback

  1. Escreva /feedback e prima Enter.
  2. Siga os prompts para incluir registos ou diagnósticos.

Resultado esperado: o Codex recolhe os diagnósticos solicitados e envia-os aos responsáveis pela manutenção.

Terminar sessão com /logout

  1. Escreva /logout e prima Enter.

Resultado esperado: o Codex limpa as credenciais locais da sessão do utilizador atual.

Sair da CLI com /quit ou /exit

  1. Escreva /quit (ou /exit) e prima Enter.

Resultado esperado: o Codex encerra imediatamente. Guarde ou faça commit de qualquer trabalho importante primeiro.

Comandos da extensão do IDE

Utilize estes comandos para controlar o Codex a partir da Paleta de Comandos do VS Code. Também pode associá-los a atalhos de teclado.

Atribuir uma associação de teclas

Para atribuir ou alterar uma associação de teclas de um comando do Codex:

  1. Abra a Paleta de Comandos (Cmd+Shift+P no macOS ou Ctrl+Shift+P no Windows/Linux).
  2. Execute Preferences: Open Keyboard Shortcuts.
  3. Procure Codex ou o ID do comando (por exemplo, chatgpt.newChat).
  4. Selecione o ícone de lápis e, em seguida, introduza o atalho pretendido.

Comandos da extensão

Comando Associação de teclas predefinida Descrição
chatgpt.addToThread - Adicionar o intervalo de texto selecionado como contexto da conversa atual
chatgpt.addFileToThread - Adicionar o ficheiro completo como contexto da conversa atual
chatgpt.newChat macOS: Cmd+N
Windows/Linux: Ctrl+N		 Criar uma nova conversa
chatgpt.newCodexPanel - Criar um novo painel do Codex
chatgpt.openCommandMenu - Abrir o menu de comandos do Codex
chatgpt.openSidebar - Abrir o painel lateral do Codex

Comandos de barra da extensão do IDE

Os comandos de barra permitem controlar o Codex sem sair do compositor. Utilize-os para verificar o estado, alternar entre os modos local e na cloud ou enviar comentários.

Utilizar um comando de barra

  1. No compositor do Codex, escreva /.
  2. Selecione um comando na lista ou continue a escrever para filtrar (por exemplo, /status).
  3. Prima Enter.

Comandos de barra disponíveis

Comando de barra Descrição
/approve Aprovar uma nova tentativa após uma recusa recente da revisão automática, quando esta estiver ativa.
/cloud Executar a conversa na cloud, quando a execução na cloud estiver disponível.
/cloud-environment Escolher o ambiente de cloud para a conversa.
/compact Compactar o contexto da conversa atual.
/fast Ativar ou desativar um nível de serviço Fast fornecido pelo catálogo, quando disponível.
/feedback Abrir a caixa de diálogo de comentários para enviar comentários e, opcionalmente, incluir registos.
/fork Copiar uma conversa local para uma nova conversa local.
/goal Definir um objetivo persistente para o Codex alcançar.
/ide-context Ativar ou desativar o contexto automático do IDE.
/init Gerar uma estrutura AGENTS.md para o projeto atual.
/local Executar a conversa no seu espaço de trabalho local.
/mcp Abrir o estado do MCP para ver os servidores ligados.
/memories Configurar se a conversa pode utilizar ou gerar memórias, quando Memories estiver disponível.
/model Escolher o modelo para a conversa atual.
/personality Escolher a forma como o Codex responde, quando o modelo atual suporta personalidades.
/plan Ativar ou desativar o modo de planeamento para planeamento em várias etapas.
/project Escolher um projeto para novas conversas.
/reasoning Escolher o esforço de raciocínio para a conversa atual.
/review Iniciar o modo de revisão de código para rever alterações sem commit ou comparar com um ramo de base.
/side Iniciar uma conversa lateral temporária sem interromper a conversa principal.
/status Mostrar o ID da conversa, a utilização de contexto e os limites de taxa.
/worktree Executar a conversa numa nova árvore de trabalho do Git.