// tutorial · instalação

Como instalar o Codex, a CLI da OpenAI

O Codex é a ferramenta de terminal da OpenAI, o equivalente ao Claude Code, mas conectado à sua conta ChatGPT. Você abre numa pasta, pede em português e ele lê os arquivos e propõe mudanças. Este guia mostra o comando oficial de instalação, o login e o que fazer quando algo não funciona.

Antes de começar: o que você precisa

Conta: uma conta ChatGPT com o Codex habilitado no seu plano. Sem isso, a instalação até completa, mas o login não deixa você entrar.
Mac e Linux: só o terminal. O comando oficial faz o resto.
Windows: a OpenAI publica o instalador oficial para Mac e Linux. No Windows, os dois caminhos são o npm (precisa do Node.js instalado) ou o WSL, o Linux que roda dentro do Windows. Dentro dele, vale a seção de Linux.

Um aviso de segurança. O comando abaixo baixa um script da internet e executa na sua máquina. É assim que instaladores oficiais funcionam, mas confira sempre se a URL é exatamente a do fabricante (aqui, chatgpt.com) antes de rodar. Comando de instalação de fonte desconhecida não se roda.

Mac

Abra o Terminal (Command + Espaço, digite "Terminal" e dê Enter). Cole o comando e aperte Enter:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Linux (e WSL no Windows)

Abra o terminal e rode:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows (via npm), vale para qualquer sistema

Com o Node.js instalado, rode no PowerShell ou no terminal:

npm install -g @openai/codex

Esse mesmo comando funciona no Mac e no Linux, se você preferir o npm ao instalador oficial.

Faça login e verifique

Feche e reabra o terminal. Depois, entre na pasta de um projeto (qualquer pasta com arquivos que você queira trabalhar) e rode:

codex

Se a interface abrir, a instalação funcionou. Na primeira vez, escolha "Sign in with ChatGPT" e siga as instruções no navegador para conectar sua conta. Depois disso, você volta pro terminal já logado. Se preferir fazer só o login, sem abrir a conversa, o comando codex login faz a mesma coisa.

Os três comandos que você vai usar

codex: abre o modo interativo, a conversa normal no terminal.
codex resume: retoma uma conversa anterior de onde parou.
codex exec: roda uma tarefa direto, sem abrir a interface. Útil mais pra frente, quando você já estiver confortável.

Problemas comuns

"codex: command not found" (ou "não é reconhecido")

Na maioria das vezes o terminal aberto ainda não conhece o programa recém-instalado. Feche todas as janelas do terminal, abra uma nova e tente de novo.

O npm deu erro ou nem existe

O caminho npm depende do Node.js. Se o comando npm não existe na sua máquina, instale o Node.js pelo site oficial (nodejs.org) e tente de novo, ou, no Mac e Linux, use o instalador oficial da seção acima, que não depende de Node.

Fiz login e ele diz que não tenho acesso

O Codex precisa estar habilitado no seu plano do ChatGPT. Confira no site do ChatGPT o que o seu plano inclui antes de assumir que o problema é a instalação.

Próximo passo

A lógica de uso do Codex é a mesma dos outros agentes de terminal: abrir na pasta certa, pedir com contexto e revisar antes de aceitar. Nosso guia Primeiros passos no Claude Code ensina essa lógica, quase tudo ali vale pro Codex também.

// continue daqui

Quer saber por onde começar no seu caso?

Cada pessoa chega num ponto diferente. O nosso diagnóstico gratuito leva 2 minutos e indica o próximo passo pro seu momento. E se você quer aprender com método, as Formações da Xentory estão chegando.

Fazer o diagnóstico gratuito Entrar na lista de espera das Formações