Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Superfícies: Aplicação de Ambiente de Trabalho, Nuvem, IDE e CLI

Aula 2 de 20 Atualizada a 3 de novembro de 2026 Programador
Nesta página
  1. Um Agente, Múltiplas Superfícies
  2. A Aplicação de Ambiente de Trabalho ChatGPT
  3. Codex Cloud
  4. A Extensão para IDE
  5. A CLI
  6. Que Superfície Deve Escolher?
  7. Pontos-chave

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 --interactive que 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çãoSuperfície RecomendadaPorquê
Migração de frameworkCodex CloudTarefa de longa duração, ambiente preparado, trabalho paralelo
Refatoração de um ficheiro abertoExtensão IDEContexto local imediato, revisão lado a lado
Projeto local, sessão longaAplicação de Ambiente de TrabalhoPasta aberta, ferramentas de desenvolvimento
Script de automaçãoCLI (codex exec)Integração em pipeline
Geração rápida de testesExtensão IDEResultados 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; utilize codex exec para automação
  • Todas as superfícies leem o mesmo ficheiro AGENTS.md