Флаг Codex CLI —local-provider: выбор локальной модели

Флаг Codex CLI --local-provider применяется для выбора локального провайдера, через которого Codex CLI будет обращаться к модели на компьютере пользователя. Вместо отправки запросов во внешний облачный сервис можно подключить, например, Ollama или LM Studio и запускать работу с моделью в локальной инфраструктуре.

--local-provider не устанавливает модель и не превращает Codex CLI в сервер. Он лишь указывает, какой локальный бэкенд следует использовать; сам провайдер, модель и её доступность нужно подготовить отдельно.

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

Как использовать --local-provider

В самом простом случае флаг передаётся при запуске Codex CLI вместе с названием локального провайдера. Общая форма команды выглядит так:

codex --local-provider <провайдер>

Наиболее часто встречаются значения ollama и lmstudio. Они соответствуют двум разным программам, которые умеют запускать языковые модели локально и предоставлять к ним API для других приложений.

Значение	Что означает	Что должно быть запущено заранее	Когда подходит
ollama	Использовать локальный сервер Ollama	Установленная модель и работающий сервис Ollama	Для запуска моделей через командную строку и автоматизации
lmstudio	Использовать локальный сервер LM Studio	LM Studio с загруженной моделью и включённым API-сервером	Для графического управления моделями и параметрами
другое значение	Зависит от версии Codex CLI	Поддержка должна быть заявлена в конкретной версии	Только после проверки справки команды

Типичный запуск с Ollama выглядит следующим образом:

codex --local-provider ollama

Для LM Studio используется аналогичная форма:

codex --local-provider lmstudio

В некоторых версиях Codex CLI локальный режим дополнительно связывают с флагом --oss, который предназначен для работы с открытыми моделями. Поэтому перед использованием стоит проверить справку именно установленной версии:

codex --help

Проверка	Команда	Зачем нужна
Проверить наличие Codex CLI	codex --version	Узнать установленную версию и сопоставить её с документацией
Посмотреть доступные параметры	codex --help	Убедиться, что текущая версия поддерживает --local-provider
Проверить Ollama	ollama list	Увидеть установленные локальные модели
Проверить сервер LM Studio	Настройки LM Studio	Убедиться, что локальный API-сервер включён

Сам флаг обычно не принимает название модели. Это важное различие: --local-provider ollama выбирает Ollama как посредника, но не обязательно сообщает Codex CLI, какую из нескольких моделей нужно загрузить. Выбор модели может зависеть от конфигурации Codex CLI, настроек локального провайдера или конкретной версии инструмента.

Если на компьютере установлено пять моделей, параметр --local-provider ollama не отвечает на вопрос, какую из них использовать. Он отвечает только на вопрос: через какой локальный сервис отправлять запросы.

Проверка поддерживаемых значений

Перед запуском полезно посмотреть справку. Это особенно важно потому, что интерфейс Codex CLI развивается, а набор поддерживаемых локальных провайдеров может отличаться между версиями.

codex --help | grep -A 3 -- --local-provider

В Windows аналогичную информацию можно найти через:

codex --help | Select-String "local-provider"

Ситуация	Что сделать	Почему это важно
Флаг не распознаётся	Проверить версию и справку	Параметр может отсутствовать в старой сборке
Провайдер не принимается	Сверить написание значения	Названия обычно чувствительны к точному формату
Запуск начинается, но модель недоступна	Проверить локальный сервер и модель	Выбор провайдера не запускает модель автоматически во всех конфигурациях

Запуск в рабочем каталоге проекта

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

cd ~/projects/demo-app
codex --local-provider ollama

В Windows команда может выглядеть так:

cd C:UsersAlexprojectsdemo-app
codex --local-provider ollama

Локальность модели не отменяет необходимости внимательно проверять действия Codex CLI с файлами. Запрос может не уходить в облако, но команда всё равно способна читать, анализировать и изменять данные внутри рабочей директории согласно своим настройкам и разрешениям.

Когда применять --local-provider

Флаг имеет смысл не просто потому, что «локальная модель звучит безопаснее». У неё есть конкретные преимущества и ограничения. Выбор стоит делать исходя из характера проекта, мощности компьютера, требований к приватности и качества, которое требуется от модели.

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

