Comandos para desenvolvedores

O ChatGPT na Web tem seu próprio menu de comandos no campo de mensagem. Digite / para ver as ações disponíveis no chat atual. Essa interface não oferece o conjunto de comandos do aplicativo ChatGPT para desktop nem o da CLI. Os comandos de barra do Codex, os comandos da CLI e as flags desta referência não se aplicam ao ChatGPT na Web.

Comandos do aplicativo ChatGPT para desktop

A página de Comandos aborda a navegação no aplicativo, os atalhos de chat, a personalização do teclado e os links diretos para chats, configurações, habilidades, tarefas agendadas, plugins e mascotes.

A página de Comandos de barra descreve os comandos disponíveis no campo de mensagem do aplicativo, incluindo /feedback, /goal, /init, /mcp, /plan, /review e /status.

Como consultar esta referência

Esta página reúne todos os comandos e flags documentados da CLI do Codex. Use as tabelas interativas para pesquisar por chave ou descrição. Cada seção indica o estágio de maturidade das opções e destaca as opções descontinuadas e as combinações de risco.

Flags globais

Essas opções se aplicam ao comando base codex. A maioria também se aplica aos subcomandos. Consulte as observações acima ou a ajuda do comando para conhecer as exceções. Para usar as flags que se propagam, siga a ajuda do comando correspondente. Por exemplo, codex exec --oss ... aplica --oss a exec.

Visão geral dos comandos

Detalhes dos comandos

codex (interativo)

Executar codex sem subcomando abre a interface interativa do terminal (TUI). O agente aceita as flags globais acima e imagens anexadas. Por padrão, a pesquisa na Web usa resultados em cache. Use --search para pesquisar em tempo real. Para simplificar o trabalho local, use --sandbox workspace-write --ask-for-approval on-request.

Use --remote ws://host:port ou --remote wss://host:port para conectar a TUI a um App Server iniciado com codex app-server --listen ws://IP:PORT. Para usar um socket Unix local, passe --remote unix:// para o socket padrão ou --remote unix://PATH para indicar um caminho específico. Adicione --remote-auth-token-env <ENV_VAR> quando o servidor exigir um token Bearer para autenticação via WebSocket.

codex agents

Abra a central de comandos para consultar chats e alternar entre agentes em um servidor compartilhado. Use --remote <URL> para se conectar a um servidor remoto e --cd <DIR> para definir o diretório das novas tarefas remotas. O comando codex agents não aceita --no-daemon.

codex queue

Coloque uma mensagem de texto na fila de 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. Use um UUID quando houver sessões com o mesmo nome. As mensagens na fila usam o modelo da sessão. O comando aceita apenas texto.

Adicione --resume para colocar a mensagem na fila e, em seguida, retomar a sessão caso ela ainda não esteja carregada. Para retomar a sessão, é preciso ter um daemon local em execução ou selecionar um servidor com --remote. Use --remote-auth-token-env se o servidor exigir um token. Se o Codex não conseguir retomar a sessão, ele exibe um aviso e o comando termina com sucesso mesmo assim.

codex app-server

Inicie o App Server do Codex localmente. Ele se destina principalmente ao desenvolvimento e à depuração e pode mudar sem aviso prévio.

codex app-server --listen stdio:// mantém o comportamento padrão de transmitir JSONL via stdio, e codex app-server --stdio é um alias para esse transporte. --listen ws://IP:PORT habilita o transporte WebSocket para os clientes do App Server. O servidor aceita URLs de escuta ws://. Use terminação TLS ou um proxy seguro quando os clientes se conectarem com wss://. Use --listen unix:// para aceitar handshakes WebSocket no socket Unix padrão do Codex ou --listen unix:///absolute/path.sock para escolher o caminho do socket. Se você gerar schemas para os bindings do cliente, adicione --experimental para incluir campos e métodos de acesso restrito.

Use --code-mode-host https://code-mode.example.com para conectar todas as threads do processo do App Server a um host remoto do Code Mode via gRPC. A flag --listen controla como os clientes se conectam ao App Server.

codex remote-control

Execute codex remote-control para iniciar o controle remoto pelo servidor gerenciado em segundo plano quando essa opção estiver disponível. Caso contrário, ele será executado em primeiro plano. Use codex remote-control --no-daemon para executar explicitamente em primeiro plano. Use codex remote-control start para iniciar o daemon local do App Server com o controle remoto habilitado e codex remote-control stop para pará-lo. Clientes de controle remoto gerenciado e fluxos de trabalho remotos via SSH usam esses comandos. Para criar um cliente local do protocolo, continue usando codex app-server --listen.

Depois que o daemon estiver em execução, use codex remote-control pair para criar e exibir um código de pareamento manual de curta duração. Adicione --json a qualquer comando de controle remoto para obter uma saída legível por máquina. Para pair, a resposta JSON inclui pairingCode, manualPairingCode, environmentId e expiresAt. --no-daemon só se aplica ao comando remote-control sem subcomando. Não combine essa flag com start, stop ou pair.

codex app

Inicie o aplicativo ChatGPT para desktop pelo terminal no macOS ou no Windows. No macOS, o Codex pode abrir um caminho específico do workspace. No Windows, ele exibe o caminho a abrir.

codex app abre o aplicativo ChatGPT para desktop, se estiver instalado, ou inicia o instalador. No macOS, o Codex abre o caminho informado para o workspace. No Windows, ele exibe o caminho a abrir após a instalação.

codex debug app-server send-message-v2

Envie uma mensagem pelo fluxo V2 de threads e turnos do App Server usando o cliente de teste integrado ao servidor.

Esse fluxo de depuração é inicializado com experimentalApi: true, inicia uma thread, envia um turno e transmite as notificações do servidor em tempo real. Use-o para reproduzir e examinar localmente o comportamento do protocolo do App Server.

codex debug models

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

Use --bundled para examinar apenas o catálogo incluído no binário atual, sem atualizá-lo pelo endpoint remoto de modelos.

codex debug prompt-input

Exiba em JSON a lista exata de entradas do prompt que o modelo recebe. Use esse comando para depurar a localização de instruções, o contexto da sessão ou a construção do prompt.

codex apply

Aplique ao repositório local o diff mais recente de um chat do Codex na nuvem. Você precisa se autenticar e ter acesso ao chat.

O Codex lista os arquivos modificados e encerra com um código diferente de zero se git apply falhar, por exemplo, devido a conflitos.

codex review

Execute uma revisão de código sem interação. Escolha exatamente um alvo para a revisão ou passe instruções personalizadas de revisão em um prompt.

--uncommitted, --base, --commit e um PROMPT personalizado são mutuamente exclusivos. Use --title apenas com --commit.

codex archive e codex unarchive

Arquive ou restaure uma sessão interativa salva usando o ID ou o nome da sessão. Use esses comandos para organizar a lista do seletor de sessões sem excluir o histórico. Os IDs de sessão têm precedência sobre os nomes.

Quando você arquiva ou restaura uma sessão, o Codex também tenta arquivar ou restaurar as sessões de subagentes que ela criou e todas as sessões descendentes delas.

codex archive <SESSION>
codex unarchive <SESSION>

codex delete

Exclua permanentemente uma sessão interativa salva usando o ID ou o nome da sessão. Use esse comando apenas se quiser remover o histórico em vez de ocultar a sessão nas listas de sessões ativas.

codex delete <SESSION>
codex delete <SESSION_UUID> --force

Use --force apenas com o UUID da sessão. Ao usar o nome, ainda é preciso confirmar a exclusão. Assim, o Codex não exclui uma sessão com nome repetido ou ambíguo sem perguntar.

codex cloud

Acesse os chats do Codex na nuvem pelo terminal. O comando padrão abre um seletor interativo. codex cloud exec envia uma tarefa diretamente e codex cloud list retorna os chats recentes para uso em scripts ou para consulta rápida.

A autenticação usa as mesmas credenciais da CLI principal. Se o envio da tarefa falhar, o Codex encerra com um código diferente de zero.

codex cloud list

Liste os chats recentes na nuvem, com opções de filtragem e paginação.

A saída em texto simples exibe a URL de uma tarefa seguida dos detalhes de status. Use --json para automação. A resposta 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

Gere scripts de preenchimento automático para o shell e redirecione a saída para o local apropriado, por exemplo, codex completion zsh > "${fpath[1]}/_codex".

codex doctor

Gere um relatório de diagnóstico local antes de abrir uma issue de suporte ou durante a investigação de uma falha na instalação do Codex. O relatório verifica a integridade da instalação, da configuração, da autenticação, do ambiente de execução, do Git, do terminal, do App Server e do inventário de threads.

codex features

Gerencie as flags de recursos armazenadas em $CODEX_HOME/config.toml. Os comandos enable e disable salvam as alterações para que se apliquem a sessões futuras. O subcomando features não aceita --profile.

codex exec

Use codex exec (ou a forma abreviada codex e) para execuções em scripts ou em fluxos de integração contínua (CI) que precisam terminar sem interação humana.

Por padrão, o Codex gera uma saída formatada. Adicione --json para receber eventos JSON separados por quebras de linha, um por mudança de estado. O subcomando opcional resume permite continuar tarefas não interativas. Use --last para selecionar a sessão mais recente do diretório de trabalho atual ou adicione --all para pesquisar em todas as sessões:

Use codex exec fork <SESSION_ID> [PROMPT] para copiar uma sessão salva para uma nova sessão. O argumento da sessão aceita um UUID ou um nome. Sem um prompt, o Codex cria o fork sem iniciar um turno. Passe - como prompt para lê-lo de stdin ou adicione --image para anexar imagens.

É obrigatório fornecer um prompt ao usar imagens, --output-schema, --output-last-message ou --ephemeral.

Adicione --worktree a uma nova execução ou a uma execução criada por fork para criar uma árvore de trabalho Git gerenciada:

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

--worktree exige execução local. Não combine essa flag com resume, review, --ephemeral ou --ignore-user-config.

codex execpolicy

Verifique os arquivos de regras de execpolicy antes de salvá-los. codex execpolicy check aceita uma ou mais flags --rules (por exemplo, para arquivos em ~/.codex/rules) e gera uma saída JSON com a decisão mais restritiva e as regras correspondentes. Adicione --pretty para formatar a saída. O comando execpolicy está em fase de prévia.

codex login

