Curso Básico de Codex – Aula 6 – Como usar o Codex no VS Code como um profissional

O que é o Codex no VS Code

A integração do Codex com o VS Code representa um salto importante na forma como pessoas desenvolvedoras interagem com ferramentas de inteligência artificial no dia a dia. Nesta aula do Curso Básico de Codex, o foco está na execução de um projeto real de automação de relatórios de vendas usando Python, Pandas e Streamlit, tudo a partir do ambiente de desenvolvimento. A proposta é demonstrar como o Codex deixa de ser apenas um assistente conversacional para se tornar um agente ativo dentro do editor, com capacidade de planejar, criar arquivos, executar etapas e validar resultados. A aula tem duração de 39 minutos e explora desde a instalação da extensão até a geração de um arquivo de memória do projeto, o agents.md.

A diferença central entre o aplicativo desktop do ChatGPT e o VS Code é a profundidade de acesso. No desktop, a interação ocorre por meio de chat e anexos manuais. No VS Code, a extensão do Codex consegue ler a estrutura de pastas, identificar arquivos, propor alterações e executar comandos no terminal, sempre com aprovação explícita de quem está conduzindo o projeto. Essa combinação cria um fluxo de trabalho mais integrado e menos suscetível a erros de cópia e colagem, pois o agente entende o contexto do repositório inteiro.

Preparação do projeto AutoVendas

O projeto utilizado na aula se chama AutoVendas e parte de uma base de dados em CSV com informações de vendas. Antes de qualquer automação, a aula mostra como organizar a pasta do projeto e inserir o arquivo CSV no contexto. O objetivo é tratar os dados, validar inconsistências e transformá-los em um painel interativo. A etapa inicial de preparação é essencial porque o Codex depende de uma estrutura limpa para navegar e propor mudanças coerentes.

A aula orienta a realização do download do VS Code e da extensão oficial do Codex. Depois da instalação, é necessário fazer login e vincular a conta. Esse vínculo permite que o projeto criado no aplicativo desktop seja linkado ao editor. A sincronização entre os dois ambientes é um dos pontos mais comentados, pois garante que as conversas e o histórico de decisões permaneçam disponíveis tanto no desktop quanto no VS Code. A demonstração deixa claro que a extensão não substitui o ChatGPT, mas amplia o alcance do assistente para dentro do código.

Modo de planejamento e aprovação de etapas

O Codex no VS Code oferece um modo de planejamento conhecido como plan mode. Nesse modo, o agente não éxecuta nada imediatamente. Antes, ele analisa o briefing fornecido e faz uma série de perguntas para esclarecer intenções, riscos e critérios de aceite. Na aula, o briefing é uma automação em Python com Pandas e Streamlit, e o Codex questiona pontos como formato do arquivo, regras de tratamento de dados, filtros desejados e forma de execução do projeto.

Depois de responder às perguntas, o Codex gera um plano estruturado em etapas. A pessoa que conduz a aula tem a oportunidade de analisar o plano antes de aprovar. Em seguida, a execução também acontece por etapas, com aprovação individual para cada bloco. Essa metodologia reduz os riscos de gerar código incompleto ou de seguir um caminho que não atende às expectativas. O plano inicial pode ser ajustado, e cada fase concluída pode ser visualizada diretamente no explorador de arquivos do VS Code, o que facilita a revisão e o aprendizado.

Etapa 1: limpeza e validação dos dados

A primeira etapa executada pelo Codex é a criação de um pipeline de limpeza e validação do CSV. A automação identifica inconsistências como valores vazios, datas fora do padrão e tipos de dados incorretos. O Pandas é a biblioteca principal para essa tarefa, e o Codex gera scripts que padronizam as colunas e preparam o arquivo tratado para as fases seguintes. A geração do CSV limpo é um entregável importante, pois serve de base para o painel interativo.