Причина	Почему подходит локальный провайдер	Что учитывать
Конфиденциальный исходный код	Файлы не нужно отправлять внешнему API	Необходимо защищать сам компьютер и локальный сервер
Работа без интернета	Модель доступна в локальной сети или автономно	Модель и зависимости нужно скачать заранее
Обучение и эксперименты	Можно менять модели и параметры	Результаты могут сильно различаться по качеству
Контроль расходов	Нет оплаты за каждый отдельный API-запрос	Есть затраты на видеокарту, память и электричество
Интеграция в закрытую среду	Сервис работает внутри локальной инфраструктуры	Нужно самостоятельно следить за обновлениями и безопасностью

Конфиденциальные проекты

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

cd ~/private-company-service
codex --local-provider ollama

Перед таким использованием стоит определить, где хранятся журналы запросов, какие каталоги доступны модели и включён ли сетевой доступ к локальному API.

Уровень контроля	Вопрос	Что проверить
Файлы проекта	Какие каталоги может читать CLI?	Рабочую директорию и настройки разрешений
Локальный API	На каком интерфейсе он слушает?	Не открыт ли сервер наружу без необходимости
История запросов	Сохраняются ли промпты и ответы?	Логи Codex CLI и провайдера
Доступ пользователей	Кто может вызвать локальную модель?	Права ОС, сетевые правила и настройки сервера

Работа в изолированной сети

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

ollama list
codex --local-provider ollama

Если модель не загружена, Codex CLI не сможет «магически» получить её из интернета. Сначала провайдер должен видеть нужную модель локально.

Снижение расходов на запросы

При постоянной работе с небольшими задачами локальная модель может оказаться экономически привлекательной. Это особенно заметно, когда разработчик часто просит объяснить структуру проекта, написать тест, найти очевидную ошибку или преобразовать небольшой фрагмент кода.

Тип расходов	Облачная модель	Локальная модель
Оплата запросов	Может зависеть от объёма токенов	Обычно отсутствует как отдельная статья
Оборудование	Минимальные требования на стороне пользователя	Нужны RAM, CPU или GPU
Электроэнергия	В основном расходуется удалённой инфраструктурой	Оплачивается пользователем
Обслуживание	В основном выполняется поставщиком	Модели и сервис нужно обновлять самостоятельно

При этом экономия не должна быть единственным критерием. Если локальная модель постоянно выдаёт неточный код, время на исправления может оказаться дороже условной платы за более сильный облачный сервис.

Обучение и эксперименты

Локальный провайдер позволяет сравнивать модели на одних и тех же задачах. Это полезно для обучения: можно увидеть, как меняются ответы при разных размерах модели, контекстах и параметрах генерации.

codex --local-provider ollama

Лучше начинать с небольшого репозитория и безопасных операций: анализа файлов, составления плана, написания документации и генерации тестов. Изменения в критическом коде нужно проверять вручную.

Примеры использования

Ниже приведены практические сценарии. Команды показаны в компактном виде, но перед выполнением важно проверить названия моделей, состояние локального сервера и совместимость установленной версии Codex CLI.

Запуск с Ollama

Ollama часто выбирают пользователи, которым удобно управлять моделями из терминала. Сначала нужно убедиться, что сервис запущен и хотя бы одна модель доступна.

ollama list
codex --local-provider ollama

Шаг	Результат	Если возникла проблема
ollama list	Показывает локальные модели	Проверить установку Ollama и запуск сервиса
codex --local-provider ollama	Запускает Codex CLI с Ollama	Проверить поддержку значения ollama

Запуск с LM Studio

LM Studio удобен тем, что позволяет выбирать и загружать модели через графический интерфейс, а затем запускать совместимый локальный API-сервер.

codex --local-provider lmstudio

До выполнения команды в LM Studio нужно загрузить модель и включить сервер. Если интерфейс программы сообщает, что сервер остановлен, один только флаг не сможет исправить ситуацию.

Запуск из конкретного проекта

Чтобы Codex CLI работал с нужным репозиторием, сначала перейдите в его каталог. Это снижает вероятность случайного анализа чужих файлов и помогает сохранять рабочий контекст.

cd ~/work/catalog-service
codex --local-provider ollama

Проверка версии перед настройкой

Когда команда не работает, полезно не перебирать параметры наугад, а начать с версии и встроенной справки.

codex --version
codex --help

Так можно выяснить, поддерживает ли установленный CLI нужный параметр и какие дополнительные флаги требуются для локального режима.

Проверка локальных моделей в Ollama

