Português

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. Introduza / 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, subcomandos da CLI e sinalizadores do Codex 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 profundas para conversas, definições, competências, tarefas agendadas, plugins e animais de estimação.

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 sinalizadores 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.

Sinalizadores 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 coloca a execução em pausa para obter 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 reforçado.
--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á verificam as origens dos hooks.
--disable feature Desativa forçadamente um sinalizador de funcionalidade (converte-se em -c features.<name>=false). Pode ser repetido.
--enable feature Ativa forçadamente um sinalizador de funcionalidade (converte-se em -c features.<name>=true). Pode ser repetido.
--image, -i path[,path...] Anexa um ou mais ficheiros de imagem ao pedido inicial. Separe vários caminhos com vírgulas ou repita o sinalizador.
--local-provider lmstudio | ollama Seleciona 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 pede-lhe 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 endpoint app-server remoto através de WebSocket ou de um socket Unix. Suportado para codex, codex resume, codex fork, codex archive, codex delete e codex unarchive; os restantes subcomandos rejeitam o modo remoto.
--remote-auth-token-env ENV_VAR Lê um bearer token desta variável de ambiente e envia-o ao estabelecer ligação com --remote. Requer --remote; os tokens apenas 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 direto na Web (define web_search = "live" em vez da predefinição "cached").
--strict-config boolean Produz um erro quando config.toml contém campos que esta versão do Codex não reconhece. Suportado por comandos de runtime 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 os sinalizadores propagados, siga a ajuda do comando relevante. Por exemplo, codex exec --oss ... aplica --oss a exec.

Visão geral dos comandos

Chave Maturidade Detalhes
codex Estável Inicia a interface de utilizador do terminal. Aceita os sinalizadores globais acima, além de um pedido 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 a abrir.
codex app-server Experimental Inicia o app-server do 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 o diff mais recente gerado 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 de 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 pedido visível para o modelo, opcionalmente com um pedido 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 da instalação local, configuração, autenticação, runtime, 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, opcionalmente, retoma 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 Lista sinalizadores de funcionalidades e ativa-os ou desativa-os 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 de ChatGPT OAuth, 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 Estável Executa o próprio Codex como servidor MCP através de stdio. Útil quando outro agente utiliza o Codex.
codex plugin Estável Instala, lista e remove plugins de origens de marketplace configuradas.
codex plugin marketplace Estável Adiciona, lista, atualiza ou remove marketplaces de plugins provenientes do Git ou de origens 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, do diff de um ramo base, de um commit ou de instruções de revisão personalizadas.
codex sandbox Estável Executa comandos arbitrários dentro dos 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 suporta a atualização automática.

Detalhes dos comandos

codex (interativo)

A execução de codex sem subcomandos inicia a interface de utilizador interativa do terminal (TUI). O agente aceita os sinalizadores globais acima, além de anexos de imagem. A pesquisa na Web utiliza o modo em cache por predefinição; utilize --search para mudar para a navegação em direto. Para trabalho local sem dificuldades, 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 app-server 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 um caminho explícito. Adicione --remote-auth-token-env <ENV_VAR> quando o servidor exigir um bearer token para autenticação WebSocket.

codex app-server

Inicia localmente o app-server do Codex. Destina-se principalmente a desenvolvimento e depuração e pode ser alterado sem aviso prévio.