Autentique a CLI com uma conta do ChatGPT, uma chave de API ou um token de acesso. Sem flags, o Codex abre o navegador para o fluxo OAuth do ChatGPT.

codex login status encerra com o código 0 quando há credenciais, o que facilita a verificação em scripts de automação.

codex logout

Remova as credenciais salvas tanto para autenticação por chave de API quanto para autenticação pelo ChatGPT. Esse comando não tem flags.

codex mcp

Gerencie as entradas de servidores do Model Context Protocol armazenadas em ~/.codex/config.toml.

O subcomando add aceita os transportes stdio e HTTP com streaming:

As ações OAuth (login, logout) só funcionam com servidores HTTP com streaming que ofereçam suporte a OAuth.

codex plugin

Instale, liste e remova plugins dos marketplaces configurados.

codex plugin add --json exibe pluginId, name, marketplaceName, version, installedPath e authPolicy. codex plugin list --json exibe 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 o valor da origem configurada para o marketplace. codex plugin remove --json exibe pluginId, name e marketplaceName.

codex plugin marketplace

Gerencie as origens dos marketplaces que o Codex pode consultar para encontrar e instalar plugins.

codex plugin marketplace add aceita a notação abreviada do GitHub, como owner/repo ou owner/repo@ref, URLs Git via HTTP, HTTPS ou SSH e diretórios raiz de marketplaces locais. Use --ref para fixar uma referência Git e repita --sparse PATH para fazer checkout parcial nos repositórios Git de marketplaces.

codex plugin marketplace list exibe os nomes e diretórios raiz dos marketplaces no escopo atual, incluindo os marketplaces padrão detectados implicitamente e os snapshots de marketplaces configurados.

Adicione --json aos comandos add, list, upgrade ou remove do marketplace para obter uma saída adequada à automação. A saída JSON de add inclui marketplaceName, installedRoot e alreadyAdded. A de list inclui o array marketplaces com name, root e, opcionalmente, marketplaceSource. A de upgrade inclui selectedMarketplaces, upgradedRoots e errors. A de remove inclui marketplaceName e installedRoot.

codex mcp-server

codex resume

Continue uma sessão interativa pelo ID ou retome o chat mais recente. codex resume limita --last ao diretório de trabalho atual, a menos que você passe --all. O comando aceita substituições de modelo e sandbox, mas não aceita --worktree.

Se o diretório de trabalho atual for diferente do diretório salvo na sessão, o Codex perguntará qual usar. Defina tui.resume_cwd como "current" ou "session" para reutilizar essa escolha sem precisar responder novamente. Um diretório informado explicitamente com --cd (-C) tem precedência sobre tui.resume_cwd.

codex fork

Crie um fork de uma sessão interativa anterior em um novo chat. Por padrão, codex fork abre o seletor de sessões. Use --last para criar um fork da sessão mais recente do diretório atual. Use --last --all para criar um fork da sessão mais recente entre todos os diretórios.

Quando o diretório atual difere do diretório salvo na sessão, codex fork usa a mesma pergunta sobre o diretório de trabalho e a mesma configuração tui.resume_cwd que codex resume.

Para criar um fork em uma árvore de trabalho Git gerenciada, execute codex fork <SESSION_ID> --worktree. Isso exige um ID de sessão explícito e execução local. Não é possível usar --last nem o seletor de sessões.

codex sandbox

Use o utilitário de sandbox para executar um comando com as mesmas políticas que o Codex usa internamente.

Seatbelt do macOS

Sandbox do Linux

Windows

Antes de remover o sandbox legado do Windows, encerre os aplicativos que o utilizam. Se o serviço de provisionamento do sandbox estiver instalado, pare-o também. Em seguida, execute codex sandbox uninstall como administrador. O comando remove as contas e as regras de rede do sandbox que se aplicam a toda a máquina. Ele preserva o diretório pessoal do Codex, incluindo os diretórios do sandbox e as permissões do sistema de arquivos.

codex update

Verifique se há uma atualização da CLI do Codex e aplique-a quando a versão instalada permitir a atualização pelo próprio comando. As compilações de depuração exibem uma mensagem orientando você a instalar uma versão de distribuição.

Combinações de flags e dicas de segurança

• Use --sandbox workspace-write para tarefas locais sem supervisão que possam se limitar ao workspace. Evite --dangerously-bypass-approvals-and-sandbox, a menos que esteja em uma máquina virtual dedicada ao sandbox.
• Para conceder ao Codex acesso de gravação a mais diretórios, prefira --add-dir a forçar --sandbox danger-full-access.
• Combine --json com --output-last-message na CI para registrar o progresso em formato legível por máquina e obter um resumo final em linguagem natural.

Atalhos interativos

• Digite @ para pesquisar um arquivo no workspace e adicionar seu caminho ao prompt.
• Pressione Seta para cima ou Seta para baixo para recuperar rascunhos do histórico.
• Pressione Ctrl+R para pesquisar no histórico de prompts. Depois, pressione Enter para usar um resultado ou Escape para cancelar.
• Pressione Ctrl+ O  para copiar a última resposta concluída. Execute /copy para escolher o que copiar.
• Comece uma linha com ! para executar um comando de shell local com as configurações atuais de aprovação e sandbox.
• Pressione Tab enquanto o Codex estiver trabalhando para colocar um prompt de acompanhamento, um comando de barra ou um comando de shell na fila do próximo turno.
• Pressione Enter enquanto o Codex estiver trabalhando para inserir novas instruções no turno atual.
• Pressione Escape duas vezes com o campo de mensagem vazio para editar a mensagem anterior do usuário e criar um fork do chat a partir desse ponto.
• Pressione Ctrl+C ou execute /exit para fechar a sessão.

