Расширение Codex для VS Code: возможности и свой провайдер

Расширение Codex добавляет в VS Code боковую панель с агентом OpenAI: он видит открытые файлы и выделенный код, предлагает правки и показывает их диффом. Частый вопрос: можно ли использовать это расширение со своим провайдером, а не через вход в ChatGPT. Короткий ответ: настройки провайдера лежат в config.toml, который расширение разделяет с консольным Codex, но один нюанс со входом нужно проверить на своей версии. Ниже всё по порядку.

Сведения о расширении взяты из документации OpenAI для Codex на 18 октября 2026. Интерфейс обновляется часто, названия пунктов сверяйте со своей версией.

Что умеет расширение

По документации OpenAI, расширение даёт следующее:

• Контекст редактора. В запрос можно добавить открытый файл, выделенный фрагмент или недавний чат, и Codex стартует с тем кодом, на который вы смотрите.
• Просмотр изменений. Краткая сводка и сфокусированный дифф рядом с кодом; правки можно оставить частично и уточнить в том же чате.
• Делегирование. Быстрые итерации выполняются локально, а для крупной задачи можно подключить облачного Codex (Codex web) и вернуться за результатом в тот же редактор.
• Общие настройки с CLI. Модель, уровень рассуждений, права, песочница и MCP-серверы читаются из config.toml и одинаковы для расширения и консоли.

Расширение работает не только в VS Code: ссылки на установку есть для Cursor, Windsurf и VS Code Insiders. Для Xcode и JetBrains у Codex отдельные интеграции.

Установка и первый запуск

1. Установите расширение с идентификатором openai.chatgpt (в Marketplace оно называется Codex) в VS Code, Cursor или Windsurf.
2. Нажмите значок Codex на боковой панели. Если значка нет, откройте палитру команд и выполните Codex: Open Codex Sidebar.
3. На экране входа выберите способ авторизации. Для работы с ключом предусмотрен вариант с API-ключом (на экране он называется «Use API Key»).
4. Откройте проект и задайте небольшую задачу: объяснить код или внести точечную правку.

Перед правками полезно создать git-коммит: документация сама советует ставить такие контрольные точки до и после задачи.

Как подключить свой провайдер

Настройки агента читаются из ~/.codex/config.toml. Открыть файл можно прямо из расширения: шестерёнка в верхнем углу панели, затем Codex Settings, затем Open config.toml. Расширение и CLI используют одни и те же слои конфигурации, в том числе провайдера по умолчанию.

Пропишите шлюз Zukko:

model = "gpt-6.1-sol"
model_provider = "zukko"

[model_providers.zukko]
name = "zukko"
base_url = "https://api.zukko.pro/v1"
env_key = "ZUKKO_API_KEY"
wire_api = "responses"

Здесь base_url содержит /v1, а wire_api = "responses" по документации OpenAI единственное поддерживаемое значение: Codex общается через Responses API, который шлюз принимает на POST /v1/responses. По данным документации Zukko, в Codex работают модели GPT и Claude, а GLM нет.

Ключ fetch_... создаётся в кабинете↗. Дальше два способа передать его.

Способ A: переменная окружения (env_key). Задайте ZUKKO_API_KEY на уровне пользователя и полностью перезапустите VS Code. Важная деталь: редактор должен получить эту переменную при запуске. Если вы поставили её в профиль оболочки, а запускаете VS Code из меню, процесс может её не увидеть. Надёжнее запускать редактор из терминала (code .) или задать переменную системно.

Способ B: файл auth.json. Этот способ описан в документации Zukko по Codex↗: в config.toml указывают requires_openai_auth = true, а ключ кладут в ~/.codex/auth.json как { "OPENAI_API_KEY": "fetch_..." }. Минус: тот же файл использует и вход в аккаунт, поэтому последующий вход через ChatGPT перезапишет ключ.

Расширение читает config.toml из каталога .codex в домашней папке. Если работаете в Windows с WSL, учтите, что у Windows и WSL разные домашние каталоги и, значит, разные файлы конфигурации.

