Copilot CLI работает с Ollama на твоём компьютере: выбираешь установленную модель через /model или задаёшь её перед запуском в переменных среды. Но локальная модель сама по себе не включает режим без обращений к GitHub. Для него нужен отдельный COPILOT_OFFLINE=true, а для локального выполнения - ещё и правильный провайдер.
Ниже - порядок подключения и проверка на тестовом файле. Команды и условия сверены с документацией 10 октября 2026 года; запуск Copilot с локальной моделью здесь не проверялся. Не принимай инструкцию за замер скорости или подтверждение полной изоляции.
Что понадобится для Copilot CLI с Ollama?
Коротко: Сначала установи CLI, запусти Ollama и загрузи совместимую локальную модель. Выбор через
/modelничего из этого за тебя не делает.
Проверь подготовку:
- Установлен GitHub Copilot CLI. Способы установки и обновления - в официальной справке GitHub. Для установки через npm нужен Node.js 22 или новее, на Windows - PowerShell 6 или новее.
- Ollama работает на той же машине, где будет запущен агент. Если CLI работает внутри контейнера или на сервере,
localhostобозначает этот контейнер или сервер, а не твой ноутбук. - Модель уже загружена. В её описании заявлены tool calling и streaming: вызов инструментов и потоковая выдача ответа. Это обязательные требования GitHub, иначе CLI выдаст ошибку.
- Есть отдельная папка для пробы без клиентского кода, ключей и личных файлов.
Провайдер - программа или сервис, который исполняет запрос к модели. Модель и агент для кода - разные части: первая формирует ответ, второй даёт ей инструменты чтения и изменения файлов.
В требованиях к контексту источники дают разные рекомендации: GitHub советует не менее 128 тысяч токенов для лучших результатов, страница интеграции Ollama - не менее 64 тысяч. Это рекомендации, не универсальный минимум памяти компьютера. Если ещё выбираешь модель и железо, сначала прочитай разбор локального агента.
Для подключения своего провайдера, BYOK, вход в GitHub не обязателен. Без него недоступны /delegate, GitHub MCP и GitHub Code Search. Не путай это с доступом к моделям, которые предоставляет GitHub.
Как выбрать модель Ollama через /model?
Коротко: В CLI версии 1.0.94-0 и новее
/modelобнаруживает поддерживаемые модели работающей локальной Ollama. Проверь модель, провайдера и адрес, затем подтверди переключение.
Эту возможность GitHub анонсировала 7 октября. Порядок такой:
- Запусти Ollama с уже загруженной моделью. Затем открой Copilot CLI в тестовой папке.
- Внутри CLI набери
/modelи выбери обнаруженную модель Ollama. - Перед подтверждением проверь провайдера и endpoint - адрес, куда отправится запрос. Для этого сценария нужен сервер на твоей машине, не внешний API.
- Подтверди Add and use for this session - «добавить и использовать в этой сессии». Add without switching только добавляет модель, без переключения текущей сессии.
Загружать Ollama или веса модели через этот список не получится. Если обнаружение выдало ошибку, прочитай её в окне выбора и проверь список моделей следующим способом.
Выбранная локальная модель ещё не отключает телеметрию. Чтобы проверить отдельный автономный запуск, используй переменные среды до старта CLI.
Как запустить Copilot CLI в режиме offline?
Коротко: Задай локальный адрес, точное имя модели и
COPILOT_OFFLINE=trueперед запуском. Флаг ограничивает обращения к GitHub, но не меняет адрес поставщика модели.
Сначала узнай имя модели из списка Ollama. На macOS или Linux:
curl http://localhost:11434/api/tagsВ PowerShell:
Invoke-RestMethod http://localhost:11434/api/tagsИщи свою модель в models и копируй её точное name. Пустой список означает, что выбирать пока нечего. Ошибка соединения - что Ollama недоступна по этому адресу. Этот запрос только получает список; он не проверяет генерацию и вызов инструментов.
В примерах YOUR-MODEL-NAME - место для твоего имени, не готовая модель. Не оставляй этот текст как есть. Для полностью локальной пробы не выбирай модель с облачным исполнением: в примерах Ollama такие варианты обозначены :cloud. Одного отсутствия этого суффикса недостаточно - проверь, где исполняется выбранная модель.
macOS или Linux, bash/zsh. В тестовой папке открой новый терминал и выполни:
export COPILOT_PROVIDER_BASE_URL=http://localhost:11434
export COPILOT_MODEL=YOUR-MODEL-NAME
export COPILOT_OFFLINE=true
copilotWindows, PowerShell. В тестовой папке:
$env:COPILOT_PROVIDER_BASE_URL = "http://localhost:11434"
$env:COPILOT_MODEL = "YOUR-MODEL-NAME"
$env:COPILOT_OFFLINE = "true"
copilotЭто один маршрут по примеру GitHub для локальной Ollama. В отдельной справке Ollama есть ручной рецепт с /v1 и COPILOT_PROVIDER_WIRE_API=responses. Не смешивай адрес из одного рецепта с протоколом другого: при ошибке совместимости сверяй всю конфигурацию с одной актуальной инструкцией.
Переменные задаются для текущего терминала и запущенного из него процесса. В новом терминале их нужно задать снова. Не записывай экспериментальные настройки в профиль оболочки, пока не прошла проверка. Если раньше настраивал удалённый провайдер, сначала проверь и убери его ненужные настройки в тестовом терминале: одного нового адреса может быть мало.
По справке авторизации GitHub в offline CLI не пытается войти в GitHub, отключает телеметрию и обращается к настроенному провайдеру. Если этот провайдер удалённый, запросы и контекст кода всё равно отправляются ему по сети.
Как проверить, что агент действительно читает файл?
Коротко: Дай агенту файл с известным содержимым и проверь реальный вызов инструмента чтения. Ответ на общий вопрос подтверждает только генерацию текста.
-
В отдельной тестовой папке создай
README.mdс таким содержимым:# Локальная проверка marker: copilot-local-7 -
Из этой папки запусти CLI с настройками провайдера и offline. Отправь задание агенту:
Прочитай README.md с помощью инструмента чтения файлов. Верни точную строку marker из файла и назови путь прочитанного файла. Не используй сеть. Не меняй и не создавай файлы. -
Разреши только необходимое чтение, если CLI запросит подтверждение. В журнале действий проверь вызов чтения именно твоего
README.md. В ответе должна быть точная строкаmarker: copilot-local-7, а в папке - никаких новых правок. -
После установки программ и загрузки модели отключи интернет на своей тестовой машине. Начни новую сессию с теми же переменными и повтори чтение. Не делай это на общем сервере или машине, где отключение сети прервёт чужую работу.
Если текст получен, но чтения файла в действиях нет, проверка инструментов не пройдена. Если появилась ошибка о неподдерживаемом вызове инструментов, вернись к требованиям модели. Не включай режим без подтверждений, чтобы добиться ответа.
После подключения важнее качество задачи и проверка результата. Хочешь заранее задать агенту границы работы? Открой программу ClaudeBase: в ней разобраны правила проекта и разрешения, постановка задач и проверка сделанного. Программу можно посмотреть без оплаты; доступ к базе открывается после оплаты.
Что этот тест говорит о приватности?
Коротко: Успешное чтение README без интернета проверяет один сценарий. Оно не подтверждает, что все инструменты и будущие задачи изолированы от сети.
| Что проверяешь | Какой признак нужен | Чего этот признак не доказывает |
|---|---|---|
| Адрес провайдера | Сервер модели на твоей машине | Что сама модель не использует облачный сервис |
| Исполнение модели | Подготовлена именно локальная модель | Что отключены сетевые инструменты агента |
| Offline у CLI | Флаг задан до запуска процесса | Что удалённый провайдер стал локальным |
| Чтение файла | Видно вызов инструмента и точный маркер | Что модель справится с большим проектом |
| Проба без интернета | Та же задача выполнена в новой сессии | Что любой следующий сценарий работает автономно |
Если нужна дополнительная защита от облачных моделей Ollama, её FAQ описывает disable_ollama_cloud в конфигурации сервера или OLLAMA_NO_CLOUD=1 с перезапуском Ollama. Это настройка сервера Ollama. Задать её рядом с командой copilot недостаточно, если сервер уже работает отдельным процессом.
Отдельно проверь подключённые MCP-серверы и команды, которым разрешён выход в сеть. Запрет в тексте задания помогает задать границу, но не заменяет технические разрешения. Для конфиденциального рабочего проекта нужна проверка сетевых обращений и изоляции инструментов, а не только выбор модели.
Управление окнами и приложениями в Copilot computer use - отдельный доступ. Для пробы чтения README его включать не нужно.
Что проверить, если подключение не работает?
Коротко: Начни с доступности Ollama и точного имени модели. Затем проверь выбранную сессию, возможности модели и настройки провайдера.
| Что наблюдаешь | Следующая проверка |
|---|---|
Запрос /api/tags не соединяется |
Запущена ли Ollama, тот ли адрес и в той ли среде работает CLI |
В API пустой список models |
Подготовлена ли модель до запуска агента |
Модель есть в API, но нет в /model |
Версия CLI, поддержка инструментов и streaming, сообщение ошибки в списке |
| Добавил модель, но текущая сессия не переключилась | Не выбрал ли Add without switching вместо Add and use for this session |
| CLI просит войти в GitHub | Переданы ли настройки BYOK и offline именно запущенному процессу; не используешь ли GitHub-функцию |
| Ошибка API или протокола | Весь ли рецепт взят из одной справки; не остались ли настройки другого провайдера |
| Ответ приходит, но файл не читается | Есть ли вызов инструмента в журнале, поддерживает ли модель tool calling |
| Чтение маленького файла работает, большой проект тормозит | Размер контекста и загрузка твоего компьютера; маленький тест не измеряет производительность |
Не продолжай бесконечный перебор моделей на важных файлах. Если локальное выполнение не подходит твоей машине или задаче, сравни другие агенты для кода. Переход на облачную модель требует отдельного решения о данных, которые ей можно отправить.
Сохрани после пробы: версию CLI, точное имя модели, адрес провайдера, способ запуска с offline и результат чтения README. Это пригодится при следующем обновлении. Рабочий проект открывай только после проверки нужных тебе инструментов и разрешений.
Источники
Документация и анонс проверены 10 октября 2026 года. Ссылки описывают условия производителя; собственного замера скорости локальных моделей здесь нет.