Claude Code через Ollama: как подключить локальную модель без оплаты API Anthropic

Актуально на 30 марта 2026 года.

Если коротко: да, Claude Code можно подключить к локальной модели через Ollama, потому что Ollama теперь поддерживает совместимость с Anthropic Messages API. Это позволяет запускать Claude Code не через API Anthropic, а через локальный http://localhost:11434.

Но есть важный нюанс: это не означает полностью бесплатный Claude Code для всех. По официальной документации Anthropic, на 30 марта 2026 года Claude Code по-прежнему требует аккаунт с доступом к Claude Code: Pro, Max, Teams, Enterprise или Console. Бесплатный план Claude.ai Free Claude Code не включает. Поэтому корректнее говорить так:

• вы можете использовать Claude Code без оплаты Anthropic API-инференса;
• вы можете подключить Claude Code к локальной модели;
• вы можете держать запросы к модели локально;
• но сам доступ к Claude Code как продукту всё ещё требует подходящий аккаунт.

Если вас это устраивает, дальше всё довольно просто.

Что даёт запуск Claude Code через Ollama

Связка Claude Code + Ollama полезна в трёх сценариях:

• вы не хотите платить за вызовы модели через Anthropic API;
• вы хотите запускать Claude Code с локальной моделью для приватных задач;
• вы хотите использовать cloud-модели Ollama как альтернативный backend.

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

Что нужно заранее

Перед запуском Claude Code через Ollama проверьте четыре вещи:

1. Доступ к Claude Code

На 30 марта 2026 года Claude Code требует аккаунт Pro, Max, Teams, Enterprise или Console. Если у вас только бесплатный план Claude, этот сценарий не заработает.

2. Ollama

Нужен установленный Ollama и запущенный локальный сервер.

3. Достаточный контекст

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

То есть главный bottleneck здесь не только в "потянет ли модель", но и в том, хватит ли памяти под большой контекст.

4. Понимание разницы между local и cloud

У Ollama есть:

• локальные модели, которые работают на вашей машине;
• :cloud-модели, которые работают на стороне Ollama.

Если вы запускаете :cloud-модель, это уже не локальный inference. Для SEO и для честности это важно проговаривать прямо.

Шаг 1. Установить Ollama

macOS / Linux

curl -fsSL https://ollama.com/install.sh | sh

Windows / macOS через GUI

Скачайте установщик с сайта Ollama и завершите обычную установку.

Проверка CLI:

ollama --version

Если при запуске моделей вы ловите connection refused, значит запущен CLI, но не поднят сервер Ollama. Тогда стартуйте его вручную:

ollama serve

Шаг 2. Выбрать модель для Claude Code через Ollama

Список моделей у Ollama меняется, поэтому лучше смотреть актуальную страницу интеграции Claude Code. На 30 марта 2026 года в официальной интеграции Ollama рекомендует такие варианты:

Cloud-модели

• kimi-k2.5:cloud
• glm-5:cloud
• minimax-m2.7:cloud
• qwen3.5:cloud

Локальные модели

• glm-4.7-flash
• qwen3.5

На странице Anthropic-compatible API Ollama отдельно рекомендует для кодинга qwen3-coder. Там же есть важная ремарка: qwen3-coder — это 30B-модель, и для комфортной работы ей нужно как минимум 24 ГБ VRAM, а для длинного контекста ещё больше.

Если нужен простой старт на локальной машине, начните с:

ollama pull glm-4.7-flash

Если у вас мощная видеокарта и нужен более "кодовый" профиль:

ollama pull qwen3-coder

Проверка, что модель вообще отвечает:

ollama run glm-4.7-flash

Если модель запускается и отвечает, база готова.

Шаг 3. Увеличить context length до 64K

Это обязательный шаг, если вы хотите, чтобы Claude Code с Ollama работал стабильно. По документации Ollama:

• на машинах с VRAM меньше 24 GiB дефолтный контекст может быть всего 4k;
• для агентов, web search и coding tools рекомендуется минимум 64000 токенов.

Самый прямой способ задать контекст:

OLLAMA_CONTEXT_LENGTH=64000 ollama serve

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

Проверить, с каким контекстом реально поднята модель, можно так:

ollama ps

Смотрите на колонку CONTEXT. Для Claude Code через Ollama там должно быть что-то вроде 64000 или 65536, а не 4096.

Шаг 4. Установить Claude Code

На март 2026 официальный способ установки Claude Code — нативный инсталлер. Старый npm install -g считается устаревшим вариантом и нужен только для совместимости.

macOS / Linux / WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Проверка:

claude --version
claude doctor

Нужен ли Node.js?

Node.js 18+ нужен только если вы по какой-то причине ставите Claude Code через npm. Для нативного инсталлера он не обязателен.

Шаг 5. Один раз авторизоваться в Claude Code

После установки запустите:

claude

Claude Code откроет браузер и попросит завершить вход. Этот шаг обязателен, потому что Claude Code как продукт всё ещё завязан на аккаунт с доступом.

Если вы уже входили раньше, этот шаг можно пропустить.

Шаг 6. Запустить Claude Code через Ollama

Самый простой способ:

ollama launch claude

Ollama откроет меню выбора модели, сам настроит совместимый backend и запустит Claude Code.

