O Codex da OpenAI, uma inteligência de programação baseada na nuvem para engenheiros de software, está a mudar o fluxo de trabalho diário dos programadores. Este tutorial irá ajudá-lo a configurar, usar e dominar os recursos do Codex para tornar seu desenvolvimento mais eficiente.

Guia de configuração rápida

Para começar a utilizar o Codex, é necessário concluir uma série de autorizações de conta e configurações de ambiente. Segue-se o processo de configuração pormenorizado:

Privilégios e pré-requisitos da conta

Atualmente (maio de 2025), o Codex só está disponível para os seguintes utilizadores:

• Utilizadores do ChatGPT Pro ($200 por mês)
• Utilizadores do ChatGPT Enterprise
• Utilizadores da equipa ChatGPT

Nota: Espera-se que os utilizadores do ChatGPT Plus e do Edu tenham acesso a esta funcionalidade em breve.

Passos de configuração em detalhe

• Aceder à entrada do códice
  • Iniciar sessão na sua conta ChatGPT
  • Localizar a opção Codex na barra lateral
  • Se clicar nesta opção, será encaminhado para a página separada da candidatura ao Codex.

• Ativar a autenticação multi-fator (MFA)
  • O Codex exige que a sua conta esteja activada para MFA.
  • Pode utilizar qualquer aplicação de autenticação, como o Google Authenticator, OnePass, etc.
  • Esta é uma medida de segurança porque o Codex terá acesso aos seus repositórios do GitHub!

• Associação da conta GitHub
  • Conceder acesso ao Codex à sua conta GitHub
  • Selecionar direitos de acesso organizacionais (se aplicável à sua situação)
  • Definição da gama de direitos de acesso (acesso só de leitura ou de leitura-escrita)
  • Nota: O Codex poderá criar PRs se lhe conceder permissões de leitura e escrita.

• Definições de utilização de dados
  • Durante o processo de configuração, haverá uma opção de autorização de dados
  • Por predefinição, o Codex utilizará o seu código para a formação
  • Se não quiser que o seu código seja utilizado para formação, tem de desmarcar manualmente a caixa

Depois de ter concluído os passos acima, está pronto para começar a selecionar repositórios de código e a utilizar o Codex. Todo o processo de configuração foi concebido para ser muito intuitivo e fácil de concluir, mesmo para programadores principiantes.

Interface e funcionamento básico

Depois de ter configurado o seu Codex com sucesso, ser-lhe-á apresentada uma interface de utilizador intuitiva, por isso vamos aprender a fazer o básico.

Vista geral da interface principal

A interface principal do Codex contém os seguintes elementos-chave

• Seletor de repositório: alternar entre diferentes repositórios do GitHub
• Lista de tarefas: apresenta as tarefas actuais e históricas
• Seletor de tipo de tarefa: para selecionar o modo Perguntar ou Código
• Caixa de introdução de tarefas: introduzir uma descrição da tarefa que pretende executar

Dois modelos de missão principais

O Codex oferece dois modos de funcionamento diferentes, cada um deles adequado a diferentes cenários:

1. Modo de pergunta
   • Para consultar e compreender a base de código
   • Nenhum código será alterado
   • Ideal para compreender a estrutura de um projeto, procurar explicações ou explorar a base de código
   • Exemplo: perguntar sobre o total de linhas de código do projeto, análise da estrutura do código, etc.
2. Modo de código
   • Para executar tarefas reais de modificação de código
   • O código será modificado e as alterações serão geradas num ambiente de nuvem
   • É bom para corrigir erros, acrescentar funcionalidades, refactorizar código, etc.
   • Permite a criação de Pull Requests para submeter alterações

Criar e gerir tarefas

Para criar uma nova tarefa, os passos são os seguintes:

1. Selecionar o tipo de tarefa (Perguntar ou Codificar)
2. Descreva a sua tarefa na caixa de entrada
3. Para os utilizadores de primeira viagem, pode clicar diretamente nas tarefas de amostra predefinidas
4. Clique no botão "Iniciar tarefa" para submeter a tarefa.

Após a submissão, o Codex começará a processar a sua tarefa e apresentará o progresso em tempo real. Cada tarefa é gerida numa página separada e pode executar várias tarefas em paralelo.

Ver resultados da tarefa