Chave Tipo / Valores Detalhes
--analytics-default-enabled boolean Ativa por predefinição a análise para clientes app-server próprios, salvo se o utilizador optar por desativá-la na configuração.
--listen stdio:// | ws://IP:PORT | unix:// | unix://PATH | off URL do listener de transporte. Utilize stdio:// para JSONL, ws://IP:PORT para um endpoint 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 bearer tokens assinados. Requer --ws-auth signed-bearer-token.
--ws-auth capability-token | signed-bearer-token Modo de autenticação dos clientes WebSocket do app-server. Se for omitido, a autenticação WebSocket fica desativada; os listeners não locais apresentam um aviso durante o arranque.
--ws-issuer string Declaração iss esperada para bearer tokens assinados. Requer --ws-auth signed-bearer-token.
--ws-max-clock-skew-seconds number Tolerância ao desvio do relógio ao validar as declarações exp e nbf de um bearer token assinado. Requer --ws-auth signed-bearer-token.
--ws-shared-secret-file absolute path Ficheiro que contém o segredo partilhado HMAC utilizado para validar bearer tokens 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 provém 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 para esse 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 estabelecem 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 bindings de clientes, adicione --experimental para incluir campos e métodos condicionados.

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 no processo do app-server. Utilize ws:// apenas para um anfitrião localhost ou encaminhado 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 do 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 remotos por SSH 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 a abrir.

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á presente. No macOS, o Codex abre o caminho do espaço de trabalho fornecido; no Windows, apresenta o caminho a abrir 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 do app-server incorporado.

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

Este fluxo de depuração inicializa 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 do 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 endpoint remoto de modelos.

codex debug prompt-input

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

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

codex apply

Aplica ao repositório local o diff mais recente de uma conversa na nuvem do Codex. Tem de estar autenticado e ter acesso à conversa.

Chave Tipo / Valores Detalhes
TASK_ID string Identificador da conversa na nuvem do Codex cujo diff deve ser aplicado.

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 pedido.

Chave Tipo / Valores Detalhes
--base branch Revê as alterações em relação 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 staged, unstaged e untracked.
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 entram em conflito entre si. Utilize --title apenas com --commit.

codex archive e codex unarchive

Arquivam ou restauram 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 endpoint app-server remoto antes de alterar o estado de arquivamento.
--remote-auth-token-env ENV_VAR Lê um bearer token desta variável de ambiente quando --remote exige autenticação.
SESSION session ID | session name Sessão guardada a arquivar ou restaurar. 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 pedir 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 endpoint app-server remoto antes de eliminar a sessão.
--remote-auth-token-env ENV_VAR Lê um bearer token desta variável de ambiente quando --remote exige autenticação.
SESSION session ID | session name Sessão guardada a eliminar. 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 perguntar.

codex cloud

Permite interagir com conversas na nuvem do Codex a partir do terminal. O comando predefinido abre um seletor interativo; codex cloud exec submete diretamente uma tarefa e codex cloud list devolve conversas recentes para criação de scripts ou inspeção rápida.

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

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

codex cloud list

Lista 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 da tarefa, seguido dos detalhes do estado. Utilize --json para automatização. O payload JSON contém um array tasks e um valor opcional cursor. 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 de 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 o qual as conclusões devem ser geradas. A saída é apresentada em stdout.

codex doctor

Gera um relatório de diagnóstico local antes de comunicar um problema ao suporte ou durante a investigação de uma instalação do Codex com problemas. O relatório verifica o estado da instalação, configuração, autenticação, runtime, 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 pessoas.
--ascii boolean Utiliza etiquetas de estado e separadores ASCII na saída legível por pessoas.
--json boolean Emite um relatório de suporte anonimizado e legível por máquina.
--no-color boolean Desativa a cor ANSI na saída legível por pessoas.
--summary boolean Mostra apenas as linhas de verificação agrupadas e o resumo da contagem final.

codex features

Gere sinalizadores de funcionalidades armazenados em $CODEX_HOME/config.toml. Os comandos enable e disable tornam as alterações persistentes, para que se apliquem 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 um sinalizador de funcionalidade em $CODEX_HOME/config.toml.
Enable subcommand codex features enable <feature> Ativa de forma persistente um sinalizador de funcionalidade em $CODEX_HOME/config.toml.
List subcommand codex features list Mostra os sinalizadores de funcionalidades conhecidos, a respetiva fase de maturidade e o estado efetivo.

codex exec

