Como instalar o Codex: CLI, aplicativo ou extensão para IDE

Instale o Codex

Instale a Codex CLI se você trabalha no terminal ou quer scripts e CI. Instale o aplicativo do ChatGPT para desktop se quer projetos, chats em paralelo e um painel de revisão em uma só janela. Instale a extensão para IDE se você vive no VS Code, Cursor ou Windsurf. Os três compartilham o login e o config.toml, então você pode usar mais de um.

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.

Qual você deve instalar?

	Codex CLI	Aplicativo do ChatGPT para desktop (Codex)	Extensão para IDE
Onde roda	No seu terminal	Em uma janela de desktop	Dentro do seu editor
Ideal para	Fluxos no terminal, scripts, CI com `codex exec`	Vários projetos ao mesmo tempo, worktrees, tarefas agendadas, navegador integrado	Edições focadas nos arquivos que você tem abertos
Plataformas	macOS, Linux, Windows	macOS, Windows, Linux (prévia)	VS Code, Cursor, Windsurf; JetBrains e Xcode por meio das próprias integrações
Instalação	Instalador de uma linha, npm ou Homebrew	chatgpt.com/download ou Microsoft Store	Marketplace do editor
Guia	Instalar a CLI	Instalar o aplicativo para desktop	Instalar no seu editor

Em dúvida? Comece pela CLI. É uma instalação pequena, mostra exatamente o que o Codex está fazendo, e tudo o que você configurar vale também para as outras duas opções.

Antes de instalar

Conta. Você vai fazer login com uma conta do ChatGPT em um plano que inclua o Codex, ou com uma chave de API da OpenAI cobrada pelas tarifas da API. Veja Login no ChatGPT ou chave de API.
Git. Opcional, mas recomendado. O Codex usa o Git para revisar e reverter alterações. A OpenAI sugere criar um checkpoint no Git antes e depois de cada tarefa.
Seu sistema operacional. Confira o que sua máquina suporta com a nossa verificação do sistema.

Depois de instalar

Execute sua primeira tarefa
Adicione um arquivo AGENTS.md para que o Codex siga as convenções do seu projeto
Mantenha o Codex atualizado

Nesta seção

Instale a Codex CLI Instalação passo a passo da Codex CLI com o instalador avulso da OpenAI, o npm ou o Homebrew; depois faça login e execute codex pela primeira vez.
Instale o aplicativo do Codex para desktop O Codex para desktop agora fica no aplicativo do ChatGPT para desktop. Como instalá-lo no macOS, Windows ou Linux e iniciar um chat do Codex em um projeto.
Instale o Codex no seu editor Como adicionar a extensão do Codex ao VS Code, Cursor ou Windsurf e ativar o Codex nas IDEs da JetBrains e no Xcode, com links para cada página oficial.
Use o Codex com WSL2 no Windows Codex no WSL2: mude o agente do aplicativo para desktop para WSL, instale a CLI no Linux, compartilhe a configuração com CODEX_HOME e evite a armadilha do WSL1.
Atualize ou desinstale o Codex Atualize a Codex CLI pelo mesmo método da instalação, atualize o aplicativo para desktop em cada sistema e remova o Codex por completo, inclusive ~/.codex.

Perguntas frequentes

Posso instalar a CLI e o aplicativo para desktop juntos?

Sim. A documentação da OpenAI diz que a CLI e a extensão para IDE compartilham as mesmas camadas de configuração e o mesmo login em cache. As configurações de servidores MCP são compartilhadas entre o aplicativo para desktop, a CLI e a extensão para IDE na mesma máquina.

Preciso do Node.js para instalar o Codex?

Só se você escolher o método de instalação pelo npm. Os instaladores oficiais avulsos e o Homebrew não precisam do Node.js.