Documentação do ChatGPT
Português
Contacto goolvyouyou@gmail.com

Variáveis de ambiente

Variáveis de ambiente suportadas pelo Codex

O Codex utiliza config.toml para definições persistentes. Utilize variáveis de ambiente para substituições limitadas ao âmbito da shell, segredos de automatização, comportamento do instalador ou diagnósticos.

Esta página apresenta as variáveis de ambiente públicas e estáveis que o Codex lê diretamente. Não apresenta variáveis de desenvolvimento internas, variáveis de teste nem nomes de segredos específicos do fornecedor que o utilizador define com env_key.

Localizações principais

Variável Utilizada por Predefinição Descrição
CODEX_HOME CLI, extensão IDE, app-server, instaladores ~/.codex Define a raiz do estado do Codex, incluindo configuração, autenticação, registos, sessões, skills e metadados de pacotes autónomos. Se a definir, o diretório já terá de existir.
CODEX_SQLITE_HOME Estado da CLI e do app-server CODEX_HOME Define onde é armazenado o estado suportado por SQLite. A opção de configuração sqlite_home tem precedência. Os caminhos relativos são resolvidos a partir do diretório de trabalho atual.

Para saber mais sobre os ficheiros armazenados em CODEX_HOME, consulte Localizações de configuração e estado.

Variáveis do instalador

Estas variáveis aplicam-se aos scripts de instalação autónoma disponibilizados a partir de https://chatgpt.com/codex/install.sh e https://chatgpt.com/codex/install.ps1.

Variável Predefinição Descrição
CODEX_NON_INTERACTIVE false Defina como 1, true ou yes para ignorar os pedidos do instalador. Os pedidos utilizam a resposta predefinida, pelo que deve usar esta opção para instalações e atualizações com scripts, e não para a configuração da primeira execução.
CODEX_INSTALL_DIR ~/.local/bin no macOS/Linux; %LOCALAPPDATA%\Programs\OpenAI\Codex\bin no Windows Altera o local onde é instalado o comando codex visível. A cache de pacotes autónomos permanece em CODEX_HOME/packages/standalone.

Para instalações não assistidas, defina CODEX_NON_INTERACTIVE=1 na shell que executa o instalador transferido:

curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh
$env:CODEX_NON_INTERACTIVE=1; irm https://chatgpt.com/codex/install.ps1 | iex

Autenticação e rede

Variável Utilizada por Descrição
CODEX_API_KEY codex exec Fornece uma API key para uma única execução não interativa. Só é suportada em codex exec; ao executar código controlado pelo repositório, defina-a inline em vez de a aplicar a toda a tarefa.
CODEX_ACCESS_TOKEN CLI, app-server, automatização fidedigna Fornece um token de acesso do ChatGPT ou Codex para automatização fidedigna. Para um início de sessão persistente, encaminhe-o para codex login --with-access-token.
CODEX_CA_CERTIFICATE Clientes HTTPS, de início de sessão e WebSocket Aponta para um pacote de CAs PEM destinado a ambientes com interceção TLS empresarial ou CAs de raiz privadas. Tem precedência sobre SSL_CERT_FILE.
SSL_CERT_FILE Clientes HTTPS, de início de sessão e WebSocket Caminho alternativo para o pacote de CAs PEM quando CODEX_CA_CERTIFICATE não está definido.

Para as API keys do fornecedor, defina env_key na configuração do fornecedor do modelo. O Codex lê a variável indicada por essa configuração, pelo que o próprio nome da variável não é uma variável de ambiente fixa do Codex.

Para saber como processar segredos de automatização, consulte Utilizar autenticação por API key. Para configurar tokens de acesso, consulte Tokens de acesso.

Diagnósticos

Variável Utilizada por Descrição
RUST_LOG CLI e app-server Controla a filtragem e o nível de detalhe dos registos do Rust. Por predefinição, codex exec utiliza a saída error, a menos que defina um valor mais detalhado.

RUST_LOG aceita valores como error, warn, info, debug e trace. Também aceita filtros de registo do Rust mais específicos, como codex_core=debug,codex_tui=debug.

Por predefinição, a CLI interativa regista diagnósticos em armazenamentos locais limitados, mas o ficheiro de texto simples codex-tui.log é opcional. Defina explicitamente log_dir quando necessitar de um registo em texto simples para resolver problemas:

RUST_LOG=debug codex -c log_dir=./.codex-log
tail -F ./.codex-log/codex-tui.log

No modo não interativo, codex exec apresenta as mensagens inline em vez de as escrever num ficheiro de registo separado da TUI.