Этот сценарий помогает отличить ошибку Codex CLI от ошибки самого провайдера.

ollama list
ollama ps

Команда	Что показывает	Как интерпретировать результат
ollama list	Установленные модели	Модель скачана и доступна локально
ollama ps	Загруженные в память модели	Показывает активные процессы модели

Проверка API-сервера LM Studio

Если LM Studio предоставляет локальный HTTP API, его доступность можно проверить отдельно от Codex CLI. Конкретный URL зависит от настроек программы.

curl http://127.0.0.1:1234/v1/models

Если сервер использует другой порт, замените 1234 на значение из настроек LM Studio. Ответ с перечнем моделей означает, что API отвечает; ошибка соединения указывает на проблему с сервером или портом.

Использование в скрипте запуска

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

#!/usr/bin/env bash
set -e

cd "$(dirname "$0")"
codex --local-provider ollama

Скрипт не устанавливает Ollama и не скачивает модель. Он только стандартизирует запуск из нужной директории.

Запуск с дополнительным флагом открытых моделей

В версиях, где локальная работа связана с режимом OSS, может использоваться комбинация двух параметров. Сначала проверьте справку, поскольку обязательность --oss зависит от реализации конкретного выпуска.

codex --oss --local-provider ollama

Если CLI сообщает, что один из параметров неизвестен или несовместим, не следует добавлять его механически: ориентируйтесь на вывод codex --help.

Запуск с явным указанием проекта

Некоторые версии и обёртки позволяют передавать рабочий каталог отдельным параметром. Если такой параметр поддерживается, это удобно для автоматизации.

codex --local-provider ollama --cd ~/work/demo-app

Название параметра для каталога может отличаться или отсутствовать. Поэтому пример нужно адаптировать к справке установленной версии.

Безопасный первый запуск

Первый запуск лучше проводить на копии проекта или в тестовом репозитории. Так вы проверите совместимость локальной модели, не рискуя рабочими файлами.

cp -R demo-app demo-app-local-test
cd demo-app-local-test
codex --local-provider ollama

Подход	Преимущество	Ограничение
Рабочий репозиторий	Сразу видно поведение на реальной задаче	Выше риск нежелательных изменений
Копия репозитория	Безопаснее экспериментировать	Нужно обновлять копию при изменениях
Тестовый проект	Удобно проверять саму связку	Не показывает поведение на большом коде

Чем отличается от похожих команд и параметров

--local-provider часто путают с параметрами, которые включают локальный режим, выбирают модель, задают сервер или просто показывают справочную информацию. Ниже разобраны наиболее близкие варианты.

--local-provider ollama и --local-provider lmstudio

Обе команды выбирают локальный способ работы, но указывают разные программы-посредники. Выбор зависит не от «лучшего названия», а от того, какой сервер реально установлен и запущен.

Критерий	Ollama	LM Studio
Основной интерфейс	Командная строка	Графическое приложение
Управление моделями	Команды терминала	Графический каталог и настройки
Типичный пользователь	Разработчик, автоматизатор, администратор	Пользователь, которому удобен GUI
Что нужно включить	Сервис Ollama	Локальный API-сервер LM Studio

--local-provider ollama и --oss

--local-provider выбирает конкретный локальный провайдер, а --oss обычно обозначает режим работы с открытыми моделями. Это не всегда взаимозаменяемые параметры: один может определять инфраструктуру, другой — общий режим работы.

Параметр	Главная роль	Пример вопроса
--local-provider ollama	Выбрать локальный бэкенд	Через какой сервис отправлять запросы?
--oss	Включить сценарий открытых моделей, если он поддерживается	Нужно ли использовать OSS-режим?

--local-provider и выбор модели

Провайдер и модель — разные уровни настройки. Например, Ollama может иметь несколько скачанных моделей, а LM Studio — несколько загруженных или доступных в каталоге. Флаг провайдера не обязательно выбирает конкретную модель.

ollama list
codex --local-provider ollama

Если нужно выбрать определённую модель, ищите соответствующую настройку в конфигурации Codex CLI или провайдера. Не стоит передавать имя модели вместо имени провайдера:

codex --local-provider llama3
codex --local-provider ollama

--local-provider и адрес API

Флаг обычно выбирает заранее известный тип провайдера. Он не обязательно предназначен для произвольного URL. Если локальный сервис работает на нестандартном порту или удалённом адресе, может потребоваться отдельная переменная окружения или настройка конфигурационного файла.

