Настройка Codex CLI
Codex CLI — это Codex в терминале. Он удобен для чтения кода, изменения файлов, запуска тестов и объяснения ошибок прямо в локальных проектах. Настройки десктопного клиента находятся на странице клиента Codex; в этом разделе рассматривается именно CLI для терминала.
Что это за инструмент и для чего он нужен
Расположение файла конфигурации
| Система | Пример пути | Описание |
|---|---|---|
| Windows | C: \Users\YourUsername\. codex\config.toml | Замените имя пользователя на имя вашей учетной записи на компьютере |
| macOS / Linux | ~/. codex/config.toml | Если файла нет, создайте новый config.toml |
Как настроить кастомного провайдера
Если вы используете только официальный аккаунт, сначала пройдите стандартную процедуру авторизации. Добавляйте стороннего провайдера только в том случае, если он явно заявляет о совместимости с Codex / OpenAI.
codex login codex "Please reply only: Configuration successful"model = "MODEL_ID_FROM_PROVIDER_DASHBOARD" model_provider = "mz_proxy" [model_providers.mz_proxy] name = "Example AI Provider" base_url = "https://YOUR_PROVIDER_API_URL" env_key = "MZ_PROXY_API_KEY" wire_api = "responses"| Параметр | Что указывать | Обратите внимание |
|---|---|---|
| model | ID модели / имя модели из списка моделей в панели провайдера | Не указывайте придуманное отображаемое имя, не меняйте регистр, дефисы и точки |
| model_provider | Имя провайдера, указанное ниже | должно точно совпадать с xxx в [model_providers.xxx] |
| base_url | Адрес API из панели управления провайдера | Сверяйтесь с примером в панели провайдера, нужно ли указывать /v1 на конце |
| env_key | Имя локальной переменной окружения | Указывайте здесь имя переменной, не вставляйте сам ключ напрямую |
| wire_api | Протокол интерфейса | Выбирайте в соответствии с официальной документацией Codex и инструкцией провайдера |
Ключ и тестирование
Указанный выше env_key — это лишь имя переменной, сам ключ API нужно поместить в локальную переменную окружения. Сначала задайте ее временно для проверки, а убедившись в работоспособности, сохраните на постоянной основе.
$env:MZ_PROXY_API_KEY = "YOUR_KEY" codex "Please reply only: Configuration successful"MZ_PROXY_API_KEY="YOUR_KEY" codex "Please reply only: Configuration successful"В файле TOML параметры model и model_provider следует поместить в самое начало файла; не добавляйте их в секцию [model_providers.xxx].