Codex CLI 0.171.0: GPT-6.2 Sol по умолчанию, TUI workspace и --remote
В Codex CLI 0.171.0 модель GPT-6.2 Sol стала моделью по умолчанию в каталоге, функция TUI workspace (флаг tui_workspace) включена по умолчанию, добавлены codex exec --remote <ADDR> и /rc, а профили разрешений сохраняются при смене каталога. Проверьте активный ID модели, верните GPT-6.2 Astra или подключите API через BetterToken, отключите workspace при необходимости и проверьте требования к удалённому запуску.
Содержание

После обновления до Codex CLI 0.171.0 (релиз от 20 ноября 2026 года) модель gpt-6.2-sol выбирается в каталоге по умолчанию, а двухпанельный режим TUI workspace (tui_workspace) включён по умолчанию. Изменения затрагивают разработчиков без закреплённого поля model в config.toml, команды со скриптами на codex exec и тех, кто подключает Codex к сторонним API-провайдерам. Чтобы оставить Astra, пропишите model = "gpt-6.2-astra" в config.toml, верните однопанельный терминал командой codex features disable tui_workspace или настройте доступ к GPT-6.2 по API ниже.
Как запускать GPT-6.2 Sol и Astra в Codex CLI 0.171.0
Перед изменением настроек определитесь, как Codex будет проходить авторизацию и списывать оплату за GPT-6.2. От выбранного варианта зависит список рабочих ID моделей и доступность функций подписки ChatGPT, таких как Codex cloud и удалённое управление /rc. России нет в списке поддерживаемых стран OpenAI API (на 2026-11-21). BetterToken принимает оплату в рублях и не требует зарубежной или виртуальной карты, которая обычно нужна для официальных подписок поставщиков. Его API-эндпоинт доступен из России без VPN — это относится только к самому API-эндпоинту и не распространяется на сторонние сайты, скачивание ПО, входы в аккаунты, маркетплейсы и обновления.
| Маршрут | Аккаунт, доступ и оплата | Единица тарификации | Поддержка и ограничения Codex 0.171.0 | Когда выбирать |
|---|---|---|---|---|
Подписка ChatGPT (codex login) | Аккаунт ChatGPT через вход в браузере | Лимит тарифного плана (общий для локальных сообщений и облачных чатов) | Поддерживает Codex cloud и /rc; на плане ChatGPT Pro 200 доступен режим Ultrafast с Sol | Уже есть подходящая подписка ChatGPT и нужны облачные функции или /rc |
| OpenAI API напрямую | Аккаунт OpenAI Platform и API-ключ; России нет в списке поддерживаемых стран OpenAI API (на 2026-11-21) | За 1M токенов (USD) | Работают gpt-6.2-sol и gpt-6.2-astra; облачных функций нет, /rc недоступен при входе по API-ключу | Нужен прямой биллинг OpenAI и политики хранения данных вашей API-организации |
| API-шлюз BetterToken | Аккаунт BetterToken и API-ключ; сервис принимает оплату в рублях (не требует зарубежной или виртуальной карты, обычно нужной для официальных подписок поставщиков); API-эндпоинт доступен из России без VPN (только для API-эндпоинта, не для сторонних сайтов, загрузок, входов, маркетплейсов и обновлений) | Баланс pay-as-you-go по тарифной единице модели | В каталоге есть gpt-6.2-sol и gpt-6.2-astra через OpenAI Responses (https://www.bettertoken.ai/v1); оплаченный баланс не сгорает ежемесячно | Нужен API-доступ к разным моделям с оплатой по факту использования без подписки ChatGPT |
Настройка Codex CLI 0.171.0 через BetterToken
BetterToken — мультимодельная платформа и API-шлюз с оплатой по факту использования, а не официальный продукт OpenAI. На 2026-11-21 обе модели — gpt-6.2-sol и gpt-6.2-astra — доступны на странице актуальных цен по протоколу OpenAI Responses (https://www.bettertoken.ai/v1). Подробности по совместимости собраны в обзоре Codex API.
Зарегистрируйте аккаунт BetterToken и создайте собственный API-ключ в консоли BetterToken. Конкретные способы оплаты в рублях, подходящие карты, минимальные суммы, курсы, комиссии и сроки зачисления зависят от консоли в момент платежа. Авторизация по API-ключу через файл auth.json заменяет официальный вход через ChatGPT, поэтому функции подписки вроде /rc и ChatGPT Pro 200 Ultrafast в этом режиме не работают. Чтобы сохранить официальный вход ChatGPT рядом со сторонним провайдером, используйте руководство BetterToken по сохранению официального входа вместо правки auth.json.
Полностью закройте Codex CLI и Codex App перед редактированием: оба клиента используют общие config.toml и auth.json в одном каталоге ($CODEX_HOME, если переменная задана, иначе ~/.codex на macOS/Linux или %USERPROFILE%\.codex на Windows; см. сравнение Codex CLI, Codex App и расширения для VS Code). Сделайте резервные копии config.toml и auth.json в приватном каталоге и создайте config.toml, если файла ещё нет.
В config.toml обновите существующие корневые ключи model_provider, model и cli_auth_credentials_store на месте, а недостающие добавьте до любых секций [tables]. Если таблица [model_providers.bettertoken] уже есть, объедините поля внутри неё без дублирования заголовка; иначе добавьте блок ниже, сохранив остальные настройки по руководству BetterToken по настройке Codex:
model_provider = "bettertoken"
model = "gpt-6.2-sol"
cli_auth_credentials_store = "file"
[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false
Чтобы по умолчанию запускалась Astra, замените значение model на "gpt-6.2-astra". При файловой авторизации удалите поля env_key и experimental_bearer_token из [model_providers.bettertoken].
Затем запишите auth.json в тот же каталог Codex. На macOS и Linux с Bash и Python 3 выполните скрипт ниже: он запросит ключ без вывода в терминал, прервёт работу без изменения auth.json при пустом вводе или отмене и создаст файл с правами только для владельца (0600) до записи ключа. На Windows настройте файловую авторизацию (auth_mode со значением "apikey" и OPENAI_API_KEY с вашим ключом) в активном каталоге ($CODEX_HOME или %USERPROFILE%\.codex) по руководству BetterToken по настройке Codex:
CODEX_DIR="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_DIR"
if IFS= read -rs BETTERTOKEN_API_KEY && [ -n "$BETTERTOKEN_API_KEY" ]; then
export BETTERTOKEN_API_KEY CODEX_DIR
python3 -c 'import json, os, pathlib, tempfile
dir_path = pathlib.Path(os.environ["CODEX_DIR"])
fd, tmp_name = tempfile.mkstemp(prefix=".auth.", dir=dir_path)
try:
os.fchmod(fd, 0o600)
with os.fdopen(fd, "w", encoding="utf-8") as fh:
json.dump({"auth_mode": "apikey", "OPENAI_API_KEY": os.environ["BETTERTOKEN_API_KEY"]}, fh, indent=2)
fh.write("\n")
os.replace(tmp_name, dir_path / "auth.json")
except Exception:
os.unlink(tmp_name)
raise'
unset BETTERTOKEN_API_KEY
else
echo "API key entry cancelled or empty; auth.json was not changed." >&2
fi
Если установлен Node.js и вы предпочитаете автоматическую настройку, в документации BetterToken для Codex есть скрипт curl -fsSL "https://www.bettertoken.ai/install-codex-provider.sh" | bash для macOS и Linux, а также установщик PowerShell (install-codex-provider.ps1) для Windows. Перед запуском Codex сверьте созданные config.toml и auth.json с ручной конфигурацией выше.
Для проверки откройте новую сессию codex, выполните /status, убедитесь в корректности строк Model (gpt-6.2-sol) и Model provider, затем отправьте короткий запрос. Обычный ответ модели подтверждает работу подключения Responses.
Если вы выбираете официальный маршрут OpenAI, установите или обновите CLI до 0.171.0 командой npm install -g @openai/codex@0.171.0 (или используйте уже установленную версию 0.171.0) и проверьте, что codex --version выводит 0.171.0. Затем выполните codex login для подписки ChatGPT или войдите с API-ключом OpenAI по справочнику по авторизации Codex от OpenAI. Командам, которые сравнивают лимиты подписки и оплату по API, поможет разбор общего лимита ChatGPT и Codex.
Проверка GPT-6.2 Sol по умолчанию и выбор Astra или другой модели
В PR #62106 разработчики Codex CLI 0.171.0 добавили gpt-6.2-sol и gpt-6.2-astra во встроенный каталог, а также в каталоги Amazon Bedrock и Vertex, сделав gpt-6.2-sol выбором по умолчанию (priority: 1). В том же изменении контекстное окно gpt-6.1-sol в каталоге увеличили до 500,000 токенов.
Во встроенном каталоге версии 0.171.0 (codex-rs/models-manager/models.json) для gpt-6.2-sol указано окно 500,000 токенов, а для gpt-6.2-astra — 272,000 токенов; у обеих моделей default_reasoning_level задан как "low". В документации OpenAI API на 2026-11-21 и GPT-6.2 Sol, и GPT-6.2 Astra поддерживают окно 1,050,000 токенов (922,000 на вход, 128,000 на выход) и отклоняют уровень рассуждений none.
Сменится ли активная модель после обновления, зависит от конфигурации и активного каталога (codex-rs/models-manager/src/manager.rs):
- Если поле
modelвconfig.tomlне задано,get_default_modelвыбирает модель по умолчанию из активного каталога (default_model_from_available). Во встроенном каталоге 0.171.0 этоgpt-6.2-sol. - Если поле
modelявно задано в пользовательскомconfig.toml(или в.codex/config.tomlдоверенного проекта), Codex сохраняет её. Модель заменяется, только если одновременно включён резервный выбор провайдера и заданная модель отсутствует среди доступных моделей активного каталога.
Посмотрите встроенный каталог установленного бинарного файла:
codex debug models --bundled
В интерактивной TUI-сессии вызовите /status, чтобы проверить строку Model (и Model provider, если провайдер задан). Чтобы переключить модель без правки config.toml, выполните /model в TUI или передайте --model / -m при запуске:
codex -m gpt-6.2-astra
codex exec -m gpt-6.2-astra "Audit the auth middleware for race conditions"
Чтобы закрепить gpt-6.2-astra (или более старую модель вроде gpt-6.1-sol) постоянно, обновите или добавьте model = "gpt-6.2-astra" в корне $CODEX_HOME/config.toml (по умолчанию ~/.codex/config.toml) выше всех [tables] и перезапустите Codex.
На 2026-11-21 официальные тарифы Standard API OpenAI для текстовых токенов при объёме до 272K входных токенов составляют $2 на вход и $10 на выход за 1M токенов у GPT-6.2 Sol, а у GPT-6.2 Astra — $8 на вход и $40 на выход за 1M токенов. Если запрос превышает 272K входных токенов, для обеих моделей тарифы на вход и кеш удваиваются, а выход стоит в 1.5 раза дороже короткого контекста для всего запроса. Для повседневной разработки начинайте с Sol и переходите на Astra в сложных многофайловых задачах; критерии выбора разобраны в статье GPT-6 Astra, Sol и Luna: какую модель выбрать. Режим Ultrafast с Sol — функция подписки ChatGPT Pro 200 (в OpenAI API ставка 3x от Standard для Ultrafast действует по 28 февраля 2027 года включительно), а не настройка стороннего шлюза по умолчанию.
Соответствие имён в каталоге и ID моделей у сторонних провайдеров
В списке выбора Codex показывает читаемые названия GPT-6.2-Sol и GPT-6.2-Astra, но каждый провайдер ждёт собственный идентификатор модели в запросе.
| Провайдер | ID для GPT-6.2 Sol | ID для GPT-6.2 Astra | Примечания |
|---|---|---|---|
| OpenAI API (напрямую) | gpt-6.2-sol | gpt-6.2-astra | Совпадает со слагами встроенного каталога Codex |
BetterToken (https://www.bettertoken.ai/v1) | gpt-6.2-sol | gpt-6.2-astra | Проверено в BetterToken на 2026-11-21 для OpenAI Responses (openai-response), а также типов эндпоинтов openai и anthropic |
| Amazon Bedrock | openai.gpt-6.2-sol | openai.gpt-6.2-astra | Нормализация каталога также распознаёт кросс-региональные ID Bedrock Runtime global.openai.gpt-6.2-astra и us.openai.gpt-6.2-astra |
| Google Vertex AI | gpt-6.2-sol | gpt-6.2-astra | Добавлены во встроенный каталог GCP в PR #62106 |
Другой model_provider | Задаётся провайдером | Задаётся провайдером | Укажите точный model = "..." в config.toml |
Если model не прописан в config.toml, Codex берёт модель по умолчанию из активного каталога и не угадывает схему именования вашего шлюза. Если ваш сторонний model_provider использует префиксы вендора или псевдонимы, которые не совпадают с ID из активного каталога, запросы могут завершиться ошибкой. В таком случае закрепите точный model = "...", который принимает ваш шлюз, в корне config.toml (не внутри [projects."<path>"], где хранится trust_level проекта).
TUI workspace по умолчанию: что изменилось и как отключить
PR #61352 переводит флаг tui_workspace в статус Stable со значением default_enabled: true, поэтому режим TUI workspace включён по умолчанию. Когда вы открываете поддерживаемые элементы, рядом с основным диалогом в боковой панели появляются соответствующие вкладки просмотра:
- Превью документов (PR #61888, PR #61889): переход по ссылке на файл из истории переписки открывает в боковой панели вкладку Markdown только для чтения — с поиском, выделением с клавиатуры и мыши, офлайн-копированием Markdown и переходом по ссылкам через
Tab/Shift+TabиEnter. - Превью изображений (PR #61919): открытие ссылки на файл PNG, JPEG, GIF или WebP показывает в боковой панели превью с форматом и размерами, а без поддержки графики в терминале переключается на текстовый режим. Готовые сохранённые сгенерированные изображения выводятся после ответа ассистента с кликабельной меткой
Generated image. - Стенограммы субагентов (PR #62157): выбор субагента в боковой панели открывает вкладку чтения стенограммы рядом с родительским диалогом, не перекрывая активный чат.
Закрытие вкладки зависит от того, какой виджет сейчас в фокусе:
- В превью документа нажмите
Esc, чтобы закрыть просмотр. - В просмотре стенограммы субагента клавиша
Escвозвращает к списку субагентов с тем же выбранным агентом; полностью закрыть вкладку можно кнопкой или горячей клавишей закрытия боковой панели.
Чтобы отключить TUI workspace на одну сессию, передайте флаг --disable:
codex --disable tui_workspace
Чтобы отключить tui_workspace постоянно в $CODEX_HOME/config.toml, выполните:
codex features disable tui_workspace
Или пропишите флаг вручную в $CODEX_HOME/config.toml:
[features]
tui_workspace = false
Запустите новую сессию codex, чтобы убедиться, что боковая панель рабочего пространства остаётся отключённой. Отключение tui_workspace выключает саму панель и все её вкладки превью целиком.
Удалённый запуск: codex exec --remote против /rc и /remote в TUI
В Codex CLI 0.171.0 появились два разных удалённых инструмента:
codex exec --remote <ADDR>выполняет неинтерактивный ход на уже запущенномcodex app-server./rc(псевдоним/remote) управляет удалённым доступом с устройств к локальному фоновому серверу прямо из TUI.
Синтаксис, транспорт и ограничения codex exec --remote <ADDR>
PR #61707 позволяет подключать codex exec к работающему app-server по адресам ws://host:port, wss://host:port, unix:// (Unix-сокет по умолчанию) или unix://PATH.
Локальный хост или проброс порта по SSH (loopback): открытый WebSocket-слушатель на ws://127.0.0.1:PORT подходит только для localhost или SSH-туннеля. Запустите сервер на хосте:
codex app-server --listen ws://127.0.0.1:4500
Затем выполните codex exec на той же машине (или через SSH-туннель на порт 4500):
codex exec --remote ws://127.0.0.1:4500 "Run the test suite and summarize failures"
Отдельный сервер или CI-раннер (авторизованный wss://): не-loopback WebSocket-слушатели на этапе раскатки по умолчанию принимают подключения без авторизации, а сам codex app-server слушает ws:// (см. документацию OpenAI по app-server). Перед публикацией сервера для другой машины или CI включите WebSocket-авторизацию (предпочитайте --ws-token-file передаче токена аргументом в командной строке) и поставьте перед ним TLS-прокси, чтобы клиенты подключались по wss://:
# On the app-server host (behind a TLS reverse proxy exposing wss://remote-host:4500)
codex app-server --listen ws://127.0.0.1:4500 \
--ws-auth capability-token \
--ws-token-file /absolute/path/to/app-server-token
На клиенте или CI-раннере передайте через --remote-auth-token-env имя переменной окружения с тем же bearer-токеном, который сервер читает из файла --ws-token-file (в примере ниже введите этот же токен в CODEX_REMOTE_TOKEN). В обычном выводе codex exec --remote печатает thread id: <UUID> в stderr; с флагом --json отправляет JSONL-событие thread.started ("type": "thread.started") с полем thread_id. Для продолжения ветки подставьте UUID из первого запуска:
if IFS= read -rs CODEX_REMOTE_TOKEN && [ -n "$CODEX_REMOTE_TOKEN" ]; then
export CODEX_REMOTE_TOKEN
# Start a new noninteractive turn (capture thread_id from the thread.started JSONL event)
codex exec --remote wss://remote-host:4500 \
--remote-auth-token-env CODEX_REMOTE_TOKEN \
--json "Run the test suite and summarize failures"
# Resume syntax example: replace <THREAD_UUID> with the thread_id returned above
codex exec --remote wss://remote-host:4500 \
--remote-auth-token-env CODEX_REMOTE_TOKEN \
resume <THREAD_UUID> "Fix the failing parser test"
unset CODEX_REMOTE_TOKEN
else
echo "Remote token entry cancelled or empty." >&2
fi
Флаги --remote и --remote-auth-token-env можно ставить до или после exec; если указать разные адреса в обеих позициях, команда завершится ошибкой `codex exec` received conflicting remote server endpoints. В версии 0.171.0 (codex-rs/exec/src/remote.rs) действуют три жёстких ограничения:
- Конфигурацию агента задаёт сервер: передача параметров вроде
-m/--model,-s/--sandbox,-C/--cd, переопределений-c,-i/--image,-p/--profile,--add-dir,--output-schema,--ephemeralили--worktreeвозвращает ошибку"--remote currently supports only prompt, resume by UUID, and output options; configure the agent on the server". - Возобновление только по UUID:
exec --remote resumeотклоняет--last,--all,--imageили аргумент не в формате UUID с ошибкой"remote resume requires a thread UUID". - Без параллельных ходов: обращение к ветке, в которой уже идёт активный ход, падает с ошибкой
"remote thread already has an active turn".
Команды /rc и /remote в TUI
PR #62121 добавляет команды /rc и /remote в TUI для включения и отключения удалённого управления управляемым локальным фоновым сервером. После включения меню проверяет, сохранился ли параметр remoteControlEnabled в app-server-daemon/settings.json для следующего перезапуска, и предупреждает при сбое записи; пункт Add device выводит код ручного сопряжения. Открыть /rc можно даже из облачной сессии, но изменения применяются только к локальным сессиям.
Перед использованием /rc проверьте три условия:
- Локальный фоновый сервер должен быть запущен, иначе действия завершатся ошибкой
"Remote control requires the local background server." - Нужен вход через ChatGPT: авторизация по API-ключу отклоняется с сообщением
"Sign in with ChatGPT to manage remote control." - Администраторы корпоративных аккаунтов могут заблокировать функцию параметром
allow_remote_control = falseв управляемомrequirements.toml, что даёт ошибку"Remote control is disabled by managed requirements."
Вне TUI (например, по SSH) используйте команды codex remote-control start, codex remote-control stop и codex remote-control pair из справочника CLI от OpenAI.
Профили разрешений при смене каталога и другие исправления 0.171.0
Да, в 0.171.0 активный профиль разрешений сохраняется при смене рабочего каталога. В rust-v0.170.0 обновление только каталога при перепривязываемой политике записи в корень проекта могло заново собрать устаревший профиль из legacy-политики песочницы (codex-rs/core/src/session/session.rs).
PR #61195 убирает эту ветку пересборки: активный профиль, его выбор и настроенные корни профиля остаются прежними, а рабочие корни среды выполнения обновляются на новый каталог. В регрессионной проверке PR обычные файлы в новом каталоге остаются доступными для записи, а запись в .git/config и прежний каталог по-прежнему запрещена; пользовательские именованные профили продолжают работать по собственным корням и правилам. Если вы поддерживаете строгие сетевые и файловые ограничения для установки пакетов, сверьте правила доменов и записи по материалу о профилях разрешений песочницы Codex.
Ещё три исправления rust-v0.171.0 убирают частые сбои в ежедневной работе с CLI:
- Сохранение черновиков при смене сессии (PR #61216): черновики, поставленные в очередь сообщения и прерванный ввод остаются привязанными к своим исходным веткам при переключении или возобновлении сессий.
- Корпоративный вход в MCP без refresh-токенов (PR #62129): исправлена авторизация MCP для корпоративных провайдеров идентификации, которые выдают ID-токены без refresh-токенов.
- Корректировка активного хода и подтверждения (PR #61820, PR #61801): корректировка активного хода сохраняет предыдущие правки в общих диффах, а запоздавшие события завершения больше не отменяют подтверждения для нового хода.