Ollama и Codex: локальная модель, запуск и проверка 2026

Для десктопного приложения Codex используйте официальный мастер ollama launch codex-app; для Codex CLI подходит ollama launch codex, а ручной вариант использует codex --oss. Локальная модель экономит сетевые обращения к поставщику модели, но требует достаточной памяти, подходящего контекста и отдельной проверки инструментов.

Что работает локально, а что может уйти в сеть

Ollama запускает выбранную open-weight модель на вашем компьютере либо подключает облачную модель из своего каталога. Официальная интеграция Codex с Ollama различает локальные модели и варианты с суффиксом :cloud. Поэтому название Ollama само по себе не гарантирует локальную обработку.

Web search в профиле Ollama также может использовать внешний сервис и требует входа в Ollama. Если задача должна остаться на устройстве, отключите веб-поиск и не выбирайте cloud-модель. Код всё равно может попасть в сеть через другие MCP-серверы, Git-remote или команды проекта, поэтому проверяйте весь набор инструментов, а не только модель.

Локальность проверяется маршрутом каждого действия: модель, веб-поиск, MCP, Git и команды проекта. Одной надписи local недостаточно.

Когда Ollama подходит для Codex

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

• Нужна работа с локальной моделью без отдельного API-ключа.
• На компьютере достаточно памяти для выбранной модели и контекста.
• Задача допускает проверку результата тестами и ручным просмотром.
• Вы понимаете разницу между локальным тегом и вариантом :cloud.
• Можно начать в отдельном проекте без секретов и несохранённых данных.

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

Подготовка модели и контекста

Установите Ollama с официального сайта и проверьте, что команда доступна. Затем выберите модель для кода. В официальном объявлении ollama launch указано, что агентам кода нужен большой контекст, а для интеграции рекомендуется не менее 64 тысяч токенов. Конкретная модель и скорость зависят от вашего компьютера.

1. Запустите ollama --version и убедитесь, что установка завершена.
2. Выберите модель из актуального списка Ollama и прочитайте её требования.
3. Загрузите модель командой ollama pull <model>.
4. Откройте настройки Ollama и проверьте размер контекста.
5. Закройте тяжёлые приложения перед первым тестом, чтобы увидеть реальный запас памяти.

Не начинайте с самой крупной модели только из-за названия. Правило выбора: модель должна помещаться в память без постоянного обмена с диском, отвечать с приемлемой задержкой и проходить ваш минимальный тест проекта. Меньшая стабильная модель полезнее большой, которая зависает на каждом инструменте.

По теме: Kimi в Codex: подключение через API и локальный роутер

Быстрый запуск через ollama launch

Актуальная документация Ollama предлагает мастер, который создаёт отдельный профиль Codex и запускает его с выбранной моделью. Это снижает риск повредить основной ~/.codex/config.toml.

ollama launch codex

Выберите модель в мастере и дождитесь запуска Codex. Если нужно только подготовить профиль без немедленного старта, используйте ollama launch codex --config. Для удаления созданного профиля предусмотрена команда ollama launch codex --restore.

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

Ручной запуск через режим OSS

Если модель уже работает в Ollama, Codex CLI поддерживает встроенный OSS-провайдер. Запустите общий режим либо укажите точное имя установленной модели.

codex --oss
codex --oss -m <model>

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

По теме: DeepSeek в Codex: официальное подключение и проверка 2026

Как проверить готовность связки

Проверка должна охватывать модель, инструменты и проект. Создайте одноразовый репозиторий с простым тестом. Дайте задачу изменить одну функцию, запустить один тест и показать diff. Не оценивайте связку только по ответу в чате.

• Ollama показывает выбранную модель как загруженную во время ответа.
• Codex меняет только разрешённый файл.
• Тест проекта завершается ожидаемым результатом.
• После отмены задача действительно останавливается.
• При отключённой сети локальная модель продолжает отвечать без cloud-функций.

Практический замер состоит из четырёх величин: время первого ответа, время выполнения теста, максимальный расход памяти и число ошибочных правок. Запишите результаты для одной и той же задачи на двух моделях. Такой тест даёт основание выбора, в отличие от общего впечатления.

Диагностика медленной или нестабильной работы

• Ответ начинается очень долго: модель или контекст не помещаются в доступную память. Выберите меньшую модель либо уменьшите рабочий набор файлов.
• Codex теряет ранние инструкции: проверьте размер контекста Ollama и сократите лишние файлы в задаче.
• Модель отвечает, но инструменты ломаются: протестируйте создание файла, diff и запуск одной команды по отдельности.
• Codex не находит модель: сверьте точный тег и убедитесь, что Ollama запущена.
• Появились сетевые обращения: проверьте, не выбрана ли :cloud модель, включён ли web search и какие MCP-серверы активны.

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

По теме: Codex и Figma: подключение через официальный MCP в 2026

Как откатить настройку

Если вы использовали мастер, выполните ollama launch codex --restore, затем полностью перезапустите Codex. Проверьте стартовую модель до открытия рабочего проекта. Если профиль создавался вручную, восстановите свою резервную копию конфигурации вместо удаления случайных строк.

Остановка Ollama не возвращает Codex к OpenAI автоматически. Клиент может продолжать выбирать недоступный локальный провайдер. Поэтому критерий отката прост: Codex запускается с ожидаемым провайдером, тестовый ответ проходит, локальный профиль больше не выбирается.

Когда локальная модель не подходит

Откажитесь от локального режима, если задача требует качества или инструментов, которые выбранная модель не подтверждает тестом, компьютер постоянно уходит в swap, а время ответа мешает работе. Также не используйте cloud-модель Ollama в проекте, где разрешена только локальная обработка.

Частые вопросы

Нужен ли API-ключ OpenAI?

Для локальной модели Ollama он не нужен. Облачные модели и дополнительные сетевые функции могут требовать отдельного входа в соответствующий сервис.

Работает ли Ollama в приложении Codex?

Да. Для десктопного приложения используйте отдельный официальный мастер ollama launch codex-app в тестовой папке; для CLI используйте ollama launch codex. У каждого варианта свой профиль и команда восстановления.

Какая модель нужна для кода?

Выбирайте из актуального каталога Ollama по памяти, контексту и результату вашего теста. Универсального имени для всех компьютеров нет.

Как убедиться, что данные не уходят в сеть?

Используйте локальный тег без :cloud, отключите web search и внешние MCP, затем повторите тест без сети. Отдельно проверьте команды Git и скрипты проекта.