O Codex Cloud (legado) continua oferecendo suporte a ambientes para a revisão de código e as integrações com o Linear e o GitHub.
Para saber como usar a versão atual na Web, em dispositivos móveis e no computador, consulte o guia de ambientes de nuvem.
Use ambientes para controlar o que o Codex instala e executa durante os chats na nuvem. Por exemplo, você pode adicionar dependências, instalar ferramentas como linters e formatadores de código e definir variáveis de ambiente.
Configure os ambientes nas configurações do Codex.
Como funcionam os chats do Codex na nuvem
Quando você envia uma tarefa:
- O Codex cria um contêiner e faz checkout do repositório na branch selecionada ou no commit identificado pelo SHA selecionado.
- O Codex executa o script de configuração. Ao retomar um contêiner em cache, também executa o script de manutenção, se houver.
- O Codex aplica as configurações de acesso à internet. Os scripts de configuração são executados com acesso à internet. Por padrão, o acesso do agente à internet fica desativado, mas você pode habilitar o acesso limitado ou irrestrito conforme necessário. Consulte Acesso do agente à internet.
- O agente executa comandos de terminal em um loop. Ele edita o código, executa verificações e tenta validar o resultado. Se o repositório incluir
AGENTS.md, o agente consulta esse arquivo para encontrar os comandos de lint e de teste específicos do projeto. - Ao terminar, o agente mostra a resposta e um diff com as alterações feitas nos arquivos. Você pode abrir um PR ou fazer outras perguntas.
Imagem universal padrão
O agente do Codex é executado em uma imagem de contêiner padrão chamada universal, que já inclui linguagens, pacotes e ferramentas de uso comum.
Nas configurações do ambiente, selecione Definir versões dos pacotes para fixar as versões do Python, do Node.js e de outros ambientes de execução.
Para saber o que já vem instalado, consulte openai/codex-universal. O repositório inclui um Dockerfile de referência e uma imagem que você pode baixar e testar localmente.
A imagem codex-universal já inclui linguagens para agilizar e facilitar o uso. Você também pode instalar outros pacotes no contêiner com scripts de configuração.
Variáveis de ambiente e segredos
As variáveis de ambiente ficam definidas durante todo o chat, inclusive durante a execução dos scripts de configuração e na fase do agente.
Os segredos são semelhantes às variáveis de ambiente, com duas diferenças:
- Os segredos são armazenados com uma camada adicional de criptografia e só são descriptografados para a execução da tarefa.
- Apenas os scripts de configuração têm acesso aos segredos. Por segurança, os segredos são removidos antes do início da fase do agente.
Configuração automática
Em projetos que usam gerenciadores de pacotes comuns (npm, yarn, pnpm, pip, pipenv e poetry), o Codex pode instalar dependências e ferramentas automaticamente.
Configuração manual
Se o ambiente de desenvolvimento exigir uma configuração mais complexa, você também pode fornecer um script de configuração personalizado. Por exemplo:
# Install type checker
pip install pyright
# Install dependencies
poetry install --with test
pnpm installOs scripts de configuração são executados em uma sessão do Bash separada da sessão do agente. Por isso, as alterações feitas por comandos como export não persistem na fase do agente. Para manter as variáveis de ambiente nessa fase, adicione-as a ~/.bashrc ou defina-as nas configurações do ambiente.
Cache de contêineres
O Codex mantém o estado do contêiner em cache por até 12 horas para agilizar tanto o início de novos chats quanto a continuação dos existentes.
Ao armazenar um ambiente em cache:
- O Codex clona o repositório e faz checkout da branch padrão.
- O Codex executa o script de configuração e armazena em cache o estado resultante do contêiner.
Ao retomar um contêiner em cache:
- O Codex faz checkout da branch especificada para o chat.
- O Codex executa o script de manutenção, se houver. Esse script é útil quando o script de configuração foi executado em um commit anterior e é preciso atualizar as dependências.
O Codex invalida o cache automaticamente se você alterar o script de configuração, o script de manutenção, as variáveis de ambiente ou os segredos. Se o estado em cache se tornar incompatível com alguma alteração no repositório, selecione Redefinir cache na página do ambiente.
Nos planos Business e Enterprise, todos os usuários com acesso ao ambiente compartilham o cache. A invalidação do cache afeta todos os usuários desse ambiente no seu espaço de trabalho.
Acesso à internet e proxy de rede
Durante a execução do script de configuração, o acesso à internet fica disponível para instalar dependências. Na fase do agente, o acesso à internet fica desativado por padrão, mas você pode configurar o acesso limitado ou irrestrito. Consulte Acesso do agente à internet.
Os ambientes usam um proxy de rede HTTP/HTTPS por motivos de segurança e para prevenir abusos. Todo o tráfego de saída para a internet passa por esse proxy.
Requisitos do Agent Security para o acesso dos comandos à rede
Se o seu espaço de trabalho usa o Agent Security para gerenciar o acesso dos comandos à rede, verifique tanto as configurações de acesso à internet do ambiente quanto a política gerenciada. Consulte Isolamento de rede para entender como esses controles se aplicam aos comandos.