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: GPT-6.2 Sol по умолчанию, TUI workspace и --remote

После обновления до 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.

Создать аккаунт BetterToken

Проверка 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 SolID для GPT-6.2 AstraПримечания
OpenAI API (напрямую)gpt-6.2-solgpt-6.2-astraСовпадает со слагами встроенного каталога Codex
BetterToken (https://www.bettertoken.ai/v1)gpt-6.2-solgpt-6.2-astraПроверено в BetterToken на 2026-11-21 для OpenAI Responses (openai-response), а также типов эндпоинтов openai и anthropic
Amazon Bedrockopenai.gpt-6.2-solopenai.gpt-6.2-astraНормализация каталога также распознаёт кросс-региональные ID Bedrock Runtime global.openai.gpt-6.2-astra и us.openai.gpt-6.2-astra
Google Vertex AIgpt-6.2-solgpt-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) действуют три жёстких ограничения:

  1. Конфигурацию агента задаёт сервер: передача параметров вроде -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".
  2. Возобновление только по UUID: exec --remote resume отклоняет --last, --all, --image или аргумент не в формате UUID с ошибкой "remote resume requires a thread UUID".
  3. Без параллельных ходов: обращение к ветке, в которой уже идёт активный ход, падает с ошибкой "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): корректировка активного хода сохраняет предыдущие правки в общих диффах, а запоздавшие события завершения больше не отменяют подтверждения для нового хода.

Готовы оптимизировать LLM workflow?

Подключите единый API, управляйте ключами и контролируйте расходы на AI-модели в BetterToken.

Начать бесплатно