Recursos relacionados

• Visão geral da CLI do Codex: instalação, atualizações e dicas rápidas.
• Noções básicas de configuração: como salvar valores padrão, como o modelo e o provedor.
• Configuração avançada: perfis, provedores, ajustes do sandbox e integrações.
• AGENTS.md: visão geral das capacidades dos agentes do Codex e das práticas recomendadas.

Os comandos de barra permitem controlar o Codex rapidamente pelo teclado. Digite / no campo de mensagem para abrir o menu de comandos de barra e escolha um comando. O Codex pode trocar de modelo, ajustar permissões ou resumir chats longos sem que você precise sair do terminal.

Neste guia, você aprende a:

• Encontrar o comando de barra integrado adequado para uma tarefa
• Conduzir uma sessão ativa com comandos como /model, /fast, /permissions, /approve, /raw, /agents, /subagents e /status

Comandos de barra integrados

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

Quando um chat já está em execução, você pode digitar um comando de barra e pressionar Tab para colocá-lo na fila do próximo turno. O Codex interpreta os comandos da fila no momento da execução. Por isso, os menus e os erros desses comandos aparecem depois que o turno atual termina. O preenchimento automático continua disponível antes de você colocar o comando na fila.

Tanto /quit quanto /exit encerram a CLI. Use esses comandos somente depois de salvar ou fazer commit de todo trabalho importante.

Use /permissions para ajustar o que o Codex pode fazer sem pedir aprovação. Use /approve somente quando precisar repetir uma ação recente negada pela revisão automática.

Como controlar sua sessão com comandos de barra

Os procedimentos a seguir permitem conduzir a sessão sem reiniciar o Codex.

Alterar as preferências do terminal com /config

Digite /config para abrir as preferências do terminal. Consulte as configurações por grupo ou pressione  /  para pesquisar. O Codex salva as alterações automaticamente.

Escolher o modo do terminal com /tui

1. Digite /tui.
2. Escolha o modo de histórico de rolagem ou de tela cheia e confirme.
3. Reinicie o Codex para aplicar a seleção.

Resultado esperado: na próxima inicialização, o Codex usa o modo de terminal salvo. Opções de inicialização como --no-alt-screen continuam tendo precedência.

Exportar uma conversa com /export

1. Digite /export.
2. Escolha Copiar para a área de transferência ou Salvar em arquivo.

Resultado esperado: o Codex exporta a conversa completa em Markdown. Para salvar diretamente em um arquivo, execute /export session.md. Aguarde o turno atual terminar antes de exportar.

Resumir o chat com /recap

1. Quando o Codex estiver ocioso, digite /recap.

Resultado esperado: o Codex gera um resumo da conversa mesmo com tui.auto_recap = false. Use /compact quando quiser liberar espaço na janela de contexto.

Mudar de diretório com /cd

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

Resultado esperado: o Codex continua o chat no diretório selecionado. Para mudar de diretório, a sessão principal precisa estar ociosa, sem entradas na fila nem terminais em segundo plano.

Continuar em uma árvore de trabalho com /worktree

1. Digite /worktree em um repositório Git local.
2. Escolha se deseja iniciar um novo chat ou continuar a conversa atual em uma nova árvore de trabalho.

Resultado esperado: o Codex cria uma árvore de trabalho Git gerenciada e inicia nela o chat selecionado. Escolha Explorar árvores de trabalho para encontrar as árvores existentes e os chats aos quais pertencem. Esse comando exige suporte local a árvores de trabalho e fica indisponível enquanto uma tarefa está em execução.

Gerenciar o servidor em segundo plano com /daemon

1. Digite /daemon.
2. Confira a conexão com o servidor e as ações disponíveis.

Resultado esperado: o Codex oferece a opção de instalar a versão pública estável mais recente ou usar a compilação atual da CLI para o servidor local em segundo plano. Confirmar uma atualização encerra o Codex e pode interromper trabalhos em andamento. Para reiniciar um servidor local gerenciado, selecione Reiniciar servidor em segundo plano e confirme. O Codex se reconecta automaticamente. A reinicialização pode interromper trabalhos em andamento ou na fila de outros chats. Se a conexão for remota, gerencie o servidor no próprio host.

Consultar avisos com /warnings

1. Digite /warnings.

Resultado esperado: o Codex exibe os avisos registrados e os respectivos detalhes de diagnóstico.

Definir o modelo ativo com /model

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

1. Inicie o Codex e abra o campo de mensagem.
2. Digite /model e pressione Enter.
3. Escolha no menu um modelo como gpt-6-luna ou gpt-6.1-sol.

Resultado esperado: o Codex confirma o novo modelo no histórico do chat. Execute /status para verificar a alteração.