Após a conclusão da tarefa, verá os resultados detalhados da execução:

• Para o modo Perguntar: obter respostas detalhadas a perguntas
• Para o modo Código: ver as alterações ao código, a saída do terminal e os resultados dos testes

Para as tarefas de código, ainda é possível:

• Criar um PR do GitHub: fazer o commit de alterações no repositório como um PR
• Pedido de alterações adicionais: feedback para que o Codex adapte a sua solução
• Ver registos de execução pormenorizados e cadeia de provas

Processo completo de apresentação e execução de tarefas

Vamos analisar um exemplo real de como utilizar o Codex para uma tarefa simples de correção de código.

Escolher o armazém certo

Primeiro, escolha um repositório GitHub com o qual esteja familiarizado na interface principal do Codex. Idealmente, escolha:

• Projectos bem documentados
• Itens incluídos no teste
• Estrutura de dependência simples

Isto facilita a compreensão e a execução de tarefas pelo Codex.

Apresentar uma tarefa de código

1. Seleção do modo "Código
2. Introduzi-lo na descrição da tarefa: Explicar a base de código aos novatos. Qual é a estrutura geral, quais são as coisas importantes a saber e quais são os próximos pontos-chave a aprender.
3. Clique no botão "Iniciar tarefa".

Acompanhamento do progresso das tarefas

Depois de submeter uma tarefa, pode ver o Codex a trabalhar em tempo real:

• O Codex analisa primeiro a estrutura da base de código
• Em seguida, procurar ficheiros no diretório especificado
• Verificação de problemas ortográficos e gramaticais no código
• Aplicar correcções e executar testes para verificar

Todo o processo pode demorar vários minutos, dependendo do tamanho e da complexidade da base de código.

Analisar os resultados e criar relações públicas

Quando a tarefa estiver concluída, verás os resultados do trabalho do Codex:

• Que documentos foram alterados
• O que foi exatamente corrigido
• Teste aprovado

Se estiver satisfeito com os resultados, pode clicar no botão "Create PR" (Criar PR) e o Codex criará automaticamente um Pull Request com as alterações e, em seguida, pode voltar ao GitHub e seguir o processo habitual de revisão e fusão do PR.

Com este simples exemplo, pode ver como o Codex pode ser perfeitamente integrado no seu fluxo de trabalho de desenvolvimento para ajudar nas tarefas diárias de codificação.

Dicas de utilização avançada

Para aproveitar todo o potencial do Codex, é importante ter algumas dicas avançadas e boas práticas.

Palavra-chave engenharia

Escrever descrições de tarefas (prompts) de alta qualidade é a chave para tirar o máximo partido do Codex. Aqui estão algumas dicas práticas:

Otimização da configuração do projeto

Para que o Codex funcione de forma mais eficiente, pode adicionar informações auxiliares ao seu projeto:

Adicionar ficheiro AGENTS.md

No diretório raiz do projeto, crie o ficheiro AGENTES.md documento que fornece orientações de projeto para inteligências de IA, incluindo:

• Descrição da estrutura do projeto
• Normas de codificação e guias de estilo
• Método de execução do teste
• Regras de criação de relações públicas
• Descrição do processo de desenvolvimento

Exemplo de conteúdo do AGENTS.md:

Estrutura do projeto ##
- src/api: Definição do endpoint da API
- src/componentes: componentes React
- src/utils: Funções utilitárias genéricas

Guia de teste do ##
- Execute `npm test` para executar todos os testes.
- Toda funcionalidade deve ter testes unitários

Especificação do PR do ##
- Título Formato: [Módulo] Breve Descrição
- Deve passar em todos os testes e verificações de lint

Restrições e precauções ambientais

Aplicam-se as seguintes restrições à utilização do Codex:

