Codex в VS Code

Официальное расширение Codex: подключение в Windows, Linux и WSL, выбор модели и проверка настроек.

Codex можно открыть прямо рядом с кодом в VS Code. Расширение использует config.toml, как CLI, но окружение самого редактора нужно проверить отдельно.

Перед установкой

Нужны актуальный VS Code, GPT-ключ claud.sale группы codex_pro с доступным балансом и папка проекта. Для первого подключения пройдите настройку и проверку CLI для своей системы: Windows или Linux / WSL. Это позволит отдельно проверить ключ и API.

1. Установите официальное расширение

В VS Code откройте Extensions клавишами Ctrl + Shift + X, найдите Codex от издателя OpenAI. Точный идентификатор расширения — openai.chatgpt. Если команда code доступна в терминале, можно установить так:

code --install-extension openai.chatgpt

Официальная страница OpenAI содержит ссылку на установку расширения. После установки откройте значок Codex на боковой панели или команду Codex: Open Codex Sidebar через Ctrl + Shift + P.

2. Проверьте общий конфиг

В боковой панели Codex откройте шестерёнку → Codex Settings → Open config.toml. После нашего настройщика там должен быть провайдер claudsale:

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

Это фрагмент для config.toml, а не для VS Code settings.json. Если нужные строки уже есть, не добавляйте их повторно. Для ручного изменения предварительно сохраните копию файла; порядок и команды есть в инструкции вашей ОС.

3. Передайте ключ процессу VS Code

Windows

Полностью закройте все окна VS Code после настройки. Откройте новый PowerShell, убедитесь в наличии переменной и запустите редактор из папки проекта:

if ($env:CLAUDSALE_API_KEY) { 'Ключ загружен' } else { 'Ключ не найден' }
code .

Новая вкладка терминала внутри старого окна VS Code не обновляет окружение всего приложения. Если ключ не найден, выполните шаг подключения в Windows-инструкции, затем перезапустите редактор полностью.

Linux

Полностью завершите VS Code. В Bash загрузите окружение и запустите редактор:

. "${CODEX_HOME:-$HOME/.codex}/claudsale.env"
code .

Запуск из меню рабочего стола может получить другое окружение.

WSL и удалённая разработка

Windows и WSL имеют отдельные домашние папки и переменные. Если агент запускается внутри WSL, выполните Linux-настройку в этом дистрибутиве. В параметрах расширения Windows есть chatgpt.runCodexInWindowsSubsystemForLinux; включайте его для работы агента в WSL, а не как способ исправить любой сетевой сбой.

В удалённом окне проверяйте окружение именно там, где запущен агент. Если VS Code Server уже работал до изменения ключа, переподключите удалённое окно с перезапуском сервера. Один только экспорт переменной в старом встроенном терминале не меняет окружение уже запущенного расширения.

4. Отправьте короткую проверку

1. Откройте папку проекта и новую локальную беседу Codex.
2. Проверьте модель gpt-5.6-sol и выбранный конфиг провайдера.
3. Отправьте: «Ответь одним словом OK, не меняй файлы и не запускай команды».
4. Убедитесь, что текст пришёл, а в истории использования claud.sale появилась запись с нужной моделью.

История запросов в кабинете подтверждает, что обращение прошло через claud.sale. Успешный вход в ChatGPT или ответ другого подключённого провайдера не проверяет эту настройку.

Выбор модели

В новой беседе используйте меню модели. Для постоянного выбора замените верхнюю строку конфига на model = "gpt-6-astra" и начните новую беседу. Доступные имена проверяются каталогом вашего ключа; команды есть в Windows и Linux.

Если расширение не показывает имя из каталога после перезапуска, сначала проверьте его в CLI командой codex -m gpt-6-astra. Список интерфейса и каталог шлюза могут различаться; не выбирайте похожее имя наугад.

Обновление и отмена

Обновляйте Codex в разделе Extensions → Updates VS Code. У расширения есть встроенный агент, поэтому обновление отдельного npm-пакета CLI не заменяет обновление расширения. Параметр chatgpt.cliExecutable предназначен для разработки Codex; для обычной установки оставьте его пустым.

Чтобы отключить claud.sale, восстановите конфигурацию через -Restore в Windows или --restore в Linux по инструкции настройки. Полностью перезапустите VS Code. Для удаления только интерфейса используйте Uninstall у расширения; это не удаляет ключи и пользовательский config.toml.

Если CLI работает, а VS Code — нет

• Ключ не найден: завершите все процессы редактора и запустите code . из терминала, где ключ уже загружен.
• Другой провайдер или модель: проверьте активный config.toml, проектный .codex/config.toml, выбранный профиль и переопределённый CODEX_HOME.
• Есть только вход в ChatGPT: обновите расширение и проверьте, что оно видит конфиг с model_provider = "claudsale". Не отправляйте ключ claud.sale в форму входа OpenAI для проверки.
• Панель не открывается: проверьте, что расширение включено в текущем окне и установлено в нужном окружении. Посмотрите Output → Codex и диагностику Windows sandbox.
• Ошибка API: сохраните время, модель и request ID; проверьте общую диагностику. Перед отправкой логов уберите ключи и содержимое частного проекта.

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

Проверено 9 сентября 2026 года: Codex IDE extension, настройки расширения, общая конфигурация CLI и IDE, работа в WSL.