Что нужно проверить на своей версии

Честно о неочевидном. Документация OpenAI сообщает, что в расширении, настольном приложении и CLI поддерживаются оба способа входа, ChatGPT и API-ключ. Что именно покажет экран входа, когда провайдер уже задан в config.toml, из документации однозначно не следует, и может отличаться между версиями. Если расширение просит войти, выберите вариант с API-ключом и вставьте ключ Zukko, а затем убедитесь по счёту расходов в кабинете, что запросы идут именно через шлюз. Если у вас получилось иначе, сверьтесь с актуальной документацией расширения.

Ограничения, о которых стоит знать заранее:

• облачный Codex (Codex web) и задачи, которые делегируются из расширения в облако, по документации OpenAI требуют входа через ChatGPT; с API-ключом они недоступны;
• функции, привязанные к рабочему пространству ChatGPT, при входе по ключу ограничены или недоступны;
• настройки расширения с префиксом chatgpt.* задаются в настройках редактора, а не в config.toml.

Сколько стоит работа

С шлюзом вы платите за токены, подписка не нужна. Прикинем сессию в редакторе: 20 запросов, в среднем 15 000 входных токенов (открытые файлы и история) и 700 выходных. Вход 20 × 15 000 = 300 000, выход 20 × 700 = 14 000 токенов. Цены на 18 октября 2026 за 1M токенов, без учёта кэша; объёмы ниже в миллионах токенов.

• gpt-6.1-sol (вход $0.27, выход $1.32): 0.3 × 0.27 + 0.014 × 1.32 = 0.081 + 0.01848 ≈ $0.0995.
• claude-sonnet-5-5 (вход $0.4, выход $2): 0.3 × 0.4 + 0.014 × 2 = 0.12 + 0.028 = $0.148.

У GPT-моделей шлюз видит чтение кэша (prompt_tokens_details.cached_tokens), и оно тарифицируется по цене чтения из таблицы; запись в кэш у GPT отдельно не списывается. Какая модель лучше справится с вашим кодом, проверьте сами, сравнив результат и цену. Индекс силы Artificial Analysis у gpt-6.1-sol 52, у claude-sonnet-5-5 48, но это не гарантия на конкретной задаче.

Следить за тратами помогает дневной и месячный лимит на ключ в кабинете. Текущие цены смотрите в GET https://api.zukko.pro/v1/models. Пополнить баланс можно через СБП (платёжная страница добавляет комиссию 8,5% сверху), криптовалютой или картой MasterCard.

Расширение или другие варианты

Если вам не подходит агент OpenAI в панели, в VS Code есть и другие расширения, которые подключаются к шлюзу напрямую, например Cline и Kilo Code (расширение Roo Code, по сообщению в его документации, закрыто 15 мая 2026 года). Их настройка описана в документации по расширениям VS Code↗. Консольный вариант Codex и его отличия от Claude Code разобраны в статье Codex или Claude Code↗.

Частые вопросы

Работает ли расширение Codex без подписки ChatGPT?

Документация OpenAI допускает вход по API-ключу. Схема с собственным провайдером подробно разобрана выше, а в статье Codex без подписки ChatGPT↗ описан консольный вариант.

Один конфиг для расширения и для консоли?

Да, документация OpenAI называет слои конфигурации общими для CLI и расширения. Изменив config.toml, вы меняете поведение обоих.

Почему расширение не видит переменную окружения?

Процесс редактора получил окружение до того, как вы её задали, либо его запустили из меню, а не из терминала. Задайте переменную системно и полностью закройте VS Code, затем откройте снова.

Расширение молчит или не отвечает, что делать?

Для Windows документация называет возможную причину: в системе нет инструментов C++ (Visual Studio Build Tools с C++ и Microsoft Visual C++ Redistributable). Установите их и полностью перезапустите VS Code.

Чтобы попробовать, создайте ключ в кабинете Zukko, пропишите провайдера в config.toml и откройте панель Codex.