Codex: O guia definitivo e descomplicado para começar

Este tutorial é para iniciantes e para quem tem conhecimento parcial. É um guia passo a passo com muitas ilustrações, contando tudo que você precisa para colocar o Codex em funcionamento rapidamente! O Codex é um agente de IA para tarefas de programação e computador. Simplificando, ele não apenas "responde perguntas sobre código"; ele pode ler arquivos em um projeto, modificar código, executar comandos, corrigir bugs, escrever testes, realizar revisões de código e até ajudar você a concluir tarefas repetitivas em diferentes ferramentas. A OpenAI o descreve oficialmente como um "agente de IA que pode receber tarefas reais". Sem mais delongas, vamos ver como usá-lo: # Conversa !Imagem ## Criar Novo Projeto/Abrir Projeto Existente Nesta parte da barra lateral (conforme mostrado), há um ícone de pasta. Clicar nele revela duas opções: !Imagem - Criar Novo Projeto em Branco Isso cria um Novo Projeto no caminho padrão do Codex. Geralmente, não recomendamos esta abordagem. - Usar Pasta Existente Recomendamos esta opção. Você não só pode abrir projetos existentes, mas, por exemplo, se quiser que o Codex acesse seus projetos relacionados a PPT, basta abrir sua pasta de PPT aqui. Além disso, se quiser iniciar um novo trabalho em um projeto em branco, é recomendável criar uma pasta no explorador de arquivos do seu sistema primeiro e depois abri-la com o Codex. Isso evita complicações como não conseguir encontrar seu projeto. ## Modelo e Velocidade Após entrar em um projeto, você pode selecionar o modelo, o nível de raciocínio e a velocidade na barra de chat (conforme mostrado): !Imagem Todos entendem os modelos, então não vou me alongar. O nível de raciocínio refere-se a quanto de capacidade de raciocínio/planejamento o Codex está disposto a gastar ao concluir uma tarefa. A velocidade refere-se à velocidade de geração (Alta Velocidade atualmente consome 1,5x). Recomendo usar GPT-5.5 + Ultra Alto + Velocidade Padrão para qualquer tarefa. Esta combinação é a mais estável, e o consumo é aceitável. Você pode, certamente, executar tarefas simples em um nível mais baixo com base no cenário, mas o ato de "julgar qual nível usar" consome sua energia, e a instabilidade de níveis mais baixos pode levar a retrabalho. Portanto, acredito que manter a combinação GPT-5.5 + Ultra Alto + Velocidade Padrão inalterada é o melhor. ## Permissões Clique aqui na barra de chat (conforme mostrado) para controlar os limites de permissão do Codex: !Imagem Estes três são os Modos de Permissão/Aprovação do Codex. As principais diferenças são: se ele pode modificar arquivos automaticamente, se pode executar comandos automaticamente e quando precisa perguntar a você. As permissões padrão são conservadoras. O Codex precisa confirmar com você antes de operações importantes, como modificar arquivos ou executar certos comandos. É seguro, mas aparecerão confirmações com frequência. A Revisão Automática é o meio-termo. Quando o Codex encontra uma operação que requer confirmação, a "Revisão Automática" primeiro julga se é segura; as seguras são permitidas automaticamente, enquanto as incertas/perigosas perguntarão a você. É mais conveniente que o Padrão, mas o julgamento automático não é absolutamente confiável. O Acesso Total é o mais aberto. Ele tenta não bloquear o Codex, permitindo que ele leia, escreva e execute comandos mais livremente, potencialmente envolvendo uma gama mais ampla de operações. Meu conselho: - Começando com o Codex: Escolha "Revisão Automática" - Lidando com projetos importantes/código da empresa: Escolha "Padrão" ou "Revisão Automática" - Use "Acesso Total" apenas em demonstrações temporárias, repositórios de teste ou projetos que podem ser restaurados a qualquer momento - Não ative o Acesso Total em diretórios que contenham chaves, arquivos privados ou configurações de ambiente de produção ## Modo Plano !Imagem O Modo Plano permite que o Codex pense em uma solução antes de modificar o código. Quando ativado, ele geralmente faz o seguinte primeiro: 1. Lê o contexto do projeto: Examina os arquivos no espaço de trabalho, a estrutura do projeto e o código relevante. 2. Entende seu objetivo: Confirma o que você realmente deseja alcançar. 3. Propõe um plano de execução: Diz a você quais arquivos planeja alterar, as etapas envolvidas e os riscos potenciais. 4. Faz perguntas, se necessário: Se os requisitos não estiverem claros ou se afetar bancos de dados/interfaces/dependências, ele confirmará primeiro. 5. Implementa após o plano estar claro: Evita alterações confusas desde o início. Quando é adequado? - Modificar vários arquivos - Adicionar novos recursos - Refatorar um projeto - A causa de um bug não é óbvia - Você não tem certeza de como proceder - O projeto é importante e você não quer que ele faça alterações aleatórias Simplificando: faça coisas pequenas diretamente, use o Modo Plano para coisas grandes. ## Revisão !Imagem Isso mostra as alterações e saídas de cada conversa, permitindo que você revise ou desfaça diretamente. Normalmente, você não precisa se preocupar com isso, a menos que haja algo específico para revisar; se houver um problema, basta pedir ao Codex para alterá-lo. !Imagem Isso mostra algumas informações do ambiente. É recomendável configurar a CLI do GitHub localmente. Desenvolvedores também podem configurar CLIs para Railway/Vercel, Sentry, etc. Isso proporcionará uma experiência muito mais suave. ## Algumas Dicas !Imagem Você pode fixar suas janelas de conversa usadas com frequência ou inacabadas aqui para acesso rápido na próxima vez. !Imagem A entrada de voz é muito conveniente aqui. Metade dos meus prompts agora são ditados. !Imagem Você pode abrir a barra lateral ou a janela inferior aqui para acessar arquivos, o terminal ou sites. Podemos deixá-lo modificar o código enquanto abrimos um navegador aqui para ver os resultados. Ou abrir um livro de referência de prompts para seguir passo a passo. Você pode até colocar um PPT ou assistir a um filme enquanto trabalha. !Imagem Você pode abrir a pasta do projeto aqui, facilitando muito a localização de coisas. # Habilidades e Plugins Plugins = Instalar capacidades. Habilidades = Maneiras específicas de usar essas capacidades. ## Plugins !Imagem Clique no local mostrado para abrir plugins. Explicar isso em detalhes é complexo, então basta saber que os Plugins são como pacotes de instalação/extensão. Uma vez instalados, o Codex ganha certas habilidades, como Chrome, Planilhas, Apresentações, Slack, etc. Recomendados: Chrome, Apresentações, Planilha, Documentos. Escolha outros com base nas suas necessidades de desenvolvimento. Selecione-os explicitamente aqui ao usá-los: !Imagem ## Habilidades Habilidades são fluxos de trabalho específicos ou manuais de instrução configurados dentro de plugins ou localmente. Elas dizem ao Codex quais passos seguir, quais scripts usar e quais modelos consultar ao encontrar certas tarefas. Podemos obtê-las do GitHub, instalá-las das recomendações do Codex ou criar nossas próprias habilidades. No GitHub, você geralmente pode fazer isso: (Cole o link do GitHub), me ajude a puxar essa habilidade e registrá-la como uma habilidade global. Para fazer sua própria habilidade, use esta entrada (conforme mostrado). Após clicar em criar, ele lhe dará um prompt onde você pode adicionar seus requisitos. !Imagem Existem várias maneiras de usar as habilidades. A primeira é o acionamento implícito com base nas configurações da habilidade — se sua habilidade diz para usá-la na situação XX, e essa situação ocorre, o Codex dirá: "OK, hora de usar a habilidade XX." Há também o uso explícito. Após digitar "$" na caixa de entrada: !Imagem Sua lista de habilidades aparecerá. Encontre e clique ou digite as primeiras letras para corresponder, dizendo ao Codex: "Quero usar esta habilidade agora!" Quero enfatizar esta habilidade: image gen!! Ela integra perfeitamente as capacidades do gpt-image-2 no Codex. Isso significa que podemos deixar o Codex olhar para especificações de design locais ou conteúdo, planejar um prompt e gerar imagens diretamente dentro do Codex. Ele também pode ajudá-lo a usar as imagens imediatamente, como colocá-las no código ou inseri-las em um artigo, reduzindo muito o atrito! ## Conclusão O Codex tem muitos outros recursos como automação e árvores de trabalho, nos quais não vou me aprofundar aqui. Espero que todos os explorem! Espero também que este artigo ajude você!!