Codex: Instalação e Configuração do Codex

Última atualização: 2026-08-31

O Codex oferece múltiplos métodos de instalação. Escolha o que melhor se adapta ao seu sistema operacional e fluxo de trabalho.

📋 Pré-requisitos: Conhecimento básico de linha de comando, Node.js instalado (necessário para o método CLI)

1. Visão Geral dos Métodos de Instalação

2. Codex App (Aplicação Desktop)

O método mais simples — baixe o cliente desktop diretamente.

Visite https://chatgpt.com/codex e baixe o app para sua plataforma.

(1) Passos de Instalação

1. Visite chatgpt.com/codex
2. Clique em "Download for macOS/Windows"
3. Instale a aplicação
4. Faça login com sua conta ChatGPT
5. Comece a usar

(2) Primeira Execução

Após o login, você verá uma interface de três painéis: lista de tarefas à esquerda, janela de conversa no centro e área multifuncional à direita.

O Codex App usa um layout clássico de três painéis: lista de tarefas + janela de conversa + área multifuncional.

3. Codex CLI (Linha de Comando)

O método mais popular entre desenvolvedores. O CLI roda localmente — seu código não é enviado para a nuvem.

(1) Instalação

# Instalar via npm
sudo npm install -g @openai/codex

# Aceleração via mirror (China)
sudo npm install -g @openai/codex --registry=https://registry.npmmirror.com

(2) Login

A primeira execução requer autenticação. Três opções:

Opção 1: Login via ChatGPT (Recomendado)

codex
# Selecione "Sign in with ChatGPT"
# O navegador abre a página de login automaticamente

Opção 2: Login via API Key

# macOS/Linux temporário
export OPENAI_API_KEY="sk-your-api-key"

# Permanente (adicione ao config do shell)
echo 'export OPENAI_API_KEY="sk-your-api-key"' >> ~/.zshrc
source ~/.zshrc

# Windows PowerShell
$env:OPENAI_API_KEY="sk-your-api-key"

# Iniciar com modelo específico
codex --model gpt-5-codex

Opção 3: Arquivo auth.json

mkdir -p ~/.codex
cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "sk-your-api-key"
}
EOF

(3) Primeira Execução

cd my-project
codex
# Digite: Analyze the current project structure

▶ Exemplo 1: Primeira Experiência de Alice

# Alice cria um projeto de teste
mkdir codex-test && cd codex-test

# Cria um arquivo simples
echo 'print("Hello World")' > test.py

# Inicia o Codex
codex

# Alice digita:
# "Add command-line argument support to test.py, support --name parameter"

4. Três Modos de Execução

O Codex CLI oferece três modos de segurança:

# Modo padrão
codex

# Modo Auto Edit
codex --auto-edit

# Modo Full Auto
codex --full-auto

▶ Exemplo 2: Seleção de Modo

def choose_mode(task_risk, task_complexity):
    if task_risk == "high":
        return "Suggest - confirmar cada ação para segurança"
    elif task_complexity == "low":
        return "Full Auto - tarefas simples feitas rapidamente"
    else:
        return "Auto Edit - arquivos auto-editados, comandos revisados por humano"

5. Instalação via Homebrew (Recomendado para Mac)

# Instalar
brew install --cask codex

# Executar
codex

Ideal para desenvolvedores Mac que não querem instalar o Node.js.

6. Instalação via Pacote Binário

Baixe diretamente do GitHub Release:

# URL de download: https://github.com/openai/codex/releases

# Mac Apple Silicon
tar -xzf codex-aarch64-apple-darwin.tar.gz

# Linux
tar -xzf codex-x86_64-unknown-linux-musl.tar.gz

# Adicionar ao PATH
sudo mv codex /usr/local/bin

# Executar
codex

7. Instalação do Plugin IDE

Suporta VS Code, Cursor, Windsurf e outras IDEs.

(1) Passos de Instalação

1. Abra o marketplace de extensões da sua IDE
2. Pesquise por "Codex"
3. Instale o plugin
4. Faça login com sua conta ChatGPT

(2) Recursos da IDE

• Auto-corrigir código
• Auto-gerar funções
• Auto-refatorar código
• Clicar com o botão direito no código selecionado para enviar ao Codex

8. Atualização e Desinstalação

# Atualizar CLI
npm update -g @openai/codex

# Forçar reinstalação da versão mais recente
npm install -g @openai/codex@latest

# Desinstalar
npm uninstall -g @openai/codex

# Desinstalar via Homebrew
brew uninstall --cask codex

9. Suporte de Sistemas

10. Problemas de Rede

Usuários na China podem encontrar barreiras de rede ao acessar o Codex. Considere:

• Usar um proxy de rede
• Experimentar produtos similares como Alibaba Qoder Quest ou ByteDance Trae Solo

❓ Perguntas Frequentes

P: O que preciso antes de instalar o CLI? R: Node.js (v18+) é necessário; npm está incluído com o Node.js. Usuários Mac podem instalar o Codex via Homebrew para pular o Node.js.

P: Posso usar o Codex CLI no Windows? R: Suporte experimental — recomenda-se usar via WSL (Windows Subsystem for Linux) para uma experiência mais estável.

P: API Key ou login via ChatGPT — qual é melhor? R: O login via ChatGPT é mais simples e serve para a maioria dos usuários; API Key é melhor para desenvolvedores que precisam de controle preciso sobre modelos e custos.

P: O modo Full Auto é seguro? R: Há algum risco. O Codex auto-executará todas as operações incluindo comandos shell. Recomendado apenas para projetos confiáveis, ou com modo sandbox habilitado.

P: Como verifico a versão do Codex? R: Execute codex --version para ver a versão atual.

📖 Resumo

• Cinco métodos de instalação: App / CLI / Homebrew / Binário / Plugin IDE
• CLI é a primeira escolha dos desenvolvedores — npm install -g @openai/codex resolve em uma linha
• Três modos de segurança: Suggest / Auto Edit / Full Auto
• Primeira execução requer login: Login ChatGPT (recomendado) / API Key / auth.json
• Usuários de Windows devem usar WSL

📝 Exercícios

1. Básico (⭐): Instale o Codex CLI e faça login com sucesso. Tire um screenshot da interface da primeira execução.
2. Intermediário (⭐⭐): Complete a mesma tarefa usando os modos Suggest e Auto Edit, e compare a experiência.
3. Avançado (⭐⭐⭐): Instale o Codex CLI em um ambiente WSL e escreva um guia de solução de problemas de instalação.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós