Codex в Windows

Установка Codex, подключение claud.sale и первый запрос в PowerShell. Настройка ключа, моделей и восстановление конфигурации.

Codex работает в терминале PowerShell и помогает разбирать, менять и проверять код. Здесь подключаем его к claud.sale через ваш GPT-ключ. Для интерфейса рядом с редактором есть отдельная инструкция VS Code.

Что понадобится

• Windows 11 и PowerShell. Актуальная Windows 10 поддерживается OpenAI в режиме best effort; старые сборки могут не работать.
• Доступ к интернету и отдельный ключ claud.sale для группы codex_pro с доступным балансом. Создайте его в разделе API-ключей, баланс проверьте в кабинете. Claude-ключ для этой инструкции не подходит.
• Папка проекта. Git и инструменты языка устанавливаются отдельно, если они нужны вашему проекту.

Для самостоятельного установщика Codex не нужны Node.js и npm. Native-режим работает без WSL. Если вы уже разрабатываете внутри WSL, используйте инструкцию для Linux в терминале WSL.

1. Установите официальный Codex

Откройте PowerShell обычного пользователя. Команда скачает официальный установщик OpenAI во временный файл и запустит его:

$ErrorActionPreference = 'Stop'
$codexInstaller = Join-Path ([IO.Path]::GetTempPath()) ('codex-install-' + [guid]::NewGuid() + '.ps1')
Invoke-WebRequest -UseBasicParsing 'https://chatgpt.com/codex/install.ps1' -OutFile $codexInstaller
powershell -NoProfile -ExecutionPolicy Bypass -File $codexInstaller
Remove-Item $codexInstaller

Закройте PowerShell, откройте новое окно и проверьте:

codex --version

Если Codex уже установлен через npm, продолжайте использовать этот способ обновления: npm.cmd install -g @openai/codex@latest. Не устанавливайте несколько копий без необходимости.

2. Подключите claud.sale

Замените api_key в команде на свой GPT-ключ группы codex_pro и выполните блок целиком. Ключ передаётся настройщику через CLAUDSALE_API_KEY; повторно вводить его не потребуется. Можно войти и скопировать команду с ключом на главной и скопировать готовую команду.

$env:CLAUDSALE_API_KEY='api_key'; powershell -NoProfile -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12; iex (irm 'https://claud.sale/iw' -ErrorAction Stop)"

После успешной настройки полностью закройте терминал и откройте новый. Это нужно, чтобы процесс увидел сохранённую переменную с ключом. Старый адрес /iw остаётся совместимым алиасом этого настройщика.

3. Проверьте первый ответ

Убедитесь, что новый PowerShell видит ключ. Его значение эта команда не показывает:

if ($env:CLAUDSALE_API_KEY) { 'Ключ загружен' } else { 'Ключ не найден' }
codex -m gpt-5.6-sol

Для первой проверки выберите папку проекта, откройте /status и отправьте: «Ответь одним словом OK, не меняй файлы и не запускай команды». Должен прийти текстовый ответ; соответствующая запись появится в истории использования claud.sale. Такая проба расходует токены.

Настройка с env_key использует ключ claud.sale. Вход в подписку ChatGPT для этого подключения не требуется. Команда codex login status сама по себе не проверяет доступность нашего API.

4. Выберите модель

Настройщик выбирает gpt-5.6-sol. Для разового запуска другой модели:

codex -m gpt-6-astra

Используйте точное имя из каталога вашего GPT-ключа. Его можно прочитать без генерации ответа:

$modelHeaders = @{ Authorization = 'Bearer ' + $env:CLAUDSALE_API_KEY }
(Invoke-RestMethod 'https://claud.sale/v1/models' -Headers $modelHeaders).data.id
Remove-Variable modelHeaders

Наличие имени в каталоге показывает доступные маршруты, но не гарантирует мгновенную свободную ёмкость. В активном Codex меню /model переключает модель; если нужного имени там нет, запустите новую сессию с -m. Не включайте максимальное рассуждение для первой проверки скорости.

Ручная настройка и существующий config.toml

Пользовательский файл обычно расположен в %USERPROFILE%\.codex\config.toml. Если вы сами задали CODEX_HOME, используется папка из этой переменной. Сначала сделайте копию:

$codexConfigDir = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE '.codex' }
New-Item -ItemType Directory -Force $codexConfigDir | Out-Null
$codexConfigFile = Join-Path $codexConfigDir 'config.toml'
if (Test-Path $codexConfigFile) {
    Copy-Item $codexConfigFile ($codexConfigFile + '.before-claudsale-' + (Get-Date -Format 'yyyyMMdd-HHmmss'))
}
notepad $codexConfigFile

Обновите model и model_provider в начале файла, до первого заголовка [...]. Добавьте блок провайдера один раз. Не стирайте остальные настройки проекта и MCP:

model = "gpt-5.6-sol"
model_provider = "claudsale"

[model_providers.claudsale]
name = "claud.sale"
base_url = "https://claud.sale/v1"
wire_api = "responses"
env_key = "CLAUDSALE_API_KEY"
requires_openai_auth = false

Если не используете настройщик, введите ключ скрыто и сохраните его в пользовательской переменной Windows:

$claudSecret = Read-Host 'GPT API-ключ claud.sale' -AsSecureString
$claudCredential = New-Object System.Net.NetworkCredential('', $claudSecret)
$env:CLAUDSALE_API_KEY = $claudCredential.Password
[Environment]::SetEnvironmentVariable('CLAUDSALE_API_KEY', $env:CLAUDSALE_API_KEY, 'User')
Remove-Variable claudCredential, claudSecret

Переменная пользователя хранит ключ локально в профиле Windows. Не добавляйте его в репозиторий. Для VS Code после изменения потребуется полное завершение и новый запуск редактора.

Обновление и отмена настройки

Чтобы обновить standalone-версию Codex, повторите шаг официальной установки и снова проверьте codex --version. Обновление CLI и повторная настройка claud.sale — отдельные действия.

Чтобы вернуть конфигурацию из последней копии настройщика:

$ErrorActionPreference = 'Stop'
$claudRestore = Join-Path ([IO.Path]::GetTempPath()) ('claudsale-codex-' + [guid]::NewGuid() + '.ps1')
Invoke-WebRequest -UseBasicParsing 'https://claud.sale/install/codex.ps1' -OutFile $claudRestore
powershell -NoProfile -ExecutionPolicy Bypass -File $claudRestore -Restore

Перед восстановлением скрипт сохраняет текущее состояние в отдельную копию. После восстановления перезапустите терминал и VS Code. Для ручной настройки верните свой config.toml.before-claudsale-...; удаление переменной потребуется отдельно, если она больше нигде не используется.

Установка через npm удаляется командой npm.cmd uninstall -g @openai/codex. Для standalone-версии сначала найдите установленный файл через Get-Command codex -All и следуйте инструкции официального установщика. Папка .codex содержит настройки и историю: удалять её для отключения нашего провайдера не нужно.

Если не заработало

Подробный разбор: ошибки подключения. Стоимость и кэш: тарифы.

Официальные источники

Проверено 9 сентября 2026 года: установка Codex CLI, Codex в Windows, внешние провайдеры, авторизация провайдера.