Utilize codex exec (ou a forma abreviada codex e) para execuções com 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 a cor ANSI em stdout.
--dangerously-bypass-approvals-and-sandbox, --yolo boolean Ignora os pedidos de aprovação e o isolamento. Perigoso — utilize apenas num runner 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á verificam as origens dos hooks.
--ephemeral boolean Executa sem guardar ficheiros de rollout da sessão no disco.
--full-auto boolean Sinalizador de compatibilidade obsoleto. Prefira --sandbox workspace-write; o Codex apresenta um aviso quando este sinalizador é utilizado.
--ignore-rules boolean Não carrega ficheiros execpolicy .rules do utilizador ou 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 repetido; suporta 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 Seleciona 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 estiver definido.
--output-last-message, -o path Escreve a mensagem final do assistente num ficheiro. Útil para scripts posteriores.
--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 a este esquema.
--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 encaminhar o pedido a partir 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 pedido 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 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 pedido de seguimento. Separe vários caminhos com vírgulas ou repita o sinalizador.
--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 um ou mais sinalizadores --rules (por exemplo, ficheiros em ~/.codex/rules) e emite JSON que mostra a decisão mais restritiva e as 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 para um ficheiro de regras execpolicy a avaliar. Forneça vários sinalizadores para combinar regras de vários ficheiros.
COMMAND... var-args Comando a verificar em relação às políticas especificadas.

codex login

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

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 da API key e da autenticação ChatGPT. Este comando não tem sinalizadores.

codex mcp

Gere entradas de servidores Model Context Protocol armazenadas 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. Suporta --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 Lista os servidores MCP configurados. Adicione --json para obter uma saída legível por máquina.
login <name> --scopes scope1,scope2 Inicia uma sessão OAuth para um servidor HTTP com transmissão contínua (apenas servidores que suportem OAuth).
logout <name> Remove as credenciais OAuth guardadas de um servidor HTTP com transmissão contínua.
remove <name> Elimina uma definição guardada de servidor MCP.

O subcomando add suporta 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 bearer token 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 do cliente OAuth para um servidor MCP HTTP com transmissão contínua. Requer --url.
--oauth-resource RESOURCE Parâmetro de recurso OAuth a incluir durante o início de sessã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) apenas funcionam com servidores HTTP com transmissão contínua (e apenas quando o servidor suporta OAuth).

codex plugin

Instala, lista e remove plugins de marketplaces configurados.

Chave Tipo / Valores Detalhes
add <plugin[@marketplace]> [--marketplace, -m NAME] [--json] Instala um plugin a partir de um marketplace configurado. Utilize --marketplace ou -m quando o argumento do plugin omite @marketplace.
list [--marketplace, -m NAME] [--available --json] [--json] Lista os plugins instalados. Com --json, a saída contém arrays installed e available; --available inclui plugins não instalados do marketplace e requer --json.
marketplace Gere as origens de marketplace configuradas. Consulte codex plugin marketplace abaixo.
remove <plugin[@marketplace]> [--marketplace, -m NAME] [--json] Remove um plugin instalado da configuração e cache locais. 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 os arrays installed e available. As entradas incluem pluginId, name, marketplaceName, version, installed, enabled, source, installPolicy, authPolicy e, quando disponível, marketplaceSource com o tipo e valor da origem do marketplace configurado. 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 abreviatura do GitHub, um URL Git, um URL SSH ou um diretório raiz de marketplace local. --sparse apenas é suportado para origens Git e pode ser repetido.
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 um nome.

codex plugin marketplace add aceita abreviaturas 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 esparso em repositórios de marketplaces baseados em Git.

codex plugin marketplace list apresenta os nomes e as raízes dos marketplaces abrangidos, incluindo os marketplaces predefinidos descobertos implicitamente e os snapshots dos marketplaces configurados.

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

codex mcp-server

Executa o Codex como servidor MCP através de stdio para permitir a ligação de outras ferramentas. Este comando herda as substituições da configuração global e termina quando o cliente a jusante fecha a ligação.