Durante a execução, o agente exibe o que éstá fazendo e pede confirmação nos momentos críticos. Isso transforma o Codex em um copiloto de projeto, não em um gerador silencioso de código. A possibilidade de visualizar os arquivos criados em tempo real ajuda a entender o que cada script faz e onde cada artefato foi salvo. A aula mostra como navegar pela árvore de diretórios do VS Code para localizar os scripts e o resultado do processamento.

Etapa 2: criação do painel com Streamlit

A segunda etapa usa o Streamlit para transformar os dados limpos em um dashboard interativo. O Codex cria o arquivo app.py com a lógica de visualização, filtros e gráficos. O painel exibe métricas de venda e permite aplicar filtros por período, categoria, região e vendedor. Essa capacidade de gerar uma interface funcional a partir de uma descrição textual é um dos grandes atrativos da automação, pois elimina etapas repetitivas de configuração inicial.

A aula demonstra como executar o painel no terminal e visualizar o dashboard no navegador. O Streamlit é iniciado a partir do comando adequado, e a interface aparece em localhost. A demonstração inclui a aplicação de filtros e a validação de que os dados respondem corretamente às seleções. O resultado é um relatório de vendas interativo e atualizável, criado com pouquíssima intervenção manual no código.

Etapa 3: testes e arquivos de suporte

Depois do painel, o Codex avança para a criação de testes automáticos, do arquivo requirements.txt e do README. Os testes ajudam a verificar se as funções principais continuam funcionando após mudanças. O requirements.txt registra as dependências do projeto, e o README documenta o propósito, a estrutura e o modo de uso. Esses arquivos são fundamentais para transformar o projeto em algo sustentável e reproduzível, mesmo fora da máquina original.

A geração automatizada desses artefatos reduz o trabalho burocrático e permite que o foco permaneça na solução do problema de negócio. A aula também mostra como atualizar o CSV manualmente no VS Code e pedir ao Codex para reprocessar o fluxo completo sem usar o terminal. O agente detecta a mudança no arquivo de origem, reexecuta as etapas necessárias e atualiza o painel. Essa capacidade de reagir a alterações de dados é essencial para relatórios recorrentes.

Agents.md e sincronização com o desktop

Um dos momentos mais interessantes da aula é a geração do agents.md, um arquivo que registra a stack, a estrutura do projeto e as regras de tratamento definidas durante a sessão. Esse documento funciona como memória de longo prazo para o agente. Em sessões futuras, o Codex pode consultar o agents.md para entender rapidamente o que foi feito, quais decisões foram tomadas e como o projeto está organizado. Isso agiliza a continuidade do trabalho e reduz a necessidade de repetir briefings completos.

A sincronização entre o VS Code e o aplicativo desktop do ChatGPT também é explorada. O vínculo da conta permite que as alterações feitas no editor apareçam no histórico do aplicativo e vice-versa. Esse comportamento amplia a usabilidade para quem trabalha em diferentes dispositivos ou alterna entre o desktop e o editor. A aula conclui com a recomendação de usar o VS Code para tarefas de código e o aplicativo desktop para planejamento inicial, aproveitando o melhor de cada ambiente.

Para quem é esta aula e como aplicá-la

A aula é direcionada a pessoas que desejam sair do uso básico de IA e começar a integrá-la em fluxos reais de desenvolvimento. Não é necessário ser especialista em Python, mas alguma familiaridade com a linguagem ajuda a acompanhar as execuções e a revisar os códigos gerados. O conteúdo também é relevante para analistas de dados que precisam criar relatórios recorrentes sem depender de ferramentas visuais complexas.

A aplicação prática do que é mostrado pode ser adaptada para outros tipos de dados, como relatórios financeiros, indicadores de marketing ou logs operacionais. Basta substituir o CSV de vendas por outra base e ajustar o briefing. O fluxo de planejamento, aprovação por etapas e geração de artefatos de suporte se mantém válido para diferentes contextos. A aula cumpre o papel de demonstrar que o Codex no VS Code pode atuar como um agente de desenvolvimento completo quando bem orientado.