---
title: "Setup inicial para vibe coding: preparando o VS Code com Codex"
summary: "Um guia direto para preparar OpenAI, VS Code, Codex, Git e GitHub antes de começar a trabalhar com agentes de IA."
slug: "setup-inicial-vibe-coding-codex"
language: "pt"
publishedAt: "2026-05-25"
updatedAt: null
tags:
  - "guia"
  - "setup"
  - "vscode"
  - "codex"
  - "github"
translationOf: null
translationStatus: "original"
---

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](https://help.openai.com/pt-br/articles/11369540-usando-o-codex-com-seu-plano-chatgpt)
- [OpenAI para desenvolvedores](https://developers.openai.com/)

Se você optar por usar API key:

1. Acesse a [plataforma de desenvolvedores da OpenAI](https://platform.openai.com/).
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:

```bash
winget install -e --id Microsoft.VisualStudioCode
```

No macOS, usando Homebrew:

```bash
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:

```bash
npm install -g @openai/codex
```

Depois faça login:

```bash
codex
```

ou, quando aplicável:

```bash
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:

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

Depois, dentro da pasta do projeto:

```bash
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:

```bash
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:

```txt
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:

```txt
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:

```txt
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.