Если хотите сразу указать модель:

ollama launch claude --model glm-4.7-flash

Для headless-сценариев, CI или скриптов у Ollama есть и неинтерактивный режим:

ollama launch claude --model glm-4.7-flash --yes -- -p "explain this repository"

Шаг 7. Ручная настройка через переменные окружения

Если ollama launch claude не работает, можно подключить Claude Code к Ollama вручную.

export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434

После этого запускайте Claude Code с именем модели из Ollama:

claude --model glm-4.7-flash

Или так, в одну строку:

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

Что делают эти переменные

• ANTHROPIC_BASE_URL перенаправляет Claude Code на локальный сервер Ollama;
• ANTHROPIC_AUTH_TOKEN=ollama обязателен для совместимости, но Ollama его не валидирует;
• пустой ANTHROPIC_API_KEY часто используют в гайдах и в официальной интеграции Ollama для совместимости.

Если хотите не вводить их каждый раз, добавьте переменные в ~/.zshrc, ~/.bashrc или в профиль вашей оболочки на Windows.

Как понять, что Claude Code действительно работает через локальную модель

Есть три практических признака:

1. Вы запускаете не :cloud-модель

Если у модели есть суффикс :cloud, inference точно идёт не локально.

2. В ANTHROPIC_BASE_URL указан http://localhost:11434

Это означает, что Claude Code обращается к Ollama на вашей машине.

3. В ollama ps видно активную модель

Команда:

ollama ps

покажет, какая модель реально загружена, где она работает и какой у неё контекст.

Когда Claude Code через Ollama действительно имеет смысл

Этот сценарий особенно полезен, если вы:

• хотите уменьшить расходы на API;
• работаете с чувствительным кодом и не хотите отправлять запросы в облако модели;
• учитесь пользоваться Claude Code и хотите экспериментировать на локальной модели;
• решаете простые и средние задачи, где облачный топовый inference избыточен.

Ограничения, о которых лучше знать заранее

Локальная модель слабее Opus и Sonnet

Это не "бесплатный Sonnet". Даже хорошие локальные модели заметно слабее облачных топовых моделей Anthropic на сложной архитектуре, больших рефакторингах и многошаговом reasoning.

Производительность сильно зависит от железа

Чем больше контекст, тем выше требования к памяти. Ollama прямо пишет, что память растёт вместе с OLLAMA_CONTEXT_LENGTH, а параллельная обработка увеличивает потребление ещё сильнее.

Cloud-модели через Ollama — это уже не локальность

Если вы используете kimi-k2.5:cloud, glm-5:cloud или другие cloud-варианты, запросы уходят наружу. Это удобно, но не равно приватному локальному запуску.

Частые ошибки и как их исправить

connection refused

Ollama-сервер не запущен.

ollama serve

model not found

Проверьте точное имя модели:

ollama list

Всё очень медленно

Чаще всего проблема в одном из трёх:

• модель слишком тяжёлая для вашей машины;
• контекст выставлен слишком большим для доступной памяти;
• модель частично выгружается на CPU.

Проверьте:

ollama ps

и посмотрите на PROCESSOR и CONTEXT.

Claude Code не даёт редактировать файлы или запускать команды

Проверьте систему разрешений внутри Claude Code:

/permissions

По документации Anthropic, Claude Code по умолчанию работает в более безопасном режиме и просит подтверждение на команды и изменения файлов.

:cloud-модель не стартует

Для облачных моделей Ollama может потребоваться вход:

ollama signin

FAQ

Можно ли запустить Claude Code полностью бесплатно?

Не совсем. На 30 марта 2026 года вы можете убрать оплату Anthropic API-инференса, если используете Ollama как backend, но сам Claude Code всё ещё требует аккаунт с доступом к Claude Code. Бесплатный план Claude.ai этого доступа не даёт.

Какая локальная модель лучше для Claude Code через Ollama?

Для простого старта подойдёт glm-4.7-flash. Если у вас мощное железо и нужен более сильный coding-профиль, стоит смотреть на qwen3-coder.

Обязательно ли ставить контекст 64K?

Для Claude Code, агентов и coding tools — да, это очень желательно. Именно здесь многие и спотыкаются: модель запускается, но с маленьким контекстом начинает вести себя нестабильно или бесполезно.

Можно ли запускать Claude Code офлайн?

Если вы используете локальную модель в Ollama, inference идёт локально. Но Claude Code как продукт остаётся связан с учётной записью и своей инфраструктурой. Поэтому корректнее говорить не "полностью офлайн", а "локальный inference модели через Ollama".

Вывод

Запуск Claude Code через Ollama — рабочий способ подключить локальную модель или альтернативный backend, не платить за Anthropic API-инференс и получить более приватный сценарий работы с кодом.

Но чтобы этот стек действительно работал хорошо, нужны три вещи:

• подходящий доступ к Claude Code;
• локальная или cloud-модель в Ollama;
• контекст минимум 64K, иначе Claude Code через Ollama быстро упрётся в ограничения.

Если хотите, следующим шагом этот текст можно:

1. сократить до более "человеческой" блоговой версии без потери SEO;
2. оформить сразу в HTML/Gutenberg-блоки для WordPress;
3. опубликовать в WordPress как черновик с title, slug, excerpt и метаописанием.