PurpleSchool — курсы программирования онлайн
  • Пути
    • Frontend React разработчик
    • Frontend Vue разработчик
    • Backend разработчик Node.js
    • Fullstack разработчик React / Node.js
    • Mobile разработчик React Native
    • Backend разработчик Golang
    • Devops инженер
    • Backend разработчик Python
  • Подписка
  • AI для кодаНовое
  • О нас
    • Отзывы
    • Реферальная программа
    • О компании
    • Контакты
  • Иконка открытия меню
    • PurpleFlow
    • Сообщество
    • PurpleПлюс
    • AI Собеседование
    • AI тренажёр
    • Проекты
PurpleSchool — платформа бесплатных roadmap и курсов для разработчиков
ютуб иконка
Telegram иконка
VK иконка
VK иконка
Курсы
ГлавнаяКаталог курсовFrontendBackendFullstack
Практика
КарьераПроектыPurpleПлюсPurpleMax
Материалы
БлогБаза знаний
Документы
Договор офертаПолитика конфиденциальностиПроверка сертификатаМиграция курсовРеферальная программа
Реквизиты
ИП Ларичев Антон АндреевичИНН 773373765379contact@purpleschool.ru

PurpleSchool © 2020 -2026 Все права защищены

  • Курсы
    • FrontendИконка стрелки
    • AI разработкаИконка стрелки
    • BackendИконка стрелки
    • DevOpsИконка стрелки
    • MobileИконка стрелки
    • ТестированиеИконка стрелки
    • Soft-skillsИконка стрелки
    • ДизайнИконка стрелки
    Иконка слояПерейти в каталог курсов
  • Бесплатно
    • Курсы
    • JavaScript Основы разработкиPython Основы PythonCSS CSS FlexboxКарта развитияВопросы для собеседований
    • База знанийИконка стрелки
    • Новостные рассылкиИконка стрелки
  • PurpleSchool — курсы программирования онлайн
    • Подписка
    • AI для кодаНовое
    • Сообщество
    Главная
    Сообщество
    Codex не работает: частые ошибки и решения

    Codex не работает: частые ошибки и решения

    Аватар автора Codex не работает: частые ошибки и решения

    Антон Ларичев

    Иконка календаря23 октября 2026
    AI-инструментыapiразработкаjuniorИконка уровня junior
    Картинка поста Codex не работает: частые ошибки и решения

    Codex не работает: частые ошибки и решения

    Чаще всего Codex не работает по одной из четырёх причин: команда codex не находится в системе, Codex пытается войти в аккаунт OpenAI, который из России недоступен, неправильно настроен провайдер в ~/.codex/config.toml или песочница не даёт командам выйти в сеть. Ниже — ошибки по симптомам: что вы видите, почему это происходит и что исправить. В конце — как включить подробный лог, если ни один пункт не подошёл.

    Если вы ещё не настраивали Codex, начните с инструкции Codex в России: как установить и настроить без VPN: большинство ошибок ниже — это отступления от неё.

    Команда codex не найдена

    Что видите: command not found: codex на macOS и Linux или «codex не распознано как имя командлета» в PowerShell.

    Почему: Codex не установлен или папка с ним не попала в PATH.

    Что делать. Проверьте установку:

    codex --version

    Если команды нет, установите Codex через npm:

    npm install -g @openai/codex

    Если после установки команда всё равно не находится, папка глобальных пакетов npm не в PATH. Узнайте её командой npm config get prefix, добавьте в PATH и откройте новый терминал. На Windows это самая частая проблема — пошаговый разбор в статье Как установить Codex на Windows в России.

    У Codex есть и отдельный установщик, который скачивается с chatgpt.com. Если из России скачивание не проходит, ставьте через npm — это тот же Codex.

    Ошибка региона или неподдерживаемой страны при входе

    Что видите: при запуске открывается вход через ChatGPT, а дальше — ошибка о неподдерживаемой стране или регионе.

    Почему: Codex по умолчанию входит через аккаунт OpenAI, а OpenAI не поддерживает Россию.

    Что делать: не входить в OpenAI вовсе, а подключить Codex к своему провайдеру с ключом из переменной окружения. Тогда вход не нужен. Как это устроено — в статье Как войти в Codex из России.

    Codex просит войти, хотя провайдер настроен

    Что видите: вы прописали провайдера в config.toml, но Codex всё равно открывает экран входа или запросы идут в OpenAI.

    Почему: Codex не применил вашего провайдера. Причин три.

    1. model_provider не совпадает с именем секции. В строке model_provider = "purpleschool" и в заголовке [model_providers.purpleschool] должно стоять одно и то же имя.
    2. Провайдер назван зарезервированным именем. Имена openai, ollama и lmstudio заняты встроенными провайдерами, переопределить их нельзя. Назовите своего иначе, например purpleschool.
    3. Строки model и model_provider стоят не в том месте файла. Это ловушка формата TOML: всё, что написано после заголовка [model_providers.purpleschool], относится к этой секции. Если model = "..." оказалась ниже заголовка, Codex её не увидит как общую настройку.

    Правильный порядок — общие строки вверху файла, секции ниже:

    model = "gpt-6-sol"
    model_provider = "purpleschool"
    
    [model_providers.purpleschool]
    name = "PurpleSchool OpenAI Proxy"
    base_url = "https://app.purpleschool.ru/api-v2/public/ai-proxy/openai/v1"
    env_key = "PURPLESCHOOL_API_KEY"
    wire_api = "responses"
    supports_websockets = false

    Если раньше вы входили через ChatGPT и хотите окончательно перейти на провайдера, удалите сохранённый вход командой codex logout.

    Codex не находит ключ

    Что видите: сообщение о том, что не задана переменная окружения с ключом.

    Почему: Codex читает ключ из переменной, имя которой указано в env_key. Если в текущем терминале переменной нет, ключа тоже нет.

    Что делать. Проверьте переменную в том же терминале, где запускаете Codex:

    echo $PURPLESCHOOL_API_KEY

    В PowerShell — echo $env:PURPLESCHOOL_API_KEY. Пустой вывод значит, что переменная задана в другом файле оболочки или терминал открыт раньше, чем вы её добавили. Откройте новый терминал или выполните source ~/.zshrc. Как работают переменные окружения и почему уже запущенные программы не видят новые значения — в статье про переменные окружения в Bash.

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

    Ошибка 401: ключ не принят

    Что видите: ответ 401 Unauthorized.

    Почему: провайдер не принял ключ. Обычно это одна из трёх вещей:

    • ключ скопирован с ошибкой или с лишним пробелом;
    • ключ отключён в личном кабинете;
    • в env_key вписан сам ключ, а не имя переменной. Правильно — env_key = "PURPLESCHOOL_API_KEY", а значение ключа лежит в переменной окружения.

    Ошибка 404 или модель не найдена

    Что видите: 404 Not Found на каждый запрос или сообщение, что модель не существует.

    Почему и что делать:

    • В base_url нет /v1 в конце. Адрес должен заканчиваться на .../ai-proxy/openai/v1. Без /v1 прокси отвечает 404.
    • Неправильный wire_api. Codex общается с провайдером по протоколу Responses API, поэтому нужно wire_api = "responses". С другим протоколом запросы уходят на путь, которого у провайдера нет.
    • Опечатка в имени модели. Сверьте значение model с инструкцией на странице AI для кода. Имена моделей OpenAI пишутся через дефис и точку: gpt-6-sol, gpt-5.6-terra.

    Codex перестал отвечать, хотя всё работало

    Что видите: конфиг не менялся, вчера всё работало, сегодня ответов нет или приходит ошибка о нехватке баланса.

    Почему: конфиг сам не ломается — меняется что-то вокруг. Проверьте по порядку:

    1. Баланс. Когда токены месяца закончились, доступ к API приостанавливается. Посмотрите остаток в личном кабинете: можно дождаться обновления лимита, сменить тариф или докупить пакет.
    2. Обновление Codex. Начиная с версии 0.134.0 Codex больше не читает профили из секций [profiles.имя] в config.toml и не поддерживает строку profile = "имя". Если вы пользовались профилями, перенесите их настройки в отдельные файлы ~/.codex/имя.config.toml, а старые секции удалите.
    3. Ключ. Его могли отключить в кабинете или пересоздать.

    Ответ обрывается или зависает

    Что видите: длинный ответ останавливается на середине, Codex долго ничего не пишет, а потом сообщает об ошибке соединения.

    Почему: соединение с провайдером оборвалось или ответ шёл дольше, чем Codex готов ждать.

    Что делать. Сначала проверьте, не включён ли системный VPN или корпоративный прокси: с провайдером, доступным из России, они только добавляют точек отказа. Если обрывы повторяются, добавьте в секцию провайдера повторные попытки и увеличьте время ожидания:

    [model_providers.purpleschool]
    # ...остальные строки секции без изменений
    request_max_retries = 4
    stream_max_retries = 10
    stream_idle_timeout_ms = 300000

    request_max_retries — сколько раз повторять неудавшийся запрос, stream_max_retries — сколько раз переподключаться при обрыве потока ответа, stream_idle_timeout_ms — сколько миллисекунд ждать следующего фрагмента ответа, здесь пять минут.

    Команды внутри Codex не работают

    Что видите: агент пытается выполнить npm install, pip install или git push, а команда падает с сетевой ошибкой. Или на Linux Codex сообщает, что не может запустить песочницу.

    Почему: Codex выполняет команды в песочнице. В режиме по умолчанию агент может менять файлы проекта, но исходящая сеть для команд выключена. На Linux и в WSL2 для песочницы нужна утилита bubblewrap.

    Что делать. Если сеть нужна для одной сессии, включите её при запуске:

    codex --config sandbox_workspace_write.network_access=true

    Постоянно — в config.toml:

    [sandbox_workspace_write]
    network_access = true

    Включайте сеть осознанно: так агент сможет скачивать пакеты и обращаться к внешним сервисам без отдельного подтверждения.

    На Ubuntu и Debian bubblewrap ставится так:

    sudo apt install bubblewrap

    Не удалось загрузить настройки рабочей области или организации

    Что видите: такое сообщение в приложении Codex, новый чат не запускается или приложение не открывается.

    Почему: приложение не получило настройки аккаунта с серверов OpenAI. Официальной причины и общего решения на 2 ноября 2026 года мы не нашли. В разборах пользователей встречаются ответы 401 и 403 в логах приложения.

    Что делать. Обновите приложение, выйдите из аккаунта и войдите снова. Если не помогло, работайте через консольный Codex. Из России консольному Codex не нужен аккаунт OpenAI, если настроен свой провайдер: инструкция — в статье Как войти в Codex из России.

    Как включить подробный лог

    Если ни один пункт не подошёл, посмотрите, что именно происходит. Codex пишет подробный лог, если задать уровень и папку:

    RUST_LOG=debug codex -c log_dir=./.codex-log

    В соседнем терминале следите за файлом:

    tail -F ./.codex-log/codex-tui.log

    В логе видно, на какой адрес уходит запрос, какой провайдер выбран и какой код ответа вернулся. Обычно этого хватает, чтобы понять, какой из пунктов выше ваш. Не публикуйте лог целиком: в нём могут оказаться пути проекта и фрагменты кода.

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

    Почему Codex не работает в России без VPN? Штатно Codex ходит к серверам OpenAI и входит через аккаунт OpenAI, а Россия не входит в список поддерживаемых стран. Без VPN он работает через своего провайдера — например, с ключом AI для кода от PurpleSchool с оплатой в рублях.

    Где лежит конфиг Codex? В ~/.codex/config.toml, на Windows — в %USERPROFILE%\.codex\config.toml. Папку можно переопределить переменной CODEX_HOME.

    Codex работает в терминале, но не в VS Code. Что делать? Расширение использует тот же Codex CLI и тот же config.toml, но берёт переменные окружения у редактора. Закройте VS Code полностью и откройте из терминала, где задан ключ.

    Как обновить Codex? Той же командой, которой устанавливали: npm install -g @openai/codex.

    Итог

    Почти все поломки Codex сводятся к четырём местам: PATH, вход в аккаунт OpenAI, секция провайдера в config.toml и песочница. Проверяйте их в этом порядке, а если не помогло — включите лог через RUST_LOG=debug. Если Codex нужен из России без VPN и зарубежной карты, подключите его к AI для кода от PurpleSchool: один ключ, оплата в рублях, вход в OpenAI не нужен.

    Иконка глаза1 407

    Комментарии

    0
    Бесплатный курс

    Учитесь программировать с AI-агентом — бесплатно

    Курс «AI в обучении: OpenCode и skills»: поставите агента и разберёте с ним любую тему — как эту статью.

    opencode

    >объясни этот код и дай задачу

    ◆Читаю src/server.ts…

    ✓Разбор готов: 4 шага

    ✓Задача → practice/01.md

    • Установка и настройка OpenCode
    • Агент и skills на практике
    • 13 уроков, 3 модуля
    Начать бесплатно

    0 ₽ · доступ сразу после регистрации

    Бесплатные лекции

    Лучшие курсы по теме

    изображение курса

    Vue 3 и Pinia

    Антон Ларичев
    AI-тренажерыAI-тренажеры
    Практика в студииПрактика в студии
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.8
    3 999 ₽ 6 990 ₽
    Подробнее
    изображение курса

    Nuxt

    Антон Ларичев
    AI-тренажерыAI-тренажеры
    Практика в студииПрактика в студии
    Гарантия
    Бонусы
    иконка звёздочки рейтинга5.0
    3 999 ₽ 6 990 ₽
    Подробнее
    изображение курса

    Feature-Sliced Design

    Антон Ларичев
    AI-тренажерыAI-тренажеры
    Практика в студииПрактика в студии
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.6
    3 999 ₽ 6 990 ₽
    Подробнее

    Похожие статьи

    Картинка поста Как установить OpenCode на Windows
    Иконка аватараАнтон
    Иконка календаря06 ноября 2026
    AI-инструментыapiразработкаjuniorИконка уровня junior

    Как установить OpenCode на Windows

    Как установить OpenCode на Windows через npm, Chocolatey, Scoop или WSL, задать ключ в PowerShell, подключить модель из России и исправить частые ошибки.

    Иконка чипа0
    Иконка глаза1 751
    Иконка комментариев0
    Картинка поста OpenCode: пользовательские провайдеры недоступны — что делать
    Иконка аватараАнтон
    Иконка календаря26 октября 2026
    AI-инструментыapiразработкаjuniorИконка уровня junior

    OpenCode: пользовательские провайдеры недоступны — что делать

    Ошибка «Пользовательские провайдеры недоступны на этом сервере» (в английском интерфейсе — «Custom providers are unavailable on this server») появляется в OpenCode Desktop и веб-интерфейсе OpenCode, когда вы сохраняете своего провайдера через «Настройки → Провайдеры → Пользовательский провайдер». Это ошибка самого OpenCode, а не вашего ключа, сервера или региона: в версиях 2.0.x форма сохранения не подключена к серверу и выдаёт эту ошибку при любых введённых данных. VPN и смена ключа не помогут. Решение — описать провайдера в файле `opencode.json`: так он работает и в Desktop, и в терминальной версии. Ниже — что именно сломано, готовые конфиги для Claude, GPT и Qwen и что делать, если модели не появились.

    Иконка чипа0
    Иконка глаза2 051
    Иконка комментариев0
    Картинка поста Qwen 3.8 Max для кода: как подключить из России
    Иконка аватараАнтон
    Иконка календаря24 октября 2026
    AI-инструментыapiразработкаjuniorИконка уровня junior

    Qwen 3.8 Max для кода: как подключить из России

    Qwen 3.8 Max — флагманская модель Alibaba с контекстом в 1 млн токенов и ответом до 131 тыс. токенов, которую Alibaba позиционирует прежде всего для программирования. Работать с ней из России проще всего в Qwen Code или OpenCode через ключ AI для кода от PurpleSchool: оплата в рублях, без VPN и без аккаунта Alibaba Cloud. Модель подключается по протоколу OpenAI Responses API — ниже готовые конфиги для обоих клиентов, характеристики модели и частые ошибки.

    Иконка чипа0
    Иконка глаза792
    Иконка комментариев0
    Иконка чипа0