Setup inicial para vibe coding: preparando o VS Code com Codex

Bem-vindo ao vibe coding.

Antes de pedir que um agente escreva, refatore ou revise código, prepare o ambiente.

Sem isso, você aumenta o ruído. Perde histórico. Mistura ferramentas. Deixa decisões importantes escondidas em janelas soltas de chat.

Este guia cobre o setup inicial para trabalhar com VS Code, Codex e GitHub em Windows ou macOS.

1. Entenda o acesso ao Codex

Codex é o agente de programação da OpenAI. Ele pode atuar pelo aplicativo, pela CLI, pela extensão de IDE e pela web.

Hoje, a forma mais direta de começar é entrar no cliente Codex com sua conta ChatGPT. O uso está disponível em planos elegíveis do ChatGPT, com limites que variam por plano.

Também existe uso por API para fluxos técnicos específicos, automações e organizações que preferem provisionar chaves manualmente.

Antes de configurar, consulte a documentação atual:

• Usando o Codex com seu plano ChatGPT
• OpenAI para desenvolvedores

Se você optar por usar API key:

1. Acesse a plataforma de desenvolvedores da OpenAI.
2. Crie uma conta ou faça login.
3. Configure cobrança em Settings > Billing.
4. Crie uma chave em API Keys.
5. Guarde a chave em local seguro. Ela não deve ser commitada no repositório.

2. Instale o VS Code

O Visual Studio Code será a base de trabalho.

Você pode baixar pelo site oficial ou instalar pelo terminal.

No Windows, usando PowerShell:

winget install -e --id Microsoft.VisualStudioCode

No macOS, usando Homebrew:

brew install --cask visual-studio-code

Depois de instalar, abra o VS Code e confirme que o terminal integrado funciona.

3. Reduza conflito entre assistentes

Se você já usa GitHub Copilot ou outro assistente, decida qual ferramenta vai dirigir a sessão.

Para vibe coding, o ideal é evitar dois agentes competindo pelo mesmo espaço. Autocomplete agressivo, atalhos duplicados e sugestões constantes podem atrapalhar a leitura do que o agente principal está fazendo.

Você não precisa remover tudo para sempre. Mas, durante uma sessão com Codex, vale pausar ou desabilitar extensões concorrentes.

No VS Code:

1. Abra Extensions.
2. Procure por GitHub Copilot ou outra extensão de IA.
3. Clique em Disable para o workspace ou desative temporariamente.

O objetivo é simples: uma sessão, um diretor, um agente principal.

4. Instale e autentique o Codex

Escolha o cliente Codex que melhor combina com seu fluxo:

• Codex CLI;
• extensão do Codex para VS Code;
• aplicativo Codex;
• Codex na web.

Para começar pela CLI, instale o pacote oficial:

npm install -g @openai/codex

Depois faça login:

codex

ou, quando aplicável:

codex --login

Siga o fluxo de autenticação exibido no terminal.

Se estiver usando a extensão do VS Code, instale pela aba de extensões, abra o painel do Codex e siga as instruções de login. Prefira autenticação com ChatGPT quando disponível. Use API key apenas quando esse for o seu fluxo escolhido.

5. Configure Git e GitHub

Vibe coding sem Git vira memória curta.

Antes de começar a pedir mudanças reais, configure sua identidade:

git config --global user.name "Seu Nome Completo"
git config --global user.email "seuemail@exemplo.com"

Depois, dentro da pasta do projeto:

git init
git status

Se o projeto ainda não estiver no GitHub, use o painel Source Control do VS Code ou a GitHub CLI para publicar o repositório.

Com GitHub CLI:

gh auth login
gh repo create nome-do-repositorio --private --source=. --remote=origin --push

Faça commits pequenos. Cada etapa deve ser entendível.

6. Crie os arquivos de direção do projeto

O agente precisa de contexto persistente.

Crie, no mínimo:

AGENTS.md
README.md
PLANS.md
docs/

Use AGENTS.md para regras de trabalho.

Use README.md para explicar o projeto.

Use PLANS.md para organizar etapas pequenas.

Use docs/ para registrar decisões, riscos e convenções.

Um primeiro prompt útil:

Leia AGENTS.md, README.md e PLANS.md.
Entenda o objetivo do projeto.
Não implemente nada ainda.
Liste riscos, dúvidas e uma primeira etapa pequena de implementação.

7. Entenda a diferença entre chat e agente

Muita frustração vem de tratar ferramentas diferentes como se fossem iguais.

Chat	Codex integrado ao ambiente
Responde perguntas e sugere trechos.	Lê arquivos, entende a estrutura e pode editar o projeto.
Você copia, cola e decide onde encaixar.	O agente navega pelo repositório e propõe mudanças concretas.
Funciona bem para explicação e exploração.	Funciona bem para implementação, revisão e validação.
Depende muito do contexto que você cola.	Usa o contexto local do workspace, dentro dos limites autorizados.

O chat ajuda a pensar.

O agente ajuda a executar.

Os dois são úteis. Mas não fazem o mesmo trabalho.

8. Comece com um ciclo pequeno

Depois do setup, não peça o sistema inteiro.

Peça uma etapa:

Leia AGENTS.md e PLANS.md.
Implemente apenas a primeira etapa.
Antes de editar, diga quais arquivos pretende alterar.
Depois rode as validações disponíveis e atualize a documentação necessária.

Esse é o começo correto.

Ambiente pronto. Histórico protegido. Agente com contexto. Humano ainda dirigindo.

Bem-vindo ao vibe coding.