codex resume

Continua uma sessão interativa através do ID ou retoma a conversa mais recente. codex resume restringe --last ao diretório de trabalho atual, salvo se transmitir --all. Aceita os mesmos sinalizadores 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 diretório deve utilizar. Defina tui.resume_cwd como "current" ou "session" para reutilizar essa escolha sem perguntar. 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 são diferentes, codex fork utiliza o mesmo pedido de seleção do diretório de trabalho e a definição tui.resume_cwd que codex resume.

Chave Tipo / Valores Detalhes
--all boolean Mostra no seletor sessões fora 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 com as mesmas políticas que o Codex utiliza internamente.

Seatbelt do macOS
Chave Tipo / Valores Detalhes
--allow-unix-socket path Permite que o comando isolado faça bind ou estabeleça ligação a sockets Unix enraizados neste caminho. Repita para permitir vários caminhos.
--cd, -C DIR Diretório de trabalho utilizado para a resolução do perfil e execução do comando. Requer --permission-profile.
--config, -c key=value Transmite substituições de configuração à execução isolada (pode ser repetido).
--include-managed-config boolean Inclui requisitos geridos ao resolver um perfil explícito de permissões. Requer --permission-profile.
--log-denials boolean Regista as recusas do isolamento do macOS com log stream durante a execução do comando e apresenta-as após a saída.
--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 a executar sob o Seatbelt do macOS. Tudo o que se segue a -- é reencaminhado.
Landlock do Linux
Chave Tipo / Valores Detalhes
--cd, -C DIR Diretório de trabalho utilizado para a resolução do perfil e 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 explícito de permissões. 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 a executar sob 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 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 explícito de permissões. 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 a executar sob o 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 suporta 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 sinalizadores e sugestões de segurança

  • Utilize --sandbox workspace-write para trabalho local sem supervisão que possa permanecer dentro do espaço de trabalho e evite --dangerously-bypass-approvals-and-sandbox, salvo se estiver numa VM isolada dedicada.
  • Quando precisar de conceder ao Codex acesso de escrita a mais diretórios, prefira --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

  • Introduza @ para procurar um ficheiro no espaço de trabalho e adicionar o respetivo caminho ao pedido.
  • Prima Up ou Down para restaurar o histórico de rascunhos.
  • Prima Ctrl+R para pesquisar no histórico de pedidos 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 está a trabalhar para colocar na fila um pedido de seguimento, um comando de barra ou um comando de shell para o turno seguinte.
  • Prima Enter enquanto o Codex está a trabalhar para introduzir novas instruções no turno atual.
  • Prima Esc duas vezes com a 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 fechar a sessão.

Recursos relacionados

Os comandos de barra proporcionam um controlo rápido e orientado para o teclado sobre o Codex. Introduza / na caixa de composição para abrir o pop-up de comandos 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 pop-up de comandos de barra e comece a introduzir o nome do comando para filtrar a lista.

Quando uma conversa já está em curso, pode introduzir um comando de barra e premir Tab para o colocar na 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 depois de o turno atual terminar. A conclusão dos comandos de barra continua a funcionar antes de colocar o comando na fila.

