Как подключить DeepSeek к Codex: настройка, ограничения и стоимость

Подключить DeepSeek к Codex теперь можно без прокси и самодельных переходников: Codex использует Responses API, а DeepSeek поддерживает этот протокол напрямую. Но есть важное ограничение: в Codex работает лишь одна из двух моделей DeepSeek — и она не принимает изображения.

Можно ли использовать DeepSeek в Codex

Да. Codex взаимодействует с моделями через OpenAI Responses API, а API DeepSeek нативно совместим с этим протоколом. Поэтому DeepSeek добавляется в Codex как провайдер, описанный в конфигурационном файле. Официальная инструкция опубликована в документации API DeepSeek, в разделе Agent Integrations → Codex.

Раньше схема была сложнее. Codex отказался от старого пути wire_api = "chat" в пользу Responses API, и некоторое время DeepSeek приходилось подключать через слой-переводчик: LiteLLM, роутер с собственной реализацией Responses или самописный мост. Эти варианты по-прежнему работают, но больше не нужны для старта. Настройка провайдера — отдельная задача и не имеет отношения к подключению MCP-инструментов DeepSeek в Codex.

Одна конфигурация действует во всех вариантах Codex. Codex CLI, десктопное приложение ChatGPT и расширение Codex для VS Code используют одну и ту же директорию ~/.codex, поэтому настраивать каждый клиент отдельно не потребуется.

Какая модель DeepSeek доступна в Codex

Только deepseek-v4-flash. В таблице цен DeepSeek поддержка Responses API отмечена галочкой для deepseek-v4-flash и крестиком для deepseek-v4-pro. В сноске обещают поддержку Pro в начале августа 2026 года. На 3 августа 2026 года эта сноска всё ещё актуальна, а напротив Pro по-прежнему стоит ✗.

Обе модели перечислены в каталоге models.json, который создаёт настройщик. Поэтому конфигурация не помешает выбрать Pro, но ошибка возникнет выше по цепочке — уже при запросе к API. В пресете DeepSeek приложения CC Switch есть то же предупреждение, прямо в исходнике пресета: переключение на Pro до открытия интеграции со стороны DeepSeek приводит к ошибке.

Если сейчас нужна более мощная модель, можно использовать её endpoint в формате Anthropic. Именно поэтому Pro встречается в конфигурациях Claude Code, но не Codex. Модели заметно различаются по цене и лимитам параллельных запросов, так что выбирать стоит осознанно; подробнее — в сравнении deepseek-v4-flash vs deepseek-v4-pro.

Способ 1: официальный скрипт DeepSeek

DeepSeek предлагает скрипт, который создаёт всю конфигурацию автоматически. Это самый быстрый вариант, если вы не управляете несколькими провайдерами вручную. Сначала нужно установить и хотя бы один раз запустить Codex CLI или десктопное приложение ChatGPT, чтобы появилась директория ~/.codex. Версия клиента Codex должна быть не ниже 0.144.0 — такой минимум указан в каталоге моделей.

# macOS / Linux
bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh)

# Windows, в PowerShell
irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex

Скрипт открывает меню: 1 выбирает deepseek-v4-flash, 2 — deepseek-v4-pro, 3 восстанавливает конфигурацию, которая была до установки. Выбирайте 1: вариант 2 запишет корректный конфиг для модели, которая пока не может обслуживать запросы Codex. При первом запуске скрипт запросит API-ключ; его можно создать на platform.deepseek.com.

Что скрипт меняет в существующем конфиге

3 августа 2026 года я запустил официальный скрипт с одноразовым CODEX_HOME, куда заранее положил намеренно конфликтующую конфигурацию: profile, устаревший model_verbosity, model_reasoning_summary, а также MCP-сервер и запись доверенного проекта. Повторить проверку можно так: CODEX_HOME=/tmp/probe sh codex-deepseek-setup-en.sh, затем выбрать 1. Скрипт сообщил о четырёх изменениях и пояснил каждое:

