В этом учебном пособии описывается только процесс конфигурации в среде Windows, методы проверки и то, где следует приоритизировать проверку в случае возникновения проблем.
Имена моделей, версии клиентов и содержание официальных сценариев могут обновляться с течением времени, но на практике используется информация, отображаемая на официальной странице DeepSeek.
Ссылка:
- Официальное руководство DeepSeek по доступу к Codex
- Официальный сценарий конфигурации DeepSeek
Подготовка к использованию DeepSeek API Key
Сначала перейдите в консоль DeepSeek и создайте API Key:
https://platform.deepseek.com/top_up
Замечания по безопасности API Key
Если старые ключи когда-либо появлялись в следующем месте:
- Скриншоты
- Чат запись
- Статьи Учебные материалы
- Хранилище кодов
- Социальные платформы
Пожалуйста, немедленно отмените в консоли DeepSeek и не продолжите использование.
Новый API Key:
- Ввод только на свой компьютер.
- Никому не отправляйте.
- Не показывать скриншоты
- Не отправляйте в репозиторий кода
Следует также отметить:
Официальный сценарий конфигурации DeepSeek временно использует Key не только в текущем окне PowerShell, но и может записывать сведения о сертификации в каталог конфигурации пользователя Codex.
Следующие каталоги также должны быть защищены в качестве конфиденциальных каталогов:
C:\Users\你的用户名\.codex\
Не загружайте все .codex Папки, и не делитесь файлами профиля в них.
Рекомендации страницы API Key в скриншоте учебного пособия:
- Нужно кодировать
- Используйте относительные пути для сохранения изображений, чтобы избежать смены компьютеров или утраты при публикации
Пример:
Запустите официальный скрипт конфигурации DeepSeek
Откройте Windows PowerShell и выполните следующее:
irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex
Данная команда будет:
- Скачать сценарий PowerShell с официального адреса DeepSeek
- Немедленное выполнение процесса конфигурации
Несмотря на то, что адрес из официального, следует отметить:
Прямое выполнение удаленных сценариев по-прежнему сопряжено с риском.
Не копируйте подобные команды из незнакомых учебников.
Если вы не можете успокоиться, вы можете:
- Сначала открыть содержимое сценария
- Подтверждение источника
- Повторное исполнение
Шаги настройки
После появления меню в сценарии:
- Ввод:
1
- Выбор:
deepseek-v4-flash
- Выполните запрос для ввода нового ключа API DeepSeek
- Дождаться завершения конфигурации сценария
Назначения о deepseek-v4 - pro
Появление некоторых имен моделей в меню сценариев не означает, что текущая версия клиента и официальный статус доступа полностью поддерживаются.
Не выбирайте модель только потому, что в меню вы видите ее имя.
Правильный способ:
- Основывается на официальной текущей документации DeepSeek
- Подтверждение имени модели
- Подтверждение требований к версии клиента
- Подтверждение рекомендуемого способа доступа
Не надо:
- Вставьте ключ в команду.
- Запишите ключи в открытый сценарий
- Показать реальный ключ в статье
III. Перезагрузка Кодекса и трехэтапная проверка
После конфигурации:
- Полностью выйти из рабочего стола Codex
- Возобновить открытие Кодекса
Затем не приступайте к изменению проекта.
Рекомендуется проводить проверку в следующей последовательности.
Шаг 1: Испытание запроса базовой модели
Ввод:
只回复 OK
В случае возвращения:
OK
Примечание:
- Запрос API в основном успешно выполнен
- Возможно, конфигурация провайдера нормальна.
В случае появления:
- 401
- Модель не существует
- Ошибка поставщика
Не позволяйте Кодекса управлять проектом.
Приоритетные проверки:
- Ключ API
- Имя моделей
- Конфигурация поставщика
- Клиентская версия
Шаг 2: Тест файла только для чтения
Ввод:
只读当前工作区中的一个文本文件，告诉我它主要写了什么，不要修改任何文件
Для подтверждения:
- Доступ кодекса к рабочему пространству
- Функция чтения файлов нормальна?
Шаг 3: Простой тест вызова инструмента
Ввод:
只列出当前工作区中的文件名，不要创建、删除或修改任何文件
Для подтверждения:
- Нормальный ли вызов инструмента
- Нормальные ли полномочия рабочего пространства
Почему это было сделано на три шага?
Поскольку:
- Основные запросы неудачно → большинство случаев проблемы с ключами, моделями, поставщиками
- Неудача чтения файла → Возможно, это права на рабочее пространство или проблема с клиентом
- Неудачный вызов инструмента → Возможно, проблема с цепкой инструментов Codex
Отдельные тесты позволяют быстро определить причину.
IV. Расположение резервного копирования исходной конфигурации
Официальный сценарий обычно создает каталог резервного копирования:
C:\Users\Administrator\.codex\backup-deepseek\
Если имя пользователя Windows не является Администратором:
Просмотр:
C:\Users\你的用户名\.codex\backup-deepseek\
Этот каталог может содержать:
- Конфигурация поставщика
- Адрес API
- Информация о сертификации
Не надо:
- Загрузить на диск
- Отправить проверку кому-то
- В открытый склад.
V. Конечная версия Кодекса: сначала подтвердить версию
Кодекс для настольных компьютеров и кодекса для терминалов не смешиваются.
Если используется версия терминала:
Сначала выполнить:
codex --version
Например, в некоторых средах обнаружены:
0.117.0
Однако для официальных сценариев конфигурации DeepSeek может потребоваться более поздняя версия, например:
0.144.0+
Требования к версиям могут меняться, поэтому они должны соответствовать официальным текущим инструкциям.
При необходимости модернизации:
npm install -g @openai/codex
После обновления подтвердите:
codex --version
Внимание:
Если вы используете только столовую сторону:
Не используйте номер версии терминала, чтобы доказать, что рабочий стол подключен успешно.
Окончательным критерием суждения должно быть:
- Появился ли на рабочем столе соответствующий Provider
- Успех запроса модели
- Нормально ли чтение файлов и вызов инструментов
VI. Общие ошибки
1. 401 или провала аутентификации
Приоритетные проверки:
Используются ли старые ключи?
Если Ключ когда-либо был открыт:
Немедленно отменить и создать заново.
Копировать ошибку
Проверка:
- Пробелы перед и после
- символы перерыва строки
- Полный ли вход
Не отправляйте ключ другим людям для проверки.
Правильный способ:
Пересоздание ключа, введенного только при локальной конфигурации.
2.Модель не существует или не поддерживается версия
Сначала подтвердите:
codex --version
Затем подтверждается:
- Используется ли в настоящее время настольная или терминальная версия?
- DeepSeek официально требует текущих имен моделей
- Минимальная официальная версия клиента
Если версия слишком низкая:
- Модернизация клиента
- Перезапустить сценарий конфигурации
- Опять проверить.
3.Не используйте DeepSeek Key в процессе входа в OpenAI
Не использовать:
codex login --with-api-key
Причины:
DeepSeek API Key не является учетным данным входа в OpenAI.
DeepSeek должен быть:
- Пользовательские поставщики
- Конфигурация адресов API
- Соответствующий протокол связи
Доступ к нему.
И наконец, помните три пункта.
- Старый ключ был разоблачен, в первую очередь отменен.
- DeepSeek API Key не является учетным данным входа в OpenAI.
- Появление модели в интерфейсе не означает, что запрос на модель, чтение файлов и вызов инструментов полностью нормальны.
Критерий успешной конфигурации не является «Видеть имя модели», а:
- Запрос успешно выполнен
- Читение файла нормально
- Вызов инструмента нормальный