Instale o Codex CLI no macOS, Linux e Windows

Instale o Codex CLI, verifique o executável, faça login e comece com uma tarefa pequena no diretório do seu projeto. Os instaladores oficiais agora abrangem macOS, Linux e Windows; npm e Homebrew continuam sendo alternativas. Escolha uma das opções abaixo. Uma instalação funcional é o primeiro passo; o acesso à conta e o faturamento da API são escolhas separadas.

1. Escolha um método de instalação

Estes comandos vêm do guia oficial de instalação do Codex CLI. Use o instalador do ambiente em que você executará o agente. Instalar um executável do Windows não instala uma cópia Linux separada dentro do WSL, e instalar no seu laptop não instala em um servidor remoto ao qual você se conectará depois.

macOS ou Linux: instalador oficial independente

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

Windows: instalador oficial independente

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

Se você já gerencia ferramentas de desenvolvimento com um gerenciador de pacotes, use a alternativa correspondente em vez de executar os dois instaladores:

Método	Instalar	Atualizar
npm	`npm install -g @openai/codex`	`npm install -g @openai/codex`
Homebrew	`brew install --cask codex`	`brew upgrade --cask codex`
Independente	Execute o instalador do seu sistema operacional	Execute novamente o mesmo instalador

A opção npm requer uma instalação funcional do npm; verifique npm --version primeiro. A opção independente é útil se você não precisar de ferramentas Node por outros motivos. Em uma máquina gerenciada, use o método de instalação compatível com o administrador para que as atualizações futuras permaneçam previsíveis.

2. Verifique qual executável é executado

Abra um terminal novo após a instalação se o comando não for encontrado. No macOS ou Linux, command -v codex mostra o executável selecionado pelo shell. No PowerShell, use Get-Command codex. Compare esse caminho com o método de instalação escolhido antes de reinstalar. Duas cópias instaladas podem fazer com que você atualize uma enquanto continua iniciando a outra.

Verifique, faça login e execute uma primeira tarefa

codex --version
codex --help

# Open your own project directory before starting
cd /path/to/your/project
codex login
codex login status
codex --sandbox read-only "Explain this project's structure and how its tests run. Do not modify files."

Substitua o caminho de exemplo do projeto pelo seu. O comando final usa um sandbox somente leitura para uma explicação inicial. Esta é uma primeira verificação útil, pois permite confirmar o repositório correto e o acesso aos modelos antes de pedir ao agente que faça uma alteração. Se quiser consultar as opções disponíveis, use a ajuda da CLI instalada ou a referência de comandos.

3. Escolha o caminho correto da conta

codex login inicia o fluxo de login da conta. Verifique a conta e o workspace no navegador antes de concluí-lo. Para faturamento direto pela API da OpenAI, a alternativa documentada aceita uma chave da Platform pela entrada padrão:

Opcional: autenticação da API da OpenAI Platform

# After supplying OPENAI_API_KEY through your credential setup:
printenv OPENAI_API_KEY | codex login --with-api-key

Este comando da API é para uma chave da OpenAI Platform. Ele não é a configuração completa para um gateway de terceiros. Um provedor personalizado precisa de sua própria configuração, endpoint, fonte de credenciais e modelo compatível. A documentação de autenticação explica os caminhos, enquanto o nosso guia de chaves de API do Codex aborda a configuração mais detalhada do provedor.

4. Transforme a primeira resposta em uma primeira tarefa útil

Pergunte onde estão o código-fonte e os testes relevantes, depois confira a resposta no repositório.
Escolha uma alteração pequena e informe qual comportamento espera.
Use uma branch limpa ou um checkpoint e escolha permissões adequadas à alteração.
Peça ao Codex para executar as verificações relevantes e depois revise o diff e a explicação.

Por exemplo, comece com um teste com falha ou uma pequena correção de documentação. Evite fazer da primeira tarefa uma reescrita completa da aplicação: instalação, credenciais, dependências locais e qualidade da tarefa seriam mais difíceis de avaliar simultaneamente. Quando o ciclo curto funcionar, adicione as instruções do seu projeto e amplie o escopo.

Se a configuração parar, corrija a camada correspondente

“Command not found” aponta para a instalação ou o PATH. Um 401 aponta para a autenticação. Um erro de modelo aponta para o provedor e o modelo selecionados. Um aviso de limite aponta para o uso ou faturamento. Preserve as camadas que estão funcionando e siga o checklist de 401 ou o guia de limites de uso, conforme apropriado; reinstalar o executável não reabastecerá uma conta.

Para avaliar a Kunavo no trabalho local com o Codex, crie uma conta e siga a integração do Codex. Ela usa uma configuração de provedor compatível com Responses. Verifique uma tarefa pequena antes de depender da nova rota de faturamento em um projeto maior.

Perguntas frequentes

Como instalo o Codex CLI?

Use o instalador oficial independente para seu sistema operacional ou a alternativa via npm ou Homebrew. Abra um novo terminal, se necessário, verifique codex --version, depois inicie o Codex no diretório do seu projeto e escolha seu método de autenticação.

npm install -g @openai/codex ainda é compatível?

Sim. A documentação oficial de instalação, verificada em 17 de setembro de 2026, lista o npm junto com os instaladores independentes e o Homebrew. Escolha um método de instalação e use o caminho de atualização correspondente para evitar cópias conflitantes.

Preciso de uma assinatura do ChatGPT para instalar o Codex?

A instalação e o acesso aos modelos são separados. Escolha uma opção de login disponível no ChatGPT ou um acesso à API cobrado separadamente para o trabalho local compatível. Verifique as opções atuais da conta antes de escolher como pagar; instalar a CLI não adiciona créditos de modelo.

Posso instalar o Codex no Windows?

Sim. A OpenAI oferece um instalador independente para Windows. Se você preferir trabalhar dentro do WSL, instale e execute a versão Linux nesse ambiente e mantenha o controle dos caminhos de projeto e das variáveis de ambiente separados.

Documentação oficial de instalação e ajuda local da CLI verificadas em 17 de setembro de 2026.