AI-инструменты 30.03.2026 4 мин чтения

Claude Code через Ollama: локальная модель, настройка и проверка

Claude Code можно направить к локальной модели через Ollama. В этом сценарии запросы к модели обрабатывает Ollama, а не Anthropic API. Требование платной подписки Claude нельзя автоматически переносить на эту интеграцию: локальный API Ollama принимает совместимые запросы и не проверяет API-ключ.

Документация сверена 15 октября 2026 года. Ниже — настройка по первоисточникам и сценарий проверки. Перед настройкой сверьте версии клиента и модели с выбранным способом подключения.

Что требуется

  • Установленные Claude Code и Ollama. Используйте официальные инструкции Claude Code и установщик Ollama для вашей ОС.
  • Локальная модель, которая поддерживает нужные агенту инструменты, и достаточно памяти для её загрузки.
  • Отдельная папка для первого опыта, чтобы легко проверить созданные файлы и изменения.

Запуск через Ollama

В инструкции интеграции основной вариант запуска выглядит так:

ollama launch claude

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

Ручное подключение

Если нужна явная настройка, в Bash или Zsh задайте переменные для текущего терминала и запустите модель, указанную в официальном примере:

export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3.5

Модель должна быть доступна локальному серверу. В PowerShell те же переменные задаются так:

$env:ANTHROPIC_AUTH_TOKEN = 'ollama'
$env:ANTHROPIC_API_KEY = ''
$env:ANTHROPIC_BASE_URL = 'http://localhost:11434'
claude --model qwen3.5

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

Контекст и память

Для агентной работы с кодом Ollama рекомендует контекст от 64 000 токенов. Размер контекста подбирайте под задачу и доступную память: больший контекст требует больше ресурсов.

В приложении Ollama размер контекста меняется в настройках. Для сервера, который вы запускаете вручную в Bash, документирован такой вариант:

OLLAMA_CONTEXT_LENGTH=64000 ollama serve

Не запускайте второй сервер поверх уже работающего. После загрузки модели выполните ollama ps: проверьте CONTEXT и распределение вычислений в PROCESSOR. Если памяти не хватает, уменьшите объём задачи или выберите подходящую вашему компьютеру модель.

Как проверить результат на небольшой задаче

  1. Создайте пустую тестовую папку и откройте её в Claude Code.
  2. Попросите создать файл hello.txt с одной заданной строкой. Не отключайте подтверждения действий ради этого теста.
  3. Откройте файл самостоятельно и сравните строку с запросом.
  4. Проверьте выбранную модель и подключение, а для локального запуска — загруженную модель в ollama ps.
  5. Запишите версии Claude Code и Ollama, имя модели, контекст, память компьютера и результат. Эти данные помогут повторить проверку после обновления.

Ограничения и ошибки

Ollama реализует часть Anthropic Messages API. Совместимость обычного диалога не подтверждает работу всех инструментов, кеширования, PDF и расширенных настроек. Проверяйте список поддерживаемых возможностей для нужного сценария.

  • connection refused: проверьте, запущен ли сервер по адресу из ANTHROPIC_BASE_URL.
  • model not found: сравните имя модели с выводом ollama list.
  • Ответ есть, но файл не создаётся: проверьте поддержку инструментов моделью и разрешения клиента.
  • Медленная работа: посмотрите загрузку памяти и ollama ps; сравните результат на меньшей задаче.

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

Нужна ли платная подписка Claude для локального Ollama?

Документация Ollama описывает подключение к локальному серверу с условным значением токена ollama. Покупку подписки Anthropic она не задаёт как шаг этого сценария. Условия доступа к моделям Anthropic через её собственные сервисы — отдельный вопрос.

Получится ли бесплатный Claude или Sonnet на компьютере?

Нет: Claude Code здесь служит клиентом, а отвечает выбранная модель Ollama. Подключение не превращает локальную модель в модель Anthropic.

Можно ли обещать полностью офлайн-работу?

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

Исправление от 15 октября. Убрано необоснованное обязательное требование платного аккаунта Claude для локального сценария. Локальный и облачный режимы разделены; собственный запуск не заявляется.

Как собрать анимированный сайт за минуты без дизайнера и без кода →