Para alterar diretamente as configurações da sessão atual, use /model [model] [--reasoning=<level>] [--speed=<tier>]. Por exemplo, /model --reasoning=high mantém o modelo atual e define seu esforço de raciocínio como alto, se o modelo oferecer suporte a esse nível.

Reutilizar prompts e comandos com /presets

Digite /presets e pressione  n  para salvar um prompt ou comando de barra em uma posição numerada. Pressione  s  para criar uma predefinição a partir do modelo, das permissões, do título do terminal ou da linha de status em uso. Para executar uma predefinição salva, abra /presets e pressione a tecla correspondente ao número dela.

Ativar ou desativar o modo Fast com /fast

1. Digite /fast para ativar o nível de serviço Fast do modelo atual.
2. Digite /fast novamente para desativá-lo.

Resultado esperado: o Codex altera o nível de serviço e salva a seleção. No rodapé da TUI, você também pode usar /statusline para exibir o modo Fast na linha de status.

Os comandos do nível Fast dependem do catálogo. Se o modelo atual não oferecer o nível Fast, o Codex não exibirá /fast.

Ativar ou desativar o Daybreak

Se você usar a OpenAI como provedor e tanto sua conta quanto seu modelo tiverem acesso ao Daybreak, use /daybreak para ativar ou desativar o Daybreak. O Codex aplica a escolha ao chat atual e a salva como padrão para chats futuros.

Conversar com o Codex por voz com /voice

Se a versão da CLI e a sessão oferecerem suporte a voz, use /voice ou F8 para iniciar ou encerrar uma conversa por voz. Use /voice mute para ativar ou desativar o microfone e /voice stop para encerrar a conversa. Use /voice settings para escolher uma voz para conversas futuras.

Entrar no modo planejamento com /plan

1. Digite /plan e pressione Enter para colocar o chat ativo no modo planejamento.
2. Se quiser, inclua o texto do prompt no próprio comando. Por exemplo, para pedir um plano de migração para este serviço, use /plan Propose a migration plan for this service.
3. Você pode colar conteúdo ou anexar imagens ao passar argumentos na mesma linha que /plan.

Resultado esperado: o Codex entra no modo planejamento e usa o prompt opcional fornecido no comando como o primeiro pedido de planejamento.

Enquanto o Codex estiver trabalhando, /plan ficará temporariamente indisponível.

Definir ou consultar a meta de uma tarefa com /goal

1. Digite /goal <objective> para definir a meta. Por exemplo, para concluir a migração e manter todos os testes passando, use /goal Finish the migration and keep tests green.
2. Digite /goal para consultar a meta atual.
3. Use /goal edit para editar o objetivo. Use /goal pause, /goal resume ou /goal clear para pausar, retomar ou remover a meta.

Resultado esperado: o Codex mantém a meta associada ao chat ativo enquanto o trabalho continua.

O objetivo da meta não pode estar vazio e pode ter no máximo 4.000 caracteres. Para instruções mais longas, coloque os detalhes em um arquivo e indique esse arquivo na meta.

Ativar ou desativar recursos experimentais com /experimental

1. Digite /experimental e pressione Enter.
2. Ative ou desative os recursos desejados (por exemplo, o proxy de rede ou o bloqueio da suspensão durante a execução). Depois, reinicie o Codex se ele solicitar.

Resultado esperado: o Codex salva suas escolhas na configuração e as aplica ao reiniciar.

Aprovar uma nova tentativa após uma negativa da revisão automática com /approve

Use /approve quando o revisor automático negar uma ação recente e você quiser que o Codex tente executá-la mais uma vez.

1. Digite /approve.
2. Confirme a nova tentativa quando o Codex mostrar a ação negada em questão.

Resultado esperado: o Codex tenta executar a ação negada mais uma vez, seguindo a política da sessão atual.

Configurar memórias com /memories

1. Digite /memories.
2. Escolha se o Codex deve usar memórias existentes, gerar novas memórias ou manter o recurso de memória desativado.

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

Usar habilidades com /skills

1. Digite /skills.
2. Escolha a habilidade que deseja aplicar com o Codex.

Resultado esperado: o Codex insere o contexto da habilidade selecionada para que a próxima solicitação siga as instruções dessa habilidade.

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

1. Digite /import.
2. Escolha Claude Code ou Cursor.
3. Selecione as configurações, os arquivos de projeto ou os chats recentes que deseja migrar.

O Codex procura até 50 chats dos últimos 30 dias. Quando está conectado a um daemon local ou a um servidor remoto, o Codex lê e importa os arquivos na máquina em que o daemon ou servidor está em execução. Aguarde a conclusão da tarefa atual antes de iniciar uma importação.

Para consultar o procedimento no aplicativo para desktop e os tipos de artefato compatíveis, veja Importar de outro agente.

Limpar o terminal e iniciar um novo chat com /clear

1. Digite /clear e pressione Enter.

Resultado esperado: o Codex limpa o terminal, redefine o histórico visível e inicia um novo chat na mesma sessão da CLI.

Para dar um nome ao novo chat ao criá-lo, execute /clear release prep.

Ao contrário de Ctrl+L, /clear inicia um novo chat.

Ctrl+L limpa apenas a visualização do terminal e mantém o chat atual. O Codex desativa as duas ações enquanto uma tarefa está em andamento.

