DownloadCodex Guia não oficial
Português (Brasil)

Instale a Codex CLI

Instale a Codex CLI com o instalador avulso da OpenAI. No macOS ou Linux, execute curl -fsSL https://chatgpt.com/codex/install.sh | sh. No Windows, execute o comando install.ps1 em uma nova janela do PowerShell. As alternativas são npm install -g @openai/codex ou brew install --cask codex. Depois execute codex em uma pasta de projeto e escolha Sign in with ChatGPT.

Aplica-se a: Codex CLI, macOS, Linux, Windows

Esta página é uma tradução do guia em inglês. Comandos e nomes de arquivos não foram alterados. Se as duas versões divergirem, valem a página em inglês e as fontes oficiais.

1. Instale

Escolha um método.

macOS ou Linux: instalador avulso

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

Windows: instalador avulso

Abra uma nova janela do PowerShell e execute:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

npm (qualquer sistema com Node.js)

npm install -g @openai/codex

Homebrew (macOS)

brew install --cask codex

Segundo o README, os instaladores avulsos baixam de releases.openai.com/codex e recorrem ao GitHub Releases se esse endereço estiver indisponível. Para forçar o GitHub Releases:

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

2. Confirme a instalação

Abra um novo terminal para que o PATH seja atualizado e execute:

codex --version

Você deve ver um número de versão. Se aparecer “command not found”, siga esta correção.

3. Faça login

Vá até uma pasta de projeto e inicie o Codex:

cd path/to/your/project
codex

Escolha Sign in with ChatGPT (entrar com o ChatGPT). Seu navegador abre e, depois que você faz login, ele devolve as credenciais para a CLI. Você também pode executar codex login diretamente. Para usar uma chave de API:

printenv OPENAI_API_KEY | codex login --with-api-key

Confira qual método está ativo com codex login status. Trabalhando via SSH ou em um servidor sem interface gráfica? Use codex login --device-auth. Mais opções de login.

4. Execute um primeiro prompt

Tell me about this project

Depois continue com sua primeira tarefa de verdade.

Comandos úteis para conhecer

ComandoO que faz
codexInicia uma sessão interativa na pasta atual
codex resumeReabre um chat recente deste repositório
codex exec "..."Executa de forma não interativa, para scripts e CI
codex --searchUsa pesquisa na web ao vivo nesta execução
codex mcp add ...Conecta um servidor MCP
codex login statusMostra o método de login ativo
codex completionGera autocompletar para o shell

Perguntas frequentes

Qual método de instalação devo usar?

O instalador avulso é o método que a OpenAI lista primeiro, e ele não precisa do Node.js. Use o npm ou o Homebrew se você já gerencia suas ferramentas com eles. Evite misturar métodos, senão você pode acabar com duas cópias no PATH.

Posso forçar o instalador a baixar do GitHub?

Sim. O README diz que definir CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false faz o instalador usar o GitHub Releases em vez de releases.openai.com.

Como vejo o que o Codex está fazendo para depurar?

Execute codex -c log_dir=./.codex-log para gravar um log em texto puro e acompanhe-o com tail -F ./.codex-log/codex-tui.log.

Fontes

Indicamos a fonte oficial de cada instrução desta página. Se algo aqui divergir delas, confie na fonte oficial e avise a gente.

Leia a seguir