Codex: O Guia Definitivo e Sem Complicações para Começar

Este tutorial é para iniciantes e para quem tem conhecimento parcial. É um guia detalhado com muitas ilustrações, que te diz tudo o que precisas para ter o Codex a funcionar rapidamente!\n\nO Codex é um agente de IA para tarefas de programação e computador. Simplificando, ele não se limita a "responder a perguntas sobre código"; ele consegue ler ficheiros num projeto, modificar código, executar comandos, corrigir erros, escrever testes, fazer revisões de código e até ajudar-te a concluir tarefas repetitivas em diferentes ferramentas. A OpenAI descreve-o oficialmente como um "agente de IA que pode receber tarefas reais".\n\nSem mais demoras, vamos ver como usá-lo:\n\n# Conversa\n\n!Imagem\n\n## Criar Novo Projeto/Abrir Projeto Existente\n\nNesta parte da barra lateral (como mostrado), há um ícone parecido com uma pasta. Clicar nele revela duas opções:\n\n!Imagem\n\n- Criar Novo Projeto em Branco\n\nIsto cria um Novo Projeto no caminho predefinido do Codex. Geralmente, não recomendamos esta abordagem.\n\n- Usar Pasta Existente\n\nRecomendamos esta. Não só podes abrir projetos existentes, mas, por exemplo, se quiseres que o Codex aceda aos teus projetos relacionados com PowerPoint, podes simplesmente abrir a tua pasta de PowerPoint aqui. Além disso, se quiseres começar um novo trabalho num projeto em branco, é recomendável criar uma pasta no explorador de ficheiros do teu sistema primeiro e depois abri-la com o Codex. Isto evita complicações como não conseguires encontrar o teu projeto.\n\n## Modelo e Velocidade\n\nDepois de entrar num projeto, podes selecionar o modelo, o nível de raciocínio e a velocidade na barra de chat (como mostrado):\n\n!Imagem\n\nTodos devem perceber os modelos, por isso não vou alongar-me.\n\nO nível de raciocínio refere-se à quantidade de capacidade de raciocínio/planeamento que o Codex está disposto a gastar ao concluir uma tarefa.\n\nA velocidade refere-se à velocidade de geração (a Velocidade Alta consome atualmente 1,5x).\n\nRecomendo usar GPT-5.5 + Ultra High + Velocidade Predefinida para qualquer tarefa.\n\nEsta combinação é a mais estável e o consumo é aceitável. Podes certamente executar tarefas simples a um nível mais baixo dependendo do cenário, mas o ato de "decidir qual o nível a usar" consome a tua energia, e a instabilidade dos níveis mais baixos pode levar a retrabalho. Portanto, acredito que manter a combinação GPT-5.5 + Ultra High + Velocidade Predefinida inalterada é o melhor.\n\n## Permissões\n\nClica aqui na barra de chat (como mostrado) para controlar os limites de permissão do Codex:\n\n!Imagem\n\nEstes três são os Modos de Permissão/Aprovação do Codex. As principais diferenças são: se pode modificar ficheiros automaticamente, se pode executar comandos automaticamente e quando precisa de te perguntar.\n\nAs permissões predefinidas são conservadoras. O Codex precisa de confirmar contigo antes de operações importantes, como modificar ficheiros ou executar certos comandos. É seguro, mas irá mostrar pop-ups de confirmação com frequência.\n\nA Revisão Automática é o meio-termo. Quando o Codex encontra uma operação que requer confirmação, a "Revisão Automática" primeiro avalia se é segura; as seguras são automaticamente permitidas, enquanto as incertas/perigosas perguntam-te. É mais conveniente do que o Modo Predefinido, mas a avaliação automática não é absolutamente fiável.\n\nO Acesso Total é o mais aberto. Tenta não bloquear o Codex, permitindo-lhe ler, escrever e executar comandos mais livremente, podendo envolver uma gama mais ampla de operações.\n\nO meu conselho:\n- A começar com o Codex: Escolhe "Revisão Automática"\n- A lidar com projetos importantes/código da empresa: Escolhe "Predefinido" ou "Revisão Automática"\n- Usa "Acesso Total" apenas em demonstrações temporárias, repositórios de teste ou projetos que possam ser restaurados a qualquer momento\n- Não atives o Acesso Total em diretórios que contenham chaves, ficheiros privados ou configurações de ambiente de produção\n\n## Modo Plano\n\n!Imagem\n\nO Modo Plano permite que o Codex pense numa solução antes de modificar o código.\n\nQuando ativado, geralmente faz o seguinte primeiro:\n1. Lê o contexto do projeto: Examina ficheiros no espaço de trabalho, estrutura do projeto e código relevante.\n2. Compreende o teu objetivo: Confirma o que realmente queres alcançar.\n3. Propõe um plano de execução: Diz-te quais ficheiros planeia mudar, os passos envolvidos e os riscos potenciais.\n4. Faz perguntas se necessário: Se os requisitos não forem claros ou se afetar bases de dados/interfaces/dependências, confirma primeiro.\n5. Implementa após o plano estar claro: Evita alterações confusas desde o início.\n\nQuando é adequado?\n- Modificar vários ficheiros\n- Adicionar novas funcionalidades\n- Refatorar um projeto\n- A causa de um erro não é óbvia\n- Não tens a certeza de como proceder\n- O projeto é importante e não queres que ele faça alterações aleatórias\n\nSimplificando: faz as coisas pequenas diretamente, usa o Modo Plano para as grandes.\n\n## Revisão\n\n!Imagem\n\nIsto mostra as alterações e saídas de cada conversa, permitindo-te revisá-las ou desfazê-las diretamente.\n\nNormalmente, não precisas de te preocupar com isto a menos que haja algo específico para rever; se houver um problema, pede simplesmente ao Codex para o alterar.\n\n!Imagem\n\nIsto mostra algumas informações do ambiente. É recomendável configurar a CLI do GitHub localmente. Os programadores também podem configurar CLIs para Railway/Vercel, Sentry, etc.\n\nIsto dar-te-á uma experiência muito mais suave.\n\n## Algumas Dicas\n\n!Imagem\n\nPodes fixar as tuas janelas de conversa mais usadas ou incompletas aqui para acesso rápido na próxima vez.\n\n!Imagem\n\nA entrada de voz é muito conveniente aqui. Metade dos meus prompts são agora ditados.\n\n!Imagem\n\nPodes abrir a barra lateral ou a janela inferior aqui para aceder a ficheiros, terminal ou sites.\n\nPodemos deixá-lo modificar 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. Podes até colocar uma apresentação ou ver um filme enquanto trabalhas.\n\n!Imagem\n\nPodes abrir a pasta do projeto aqui, tornando muito fácil encontrar coisas.\n\n# Competências e Plugins\n\nPlugins = Instalar capacidades.\nCompetências = Formas específicas de usar essas capacidades.\n\n## Plugins\n\n!Imagem\n\nClica no local mostrado para abrir plugins. Explicar isto em detalhe é complexo, por isso apenas sabe que os Plugins são como pacotes de instalação/extensão. Uma vez instalados, o Codex ganha certas capacidades, como Chrome, Folhas de Cálculo, Apresentações, Slack, etc.\n\nRecomendados: Chrome, Apresentações, Folha de Cálculo, Documentos.\n\nEscolhe outros com base nas tuas necessidades de desenvolvimento.\n\nSeleciona-os explicitamente aqui quando os usares:\n\n!Imagem\n\n## Competências\n\nAs Competências são fluxos de trabalho específicos ou manuais de instrução configurados dentro de plugins ou localmente. Elas dizem ao Codex que passos tomar, que scripts usar e que modelos consultar ao encontrar certas tarefas.\n\nPodemos obtê-las do GitHub, instalá-las a partir de recomendações do Codex ou criar as nossas próprias competências.\n\nNo GitHub, normalmente podes fazer isto: (Cola o link do GitHub), ajuda-me a puxar esta competência e a registá-la como uma competência global.\n\nPara fazeres a tua própria competência, usa esta entrada (como mostrado). Depois de clicares em criar, ele dar-te-á um prompt onde podes adicionar os teus requisitos.\n\n!Imagem\n\nExistem várias maneiras de usar competências. A primeira é o acionamento implícito baseado nas definições da competência – se a tua competência disser para a usar na situação XX, e essa situação ocorrer, o Codex dirá: "OK, está na hora de usar a competência XX."\n\nTambém existe o uso explícito. Depois de escrever "$" na caixa de entrada:\n\n!Imagem\n\nA tua lista de competências aparecerá. Encontra e clica ou escreve as primeiras letras para corresponder, dizendo ao Codex: "Quero usar esta competência agora!"\n\nQuero enfatizar esta competência: geração de imagem!!\n\nEla integra perfeitamente as capacidades gpt-image-2 no Codex. Isto significa que podemos deixar o Codex olhar para especificações de design locais ou conteúdo, planear um prompt e gerar imagens diretamente dentro do Codex.\n\nTambém pode ajudar-te a usar as imagens imediatamente, como colocá-las em código ou inseri-las num artigo, reduzindo muito o atrito!\n\n## Conclusão\n\nO Codex tem muitas outras funcionalidades como automação e árvores de trabalho, que não vou abordar aqui. Espero que todos explorem!\n\nEspero também que este artigo te ajude!!