Plik config.toml - podstawy konfiguracji
~/.codex/config.toml przechowuje konfigurację użytkownika, czyli osobiste ustawienia domyślne Codex. Możesz używać tego pliku do ustawienia domyślnego modelu i dostawcy, polityki zatwierdzania oraz ustawień piaskownicy, a także serwerów MCP. CLI i rozszerzenie IDE korzystają z tych samych warstw konfiguracji, więc ustawienia z tego pliku są wspólne dla obu interfejsów.
Codex rozstrzyga konfigurację według kolejności pierwszeństwa: nadpisania z flag CLI i --config mają wyższy priorytet niż plik użytkownika. Przed konfiguracją użytkownika mogą być zastosowane pliki projektu oraz pliki profili wybrane przez --profile profile-name. Po konfiguracji użytkownika w kolejności znajdują się domyślne wartości zarządzane przez chmurę, konfiguracja systemowa, jeśli istnieje, oraz wartości wbudowane.
Ustawienia można ograniczyć do projektu lub podfolderu, dodając w repozytorium plik .codex/config.toml. Wartości w plikach projektu są uporządkowane od katalogu głównego projektu do bieżącego katalogu roboczego, a pierwszeństwo ma plik położony najbliżej. Plik można otworzyć w rozszerzeniu IDE przez ikonę koła zębatego, a następnie **Codex Settings > Open config.toml**.
Plik [features] w config.toml służy do przełączania opcjonalnych i eksperymentalnych możliwości. Aby włączyć funkcję, dodaj jej nazwę z wartością true pod tabelą [features]; aby ją wyłączyć, ustaw jej klucz na false. Ustawienia projektu są ładowane tylko wtedy, gdy projekt jest zaufany; dla projektu oznaczonego jako niezaufany Codex pomija lokalną konfigurację projektu.
~/.codex/config.toml
true pod tabelą [features].# ~/.codex/config.toml [features] feature_name = true
Zastosowanie w praktyce
Umieść w ~/.codex/config.toml osobiste wartości domyślne, jeśli mają obowiązywać poza ustawieniami ograniczonymi do konkretnego projektu. Użyj pliku projektu .codex/config.toml, gdy chcesz ograniczyć ustawienia do repozytorium lub podfolderu. Jeśli chcesz zmienić opcjonalne lub eksperymentalne możliwości, skonfiguruj tabelę [features] w config.toml. Przy ustawianiu wartości domyślnych uwzględnij pierwszeństwo: konfiguracja użytkownika nie zastępuje nadpisań z flag CLI i --config.
.codex/, w tym lokalny plik konfiguracyjny.