Codex Desktop

Codex Desktop использует ту же конфигурацию Codex, что и CLI: приложение читает user-level каталог ~/.codex/.

Если Codex CLI уже настроен по рабочей инструкции, для Desktop обычно остается проверить те же файлы и полностью перезапустить приложение.

Что важно заранее

provider id: apikey_center
base URL: https://apikey.center/v1
settings file: ~/.codex/config.toml
auth file: ~/.codex/auth.json
requires_openai_auth = true
ключ хранится в поле OPENAI_API_KEY

Ручная настройка

1. Найди папку `.codex`

Windows: %USERPROFILE%\.codex\
macOS / Linux: ~/.codex/

Если на macOS папка не видна в Finder:

открой домашнюю папку пользователя
нажми Command + Shift + ., чтобы показать скрытые файлы
открой .codex

Быстрый альтернативный путь на macOS:

в Finder нажми Command + Shift + G
введи ~/.codex
нажми Enter

На Windows проще всего вставить %USERPROFILE%\.codex\ прямо в адресную строку Проводника.

Если каталога еще нет, создай его.

2. Сделай backup перед правкой

Минимум нужно сохранить копии двух файлов:

~/.codex/config.toml
~/.codex/auth.json

Самый простой вариант:

macOS / Linux:

cp ~/.codex/config.toml ~/.codex/config.toml.backup 2>/dev/null || true
cp ~/.codex/auth.json ~/.codex/auth.json.backup 2>/dev/null || true

Windows PowerShell:

Copy-Item "$HOME\.codex\config.toml" "$HOME\.codex\config.toml.backup" -ErrorAction SilentlyContinue
Copy-Item "$HOME\.codex\auth.json" "$HOME\.codex\auth.json.backup" -ErrorAction SilentlyContinue

Если одного из файлов еще нет, это нормально.

3. Заполни `config.toml`

В ~/.codex/config.toml используй такой блок:

model_provider = "apikey_center"
model = "gpt-5.5"

[model_providers.apikey_center]
name = "apikey_center"
base_url = "https://apikey.center/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

Что здесь важно:

model_provider и имя секции должны совпадать
wire_api = "responses" обязателен
requires_openai_auth = true нужен, чтобы Desktop брал ключ из auth.json
supports_websockets = false входит в рабочую конфигурацию
если нужна другая модель, меняй только значение model

4. Заполни `auth.json`

В ~/.codex/auth.json положи ключ в таком виде:

{
  "OPENAI_API_KEY": "sk-REPLACE_WITH_YOUR_KEY"
}

Если файл уже существует, для этого сценария лучше полностью заменить его содержимое этим JSON. Старую версию сначала сохрани в backup.

Если ты вручную переключаешь профили Codex Desktop, меняй одновременно оба файла:

~/.codex/config.toml
~/.codex/auth.json

Одна строка model = "..." не гарантирует, что Desktop увидит модели. Нужен полный provider block и подходящий auth.json.

5. Полностью закрой Codex Desktop

Простого закрытия окна может быть недостаточно: приложение иногда остается в фоне и не перечитывает новый config.toml и auth.json.

На Windows:

нажми Ctrl + Shift + Esc
открой Processes
найди Codex и связанные процессы приложения
сделай End task
после этого снова открой Codex Desktop

На macOS обычно достаточно полного выхода из приложения. Если оно зависло, используй Command + Option + Esc и сделай Force Quit.

6. При желании проверь модель напрямую

До запуска Desktop можно сделать тот же live-check, что и для CLI.

macOS / Linux:

curl https://apikey.center/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Windows PowerShell:

Invoke-WebRequest `
  -Uri "https://apikey.center/v1/models" `
  -Headers @{ Authorization = "Bearer YOUR_API_KEY" }

Скрипт автонастройки

Если нужен самый короткий путь, можно использовать готовый скрипт автонастройки:

irm https://docs.apikey.center/i/codex-desktop.ps1 | iex

Unix-версия:

curl -fsSL https://docs.apikey.center/i/codex-desktop.sh | sh

Что делает installer:

обновляет ~/.codex/config.toml и ~/.codex/auth.json
включает provider apikey_center
пишет base_url = "https://apikey.center/v1"
фиксирует wire_api = "responses" и supports_websockets = false
добавляет requires_openai_auth = true
перезаписывает auth.json целиком и оставляет в нем только OPENAI_API_KEY
по умолчанию ставит модель gpt-5.5
делает backup и live-check через GET /v1/models

Если Codex Desktop на Windows не закрывается нормально, можно отдельно запустить best-effort force-close:

& ([scriptblock]::Create((irm https://docs.apikey.center/i/codex-desktop.ps1))) -ForceCloseCodexDesktop

Этот режим старается закрывать только процессы, которые выглядят именно как desktop app, и пропускает двусмысленные codex.exe процессы из других клиентов.

Verification

GET https://apikey.center/v1/models отвечает без route-error
Codex Desktop стартует без возврата к дефолтному OpenAI URL
приложение подхватывает модель из ~/.codex/config.toml
при неверном ключе виден auth-error, а не Invalid URL

Rollback

PowerShell installer: & ([scriptblock]::Create((irm https://docs.apikey.center/i/codex-desktop.ps1))) -Rollback
Unix installer: curl -fsSL https://docs.apikey.center/i/codex-desktop.sh | sh -s -- --rollback
верни backup ~/.codex/config.toml
верни backup ~/.codex/auth.json
или убери model_provider = "apikey_center" и блок [model_providers.apikey_center]
после rollback полностью закрой приложение и запусти его снова

Частые ошибки

Папка `.codex` не видна на macOS

Обычно помогает Command + Shift + . в Finder. Если не хочется показывать все скрытые файлы, используй Command + Shift + G и сразу открой ~/.codex.

Закрыли окно, но не завершили процесс

Если просто закрыть окно на Windows, Codex Desktop может остаться в фоне и продолжить работать со старым конфигом.

Если обычное закрытие не помогло, используй -ForceCloseCodexDesktop или заверши приложение вручную через Task Manager.

Ключ положили не туда

Для этого сценария ключ должен лежать в ~/.codex/auth.json, а не в config.toml.

Использован не тот base URL

Для Codex Desktop используй основной OpenAI-compatible URL https://apikey.center/v1.

Переименовали `.bak` обратно, а список моделей не работает

config.toml.apikey-center.codex-desktop.bak нужен для rollback, а не как отдельный профиль для ручного переключения.

Если после возврата backup-файла Desktop не видит модели, проверь:

есть ли model_provider = "apikey_center" или другой ожидаемый provider id
существует ли полный блок [model_providers....]
указан ли requires_openai_auth = true
совпадает ли текущий auth.json с этим конфигом