Comando Finalidade Quando utilizar
/permissions Definir o que o Codex pode fazer sem pedir autorização primeiro. Tornar os requisitos de aprovação menos ou mais restritivos 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. Incluir o contexto do editor no pedido seguinte sem voltar a explicar o que está aberto no IDE.
/keymap Reconfigurar 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 disponibilizar a configuração elevada.
/sandbox-add-read-dir Conceder à sandbox acesso de leitura a um diretório adicional (apenas Windows). Desbloquear comandos que precisem de ler um caminho absoluto de diretório fora das raízes atualmente acessíveis para leitura.
/agent, /subagents Mudar o thread do agente ativo. Inspecionar ou continuar o trabalho num thread de um subagente iniciado.
/apps Explorar aplicações (conectores) e inseri-las no pedido. Anexar uma aplicação como $app-slug antes de pedir ao Codex que a utilize.
/plugins Explorar plugins instalados e disponíveis para descoberta. 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 respetiva execução.
/clear Limpar o terminal e iniciar uma nova conversa. Repor em conjunto a interface visível e o contexto da conversa quando pretender começar de novo.
/rename Mudar o nome da conversa atual. Atribuir 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 for suficiente.
/compact Resumir a conversa visível para libertar tokens. Utilizar após execuções prolongadas para que o Codex retenha os pontos essenciais sem esgotar 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 acompanha. Rever as alterações do Codex antes de fazer commit ou executar testes.
/exit Sair da CLI (igual a /quit). Forma alternativa; ambos os comandos terminam 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 de uma recusa recente da revisão automática. Repetir um comando ou uma ação que o revisor automático recusou.
/memories Configurar a utilização e a geração de memórias. Ativar ou desativar a injeção ou 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 recentes do Claude Code. Migrar artefactos compatíveis 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 invocar 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 sejam inspecionados em seguida.
/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 disponibilizado pelo catálogo de modelos. 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 pedido. Pedir ao Codex que proponha um plano de execução antes do início do trabalho de implementação.
/goal Definir, editar, pausar, retomar, ver ou limpar o objetivo de uma 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, mais explicativo ou mais colaborativo sem alterar as suas instruções.
/ps Mostrar terminais em segundo plano e os respetivos resultados recentes. 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 ChatGPT para computador. Passar da TUI para a aplicação para computador no macOS ou Windows.
/side, /btw Iniciar uma conversa lateral efémera. Fazer uma pergunta complementar específica sem interferir com a transcrição da conversa principal.
/raw Ativar ou desativar o modo de histórico bruto. Aplicar menos formatação à seleção e cópia no terminal durante a análise de 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 recomeçar.
/new Iniciar uma nova conversa na mesma sessão da CLI. Repor o contexto da conversa sem sair da CLI quando pretender um novo pedido no mesmo repositório.
/quit Sair da CLI. Abandonar a sessão imediatamente.
/review Pedir ao Codex que reveja a árvore de trabalho. Executar depois de o Codex concluir o trabalho ou quando pretender uma segunda análise 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 com permissão de escrita 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 a precedência e os requisitos de política, 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 do 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 seguintes fluxos de trabalho mantêm a sessão organizada 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 pop-up.

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 mostra /fast.

Definir um estilo de comunicação com /personality

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

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

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 pedido 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 pedido 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 o objetivo de uma 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 pausar, retomar ou remover.

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

Os objetivos devem ter conteúdo e, no máximo, 4 000 caracteres. Para instruções mais longas, coloque os detalhes num ficheiro e faça com que o objetivo aponte para esse ficheiro.

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 assim o indicar.

Resultado esperado: o Codex guarda as escolhas de funcionalidades na configuração e aplica-as após o reinício.

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 segundo a 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 das memórias 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 pedido seguinte siga as instruções dessa skill.

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

  1. Escreva /import.
  2. Escolha Claude Code.
  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 de agentes externos e importa os artefactos compatíveis selecionados para a configuração e os ficheiros locais do Codex. A descoberta de sessões inclui até 50 conversas dos últimos 30 dias.

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

Para conhecer o fluxo de trabalho da aplicação para computador e os tipos de artefactos compatíveis, 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 dar 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 armazenada localmente; restaure-a mais tarde com codex unarchive <SESSION>.

/archive não está disponível enquanto uma tarefa estiver 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 estiver em execução ou 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 sem intervenção 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 contexto do IDE com /ide

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

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

Ativar ou desativar o modo Vim com /vim

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

