DeepSeek V4 Flash и Pro в Codex: настройка и выбор модели
Настройте DeepSeek в Codex через APIMaster. Найдите config.toml на Windows, macOS и Linux, задайте API-ключ, запустите интерактивный чат и выберите модель.
Настройте API-ключ APIMaster и config.toml в Codex, затем запустите codex, чтобы общаться с DeepSeek. Используйте deepseek-v4-flash, deepseek-v4-pro. Codex подключается через Responses API по адресу https://apimaster.ai/v1.
Перед началом
Выполните проверку окружения, установите Codex согласно общему руководству и получите API-ключ APIMaster с доступом к этим моделям и достаточным балансом.
codex --version
1. Откройте каталог конфигурации
Windows
Нажмите Win + R, введите следующий путь и нажмите Enter:
%USERPROFILE%\.codex
Если папка не существует, создайте её. Откройте или создайте config.toml в текстовом редакторе. Убедитесь, что имя файла не config.toml.txt.
macOS / Linux
На macOS в Finder нажмите Command + Shift + G и введите:
~/.codex
На Linux откройте тот же каталог в файловом менеджере или редакторе. При необходимости создайте его из терминала:
mkdir -p ~/.codex
Откройте или создайте config.toml в этом каталоге. Если вы используете собственный каталог состояния Codex, используйте его вместо этого.
2. Настройте config.toml
На обеих платформах используется одинаковое содержимое:
model = "deepseek-v4-flash"
model_provider = "apimaster"
model_reasoning_summary = "none"
model_supports_reasoning_summaries = false
[model_providers.apimaster]
name = "APIMaster"
base_url = "https://apimaster.ai/v1"
env_key = "APIMASTER_API_KEY"
wire_api = "responses"
Если файл уже существует, сделайте его резервную копию и объедините эти настройки. Замените существующие ключи верхнего уровня вместо дублирования и разместите их перед первым заголовком [таблицы]. Если секция провайдера уже существует, объедините её. Это изменит провайдера и модель по умолчанию для новых сессий Codex.
Базовый URL включает /v1. Сохраните wire_api = "responses"; одной конечной точки Chat Completions для этого сценария недостаточно. Настройки summary отключают необязательные резюме рассуждений, а не внутреннее мышление модели.
Чтобы сохранить существующего провайдера по умолчанию, поместите эту конфигурацию в ~/.codex/deepseek.config.toml (Windows: %USERPROFILE%\.codex\deepseek.config.toml). Затем добавьте --profile deepseek в команды запуска ниже. Именованные файлы профилей требуют Codex 0.134.0 или новее и наследуют остальные базовые настройки.
3. Задайте API-ключ
Замените YOUR_APIMASTER_API_KEY на ключ от APIMaster. Конфигурация TOML хранит имя переменной окружения, а не сам ключ.
Windows PowerShell
Выполните в том терминале, где будете запускать Codex:
$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'
Чтобы также сохранить его для будущих терминалов:
[Environment]::SetEnvironmentVariable('APIMASTER_API_KEY', 'YOUR_APIMASTER_API_KEY', 'User')
После сохранения постоянной переменной откройте новый терминал или продолжайте использовать текущий, где вы выполнили первую команду.
macOS / Linux
export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'
Это действует в текущем терминале. Чтобы использовать его в новых терминалах, добавьте ту же строку export в файл запуска вашей оболочки, например ~/.zshrc для Zsh или ~/.bashrc для интерактивного Bash, затем откройте новый терминал. Храните файлы с реальными ключами в тайне и вне общих репозиториев.
4. Запустите Codex и общайтесь
Откройте терминал в каталоге вашего проекта и выполните:
codex
После обычных подсказок первого запуска или доверия к проекту проверьте, что активная модель — deepseek-v4-flash. В диалоге Codex введите:
Reply with exactly OK.
Нормальный ответ подтверждает базовое соединение. Затем можно попросить объяснить код, прочитать файл или внести изменение. Проверяйте обычные подсказки о разрешениях на файлы и команды.
5. Выберите другую модель
Для этих пользовательских идентификаторов моделей выбирайте модель явно при запуске Codex. Выполняйте по одной команде за раз в вашем терминале:
codex --model deepseek-v4-flash
codex --model deepseek-v4-pro
Каждая команда открывает интерактивный диалог. Чтобы переключиться из открытой сессии, введите /exit, затем выполните команду для нужной модели. Чтобы продолжить существующее сохранённое диалоговое окно с другой моделью, используйте codex resume SESSION_ID --model MODEL_ID вместо запуска нового диалога.
В Codex /model открывает каталог моделей, а /status показывает активную модель. Меню автоматически не перечисляет все модели на маркетплейсе моделей APIMaster. Если вашей модели DeepSeek нет, используйте --model, как указано выше. Не полагайтесь на то, что синтаксис /model MODEL_ID из Claude Code работает в Codex; здесь это не проверенный способ выбора пользовательской модели.
Для необязательного именованного профиля, например:
codex --profile deepseek --model deepseek-v4-flash
Чтобы изменить значение по умолчанию для будущих запусков, отредактируйте значение model верхнего уровня в используемой вами конфигурации.
Устранение неполадок
| Симптом | Что проверить |
|---|---|
| Отсутствует API-ключ / 401 | Задайте APIMASTER_API_KEY в терминале, из которого запускается Codex; проверьте действительность ключа и баланс. |
| По-прежнему используется другой провайдер | Проверьте model_provider, выбранный профиль, переопределения проекта и флаги запуска. Перезапустите после изменения конфигурации. |
| Ошибка разбора TOML | Избегайте дублирующихся ключей или таблиц; настройки верхнего уровня должны предшествовать заголовкам таблиц. |
| 404 / неподдерживаемый протокол | Используйте https://apimaster.ai/v1 и wire_api = "responses". |
| Модель отсутствует в /model | Используйте полный идентификатор модели с codex --model. Встроенный каталог — не список моделей шлюза. |
| Предупреждение о метаданных модели или списке моделей | У этих идентификаторов может не быть метаданных Codex. Проверьте финальный ответ; резервные лимиты контекста не являются проверенными возможностями модели. |
| Предупреждение о потере рассуждений/вывода | Проверьте финальный ответ и результаты инструментов. Сообщайте о прерванном выводе с указанием модели, версии CLI, времени UTC и ID запроса, если они доступны. |
Валидация и необязательная проверка инструментов
Записанные интеграционные тесты: 2026-09-07 UTC, Codex CLI 0.153.4, Linux. Все перечисленные здесь модели вернули ожидаемый текст и использовали инструмент для чтения локального файла. Сложные задачи по программированию не входили в объём этого теста. Инструкции по настройке для Windows и macOS предоставлены, но эти операционные системы не участвовали в записанных запусках. Эти проверки не устанавливают полную совместимость функций, поведение длинных сессий или максимальные лимиты контекста.
Чтобы проверить файловые инструменты, создайте probe.txt во временном проекте со следующим содержимым:
FILE_PROBE_739182
Запустите там Codex с выбранной моделью, затем введите:
Read probe.txt using a tool and reply with its exact contents. Do not guess.
Убедитесь, что инструмент чтения файлов выполняется, а ответ совпадает с содержимым файла. Используйте это после того, как базовый диалог заработает.
FAQ
Использует ли это мою подписку ChatGPT?
Запросы используют ваш ключ и баланс APIMaster. Codex — это клиент; DeepSeek — выбранная модель. Эта конфигурация не делает DeepSeek моделью OpenAI.
Почему Claude Code использует другой URL?
Codex использует https://apimaster.ai/v1 для Responses. Claude Code использует корень сайта https://apimaster.ai и сам добавляет /v1/messages.