Arquivar a sessão atual com /archive

1. Digite /archive e pressione Enter.
2. Confirme que deseja arquivar a sessão atual.

Resultado esperado: o Codex arquiva a sessão e volta à central de comandos quando está conectado a um servidor local em segundo plano ou a um servidor remoto. Sem um servidor compartilhado, o Codex encerra. O histórico é mantido. Para restaurá-lo depois, use codex unarchive <SESSION>.

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

Excluir a sessão atual com /delete

1. Digite /delete e pressione Enter.
2. Confirme que deseja excluir a sessão atual.

Resultado esperado: o Codex exclui permanentemente o histórico e as sessões descendentes que foram criadas. Quando está conectado a um servidor local em segundo plano ou a um servidor remoto, o Codex volta à central de comandos. Sem um servidor compartilhado, o Codex encerra.

/delete fica indisponível enquanto o chat está em execução ou quando você está em um chat paralelo.

Atualizar permissões com /permissions

1. Digite /permissions e pressione Enter.
2. Selecione a predefinição de aprovação adequada ao nível de controle que você deseja, por exemplo, Auto para execuções sem intervenção ou Read Only para revisar edições. Quando há perfis de permissão nomeados ativos, o seletor também mostra os perfis personalizados configurados e suas descrições.

Para selecionar um perfil pelo ID para esta sessão, use /permissions <profile-id> [--approval-policy=<policy>] [--reviewer=user|auto_review]. Por exemplo, /permissions :workspace --approval-policy=on-request --reviewer=user seleciona o acesso ao workspace e encaminha as solicitações de aprovação a você quando a configuração permite.

Incluir o contexto da IDE com /ide

1. Digite /ide.
2. Se quiser, acrescente texto na mesma linha para explicar o que o Codex deve fazer com a seleção atual da IDE ou os arquivos abertos.

Resultado esperado: o Codex inclui o contexto disponível da IDE no próximo prompt.

Ativar ou desativar o modo Vim com /vim

1. Digite /vim.
2. Continue editando no campo de mensagem.

Resultado esperado: o Codex ativa ou desativa o modo Vim no campo de mensagem da sessão atual. Para usar o modo Vim por padrão em novas sessões, defina tui.vim_mode_default = true em config.toml.

Configurar o sandbox do Windows com privilégios elevados usando /setup-default-sandbox

Esse comando só aparece no Windows quando o Codex está usando o sandbox de funcionalidade reduzida com token restrito.

1. Digite /setup-default-sandbox.
2. Siga o procedimento de configuração como administrador.

Resultado esperado: o Codex configura o sandbox do Windows com privilégios elevados e seleciona a predefinição de aprovação automática correspondente.

Copiar a resposta mais recente com /copy

No modo de histórico de rolagem, digite /copy e escolha entre copiar a última resposta concluída por inteiro, um bloco de código ou uma citação dessa resposta. No modo de tela cheia, selecione um bloco no histórico. Pressione Enter para copiar a seleção.

Depois de executar /status, use /copy para copiar o status completo ou um campo específico. Para copiar diretamente a última resposta concluída, pressione Ctrl+ O .

Ativar ou desativar o histórico de rolagem sem formatação com /raw

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

Resultado esperado: o Codex ativa ou desativa o modo de histórico de rolagem sem formatação, que facilita selecionar e copiar texto no terminal. Você também pode usar o atalho padrão Alt+R ou salvar esse modo como padrão com tui.raw_output_mode = true.

Consultar a sessão com /status

1. Em qualquer chat, digite /status.
2. Confira na saída o modelo ativo, a política de aprovação, os diretórios raiz com permissão de gravação e o uso atual de tokens. Quando a TUI está conectada remotamente, a saída também mostra o endereço remoto e a versão do servidor.

Resultado esperado: o Codex exibe um resumo para você confirmar que ele está operando no local esperado.

Consultar o uso da conta com /usage

1. Digite /usage para abrir o menu de uso.
2. Escolha entre exibir a atividade de tokens ou resgatar uma redefinição de limite que você tenha obtido e que esteja disponível.
3. Para abrir diretamente a atividade de tokens, digite /usage daily, /usage weekly ou /usage cumulative.

Resultado esperado: o Codex abre as ações de uso ou mostra a atividade de tokens da conta na visualização selecionada. Se a sessão não estiver autenticada com uma conta do serviço Codex, o Codex informará que é necessário entrar na conta.

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

1. Digite /debug-config.
2. Verifique na saída a ordem das camadas de configuração (da menor para a maior precedência), quais estão ativadas ou desativadas e as origens das políticas.

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

Use essa saída para investigar por que uma configuração em vigor difere do valor em config.toml.

Configurar itens do rodapé com /statusline

1. Digite /statusline.
2. Use o seletor para ativar, desativar e reordenar os itens. Depois, confirme.

Resultado esperado: a linha de status do rodapé é atualizada imediatamente e sua configuração é salva em tui.status_line no arquivo config.toml.

Os itens disponíveis para a linha de status incluem modelo, modelo com raciocínio, estatísticas de contexto, limites de taxa, branch do Git, contadores de tokens, ID da sessão, diretório atual ou raiz do projeto e versão do Codex.

