Comandos para programadores

O ChatGPT na Web tem o seu próprio menu de comandos na caixa de mensagem. Escreva / para ver as ações disponíveis na conversa atual. Não disponibiliza o conjunto de comandos da aplicação de computador do ChatGPT nem da CLI; os comandos de barra do Codex, os comandos da CLI e as opções presentes 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, skills, 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.

Como ler 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

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.

Visão geral dos comandos

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 agents

Abra o centro de comandos para explorar conversas e alternar entre agentes num servidor partilhado. Utilize --remote <URL> para se ligar a um servidor remoto e --cd <DIR> para definir o diretório das novas tarefas remotas. codex agents não suporta --no-daemon.

codex queue

Coloque uma mensagem de texto na fila para uma sessão existente:

codex queue --thread <SESSION_ID> --message "Run the remaining checks"

--thread aceita um UUID ou o nome exato da sessão. Utilize um UUID quando as sessões partilharem o mesmo nome. O comando também aceita --remote e --remote-auth-token-env; os anexos de imagem não são suportados.

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.

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 através do servidor gerido em segundo plano quando as condições o permitirem, com execução em primeiro plano como alternativa. Utilize codex remote-control --no-daemon para executar explicitamente em primeiro plano. Utilize codex remote-control start para iniciar o daemon local do app-server com o controlo remoto ativado e codex remote-control stop para o parar. Os clientes geridos de controlo remoto e os fluxos de trabalho remotos por SSH utilizam estes comandos; estes não substituem codex app-server --listen ao desenvolver um cliente local do protocolo.

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 resultados legíveis por máquina. Para pair, a resposta JSON inclui pairingCode, manualPairingCode, environmentId e expiresAt. --no-daemon aplica-se apenas ao comando remote-control sem subcomandos; não o combine com start, stop ou pair.

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.

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.

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

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.

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.

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.

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

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

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.

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.

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 preenchimento automático da shell e redireciona a saída para a localização adequada, por exemplo, codex completion zsh > "${fpath[1]}/_codex".

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.

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.

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.

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:

Utilize codex exec fork <SESSION_ID> [PROMPT] para copiar uma sessão guardada para uma nova sessão. O argumento da sessão aceita um UUID ou um nome. Sem um prompt, o Codex cria a bifurcação sem iniciar um turno. Passe - como prompt para o ler a partir de stdin ou adicione --image para anexar imagens.

É necessário um prompt ao utilizar imagens, --output-schema, --output-last-message ou --ephemeral.

Adicione --worktree a uma execução nova ou bifurcada para criar uma árvore de trabalho Git gerida:

codex exec --worktree "implement the next step"
codex exec fork <SESSION_ID> --worktree "try an alternative approach"

--worktree requer execução local. Não combine esta opção com resume, review, --ephemeral ou --ignore-user-config.

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.

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.

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.

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

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.

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.

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

codex resume

Continue uma sessão interativa pelo ID ou retome a conversa mais recente. codex resume limita o âmbito de --last ao diretório de trabalho atual, a menos que especifique --all. Aceita substituições das definições de modelo e sandbox, mas não --worktree.

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.

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.

Para criar uma bifurcação numa árvore de trabalho Git gerida, execute codex fork <SESSION_ID> --worktree. Esta operação requer um ID de sessão explícito e execução local; não suporta --last nem o seletor de sessões.

codex sandbox

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

macOS seatbelt

Sandbox no Linux

Windows

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 dicas 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 na área de trabalho e adicionar o respetivo caminho ao prompt.
• Prima Seta para cima ou Seta para baixo para recuperar 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 Escape para cancelar.
• Prima Ctrl+O ou execute /copy para copiar a última resposta concluída do Codex.
• Inicie uma linha com ! para executar um comando de shell local com as definições atuais de aprovação e sandbox.
• Prima Tab enquanto o Codex está a trabalhar para colocar um prompt de seguimento, um comando de barra ou um comando de shell em fila para o turno seguinte.
• Prima Enter enquanto o Codex está a trabalhar para inserir novas instruções no turno atual.
• Prima Escape duas vezes com o campo de composição vazio para editar a mensagem anterior do utilizador e criar uma ramificação da conversa a partir desse ponto.
• Prima Ctrl+C ou execute /exit para fechar a sessão.

Recursos relacionados

• Descrição geral da Codex CLI: instalação, atualizações e sugestões rápidas.
• Noções básicas de configuração: conserva predefinições como o modelo e o fornecedor.
• Configuração avançada: perfis, fornecedores, ajuste do isolamento e integrações.
• AGENTS.md: descrição geral conceptual das capacidades e melhores práticas dos agentes Codex.

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, /permissions, /approve, /raw, /agents, /subagents e /status

Comandos de barra integrados

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. O preenchimento automático dos comandos de barra continua a funcionar antes de colocar o comando em fila.

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

Controle a sessão com comandos de barra

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

Escolher o modo do terminal com /tui

1. Escreva /tui.
2. Escolha o modo de histórico do terminal ou de ecrã inteiro e confirme.
3. Reinicie o Codex para aplicar a seleção.

Resultado esperado: O próximo arranque utiliza o modo do terminal guardado. As opções de arranque que substituem definições, como --no-alt-screen, continuam a aplicar-se.

Exportar uma conversa com /export

1. Escreva /export.
2. Escolha Copiar para a área de transferência ou Guardar num ficheiro.

Resultado esperado: O Codex exporta a conversa completa como Markdown. Para guardar diretamente num ficheiro, execute /export session.md. Aguarde que o turno atual termine antes de exportar.

Resumir a conversa com /recap

