Atalhos Rápidos e Comandos de Barra
📚 Navegação da Série: O artigo anterior 11 · Regras Locais de Projetos: Configurando o escopo do AGENTS.md ensinou a consolidar as regras locais de versionamento. Esta seção aborda os comandos de barra (
/command) e atalhos físicos de console para alternar modelos de linguagem, limpar contextos de threads e analisar logs de compilação em tempo real. No próximo artigo 13 · Engenharia de Prompts para Engenharia de Software, apresentaremos boas práticas para redação de prompts técnicos.
A quantidade de comandos de barra documentada oficialmente varia conforme a interface utilizada:
A CLI apresenta mais de 40 opções de comandos, enquanto o aplicativo desktop lista 6 e a extensão para IDE disponibiliza 8 comandos principais. Mapearemos as opções essenciais para otimizar suas sessões.
Muitos desenvolvedores encerram a sessão da CLI (Ctrl+C ou /exit) e reiniciam o binário para resetar o histórico de mensagens. O comando de barra /clear realiza esse descarte de tokens e reinicializa a thread em um único passo, sem a necessidade de recarregar as dependências locais.
Os comandos de barra funcionam como a console de controle rápido das sessões, permitindo ajustar parâmetros operacionais sem sair do chat. Consolidamos as chamadas da CLI, aplicativo desktop e extensões de IDE.
Ao terminar de ler este artigo, você terá:
- O conceito e a finalidade prática dos comandos de barra
- A tabela de comandos da CLI agrupada por etapas de uso (setup, depuração e commits)
- A relação de comandos aceitos nas interfaces desktop e extensões de IDE
- Os atalhos físicos mais importantes do console CLI (redesenho de TUI, triggers shell e buffers)
- Como personalizar teclas de atalho por meio do comando
/keymap - Um roteiro de validação para treinar comandos de barra em repositórios locais
01 O que são Comandos de Barra
Os comandos de barra atuam como comandos internos interceptados pelo binário do Codex. Eles instruem a aplicação local a gerenciar sessões, em vez de enviar o prompt de texto bruto para o processamento do LLM.
Analogia: ramais telefônicos de atendimento. Ao contatar uma empresa para resolver pendências administrativas, você não explica todo o caso para a recepção; você digita o ramal direto (Faturamento = 8101, TI = 8102). Cada código aciona um setor pré-determinado sem desvios de interpretação. Os comandos de barra operam como esses ramais de automação: /model altera a IA, /status exibe as estatísticas e /diff abre os arquivos alterados.
Nota técnica: O caractere / deve ser inserido obrigatoriamente no início da linha do prompt. Digitar a barra no meio do texto envia o caractere como texto comum. Digitar / na linha limpa exibe a listagem interativa de comandos da interface.
Ações operacionais comuns mapeadas para comandos de barra:
- Upgrade de processamento: Digite
/modelpara alternar a engine no meio da conversa, preservando o histórico da thread. - Checagem de parâmetros: Digite
/statuspara verificar limites de sandbox, cotas de tokens e caminhos ativos. - Reset de sessão: Digite
/clearna CLI para apagar o histórico de chamadas e abrir novo contexto.
A CLI mantém o conjunto mais completo de utilitários técnicos e lógicas de depuração. O aplicativo desktop e as extensões para IDE delegam essas interações para botões, seletores de layout e menus gráficos, mantendo a lista de comandos simplificada.
💡 Resumo em uma frase: Os comandos de barra controlam a sessão da thread de forma direta. Digite
/no início da linha para acessar a listagem disponível em sua interface.
02 Guia de Referência de Comandos da CLI
Agrupamos as chamadas da CLI com base no fluxo de desenvolvimento (setup, depuração, auditoria e commits) para facilitar a consulta:
Grupo 1: Setup e Configurações Globais
| Comando de barra | Finalidade técnica | Aplicação prática |
|---|---|---|
/init | Inicializa o arquivo AGENTS.md no diretório | Criação de diretrizes locais (ver Artigo 11) |
/permissions | Altera as regras de sandbox ativas | Alternância entre permissões Auto, Read Only e Full Access |
/mcp | Lista os servidores MCP conectados | Depuração de ferramentas e dependências externas |
/skills | Lista e seleciona Skills locais carregadas | Carregamento de fluxos específicos de linguagens |
/status | Exibe as estatísticas técnicas da sessão | Mapeamento de tokens, modelo de rede e limites locais |
Grupo 2: Controle de Contexto da Thread
| Comando de barra | Finalidade técnica | Aplicação prática |
|---|---|---|
/model | Altera a engine de processamento ativa | Ajuste de chaves de API e reasoning effort |
/compact | Compacta o histórico para liberar tokens de contexto | Reduz a verbosidade de threads longas |
/clear | Limpa a TUI e reinicializa a thread | Descarte de logs de histórico de chat anteriores |
/new | Inicializa nova thread mantendo o histórico na TUI | Reabre novo escopo mantendo a visualização física das respostas |
/plan | Ativa o modo de planejamento da escrita | Força a IA a detalhar o roteiro antes de editar os arquivos |
Diferenças cruciais de controle de histórico:
/clearversus/new: O comando/newinicializa um novo contexto de chamada sem limpar os outputs anteriores da tela do terminal. Use/clearpara resetar o terminal físico por completo./clearversus/compact: O comando/compactcondensa o histórico de mensagens da thread ativa em um resumo compacto para liberar buffer na janela de contexto de tokens, enquanto o/clearapaga todas as referências anteriores.
Grupo 3: Auditoria de Alterações e Commits
| Comando de barra | Finalidade técnica |
|---|---|
/diff | Exibe o diff completo contendo alterações (inclui arquivos não rastreados pelo Git) |
/review | Aciona o agente secundário para realizar auditoria de bugs nas modificações físicas |
/copy | Copia o último bloco de código ou resposta gerada pela IA (atalho: Ctrl+O) |
O utilitário /diff exibe logs estruturados de modificações, abrangendo arquivos untracked (não adicionados no Git). O repositório local deve estar inicializado com Git para que a auditoria visual seja executada.
Grupo 4: Utilidades Gerais e Controle da CLI
| Comando de barra | Finalidade técnica |
|---|---|
/keymap | Abre o painel interativo de mapeamento de atalhos de teclado |
/statusline | Permite selecionar e reordenar as métricas exibidas na barra de status |
/theme | Altera o esquema de realce de cores e sintaxe da CLI |
/resume | Carrega e retoma threads e históricos salvos anteriormente |
/side | Abre uma sessão lateral ("side-chat") para testar trechos sem contaminar a thread principal |
/fork | Cria uma cópia paralela do contexto atual em uma thread independente |
/quit (ou /exit) | Encerra a CLI do Codex e retorna ao console tradicional |
O Codex aceita o enfileiramento de comandos. Digite novas chamadas e pressione Tab enquanto a IA executa gravações; o comando será rodado após o encerramento do processo ativo.
💡 Resumo em uma frase: Organize a consulta por blocos de tarefas. Memorize a distinção entre
/clear(limpeza física),/new(nova thread na mesma tela) e/compact(resumo do buffer).
03 Comandos nas Interfaces Desktop e IDEs
Para preservar a consistência visual, o aplicativo desktop e as extensões da IDE implementam atalhos visuais, mantendo listas reduzidas de comandos:
Comandos no Aplicativo Desktop:
| Comando de barra | Finalidade técnica |
|---|---|
/status | Exibe o identificador da thread, limite de tokens e cota |
/review | Executa o review de alterações comparando com a branch base |
/plan | Habilita o modo de planejamento estruturado (planejar antes de reescrever) |
/goal | Declara metas lógicas de longo prazo para guiar o agente |
/mcp | Exibe o status de ferramentas de servidores MCP locais conectados |
/feedback | Abre o canal de suporte técnico para envio de logs |
O aplicativo desktop depende de atalhos de teclado de controle global (como Cmd+N para novas threads e Cmd+J para consoles), dissociando o controle do chat del gerenciamento da TUI.
Comandos nas Extensões de IDE (VS Code, Cursor):
| Comando de barra | Finalidade técnica |
|---|---|
/status | Exibe as estatísticas de tokens da thread e limitações de APIs |
/review | Inicializa rotinas de auditoria de alterações na janela ativa do editor |
/goal | Adiciona metas persistentes de desenvolvimento na sessão de chat |
/auto-context | Ativa ou desativa a inclusão automática de arquivos abertos recentemente no contexto |
/local | Configura o pipeline de escrita para o repositório local |
/cloud | Delega a compilação e a execução do sandbox para servidores na nuvem (Cloud) |
/cloud-environment | Permite gerenciar as sandboxes virtuais ativas na nuvem |
/feedback | Registra sugestões e envia logs da IDE |
Nas IDEs, os comandos /local e /cloud alternam de forma transparente a execução física das sandboxes de escrita de arquivos.
💡 Resumo em uma frase: Os ambientes gráficos limitam os comandos de barra ao escopo operacional (
/status,/review,/cloud,/local). Verifique a lista ativa digitando/no chat.
04 Ações no Painel de Comandos da IDE
Ações no editor (editor-level) são executadas pela paleta de comandos do VS Code, permitindo vincular escopos e trechos selecionados de arquivos:
| Nome do comando no painel | ID do Comando (para atalhos) | Finalidade técnica |
|---|---|---|
| Codex: New Thread | chatgpt.newChat | Abre uma nova sessão na IDE |
| Codex: Add Selection to Thread | chatgpt.addToThread | Copia o código selecionado para a thread ativa |
| Codex: Add File to Thread | chatgpt.addFileToThread | Copia todo o arquivo aberto para o contexto do chat |
| Codex: Implement TODO | chatgpt.implementTodo | Resolve comentários TODO marcados no código |
| Codex: Create Chat Panel | chatgpt.newCodexPanel | Abre uma nova janela de chat no editor principal |
| Codex: Focus on Sidebar | chatgpt.openSidebar | Abre e foca o painel lateral do Codex |
Como associar teclas de atalho a estes comandos no VS Code:
- Abra a paleta de comandos (
Cmd+Shift+Pno macOS). - Busque e selecione Preferences: Open Keyboard Shortcuts.
- Digite
Codexou insira o ID técnico do comando desejado (ex:chatgpt.addToThread). - Clique no ícone de lápis e associe a combinação de teclas de sua preferência.
Mapear a chamada chatgpt.addToThread permite enviar trechos selecionados para o chat lateral instantaneamente, dispensando o fluxo manual de copiar e colar.
💡 Resumo em uma frase: Diferencie os comandos do chat (comandos de barra) das ações del editor (paleta de comandos). Mapeie atalhos personalizados para agilizar o fluxo.
05 Atalhos Físicos de Console na CLI
Atalhos físicos de console mapeados na CLI do Codex para controle veloz da TUI:
| Tecla de console | Finalidade e Ação do sistema | Equivalente (Comando de barra) |
|---|---|---|
Ctrl+L | Redesenha a TUI (preserva o histórico de chat e limpa falhas de renderização) | Não possui |
Ctrl+O | Copia a última resposta textual gerada pela IA | /copy |
Tab (em execução) | Enfileira a instrução digitada no prompt para o próximo turno | Não possui |
Ctrl+G | Abre o editor de sistema ($EDITOR) para escrita de prompts estruturados | Não possui |
Alt+R | Alterna a exibição em formato raw para simplificar cópias no terminal | /raw |
Comando precedido por ! | Executa instruções locais diretamente no shell local | Não possui |
Particularidades dos atalhos:
Ctrl+Lversus/clear: O atalhoCtrl+Lapenas limpa a visualização estática do terminal físico caso ocorram falhas de buffer em conexões SSH. O histórico da thread ativa permanece carregado. O comando/cleardescarta o histórico e inicia uma thread do zero. Ambos são bloqueados enquanto tarefas ativas estão rodando.- Chamadas Shell (
!): Digitar o caractere!no início da linha envia o comando direto para o terminal físico. O Codex registra os logs de saída como contexto da conversa, permitindo que a IA use os resultados do console em prompts futuros.
!git status- Limitações do
Ctrl+O: O atalho apenas copia blocos de respostas que foram inteiramente geradas pela IA, ficando indisponível durante o processamento ativo ou logo após ações de rollback na thread.
想改键？用 /keymap，但新手先别急
É possível customizar os mapeamentos de teclado da CLI executando o comando /keymap na console interativa. As edições alteram o bloco tui.keymap no arquivo config.toml.
Recomenda-se utilizar os mapeamentos padrão do sistema no início do uso do Codex para evitar conflitos com outros utilitários locais.
💡 Resumo em uma frase: Use
Ctrl+Lpara limpar o console mantendo a thread e use!para comandos shell rápidos. Personalize atalhos via comando/keymapquando necessário.
06 Prática: Validando Comandos de Barra
Siga o roteiro a seguir para testar as particularidades dos comandos de barra no console de desenvolvimento local:
Passo 1: Crie a pasta temporária e inicialize
mkdir -p ~/codex-slash-demo && cd ~/codex-slash-demo && git init
codexSaída esperada: Abertura do console TUI interativo com foco no prompt de comandos.
Passo 2: Acesse a lista de comandos
Digite apenas o caractere / no prompt:
/Saída esperada: O console abrirá um menu dropdown exibindo todas as opções ativas do binário local. Digite /st para filtrar as opções.
Passo 3: Verifique as estatísticas de tokens
/statusSaída esperada: A TUI exibirá os caminhos autorizados no sandbox, modelo de rede ativo e cotas.
Passo 4: Teste atalhos de redesenho e shell
Rode um comando shell rápido e limpe o console:
!lsSaída esperada: O console listará a pasta ativa e incorporará o log no chat. Pressionar Ctrl+L redesenhará o terminal mantendo o histórico de mensagens.
Passo 5: Execute refatorações e verifique o diff
Envie o comando de escrita:
新建一个文件 hi.txt，里面写一行 hello from codexConfirme a gravação do arquivo no sandbox e rode:
/diffSaída esperada: A CLI exibirá as modificações do arquivo hi.txt em formato diff estruturado. Encerre o processo:
/exitSaída esperada: Fechamento do Codex e retorno ao shell tradicional.
Para validar as variações de comandos nos ambientes gráficos, abra a extensão do VS Code ou o aplicativo desktop e digite / no chat. Você verá uma lista menor de comandos, contendo /cloud ou /goal específicos de cada interface.
💡 Resumo em uma frase: Teste os atalhos físicos e comandos de barra locally para fixar as diferenças e conciliar o uso de consoles de auditoria.
07 Resumo
Os comandos de barra e atalhos físicos consolidam a navegação por teclado e o controle das threads no Codex.
Tópicos essenciais revisados:
| Diretriz de uso | Funcionamento e Especificação |
|---|---|
| Conceito básico | Comandos de controle gerenciados internamente, sem processamento de IA |
| Escopo da CLI | Listagem de mais de 40 opções divididas entre configurações, controle de contexto e commits |
| Sincronização | O comando de barra /clear limpa o histórico da thread, e /compact condensa o histórico |
| Interfaces Gráficas | Listas simplificadas de comandos nas extensões de IDE (/cloud, /local) e no app desktop (/goal) |
| Ações do Editor | Comandos da paleta do VS Code (chatgpt.addToThread) atuam diretamente nos blocos do editor |
| Atalhos de Console | Use Ctrl+L para limpar o vídeo, ! para comandos shell locais e /keymap para remapear teclas |
Com essas lógicas fixadas, você está apto a controlar threads por atalhos físicos, alternar a compilação local/nuvem via comandos de barra e otimizar a TUI da CLI do Codex.
O próximo artigo 13 · Engenharia de Prompts para Engenharia de Software abordará boas práticas de escrita de prompts técnicos. Discutiremos padrões para especificação de tarefas complexas, delimitação de contextos e prevenção de refatorações incorretas.