Codex CLI: O Novo Agente de Codificação Local da OpenAI que Revoluciona o Desenvolvimento no Terminal

O desenvolvimento de software está em constante evolução, com ferramentas de IA cada vez mais integradas ao fluxo de trabalho dos programadores. A OpenAI, conhecida por inovações como o ChatGPT, acaba de atualizar uma de suas ferramentas mais poderosas para desenvolvedores: o Codex. Lançado inicialmente em 2021 como um sistema de IA para traduzir linguagem natural em código, agora ganha uma nova versão como Codex CLI, um agente de codificação local de código aberto que promete mudar a forma como interagimos com nossos projetos diretamente pelo terminal.

Se você já utiliza o terminal como seu ambiente principal de desenvolvimento, esta nova ferramenta pode ser exatamente o que você precisa para aumentar sua produtividade. Neste artigo, vamos mergulhar profundamente no Codex CLI, mostrando como instalá-lo, testá-lo em um projeto real e comparar sua eficácia com ferramentas similares como o Cloud Code da Anthropic.

O Que é o Codex CLI e Por Que Você Deveria Se Importar

O Codex CLI é uma ferramenta de linha de comando desenvolvida pela OpenAI que traz o poder do raciocínio do ChatGPT diretamente para o seu terminal. Diferente de outras ferramentas de assistência de código, o Codex CLI vai além de simplesmente gerar snippets – ele pode executar código, manipular arquivos e iterar sobre seu repositório, tudo sob controle de versão.

A OpenAI descreve o Codex CLI como sendo construído para “desenvolvedores que já vivem no terminal e desejam o raciocínio de nível ChatGPT, além do poder de realmente executar código”. Em essência, é um desenvolvimento orientado por chat que entende e executa seu repositório, permitindo que você faça tudo sem sair do terminal.

Requisitos de Sistema e Instalação

Antes de começarmos a explorar a ferramenta, vamos verificar os requisitos mínimos para rodar o Codex CLI:

• Sistema Operacional: Mac, Ubuntu ou Windows 11 (via WSL2)
• NodeJS instalado
• Git instalado
• Mínimo de 4GB de RAM

Estes são requisitos básicos que a maioria dos desenvolvedores já possui em suas máquinas. Note que, atualmente, o Codex CLI não roda nativamente no Windows, sendo necessário o uso do WSL2.

Instalando o Codex CLI

A instalação é bastante simples usando NPM ou Yarn. Vamos usar o NPM neste tutorial:

1. Abra seu terminal
2. Execute: npm install -g @openai/codex
3. Configure sua chave de API da OpenAI: export OPENAI_API_KEY=sua_chave_aqui

Após a instalação, você pode verificar se tudo está funcionando corretamente verificando a versão instalada:

codex --version

Interface de Linha de Comando do Codex

O Codex CLI oferece várias opções de uso:

• codex: Inicia um loop interativo (REPL) onde você pode continuar interagindo com o modelo
• codex "prompt inicial": Inicia o REPL com um prompt específico
• codex -q "comando": Modo não-interativo (silencioso) para execução de comandos específicos
• codex completion: Imprime o script de autocompletar no shell

Testando o Codex CLI em um Projeto Real

Para demonstrar o poder do Codex CLI, vamos testá-lo em um projeto de calculadora simples escrito em TypeScript. Este é o mesmo projeto que foi usado para testar o Cloud Code da Anthropic em um vídeo anterior, o que nos permitirá fazer uma comparação direta.

Analisando o Projeto

Primeiro, vamos pedir ao Codex CLI para analisar e explicar nosso repositório:

codex “Dê-me uma visão geral deste repositório”

O Codex executa automaticamente comandos como ls -r e analisa os arquivos do projeto. Ele responde com uma descrição precisa: “uma calculadora simples baseada em navegador construída em TypeScript”. Além disso, ele fornece detalhes sobre a estrutura do projeto, a separação entre código fonte e build, estilos e instruções para compilar e executar o projeto.

Executando o Projeto

Vamos pedir ao Codex CLI que nos ajude a executar o projeto:

codex “Como executo este projeto localmente?”

O Codex fornece instruções detalhadas:

1. Instalar dependências: npm install
2. Compilar TypeScript: npx tsc
3. Iniciar um servidor local: npx http-server .

Seguindo essas instruções, conseguimos executar a calculadora no navegador perfeitamente!

Criando Testes Unitários Automaticamente

Uma das capacidades mais impressionantes do Codex CLI é a criação de testes unitários. Notando que nosso repositório não possui testes, podemos pedir:

codex “Escreva testes unitários para todo o repositório”

O Codex CLI analisa o código existente e cria arquivos de teste para cada componente do projeto. Após executar npm install seguido de npm test, vemos que a maioria dos testes passa, mas alguns falham.

Para corrigir os testes com falha, simplesmente perguntamos:

codex “Alguns dos testes unitários estão falhando. Conserte-os.”

O Codex identifica o problema, reordena os handlers de clique e ajusta os testes. Ao executar novamente npm test, todos os 23 testes passam com sucesso!

Modificando o Design com Base em uma Imagem

Uma funcionalidade surpreendente do Codex CLI é a capacidade de interpretar imagens e aplicar mudanças no código com base nelas. Para demonstrar isso, usamos uma imagem de uma calculadora com design diferente:

codex -i caminho/para/imagem/calculadora.jpg “Mude o design do app para corresponder ao da imagem de entrada”

O Codex CLI identifica corretamente a imagem como “uma calculadora de desktop de 12 dígitos com teclas quadradas arredondadas de cores pastel” e modifica o CSS do projeto para refletir esse design. Ao relançar o aplicativo, vemos que o design mudou significativamente, com botões quadrados, esquema de cores mais claro e fundo branco, semelhante à imagem de referência.

Codex CLI vs. Cloud Code: Uma Comparação

Testando o Codex CLI com o mesmo projeto usado anteriormente para avaliar o Cloud Code da Anthropic, podemos fazer algumas observações interessantes:

• Tempo de resposta: O Codex CLI parece levar um pouco mais de tempo para responder que o Cloud Code, mas as respostas são igualmente detalhadas e precisas.
• Capacidades: Ambas as ferramentas podem analisar código, criar testes e modificar arquivos, mas o Codex CLI mostra uma vantagem na integração com o terminal e no processamento de imagens.
• Fluxo de trabalho: O Codex CLI é especialmente útil para desenvolvedores que preferem trabalhar diretamente no terminal, eliminando a necessidade de alternar entre diferentes interfaces.

Ampliando seus Horizontes com Codex CLI

O Codex CLI representa um avanço significativo na forma como interagimos com nossos projetos de código. Sua capacidade de compreender e executar comandos em linguagem natural diretamente no terminal abre novas possibilidades para desenvolvedores que valorizam eficiência e produtividade.

Experimente o Codex CLI em seus projetos e descubra como ele pode transformar seu fluxo de trabalho. Baixe hoje mesmo e junte-se à revolução do desenvolvimento guiado por IA, sem sair do ambiente que você já conhece e ama: o terminal.

Quer aumentar ainda mais sua produtividade? Compartilhe suas experiências com o Codex CLI nos comentários e veja como outros desenvolvedores estão integrando esta ferramenta em seus projetos!

Perguntas Frequentes