1. Quando o Codex estiver inativo, escreva /recap.

Resultado esperado: O Codex gera um resumo da conversa, mesmo que tui.auto_recap = false. Utilize /compact quando pretender libertar espaço de contexto.

Mudar de diretório com /cd

1. Escreva /pwd (ou /cwd) para verificar o diretório atual.
2. Escreva /cd <path> para mudar de diretório ou /cd para utilizar o seu diretório pessoal.

Resultado esperado: O Codex continua a conversa no diretório selecionado. A mudança de diretório requer uma sessão principal inativa, sem entradas em fila de espera nem terminais em segundo plano.

Continuar numa árvore de trabalho com /worktree

1. Escreva /worktree num repositório Git local.
2. Escolha se pretende iniciar uma nova conversa ou continuar a conversa atual numa nova árvore de trabalho.

Resultado esperado: O Codex cria uma árvore de trabalho Git gerida e inicia a conversa selecionada nesse local. Escolha Explorar worktrees para encontrar árvores de trabalho existentes e as conversas às quais pertencem. Este comando requer suporte local para árvores de trabalho e fica indisponível enquanto uma tarefa estiver em execução.

Gerir o servidor em segundo plano com /daemon

1. Escreva /daemon.
2. Reveja a ligação ao servidor e as ações disponíveis.

Resultado esperado: O Codex propõe instalar a versão pública estável mais recente ou utilizar a compilação atual da CLI para o servidor local em segundo plano. A confirmação de uma atualização encerra o Codex e pode interromper o trabalho em curso. No caso de uma ligação remota, faça a gestão do servidor na máquina que o aloja.

Consultar avisos com /warnings

1. Escreva /warnings.

Resultado esperado: O Codex mostra os avisos retidos e os respetivos detalhes de diagnóstico.

Defina o modelo ativo com /model

O seletor mostra apenas os modelos disponíveis para a sua conta e o seu espaço de trabalho. Se o GPT-6.1 Sol não estiver listado, escolha outro modelo. Consulte a disponibilidade do GPT-6.1 Sol por plano.

1. Inicie o Codex e abra o editor de mensagens.
2. Escreva /model e prima Enter.
3. Escolha um modelo como gpt-6-luna ou gpt-6.1-sol na janela emergente.

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

Ative ou desative 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.

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

Defina ou consulte 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 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.

Ative ou desative funcionalidades experimentais com /experimental

1. Escreva /experimental e prima Enter.
2. Ative ou desative as funcionalidades pretendidas (por exemplo, Proxy de rede ou Impedir suspensão durante a execução) 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.

Aprove uma ação rejeitada pela 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.

Configure as 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.

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

Importe a configuração do Claude Code ou do 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.

Limpe o terminal e inicie 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.

Arquive a sessão atual com /archive

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

Resultado esperado: o Codex arquiva a sessão e regressa ao centro de comandos quando está ligado a um servidor local em segundo plano ou a um servidor remoto. Sem um servidor partilhado, o Codex encerra. O Codex mantém a transcrição; restaure-a mais tarde com codex unarchive <SESSION>.

Se estiver um turno em execução, confirmar /archive interrompe esse turno antes de arquivar.

Elimine a sessão atual com /delete

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

Resultado esperado: o Codex elimina permanentemente a transcrição e as sessões descendentes criadas. Quando está ligado a um servidor local em segundo plano ou a um servidor remoto, o Codex regressa ao centro de comandos. Sem um servidor partilhado, o Codex encerra.

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

Atualize as 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.

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

Ative ou desative 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.

Configure a sandbox do Windows com privilégios elevados 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.

Copie a última resposta 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.

Ative ou desative o histórico de saída sem formatação 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.

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

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

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

Configure os elementos 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.

Configure os elementos 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.

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

Escolha uma mascote do terminal com /pets

1. Escreva /pets (ou /pet) para abrir o seletor de mascotes.
2. Escolha uma mascote integrada ou personalizada, ou desative-as.

Resultado esperado: o Codex mostra a mascote decorativa selecionada nos terminais suportados e guarda a seleção. Também pode escrever /pets off para o ocultar.

Reatribua os 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.

Verifique os 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.

Pare os 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.

Mantenha as transcrições concisas 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.

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

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

Inicie uma nova conversa com /new

1. Escreva /new e prima Enter.
2. Se o Codex apresentar uma escolha de checkout, escolha o diretório atual ou uma nova árvore de trabalho.

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.

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

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

Crie uma ramificação da conversa atual com /fork

1. Escreva /fork e prima Enter.
2. Se o Codex apresentar uma escolha de checkout, escolha o diretório atual ou uma nova árvore de trabalho.

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.

Continue na aplicação de ambiente de trabalho 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í.

Inicie uma conversa secundária 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.

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

Peça 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.

Liste as 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 do servidor. Utilize /mcp login <name> para iniciar sessão num MCP server configurado a partir da sessão ativa.

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

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

Consulte e gira 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.

Gerir conversas com /agents

1. Escreva /agents e prima Enter.
2. Selecione uma conversa no centro de comandos para a abrir.

Resultado esperado: o Codex apresenta uma visão geral das conversas no servidor ligado. Pode verificar o respetivo estado e alternar entre elas. Para abrir o centro de comandos diretamente a partir do terminal, execute codex agents. O centro de comandos requer um servidor partilhado local ou remoto.

Alternar entre threads de agentes com /subagents

1. Escreva /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.

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

Termine a sessão com /logout

1. Escreva /logout e prima Enter.

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

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

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.

Atribua um atalho de teclado

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 Preferências: Abrir atalhos de teclado.
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

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.

Utilize 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