Superfícies: Aplicação de Ambiente de Trabalho, Nuvem, IDE e CLI
Nesta página
Lição reescrita a 3 de novembro de 2026 com base nas páginas Codex CLI, Codex IDE extension, Codex Cloud e na referência de comandos do Codex. A versão anterior instruía os utilizadores a instalar um pacote npm inexistente (
@openai/codex-cli) e citava uma flag--interactiveque não existe; as opções foram verificadas na CLI 0.166.0. Fontes: Codex CLI · Codex IDE extension · Codex Cloud.
Um Agente, Múltiplas Superfícies
O Codex não é uma aplicação única; é um agente acessível através de múltiplas superfícies, cada uma adaptada a um contexto de trabalho específico. O agente permanece o mesmo; o que muda é onde ele trabalha — na sua máquina local ou na nuvem —, o contexto a que tem acesso e como acompanha a execução. Escolher a superfície certa faz frequentemente mais diferença no seu fluxo de trabalho diário do que escolher um modelo específico.
A Aplicação de Ambiente de Trabalho ChatGPT
A aplicação de ambiente de trabalho ChatGPT para macOS, Windows e Linux é o ponto de entrada mais abrangente. Inicie sessão com a sua conta ChatGPT, abra uma pasta ou projeto e selecione Codex no menu do ChatGPT para desenvolvimento de software. O agente trabalha então nos ficheiros dessa pasta utilizando as suas ferramentas de desenvolvimento locais. Esta é a superfície para sessões longas e projetos locais. É também aqui que lança trabalhos baseados na nuvem, tal como pode fazer na interface web.
Codex Cloud
Para tarefas que precisam de ser executadas remotamente, o Codex Cloud executa o trabalho num ambiente que configura uma única vez. Na web ou na aplicação de ambiente de trabalho, escolha Trabalhar em › Nuvem, depois Selecionar ambiente e Criar ambiente. Selecione os seus repositórios GitHub; o Codex inspeciona o projeto, instala dependências e ferramentas, testa o fluxo de trabalho e solicita-lhe quaisquer permissões de acesso em falta. Assim que o ambiente é publicado, cada tarefa obtém o seu próprio espaço de trabalho e continua a ser executada mesmo quando o seu computador entra em modo de suspensão. Revê os ficheiros modificados e os resultados dos testes, solicita correções e, em seguida, faz commit ou abre um pull request — a partir da web, do telemóvel ou da aplicação de ambiente de trabalho.
Esta é a superfície para trabalhos de longa duração que inicia antes de uma reunião: uma migração de framework, uma refatoração extensiva ou múltiplas tarefas paralelas no mesmo ambiente.
A Extensão para IDE
A extensão Codex instala-se no Visual Studio Code e em editores compatíveis como o Cursor, Windsurf e VS Code Insiders. O Xcode e as IDEs da JetBrains oferecem as suas próprias integrações nativas do Codex. Uma vez ligado, abra o Codex através do seu ícone (ou no VS Code e derivados, através da Paleta de Comandos: Codex: Open Codex Sidebar; na JetBrains, abra o AI Chat e selecione Codex).
A sua vantagem é o contexto imediato: ficheiros abertos, seleções atuais e conversas recentes alimentam diretamente o seu prompt, e as alterações aparecem lado a lado com o seu código. Esta é a superfície para tarefas diárias — gerar testes para a função atual, explicar um bloco de código herdado ou corrigir um erro que o terminal integrado acabou de exibir. Quando uma tarefa se torna demasiado grande, pode delegá-la na nuvem a partir do editor e regressar aos resultados mais tarde. A documentação recomenda a criação de pontos de controlo Git antes e depois de uma tarefa, para que possa reverter se necessário.
A CLI
A CLI destina-se a programadores que vivem no terminal. A documentação oferece quatro métodos de instalação:
# macOS e Linux: instalador autónomo
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# npm
npm install -g @openai/codex
# Homebrew
brew install --cask codex
No Windows, execute o instalador autónomo a partir do PowerShell: powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex".
Executar codex sem argumentos numa pasta de projeto abre a interface de terminal interativo. No primeiro lançamento, ser-lhe-á pedido para iniciar sessão com a sua conta ChatGPT ou outro método.
# Abrir uma sessão interativa
codex
# Abrir uma sessão com um prompt inicial
codex "Add email validation to the signup form"
# Selecionar um modelo
codex --model gpt-6.1-sol "Refactor the payment module"
O seu verdadeiro valor brilha quando vai além da utilização manual. codex exec (alias codex e) executa uma tarefa sem interação, tornando-a ideal para scripts e pipelines. Quando o stdin é redirecionado e um prompt é também fornecido, codex exec anexa o conteúdo recebido ao prompt dentro de um bloco <stdin>. Isto permite encadear comandos que produzem listas de ficheiros.
# Encontrar ficheiros sem testes e pedir ao Codex para os gerar
find src/ -name "*.ts" -not -name "*.test.ts" | codex exec "Generate missing tests for these files"
Que Superfície Deve Escolher?
| Situação | Superfície Recomendada | Porquê |
|---|---|---|
| Migração de framework | Codex Cloud | Tarefa de longa duração, ambiente preparado, trabalho paralelo |
| Refatoração de um ficheiro aberto | Extensão IDE | Contexto local imediato, revisão lado a lado |
| Projeto local, sessão longa | Aplicação de Ambiente de Trabalho | Pasta aberta, ferramentas de desenvolvimento |
| Script de automação | CLI (codex exec) | Integração em pipeline |
| Geração rápida de testes | Extensão IDE | Resultados aparecem no editor |
Na prática, a maioria dos programadores combina estas superfícies numa única semana. As sessões de início de sessão são partilhadas: a CLI e a extensão reutilizam as mesmas credenciais em cache. E todas as superfícies leem o mesmo ficheiro AGENTS.md, o ficheiro de instruções abordado na próxima lição.
Pontos-chave
- O Codex está acessível através da aplicação de ambiente de trabalho ChatGPT, do Codex Cloud, da extensão IDE e da CLI
- A aplicação de ambiente de trabalho e a extensão funcionam localmente; o Codex Cloud executa tarefas em ambientes publicados
- A extensão instala-se no VS Code e derivados; o Xcode e a JetBrains têm as suas próprias integrações
- Instale a CLI através do instalador autónomo,
npm install -g @openai/codex, ou Homebrew; utilizecodex execpara automação - Todas as superfícies leem o mesmo ficheiro
AGENTS.md