Resultado esperado: o Codex ativa ou desativa o modo Vim do compositor para a sessão atual. Para tornar o modo Vim a predefinição de 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 utiliza a sandbox limitada com token restrito.

  1. Escreva /setup-default-sandbox.
  2. Siga o fluxo de configuração do 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 um turno ainda estiver 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 ativa ou desativa o modo de histórico bruto, que torna a seleção e a cópia no terminal mais diretas. 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 só está disponível ao executar a CLI nativamente no Windows.

  1. Escreva /sandbox-add-read-dir C:\absolute\directory\path e prima Enter.
  2. Confirme que o caminho corresponde a 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 o resultado relativo ao modelo ativo, à política de aprovação, às raízes com permissão de escrita e à 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 é esperado.

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 obtida 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 do Codex, o Codex mostra um requisito de início de sessão.

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

  1. Escreva /debug-config.
  2. Reveja o resultado relativo à ordem das camadas de configuração (primeiro a precedência mais baixa), ao estado ativado/desativado e às 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, enforce_residency e experimental_network, quando configurados.

Utilize este resultado para depurar o motivo pelo qual 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 na linha de estado incluem modelo, modelo+raciocínio, estatísticas de contexto, limites de utilização, ramo 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 o nome da aplicação, o projeto, o indicador de atividade, o estado, o thread, o ramo git, o modelo e o 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 apresenta o animal de estimação ambiente selecionado nos terminais compatíveis e guarda a seleção. Também pode escrever /pets off para o ocultar.

Reconfigurar 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 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 solicitar confirmação antes de parar os terminais apresentados.

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 concisas com /compact

  1. Após uma interação prolongada, 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 em staging, as alterações que ainda não colocou em staging e os ficheiros que o Git ainda não acompanha, 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 pop-up.

Resultado esperado: o Codex adiciona o ficheiro à conversa, garantindo que os turnos seguintes fazem referência direta ao mesmo.

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 dar 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 pedido 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 da conversa guardada 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 ficou, mantendo intacto o histórico original.

Bifurcar a conversa atual com /fork

  1. Escreva /fork e prima Enter.

Resultado esperado: o Codex clona a conversa atual para uma 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 para computador com /app

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

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

Iniciar uma conversa lateral com /side

Utilize /side para iniciar uma bifurcação efémera 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 depois de concluir 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 esta 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 de acordo com as 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. Em seguida, utilize /diff se pretender inspecionar as alterações exatas dos ficheiros.

Resultado esperado: o Codex resume os problemas encontrados na árvore de trabalho, concentrando-se em alterações de comportamento e testes em falta. Utiliza o modelo da sessão atual, a menos que defina 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 invocar nesta sessão.

Utilize /mcp verbose para incluir diagnósticos detalhados do servidor. Se transmitir qualquer valor 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, selecione um plugin para inspecionar as respetivas capacidades ou ações disponíveis.

Resultado esperado: o Codex abre o browser de plugins para que possa rever os plugins instalados, os plugins disponíveis para descoberta permitidos pela 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. Conforme necessário, confie em hooks não geridos ou desative-os ou reative-os.

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

Mudar de thread de agente com /agent

  1. Escreva /agent ou /subagents e prima Enter.
  2. Selecione o thread pretendido no seletor.

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

Enviar comentários com /feedback

  1. Escreva /feedback e prima Enter.
  2. Siga as instruções 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 termina 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 o modo local e o modo 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 de 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 disponibilizado pelo catálogo, quando disponível.
/feedback Abrir a caixa de diálogo de comentários para os enviar e incluir opcionalmente 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 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 da conversa atual.
/personality Escolher a forma como o Codex responde, quando o modelo atual suportar personalidades.
/plan Ativar ou desativar o modo de planeamento para planeamento com 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 base.
/side Iniciar uma conversa lateral temporária sem interromper a conversa principal.
/status Mostrar o ID da conversa, a utilização do contexto e os limites de utilização.
/worktree Executar a conversa numa nova árvore de trabalho do Git.