1. Sem acesso à Internet
   • O ambiente de tempo de execução do Codex não consegue aceder à rede externa
   • Não é possível instalar novos pacotes de dependências (por exemplo npm install (Inválido)
   • Utilize apenas o código e as dependências pré-instaladas que já se encontram no projeto.
2. Configuração do ambiente
   • Os guiões de ambiente podem ser personalizados através de definições avançadas
   • As dependências e os ambientes necessários têm de ser pré-configurados
3. isolamento de tarefas
   • Cada tarefa é executada num ambiente separado e não partilha o estado
   • Não há interação direta entre múltiplas tarefas

Cenários de aplicação e estudos de casos práticos

Com base nas necessidades reais de desenvolvimento, o Codex pode fornecer uma ajuda eficaz numa variedade de cenários. Seguem-se alguns casos de utilização típicos e os correspondentes métodos de conceção de tarefas.

Revisão e otimização do código

Descrição da cenaVerificar a qualidade do código e sugerir melhorias

Formato do mandato::

Reveja o ficheiro src/components/UserProfile.tsx para analisar possíveis problemas de desempenho e sugerir melhorias. Preste especial atenção ao risco de renderização desnecessária e fugas de memória.

Elementos de aplicação::

• Pedidos de recomendações específicas e acionáveis em vez de generalidades
• Especificar preocupações (por exemplo, desempenho, segurança, facilidade de manutenção)
• Exigência de provas ou explicações e não apenas de conclusões

Diagnóstico e reparação de erros complexos

Descrição da cenaReparação de erros condicionais difíceis de reproduzir

Formato do mandato::

Ocasionalmente, ocorre o seguinte erro quando um utilizador modifica vários campos ao mesmo tempo e os guarda rapidamente:
TypeError: Não é possível ler propriedades de undefined (lendo 'email')
em validateUserInput (/app/src/utils/validation.ts:41)

Analise as possíveis causas e corrija este problema para garantir que funciona mesmo em condições competitivas para operações assíncronas.

Elementos de aplicação::

• Fornecer informações completas sobre a pilha de erros
• Descrever os cenários e condições específicos em que o erro ocorreu
• Clarificar os critérios de aceitação do restauro (por exemplo, que testes devem ser efectuados)

Programação de áreas especializadas

Descrição da cena: geração de código para domínios específicos (por exemplo, linguagens de descrição de hardware)

Formato do mandato::

Desenhe um módulo Verilog para um processador RISC de 8 bits que contenha os seguintes conjuntos de instruções: ADD, SUB, AND, OR, XOR, LOAD, STORE, JUMP.

Elementos de aplicação::

• Fornecer especificações técnicas claras
• Especificar o método de verificação (por exemplo, ensaio de simulação)
• Os requisitos estão em conformidade com as práticas normalizadas do sector

Geração de testes automatizados

Descrição da cenaCriar conjuntos de testes para as novas funcionalidades implementadas

Formato do mandato::

Gere testes de unidade para todos os métodos públicos no ficheiro src/services/authentication.js. Certifique-se de que os testes incluam caminhos normais, tratamento de erros e casos extremos. Use a estrutura de teste Jest e os estilos de teste já existentes no projeto.

Elementos de aplicação::

• Esclarecer os requisitos de estrutura e estilo dos testes
• Especificar o método ou a função a ser testada
• Requisitos para cobrir diferentes tipos de cenários de teste

Resumo das dicas práticas

Com base no feedback dos programadores que utilizam o Codex no terreno, as seguintes práticas podem melhorar significativamente a eficiência:

1. processamento de tarefas em lote
   • Apresentar um pequeno lote de tarefas todas as manhãs para que o Codex as processe em paralelo
   • Voltar e rever os resultados diretamente em vez de esperar por cada tarefa
2. Tarefas progressivas
   • O Codex deve analisar primeiro o problema.
   • Refinamento das tarefas de acompanhamento com base nos resultados da análise
   • Soluções passo a passo
3. Desenvolvimento exploratório
   • Deixar o Codex tentar várias soluções ao mesmo tempo
   • Comparar as vantagens e desvantagens dos diferentes programas
   • Seleção do melhor programa para execução
4. Integração com os fluxos de trabalho da equipa
   • Fazer com que o Codex efectue a revisão do código antes da revisão do PR
   • Utilizar o Codex para gerar a documentação inicial e depois aperfeiçoá-la manualmente
   • Deixe o Codex tratar das tarefas de manutenção de rotina, como actualizações de dependências, ajustes de estilo, etc.

Com estes exemplos práticos e dicas, pode integrar eficazmente o Codex no seu processo de desenvolvimento diário, tornando-o no seu assistente de programação, tratando de tarefas entediantes e melhorando a eficiência geral do desenvolvimento.