Официальное приложение Codex от OpenAI работает с семейством Codex через Guard напрямую: без входа в ChatGPT, с семью моделями Guard и уровнем Ультра. После установки оно называется ChatGPT. Понадобятся ключ gd-…, файл настроек и одна строка с ключом.
- Ключ
gd-…из бота Guard: откройте бота, оформите доступ и скопируйте ключ. Расход списывается с баланса ключа, он виден в личном кабинете. - Компьютер: Mac с macOS 13 или новее либо компьютер с Windows и Microsoft Store.
- Приложение, Codex CLI и расширение Codex для VS Code используют один общий файл настроек. Если вы уже подключили семейство Codex в Codex CLI по нашей инструкции и в файле есть строка
model_provider = "guard-codex", шаг 2 у вас выполнен: переходите сразу к шагу 3.
macOS
- Скачайте установщик с официального сайта OpenAI: Codex.dmg. Это версия для Mac с процессором Apple. Другие варианты загрузки есть на странице приложения.
- Откройте скачанный файл
Codex.dmgи перетащите значок ChatGPT в папку Программы. - Запускать приложение пока не нужно. Если оно уже открыто, закройте его: меню ChatGPT → Выйти из ChatGPT или
Cmd+Q. Входить в ChatGPT не нужно.
Windows: установите приложение из Microsoft Store по официальной ссылке: установить ChatGPT. Вместо этого можно выполнить команду в PowerShell:
winget install --id 9PLM9XGG6VKS -s msstoreЗапускать приложение пока не нужно. Если оно уже открыто, закройте его. Входить в ChatGPT не нужно.
Приложение берёт настройки из файла config.toml, общего с Codex CLI. Если файл уже заполнен, сохраните его копию и меняйте только строки ниже.
macOS: откройте приложение Терминал: нажмите Cmd+Пробел, наберите Терминал и нажмите Return. Вставьте команды и нажмите Return. Папка и пустой файл создадутся, если их ещё нет, и файл откроется в TextEdit.
mkdir -p ~/.codex
touch ~/.codex/config.toml
open -e ~/.codex/config.tomlWindows: откройте PowerShell через меню Пуск. Вставьте команды и нажмите Enter. Файл откроется в Блокноте.
$codexConfig = Join-Path $env:USERPROFILE ".codex\config.toml"
New-Item -ItemType Directory -Force (Split-Path $codexConfig) | Out-Null
if (-not (Test-Path $codexConfig)) { New-Item -ItemType File $codexConfig | Out-Null }
notepad $codexConfigНастройки состоят из двух блоков. Поставьте курсор в самое начало файла: Cmd+↑ в TextEdit, Ctrl+Home в Блокноте. Скопируйте первый блок кнопкой копирования, вставьте и сразу нажмите Return (на Windows Enter), чтобы блок не слился со следующей строкой. Если какие-то из этих строк в файле уже есть, исправьте их, а не добавляйте вторые.
model = "gpt-6-astra"
model_provider = "guard-codex"
model_reasoning_effort = "medium"
model_context_window = 872000Затем перейдите в самый конец файла: Cmd+↓ в TextEdit, Ctrl+End в Блокноте. Нажмите Return (Enter), чтобы начать новую строку, вставьте второй блок и сохраните файл: Cmd+S в TextEdit, Ctrl+S в Блокноте. Раздел [model_providers.guard-codex] должен быть в файле один раз: если он уже есть, исправьте его строки, а не добавляйте второй.
[model_providers.guard-codex]
name = "GUARD API · Codex"
base_url = "https://api.guardrelay.ai/codex/v1"
env_key = "GUARD_API_KEY"
wire_api = "responses"| Строка | Что означает |
|---|---|
model | Модель по умолчанию. В приложении её можно сменить в меню моделей. |
model_provider | Все задачи приложения идут через Guard. |
model_reasoning_effort | Уровень рассуждения по умолчанию, здесь Среднее. |
model_context_window | Бюджет истории чата: 872000 для моделей 6 и 5.6, 272000 для 5.5. |
name | Эту подпись приложение покажет внизу слева вместо аккаунта. |
base_url | Адрес Guard для семейства Codex. Ничего к нему не добавляйте. |
env_key | Имя переменной с ключом, а не сам ключ. Ключ сохраните на шаге 3. |
wire_api | Протокол Responses, не меняйте. |
Приложение, открытое из Dock или меню Пуск, не видит ключ, заданный только в одном окне терминала. Поэтому ключ нужно сохранить постоянно.
macOS: скопируйте команду ниже кнопкой копирования, вставьте в Терминал и нажмите Return. Это одна длинная строка, не разбивайте её. На приглашении Guard API key: вставьте свой ключ и снова нажмите Return. Ключ на экране не показывается и не попадает в историю команд. Если приглашение появилось ещё раз, вставьте ключ снова. Команда допишет его строкой export GUARD_API_KEY=… в конец файла ~/.zshrc, который приложение читает при запуске.
unset GUARD_API_KEY; until [ -n "$GUARD_API_KEY" ]; do printf "Guard API key: "; read -r -s GUARD_API_KEY; printf "\n"; done; printf '\nexport GUARD_API_KEY="%s"\n' "$GUARD_API_KEY" >> ~/.zshrc; unset GUARD_API_KEY; grep -c '^export GUARD_API_KEY="gd-' ~/.zshrcВ конце команда должна напечатать 1. Если напечатала 0, ключ не сохранился: проверьте, что копируете ключ gd-… целиком, и выполните команду снова. Если напечатала 2 или больше, ключ записан несколько раз: откройте файл командой open -e ~/.zshrc, оставьте одну строку export GUARD_API_KEY=… с актуальным ключом и сохраните файл.
Если команда echo $SHELL печатает /bin/bash, а не /bin/zsh, замените в команде оба ~/.zshrc на ~/.bash_profile. Если файла ~/.bash_profile у вас нет, а ~/.profile есть, используйте ~/.profile.
Windows: в PowerShell вставьте команды и нажмите Enter. На приглашении Guard API key вставьте ключ и нажмите Enter. Ключ сохранится как переменная пользователя GUARD_API_KEY, её увидят все программы, запущенные после этого.
$guardKey = Read-Host "Guard API key" -AsSecureString
[Environment]::SetEnvironmentVariable("GUARD_API_KEY", [System.Net.NetworkCredential]::new("", $guardKey).Password, "User")
[Environment]::GetEnvironmentVariable("GUARD_API_KEY", "User").StartsWith("gd-")Последняя команда должна напечатать True. Чтобы заменить ключ, просто выполните команды снова с новым ключом.
Если в настройках приложения агент работает в WSL, повторите шаги 2 и 3 внутри WSL: файл настроек ~/.codex/config.toml и строку с ключом в ~/.profile.
- Если приложение открыто, закройте его полностью. На macOS: меню ChatGPT → Выйти из ChatGPT или
Cmd+Q. На Windows: закройте окно и проверьте, что значка приложения нет в области уведомлений. Ключ и настройки приложение читает только при запуске. - Откройте ChatGPT снова: на macOS из папки Программы, на Windows из меню Пуск.
- Входить в ChatGPT не нужно. Внизу слева вместо аккаунта появится подпись GUARD API · Codex: значит, приложение прочитало настройки Guard.
- В поле ввода справа внизу нажмите кнопку с названием модели, например 6 Astra Среднее (в английском интерфейсе 6 Astra Medium). Откроется панель: ползунок меняет уровень рассуждения, а строка со стрелкой открывает список Выбрать модель (Select model).
- В списке семь моделей: 6 Astra, 6 Sol, 6 Luna, 5.6 Sol, 5.6 Terra, 5.6 Luna и 5.5. Сам список ещё не доказывает, что ключ и адрес верны: подключение проверит первое задание на шаге 5.
- Нажмите
Cmd+Oна macOS илиCtrl+Oна Windows. То же самое есть в меню Файл → Открыть папку… (File → Open Folder…). - Выберите папку проекта и подтвердите выбор. На macOS в окне выбора можно нажать
Cmd+Shift+Gи вставить путь к папке. Папка появится слева в разделе Проекты (Projects). - В поле ввода внизу окна напишите задание, например: Прочитай список файлов в этой папке и объясни, что где лежит. Отправьте клавишей
ReturnилиEnter. Если пришёл ответ, подключение к Guard работает. - Продолжите в том же чате, например: Теперь подробнее расскажи об одном из этих файлов.
Слева внизу поля ввода выбирается режим доступа. По умолчанию стоит Запрашивать разрешение (в английском интерфейсе Ask for approval): внутри папки проекта приложение работает само, а перед изменением файлов за её пределами и выходом в интернет спрашивает. Нажимайте Разрешить один раз (Allow once) только для действий, которые вам понятны.
Расход по каждому запросу виден в личном кабинете. Кроме ваших заданий приложение делает короткие служебные запросы, например придумывает название чата моделью 5.6 Luna. Они тоже видны в кабинете и стоят доли цента.
Модель и уровень можно менять между сообщениями в меню из шага 4, новый ключ не нужен. Цены моделей в разделе Модели.
| Модель в приложении | ID для файла настроек | Уровни рассуждения |
|---|---|---|
| 6 Astra | gpt-6-astra | Лёгкий, Среднее, Высокое, Очень высокое, Макс., Ультра |
| 6 Sol | gpt-6-sol | Лёгкий, Среднее, Высокое, Очень высокое, Макс., Ультра |
| 6 Luna | gpt-6-luna | Лёгкий, Среднее, Высокое, Очень высокое, Макс. |
| 5.6 Sol | gpt-5.6-sol | Лёгкий, Среднее, Высокое, Очень высокое, Макс., Ультра |
| 5.6 Terra | gpt-5.6-terra | Лёгкий, Среднее, Высокое, Очень высокое, Макс., Ультра |
| 5.6 Luna | gpt-5.6-luna | Лёгкий, Среднее, Высокое, Очень высокое, Макс. |
| 5.5 | gpt-5.5 | Лёгкий, Среднее, Высокое, Очень высокое |
В английском интерфейсе уровни называются Light, Medium, High, Extra High, Max и Ultra.
Если в файле настроек поставить по умолчанию модель 5.5, замените вместе с ней и окно: model_context_window = 272000.
Ультра есть у 6 Astra, 6 Sol, 5.6 Sol и 5.6 Terra. На этом уровне модель рассуждает с усилием Очень высокое или Макс., в зависимости от модели, а приложение может само делить задачу между несколькими агентами. Каждый агент расходует токены отдельно, поэтому Ультра тратит баланс заметно быстрее, приложение тоже предупреждает об этом. Для обычных задач хватает уровней Среднее или Высокое.
Пока в файле настроек стоит строка model_provider = "guard-codex", все задачи приложения идут через Guard и оплачиваются с баланса ключа. То же касается Codex CLI и расширения Codex для VS Code: у них общий файл настроек.
Чтобы вернуться к подписке ChatGPT, откройте файл настроек как на шаге 2, поставьте # в начале этой строки, сохраните файл и перезапустите приложение:
# model_provider = "guard-codex"Чтобы снова работать через Guard, уберите # и перезапустите приложение. Чаты, начатые через Guard, продолжают работать через Guard, поэтому после переключения начинайте новый чат.
| Что видите | Что сделать |
|---|---|
| Приложение просит войти в ChatGPT, внизу слева нет подписи GUARD API · Codex | Приложение не прочитало файл настроек. Проверьте путь: ~/.codex/config.toml на macOS, %USERPROFILE%\.codex\config.toml на Windows. Строка model_provider = "guard-codex" должна стоять до первой строки [раздел] и не начинаться с #. После исправления полностью перезапустите приложение. |
Missing environment variable: GUARD_API_KEY | Приложение запущено без ключа. Повторите шаг 3 и полностью перезапустите приложение. Перезапуска приложения достаточно, выходить из учётной записи Windows не нужно. |
401 или invalid_api_key | Сохранён неполный или старый ключ. Повторите шаг 3 с актуальным ключом gd-…. На macOS удалите старую строку из ~/.zshrc. |
| Задание не получает ответа или приложение пишет об ошибке соединения | Проверьте, что base_url в файле настроек равен https://api.guardrelay.ai/codex/v1 без лишних символов, и полностью перезапустите приложение. |
model_not_found | Название в строке model должно точно совпадать с ID из таблицы моделей. |
402 или сообщение о балансе | На ключе не хватает средств. Пополните баланс в боте, остаток виден в личном кабинете. |
Ошибка файла настроек, например duplicate key или expected newline | В файле повтор или две строки слились в одну. Откройте файл как на шаге 2: каждая настройка должна стоять на своей строке и встречаться один раз, раздел [model_providers.guard-codex] тоже один раз. |
Если ошибка повторяется, напишите в поддержку Guard: систему, версию приложения, модель, текст ошибки и время. Ключ и файл настроек пересылать не нужно.