• Изменена модель: "gpt-5.6-sol" → "deepseek-v4-flash"
• Удалено profile = "myprofile"  ← профиль маскирует model / model_provider / model_catalog_json
• Удалено model_verbosity = "high"  ← устаревшее значение может не поддерживаться моделью
• Удалено model_reasoning_summary = "detailed"  ← в models.json указано default_reasoning_summary=none

Блок [mcp_servers.playwright], уровень доверия в [projects."..."] и approval_policy остались без изменений. До записи новый скрипт скопировал исходный файл в ~/.codex/backup-deepseek/. Он также проверил оба файла перед сохранением: корректность JSON у models.json, а у config.toml — ошибки разбора и дублирующиеся ключи. Это результат одного запуска на одной машине: он подтверждает наличие резервного копирования и восстановления, но не гарантирует одинаковое поведение для конфигов любой структуры.

Способ 2: настроить config.toml вручную

Ручное редактирование подойдёт тем, кто хранит конфигурацию в системе контроля версий или хочет понимать назначение каждого поля. Создайте ~/.codex/models.json, взяв каталог моделей из документации DeepSeek, затем добавьте в ~/.codex/config.toml следующее:

model = "deepseek-v4-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
model_catalog_json = "~/.codex/models.json"

[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "<your DeepSeek API Key>"

Способ 3: CC Switch для частой смены провайдеров

CC Switch — десктопное приложение для управления конфигурациями провайдеров в восьми инструментах для разработки, включая Codex. В нём есть готовый пресет DeepSeek: endpoint https://api.deepseek.com, модель по умолчанию deepseek-v4-flash и обе модели — Flash и Pro — в каталоге. Приложение записывает те же поля, что и при ручной настройке, только через меню в трее, а не редактор.

Перед переходом на CC Switch стоит учесть два момента. В отличие от Claude Code, Codex нужно перезапускать после смены провайдера. Кроме того, одно приложение начинает хранить учётные данные всех добавленных вами провайдеров и запускает локальный сервис для их маршрутизации. С точки зрения безопасности это совсем другая модель, чем один API-ключ в одном файле.

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

Запустите Codex CLI в проекте и посмотрите стартовый баннер: строки model и provider подтверждают активную конфигурацию. Вот результат запуска моей тестовой конфигурации 3 августа 2026 года в codex-cli 0.146.0:

OpenAI Codex v0.146.0
model: deepseek-v4-flash
provider: deepseek
reasoning effort: high

Неверный ключ даёт характерную ошибку с указанием endpoint. Это самый быстрый способ убедиться, что запросы действительно уходят в DeepSeek:

ERROR: unexpected status 401 Unauthorized: Authentication Fails, Your api key: ****r000 is invalid,
       url: https://api.deepseek.com/responses

Прежде чем показать эту ошибку, Codex повторил запрос пять раз — при опечатке в ключе сначала придётся несколько секунд подождать в тишине. В десктопном приложении ChatGPT на macOS селектор модели показывает Custom, а не имя модели: так приложение помечает любую локально настроенную модель. При этом используется выбранная вами модель DeepSeek. Если в логах Codex появились fallback model metadata или Unknown model, значит, models.json не загрузился и путь к каталогу указан неверно.

Что меняется при запуске DeepSeek внутри Codex

По сравнению с Codex на модели OpenAI есть четыре отличия. Отлаживать их как неисправности не нужно.

Изображения не поддерживаются. Для DeepSeek в models.json задано input_modalities: ["text"]. Поэтому пока активна модель DeepSeek, ни один клиент Codex не позволит вставлять скриншоты или прикреплять изображения. Разработчик на Hacker News 2 августа 2026 года столкнулся с той же проблемой и оставил второго провайдера для задач со зрением:

Поскольку у DeepSeek V4 нет зрения, он настроил OMP на использование GPT 5.6 Luna через подписку Codex.

Для такого обходного пути нужен второй блок [model_providers.*], указывающий на сервис, принимающий изображения. Формат с wire_api = "responses" остаётся тем же, поэтому endpoint агрегатора с GPT-5.6 добавляется в ту же конфигурацию, а переключение сводится к изменению одной строки model.

Старые сессии могут показаться удалёнными. Codex группирует историю сессий по способу входа. При переходе с подписки ChatGPT на API-ключ стороннего провайдера прежняя группа скрывается, а не удаляется. Верните прошлую конфигурацию — и старые сессии снова появятся, а сессии DeepSeek исчезнут из вида.

Ключ хранится в конфиге открытым текстом. Поле experimental_bearer_token содержит сам ключ, а не ссылку на переменную окружения. Поэтому ~/.codex/config.toml становится файлом с секретом: это важно помнить перед синхронизацией директории или коммитом репозитория с dotfiles.

Модель может называть себя ChatGPT. Устанавливаемый интеграцией models.json содержит собственный системный prompt оболочки Codex. Он начинается с фразы "You are Codex, an agent based on GPT-5." Этот prompt действительно влияет на работу: он задаёт протокол инструментов, правила подтверждения действий и формат вывода агента. Поэтому поведение модели здесь отличается от той же модели в обычном чат-окне, а строка с идентичностью идёт от оболочки, а не от заявления модели о происхождении.

Сколько стоит DeepSeek в Codex

Цена deepseek-v4-flash — $0.14 за миллион входных токенов при промахе кэша и $0.28 за миллион выходных токенов. Тарифы были сверены на странице цен DeepSeek 3 августа 2026 года. Попадание в кэш стоит $0.0028 за миллион входных токенов — в пятьдесят раз дешевле промаха. Именно эта разница определяет стоимость длинных агентных сессий, поскольку агент для программирования на каждом ходе заново отправляет растущий контекст.

В таблицу не вошли ещё два нюанса. DeepSeek заявляет, что в будущем появятся пиковые и непиковые тарифы: в часы пик ставки будут в 2× выше указанных. Пиковыми ежедневно считаются 09:00–12:00 и 14:00–18:00 по пекинскому времени (UTC+8), а дату запуска объявят позже. Кроме того, в каталоге для контекстного окна 1M указана эффективная ёмкость 95%; при её превышении контекст обрезается по политике, заданной в models.json.

FAQ

Можно ли использовать DeepSeek в Codex без подписки ChatGPT?

Да. Параметры preferred_auth_method = "apikey" и forced_login_method = "api" заставляют Codex использовать ваш ключ DeepSeek и полностью пропускать вход в аккаунт.

Нужно ли отдельно настраивать расширение VS Code и десктопное приложение?

Нет. Все три клиента Codex используют одну конфигурацию в ~/.codex. После переключения перезапустите десктопный клиент, чтобы он подхватил изменения.

Как вернуться к официальной модели?

Повторно запустите скрипт настройки и выберите вариант 3: он восстановит резервную копию config.toml, сделанную до установки. Если вы настраивали Codex вручную, удалите поля DeepSeek и блок [model_providers.deepseek], затем войдите снова.

Можно ли уже использовать deepseek-v4-pro в Codex?

Нет, на 3 августа 2026 года нельзя. На странице цен DeepSeek поддержка её Responses API всё ещё отмечена ✗. Обещанный срок — начало августа 2026 года, поэтому лучше перепроверить эту страницу, а не полагаться на конфиг, который позволяет выбрать модель.

Какой способ выбрать

Главный открытый вопрос — Pro. Flash — недорогая, быстрая и текстовая половина линейки, тогда как модель, которую большинству хочется видеть в агентном цикле, пока не поддерживает нужный Codex протокол. Пока сноска не изменится, выбор DeepSeek для Codex означает осознанный выбор Flash.

Читайте также: Codex vs Claude Code · How to use GLM-5.2 in Claude Code