Para configurar o rodapé apenas para esta sessão, liste os itens na ordem em que devem aparecer. Por exemplo, /statusline model project-name exibe o modelo antes do nome do projeto. Use /statusline --clear para ocultar todos os itens nesta sessão.

Configurar os itens do título do terminal com /title

1. Digite /title.
2. Use o seletor para ativar, desativar e reordenar os itens. Depois, confirme.

Resultado esperado: o título da janela ou aba do terminal é atualizado imediatamente e sua configuração é salva em tui.terminal_title no arquivo config.toml.

Os itens disponíveis para o título incluem nome do aplicativo, projeto, indicador de atividade, status, thread, branch do Git, modelo e progresso da tarefa.

Para configurar o título apenas para esta sessão, liste os itens na ordem em que devem aparecer. Por exemplo, /title project-name model exibe o nome do projeto antes do modelo. Use /title --clear para remover os itens do título nesta sessão.

Escolher um tema de sintaxe com /theme

1. Digite /theme.
2. Visualize um tema no seletor e confirme.

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

Escolher um mascote do terminal com /pets

1. Digite /pets (ou /pet) para abrir o seletor de mascotes.
2. Escolha um mascote integrado ou personalizado ou desative os mascotes.

Resultado esperado: o Codex exibe o mascote selecionado nos terminais compatíveis e salva a seleção. Você também pode digitar /pets off para ocultá-lo.

Redefinir atalhos da TUI com /keymap

Use /keymap para consultar, alterar e salvar os atalhos de teclado da TUI.

1. Digite /keymap.
2. Escolha o contexto do atalho e a ação que deseja alterar.
3. Informe a nova combinação de teclas ou remova a existente.

Resultado esperado: o Codex atualiza o mapeamento de teclas ativo e grava o atalho personalizado em tui.keymap no arquivo config.toml.

Os atalhos usam nomes como ctrl-a, shift-enter e page-down. Os atalhos específicos de um contexto têm precedência sobre tui.keymap.global. Uma lista vazia de atalhos deixa a ação sem tecla associada.

Verificar terminais em segundo plano com /ps

1. Digite /ps.
2. Confira a lista de terminais em segundo plano e seus respectivos status.

Resultado esperado: o Codex mostra o comando de cada terminal em segundo plano e até três linhas recentes não vazias da saída para que você possa conferir rapidamente o progresso.

Os terminais em segundo plano aparecem quando unified_exec está em uso. Caso contrário, a lista pode estar vazia.

Parar terminais em segundo plano com /stop

1. Digite /stop.
2. Se o Codex pedir confirmação antes de parar os terminais listados, confirme.

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

Reduzir o histórico do chat com /compact

1. Depois de uma troca longa de mensagens, digite /compact.
2. Confirme quando o Codex oferecer a opção de resumir o chat até aquele momento.

Resultado esperado: o Codex substitui os turnos anteriores por um resumo conciso, liberando espaço na janela de contexto e preservando os detalhes essenciais.

Revisar alterações com /diff

1. Digite /diff para examinar o diff do Git.
2. Percorra a saída na CLI para revisar as edições e os arquivos adicionados.

Resultado esperado: o Codex mostra as alterações já preparadas para commit, as que ainda não foram preparadas e os arquivos que o Git ainda não rastreia. Assim, você pode decidir o que manter.

Destacar arquivos com /mention

1. Digite /mention seguido de um caminho, por exemplo, /mention src/lib/api.ts.
2. Selecione o resultado correspondente no menu.

Resultado esperado: o Codex adiciona o arquivo ao chat para que os próximos turnos façam referência direta a ele.

Iniciar um novo chat com /new

1. Digite /new e pressione Enter.
2. Se o Codex oferecer opções de checkout, escolha o diretório atual ou uma nova árvore de trabalho.

Resultado esperado: o Codex inicia um novo chat na mesma sessão da CLI, permitindo que você troque de chat sem sair do terminal.

Para dar um nome ao novo chat ao criá-lo, execute /new bug bash.

Ao contrário de /clear, /new não limpa a visualização atual do terminal antes de iniciar o chat.

Renomear o chat atual com /rename

1. Digite /rename <name> ou digite /rename para abrir o campo de nome.
2. Informe um nome curto que ajude você a encontrar o chat depois.

Resultado esperado: o Codex atualiza o nome do chat salvo sem alterar seu histórico.

Retomar um chat salvo com /resume

1. Digite /resume e pressione Enter.
2. Escolha o escopo da pesquisa no seletor. Cwd mostra os chats do diretório atual. Repo, quando disponível, inclui o diretório correspondente nas árvores de trabalho locais vinculadas. All pesquisa em todos os diretórios.
3. Selecione o chat que deseja retomar.

Resultado esperado: o Codex recarrega o histórico do chat selecionado para que você possa continuar de onde parou, mantendo o histórico original intacto.

Criar um fork do chat atual com /fork

1. Digite /fork e pressione Enter.
2. Se o Codex oferecer opções de checkout, escolha o diretório atual ou uma nova árvore de trabalho.

Resultado esperado: o Codex copia o chat atual para um novo chat com um novo ID, mantendo o histórico original intacto para que você possa explorar outra abordagem em paralelo.

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

Continuar no aplicativo para desktop com /app

