Variáveis de ambiente
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 | iexAutenticação e rede
| Variável | Utilizada por | Descrição |
|---|---|---|
CODEX_API_KEY |
Exec, revisão, TypeScript SDK, exec-server remoto | Fornece uma API key a um processo Codex não interativo. Defina-a inline, em vez de para toda a tarefa, ao executar código controlado pelo repositório. |
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. |
OPENAI_FEDERATION_RULE_ID |
Identidade da carga de trabalho | Seleciona a regra de federação configurada para a carga de trabalho. |
OPENAI_IDENTITY_TOKEN_FILE |
Identidade da carga de trabalho | Aponta para o caminho absoluto do ficheiro que contém o token OIDC atual ou o SPIFFE JWT-SVID. |
OPENAI_WORKLOAD_IDENTITY_CONTEXT |
Identidade da carga de trabalho | Fornece opcionalmente identificadores JSON limitados para atribuição de auditoria comunicada pelo cliente. Não afeta a autenticação nem a autorização. |
CODEX_CA_CERTIFICATE |
Clientes HTTPS, de início de sessão e WebSocket | Aponta para um pacote de AC em PEM para ambientes com interceção TLS empresarial ou certificados de raiz privados. Tem precedência sobre SSL_CERT_FILE. |
SSL_CERT_FILE |
Clientes HTTPS, de início de sessão e WebSocket | Caminho de recurso ao pacote de AC em 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 a gestão de segredos em automações, consulte Utilizar autenticação com 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.logNo modo não interativo, codex exec apresenta as mensagens inline em vez de as escrever
num ficheiro de registo separado da TUI.