Codex Desktop

Codex входит в настольное приложение ChatGPT для macOS и Windows. Десктоп-приложение, Codex CLI и IDE-расширение читают один и тот же ~/.codex/config.toml — разница только в том, как до процесса доходит API ключ: GUI-приложение не наследует профиль оболочки.

Шаг 1. Установка

Скачайте настольное приложение ChatGPT дляmacOS или Windows и войдите в аккаунт.

Шаг 2. Конфигурация

Создайте или отредактируйте ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml):

model_provider = "aichaos"
model = "chat-model"

[model_providers.aichaos]
name = "AI Chaos"
base_url = "https://aichaos.ru/v1"
env_key = "AICHAOS_API_KEY"
wire_api = "chat"
supports_websockets = false

Замените chat-model на код модели изкаталога . model_provider и model_providers учитываются только в пользовательском конфиге — в проектном .codex/config.toml их игнорируют.

Шаг 3. Ключ для GUI-приложения

env_key читает переменную окружения, но export в ~/.zshrc до приложения из Dock или меню «Пуск» не доходит. Задайте переменную на уровне сессии и полностью перезапустите приложение.

macOS

launchctl setenv AICHAOS_API_KEY "chaos-u-..."

Не переживёт logout/ребут. Для постоянного значения добавьте команду в launchd-агент, который запускается при логине.

Windows

setx AICHAOS_API_KEY "chaos-u-..."

Переменная уровня пользователя: процессы, запущенные после, её наследуют — перезапустите приложение.

Шаг 4. Запуск

Полностью закройте приложение (не только окно), откройте снова, выберите Codex и начните новый чат. Запросы пойдут через AI Chaos и отобразятся в панели активности.

Устранение неполадок

  • Ошибки аутентификации / Missing Authentication header. Приложение не видит AICHAOS_API_KEY: задайте её через launchctl setenv (macOS) или setx (Windows), затем полностью перезапустите приложение.
  • Правки config.toml не применяются. Вы редактировали проектный .codex/config.toml — нужен пользовательский ~/.codex/config.toml, после правки перезапустите приложение.
  • Model not found. Сверьте точный код модели вкаталоге моделей со значением model посимвольно.

См. также