No macOS e no Windows, digite /app para abrir a sessão atual no aplicativo ChatGPT para desktop. Se o aplicativo não estiver instalado ou em execução, o Codex exibirá um erro pedindo que você o instale ou inicie.

Resultado esperado: o aplicativo para desktop abre o mesmo chat salvo para que você possa continuar nele.

Iniciar um chat paralelo com /side

Use /side para criar um fork temporário do chat atual sem sair do chat principal.

1. Digite /side para abrir um chat paralelo.
2. Se quiser, acrescente texto na mesma linha. Por exemplo, para verificar se há algum risco evidente neste plano, use /side Check whether this plan has an obvious risk.
3. Volte ao chat de origem quando terminar de tratar da questão paralela.

Resultado esperado: o Codex abre um chat paralelo com um histórico separado do chat de origem. Nesse modo, a TUI continua mostrando o status do chat de origem para que você veja se o chat principal ainda está em execução.

/side fica indisponível dentro de outro chat paralelo e durante o modo de revisão.

Gerar AGENTS.md com /init

1. Execute /init no diretório em que deseja que o Codex procure instruções persistentes.
2. Revise o AGENTS.md gerado e edite-o de acordo com as convenções do repositório.

Resultado esperado: o Codex cria uma estrutura inicial de AGENTS.md que você pode ajustar e incluir em um commit para usar em sessões futuras.

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

1. Digite /review.
2. Em seguida, use /diff se quiser examinar as alterações exatas nos arquivos.

Resultado esperado: o Codex resume os problemas encontrados na árvore de trabalho, com foco em mudanças de comportamento e testes que faltam. Ele usa o modelo da sessão atual, a menos que você defina review_model em config.toml.

Listar ferramentas MCP com /mcp

1. Digite /mcp.
2. Confira a lista para confirmar quais servidores e ferramentas MCP estão disponíveis.

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

Use /mcp verbose para incluir diagnósticos detalhados dos servidores. Use /mcp login <name> para se autenticar em um servidor MCP configurado a partir da sessão ativa.

Explorar aplicativos com /apps

1. Digite /apps.
2. Escolha um aplicativo na lista.

Resultado esperado: o Codex insere a menção ao aplicativo no campo de mensagem como $app-slug, e você já pode pedir ao Codex que o use.

Explorar plugins com /plugins

1. Digite /plugins.
2. Escolha uma aba de marketplace e selecione um plugin para examinar seus recursos ou as ações disponíveis.

Resultado esperado: o Codex abre o navegador de plugins para que você consulte os plugins instalados, os que a configuração permite descobrir e o estado dos que já estão instalados. Pressione Espaço sobre um plugin instalado para ativá-lo ou desativá-lo.

Consultar e gerenciar hooks de ciclo de vida com /hooks

1. Digite /hooks.
2. Escolha um evento de hook para examinar os manipuladores correspondentes.
3. Conforme necessário, marque os hooks não gerenciados como confiáveis, desative-os ou reative-os.

Resultado esperado: o Codex abre o navegador de hooks para que você examine os hooks de ciclo de vida configurados. Os hooks gerenciados aparecem identificados como tal e não podem ser desativados pelo navegador de hooks do usuário.

Gerenciar chats com /agents

1. Digite /agents e pressione Enter.
2. Selecione um chat na central de comandos para abri-lo.

Resultado esperado: o Codex mostra uma visão geral dos chats no servidor conectado. Você pode consultar o status de cada um e alternar entre eles. Para abrir a central de comandos diretamente pelo terminal, execute codex agents. A central de comandos exige um servidor compartilhado, local ou remoto.

Alternar entre threads de agentes com /subagents

1. Digite /subagents e pressione Enter.
2. Selecione a thread desejada no seletor.

Resultado esperado: o Codex troca a thread ativa para que você possa examinar ou continuar o trabalho daquele agente.

Enviar feedback com /feedback

1. Digite /feedback e pressione Enter.
2. Siga as instruções para incluir logs ou diagnósticos.

Resultado esperado: o Codex coleta os diagnósticos solicitados e os envia aos mantenedores.

Sair da conta com /logout

1. Digite /logout e pressione Enter.

Resultado esperado: o Codex limpa as credenciais locais da sessão atual do usuário.

Sair da CLI com /quit ou /exit

1. Digite /quit (ou /exit) e pressione Enter.

Resultado esperado: o Codex encerra imediatamente. Antes disso, salve ou faça commit de todo trabalho importante.

Use estes comandos para controlar o Codex pela paleta de comandos do VS Code. Você também pode associá-los a atalhos de teclado.

Atribuir um atalho de teclado

Para atribuir ou alterar um atalho de teclado 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. Pesquise por Codex ou pelo ID do comando (por exemplo, chatgpt.newChat).
4. Selecione o ícone de lápis e pressione a combinação de teclas desejada.

Comandos da extensão

Os comandos de barra permitem controlar o Codex sem sair do campo de mensagem. Use-os para consultar o status, alternar entre execução local e na nuvem ou enviar feedback.

Usar um comando de barra

1. No campo de mensagem do Codex, digite /.
2. Selecione um comando na lista ou continue digitando para filtrar as opções (por exemplo, /status).
3. Pressione Enter.

Comandos de barra disponíveis