Задача	Подходящий уровень настройки
Выбрать Ollama	--local-provider ollama
Выбрать LM Studio	--local-provider lmstudio
Изменить порт API	Настройки провайдера или переменная окружения
Выбрать модель	Конфигурация Codex CLI или локального сервера

Типичные ошибки

Большинство проблем с --local-provider возникает не из-за самого флага, а из-за рассогласования между Codex CLI, локальным сервером и моделью. Ниже перечислены ситуации, которые встречаются чаще всего.

Ошибка: неизвестный параметр

Сообщение вроде «unknown option» обычно означает, что текущая версия Codex CLI не знает флаг или использует другую форму команды.

codex --local-provider ollama

Возможная причина	Проверка	Решение
Старая версия CLI	codex --version	Обновить Codex CLI
Опечатка	codex --help	Сверить написание параметра
Другой режим запуска	Документация конкретной версии	Использовать актуальный синтаксис

Ошибка: провайдер не запущен

Codex CLI может корректно распознать значение ollama, но не подключиться к сервису. В таком случае нужно проверить сам провайдер, а не менять название флага.

ollama ps
codex --local-provider ollama

Если Ollama не работает, запустите его штатным способом для вашей операционной системы и повторите проверку.

Ошибка: модель не установлена

Наличие Ollama или LM Studio ещё не означает, что внутри есть пригодная модель. Провайдер может быть полностью исправен, но отвечать нечем.

ollama list

Если список пуст или нужной модели в нём нет, сначала загрузите совместимую модель. Конкретная команда загрузки зависит от выбранной модели и требований вашей среды.

Ошибка: перепутано имя провайдера и имя модели

Одна из самых распространённых ошибок — передать в --local-provider название модели. Например, имя вроде llama3 описывает модель, а не сервер-посредник.

codex --local-provider llama3
codex --local-provider ollama

Используйте допустимое значение провайдера, а модель настраивайте отдельно.

Ошибка: ожидание облачного качества от небольшой локальной модели

Даже при идеальной технической настройке локальная модель может плохо работать с большим репозиторием, длинным контекстом или сложным рефакторингом. Это не обязательно ошибка подключения.

Симптом	Вероятная причина	Что попробовать
Модель теряет контекст	Недостаточное окно контекста	Уменьшить объём входных данных или выбрать другую модель
Код содержит больше ошибок	Недостаточная способность модели к программированию	Сравнить несколько локальных моделей
Ответы идут медленно	Нехватка RAM или GPU	Использовать меньшую модель или изменить параметры запуска
Модель повторяет фрагменты	Проблемы с настройками генерации	Проверить конфигурацию провайдера

Краткая памятка

--local-provider — это переключатель локального посредника между Codex CLI и языковой моделью. Он полезен для Ollama и LM Studio, но не заменяет установку самого провайдера, загрузку модели и настройку сервера.

Что нужно сделать	Пример	Зачем
Проверить версию CLI	codex --version	Убедиться в совместимости
Посмотреть справку	codex --help	Уточнить доступный синтаксис
Проверить Ollama	ollama list	Убедиться, что модели доступны
Выбрать Ollama	codex --local-provider ollama	Запустить локальный режим через Ollama
Выбрать LM Studio	codex --local-provider lmstudio	Запустить локальный режим через LM Studio
Проверить проект	Запускать CLI из нужного каталога	Ограничить рабочий контекст проектом
Проверить результат	Просмотреть изменения и выполнить тесты	Не принимать ответ модели без проверки

Минимальный алгоритм выглядит так:

1. Обновите или проверьте Codex CLI.
2. Выполните codex --help и убедитесь, что флаг поддерживается.
3. Установите и запустите Ollama или LM Studio.
4. Загрузите совместимую локальную модель.
5. Перейдите в каталог проекта.
6. Запустите Codex CLI с нужным провайдером.
7. Проверьте изменения, тесты и журналы работы.

cd ~/projects/my-app
codex --version
codex --help
codex --local-provider ollama

Главное правило простое: сначала проверяйте цепочку «Codex CLI — провайдер — модель — проект», а уже потом экспериментируйте с дополнительными параметрами. Тогда --local-provider действительно становится удобным инструментом локальной разработки, а не загадочным переключателем, который обвиняют во всех проблемах разом.