Zmienne środowiskowe Codexa
CODEX_HOME wskazuje katalog główny stanu Codexa, zamiast określać pojedynczą opcję konfiguracyjną. Zmienne środowiskowe służą między innymi do nadpisywania ustawień w zakresie powłoki, a ustawienia trwałe Codex przechowuje w config.toml. Wartość domyślna CODEX_HOME to ~/.codex.
Pod wskazanym katalogiem znajduje się stan obejmujący konfigurację, dane uwierzytelniania, logi, sesje, umiejętności oraz metadane samodzielnego pakietu. Zmienna jest używana przez CLI, rozszerzenie IDE, app-server oraz instalatory. Ustawiając CODEX_HOME, wybierasz katalog główny dla tych danych, a nie tylko miejsce przechowywania jednej kategorii stanu.
Przy własnej wartości wskaż katalog, który już istnieje. W praktyce najpierw przygotuj katalog docelowy, a następnie ustaw CODEX_HOME na jego ścieżkę. Wartość domyślna ~/.codex jest używana, gdy nie wskazujesz innego katalogu.
Użyj tej zmiennej, gdy chcesz ustalić katalog stanu Codexa dla obsługiwanych narzędzi, w tym CLI, rozszerzenia IDE, app-servera lub instalatorów. Pasuje ona do konfiguracji zależnej od środowiska, ponieważ zmienne środowiskowe mogą służyć do nadpisywania ustawień w zakresie powłoki. Ograniczenie jest istotne: katalog wskazany przez CODEX_HOME musi istnieć już w chwili ustawienia tej wartości.
CODEX_HOME=~/.codex
CODEX_HOME w powłoce uruchamiającej Codexa, a wskazany katalog musi już istnieć.CODEX_HOME=~/.codex codex
Zastosowanie w praktyce
Ustaw CODEX_HOME, gdy chcesz wskazać katalog główny stanu używany przez CLI, rozszerzenie IDE, app-server lub instalatory. Możesz wykorzystać zmienne środowiskowe do nadpisań ograniczonych do zakresu powłoki. Wybierając własną lokalizację, upewnij się, że katalog już istnieje.
CODEX_HOME do katalogu, którego jeszcze nie utworzono: wskazany katalog musi już istnieć.