Como usar o Codex: instalar, entrar e primeira tarefa

Em resumo

• Instale o Codex, rode codex no seu projeto e entre com o ChatGPT.
• Descreva uma tarefa pequena, revise as mudanças e aceite ou rejeite.
• Coloque as suas regras em um arquivo AGENTS.md para o Codex seguir sempre.

O que é o Codex?

Somos a RocketLauncher, uma empresa de software, e usamos tanto o Codex quanto o Claude Code. O Codex é o agente de programação da OpenAI. Você dá uma tarefa em linguagem comum. Ele lê o seu projeto, faz um plano, edita arquivos e pode rodar comandos. Você pode usar em vários lugares:

• A CLI, no seu terminal.
• Uma extensão de IDE para VS Code, Cursor e Windsurf, além de suporte nativo no Xcode e nas IDEs da JetBrains.
• Um app de desktop.
• O Codex na web, para tarefas que você delega e confere depois.

Este guia usa a CLI, porque as outras opções funcionam do mesmo jeito quando você a conhece. Nosso hub do Codex reúne mais recursos.

O que você precisa

• Um computador com terminal. Quem usa Windows pode usar o app para Windows, o sandbox do Windows ou o WSL. Veja a documentação da OpenAI para as opções atuais.
• Uma conta do ChatGPT. Quais planos incluem o Codex, e quanto uso eles dão, muda com o tempo. Veja a página de preços atual do Codex.
• Uma pasta de projeto, de preferência com git.

Como instalar e começar

1. Abra a página atual da CLI do Codex na OpenAI e copie o comando de instalação do seu sistema. No macOS e no Linux é um script de uma linha. As opções para Windows, npm e Homebrew também estão listadas lá.
2. Abra um terminal e entre na pasta do seu projeto.
3. Rode codex.
4. Na primeira execução, escolha Sign in with ChatGPT, ou outro método de login se preferir.
5. Espere o prompt aparecer. Está pronto.

Nunca cole uma chave de API em um chat nem faça commit dela no git. Guarde as chaves em variáveis de ambiente.

Sua primeira tarefa

1. Faça commit do seu trabalho primeiro. Um checkpoint do git antes e depois de uma tarefa permite desfazer qualquer coisa.
2. Comece com um pedido de só leitura, por exemplo: "Fale sobre este projeto."
3. Leia a resposta. Confira se o Codex entendeu a estrutura.
4. Peça uma mudança pequena: "Adicione uma seção no README que explique como rodar os testes."
5. Revise o que o Codex propõe. Aprove a edição ou peça outra coisa.
6. Peça que ele rode os testes ou o build e leia o resultado.
7. Faça o commit se você estiver satisfeito.

Mantenha as tarefas pequenas

Tarefas pequenas dão resultados melhores. "Corrija o formato de data na página de faturas" funciona melhor do que "melhore o app inteiro". Se a tarefa for grande, peça primeiro um plano ao Codex e vá passo a passo.

Controle o que o Codex pode fazer

Use o comando /permissions para escolher quando o Codex pode editar arquivos ou rodar comandos sem perguntar. Um padrão seguro:

• Comece com o Codex perguntando antes de cada edição e cada comando.
• Libere as edições dentro da pasta do projeto quando você confiar na tarefa.
• Deixe sob aprovação manual os comandos que acessam a rede, apagam arquivos ou fazem deploy.

Configure o AGENTS.md

O AGENTS.md é um arquivo markdown na raiz do seu projeto. Ele diz aos agentes de programação como trabalhar no seu repositório. O Codex lê antes de começar.

1. No Codex, rode /init. Ele cria um AGENTS.md inicial.
2. Edite. Mantenha curto e concreto.
3. Faça o commit para o time todo compartilhar as mesmas regras.

Coisas boas para colocar nele:

• Como instalar, compilar e testar, com os comandos exatos.
• Regras de estilo de código e pastas proibidas.
• Palavras ou padrões a evitar.
• O que significa "pronto", por exemplo "os testes passam e o lint está limpo".

Outras ferramentas também leem esse formato. O Claude Code pode usar um arquivo AGENTS.md se o seu repositório tiver um, e muitos times mantêm um arquivo só para as duas ferramentas.

Use o Codex no seu editor

Para VS Code, Cursor ou Windsurf, instale a extensão do Codex e clique no ícone do Codex, ou rode "Codex: Open Codex Sidebar" na paleta de comandos. Entre na sua conta e comece um chat. Você pode adicionar arquivos abertos ou seleções ao prompt, revisar os diffs no próprio lugar e mandar trabalhos maiores para o Codex na web.

Prompts que funcionam bem

• "Explique como o login funciona neste projeto. Não altere nenhum arquivo."
• "Escreva um plano para adicionar um formulário de contato. Liste os arquivos que você vai mexer."
• "Corrija o teste que está falhando no módulo de faturas e rode os testes de novo."
• "Revise o meu último commit procurando bugs e testes que faltam."

Um bom prompt diz o objetivo, o lugar no código e como conferir o resultado. Se o Codex for pelo caminho errado, pare, diga o que você queria e tente de novo. Você também pode pedir que ele desfaça a última mudança.

Erros comuns

• Dar uma tarefa enorme em um só prompt.
• Pular o git e depois não ter como voltar.
• Aprovar todos os comandos sem ler.
• Deixar o AGENTS.md vazio e repetir as mesmas regras em todo prompt.

Transforme isso em um serviço com o GoHighLevel

Muita gente usa o Codex para construir coisas pequenas para negócios locais, como uma página de agendamento, um formulário de leads ou um conjunto de automações de follow-up, e depois roda tudo no GoHighLevel. O Codex ajuda a escrever e corrigir o código, e o GoHighLevel cuida de contatos, mensagens, agendas e pagamentos. Nosso kit Claude Code + GoHighLevel mostra o processo completo, e os mesmos passos servem para o Codex. Você também pode ver os outros kits para criar e vender. Não prometemos renda. Os resultados dependem do seu trabalho e dos seus clientes.