Да, Claude Code способен работать с локальной моделью через Ollama, и Ollama посвятила этому отдельную страницу документации. Связка не проверялась на реальном железе, поэтому дальше только то, что подтверждают тексты Anthropic и Ollama на 10 ноября 2026, и то, что придётся проверить самому. Справится ли выбранная модель с вашим репозиторием, покажет лишь собственный прогон. Порядок такого прогона описан в шаге 6.
К локальному запуску приходят по трём причинам: код нельзя выпускать с машины, сети нет или она нестабильна, либо хочется потрогать агента без платы за токены. Причины веские. Поэтому ограничения стоит прочесть до установки.
Что сказано в документации
| Вопрос | Что написано |
|---|---|
| Адрес и токен | Локальный сервер Ollama: http://localhost:11434, ANTHROPIC_AUTH_TOKEN=ollama. Ключ сервер не проверяет |
| Что поддержано | Сообщения, потоковый ответ, системные промпты, диалог из нескольких ходов, вызов инструментов и их результаты, режим рассуждений, картинки в base64 |
| Чего нет | tool_choice, metadata, подсчёт токенов /v1/messages/count_tokens, кэширование промптов cache_control, Batches API, цитаты, PDF-блоки, картинки по ссылке |
| Контекст | Для локальных моделей нужно окно «64k+» |
| Оговорки Ollama | Hosted WebSearch и расширенные настройки инструментов поддержаны не полностью, а модель должна уметь вызывать инструменты |
| Позиция Anthropic | Anthropic не поддерживает направление Claude Code на не-Claude модели через шлюзы |
Таблица опирается на три текста: документацию Claude Code по шлюзам и две страницы Ollama, про совместимость с Anthropic API и про Claude Code.
Особенно важна последняя строка. Anthropic не называет Ollama, но заявление по смыслу накрывает любую схему, где под ANTHROPIC_BASE_URL отвечает не Claude. Так читается текст, прямой цитаты тут нет. Следствие простое: если обновление Claude Code что-нибудь сломает на вашей локальной модели, ждать правки от Anthropic бессмысленно. В той же документации по шлюзам есть и второе предупреждение. Новые функции Claude Code появляются с каждым релизом, а шлюз, который их не пересылает, портит соответствующие возможности.
Запуск по шагам
Шаг 1. Установите Claude Code
Установка по документации Anthropic для macOS, Linux и WSL (подробности в руководстве по настройке Claude Code):
curl -fsSL https://claude.ai/install.sh | bash
В Windows подойдёт irm https://claude.ai/install.ps1 | iex, а при сбоях пригодится статья про установку Claude Code на Windows. Проверка: claude --version.
Шаг 2. Поставьте Ollama и скачайте модель
Установщик Ollama лежит на ollama.com. Затем скачайте модель, которую документация берёт для примера:
ollama pull qwen3.5
Без тега скачается latest, а в библиотеке Ollama на странице модели он совпадает с 9b. Семейство несёт метки vision, tools и thinking. Размеры загрузки такие:
| Тег | Размер скачивания |
|---|---|
qwen3.5:9b (он же latest) | 6.6-7.6 ГБ |
qwen3.5:27b | 17-20 ГБ |
qwen3.5:35b | 22 ГБ |
qwen3.5:122b | 81 ГБ |
Это размер одних только весов. Кэш контекста добавляется сверху, о нём ниже.
Шаг 3. Увеличьте контекст
Длину контекста Ollama подбирает по видеопамяти:
| Видеопамять | Контекст по умолчанию |
|---|---|
| меньше 24 ГиБ | 4k |
| 24-48 ГиБ | 32k |
| 48 ГиБ и больше | 256k |
Для Claude Code документация советует 64k и больше. Запускайте сервер так:
OLLAMA_CONTEXT_LENGTH=64000 ollama serve
В приложении Ollama это ползунок длины контекста в настройках. Проверяйте результат через ollama ps: колонка CONTEXT покажет фактическое число, а PROCESSOR скажет, целиком ли модель сидит на GPU или часть переехала на процессор.
Шаг 4. Запустите Claude Code на модели
Способ первый, одна команда из документации Ollama:
ollama launch claude --model qwen3.5
Какие настройки Claude Code эта команда меняет, документация не раскрывает, потому результат стоит сверить через /status.
Способ второй, ручной. macOS и Linux:
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3.5
Windows, PowerShell:
$env:ANTHROPIC_AUTH_TOKEN = "ollama"
$env:ANTHROPIC_API_KEY = ""
$env:ANTHROPIC_BASE_URL = "http://localhost:11434"
claude --model qwen3.5
Шаг 5. Узнайте, куда на самом деле идут запросы
Откройте /status: в строке Anthropic base URL должно быть http://localhost:11434. Нет такой строки? Значит, переменная не попала в сессию.
Документация Claude Code предупреждает о двух подводных камнях. Во-первых, при конфликте переменной в оболочке и в блоке env файла settings.json выигрывает файл. Раньше прописанный в ~/.claude/settings.json шлюз перебьёт ваш экспорт, и запросы пойдут к нему, а потому на время опытов блок env лучше убрать. Во-вторых, вход. Если переменные заданы только в проектных .claude/settings.json или .claude/settings.local.json, Claude Code всё равно попросит авторизоваться: эти файлы подхватываются уже после мастера первого запуска. Раньше срабатывают экспорт в оболочке, ~/.claude/settings.json и управляемые настройки.
Шаг 6. Дайте три задачи
Нужны три испытания на вашем репозитории. Первое: попросить объяснить модуль, которого вы не писали. Второе: починить упавший тест. Третье: внести одну правку сразу в два файла. Записывайте три числа: прошёл ли тест с первой попытки, сколько было итераций, сколько времени ушло. Если на втором испытании модель вертится по кругу, продолжать не стоит.
Что может не заработать
Поиск в сети. Ollama сообщает, что hosted WebSearch поддержан не полностью, поэтому веб-инструменты проверяйте отдельно.
Кэш промптов и счётчик токенов. В Ollama нет ни cache_control, ни count_tokens. Что Claude Code делает без счётчика, не проверялось.
Фоновые обращения к Anthropic (обновления, телеметрия) отключает CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1, платой станут автообновления. Но проверка безопасности WebFetch всё равно стучится на api.anthropic.com, и выключить её можно настройкой skipWebFetchPreflight: true. Запуск совсем без сети не пробовали, а сама установка без интернета невозможна.
Контекст. Рекомендация и умолчание расходятся в разы: 64k против 4k. Пропустите шаг 3, и результаты прогона опишут настройку, а не модель.
Модели. Примеры в документации Ollama используют qwen3.5, gemma4:cloud, glm-5.3-flash и kimi-k2.7-code:cloud. Других моделей, Qwen3.8 включительно, в этих текстах нет.
Как понять, что не тянет настройка или модель
Четыре признака, и ни для одного не нужны замеры.
PROCESSORвollama psпоказывает, где размещена модель: в видеопамяти, в оперативной или поровну. Любое значение, кроме «100% GPU», может говорить о том, что модель не поместилась в видеопамять целиком, и тогда выгрузка заметно её замедлит, как сказано в статье про Qwen. Но проверьте и другие причины: GPU мог быть отключён принудительно (скажем,CUDA_VISIBLE_DEVICES=-1) или не обнаружен Ollama, что на Linux случается после выхода из сна.- Колонка
CONTEXTне совпадает с заданным числом. Вероятно, сервер стартовал без переменной либо параллельно работает приложение Ollama с собственным значением. - В библиотеке у модели нет значка tools. Ollama ставит поддержку инструментов условием, и её страница связывает чат с правкой файлов именно с совместимыми моделями.
- На втором испытании из шага 6 агент ходит кругами: читает тот же файл, повторяет ту же правку, снова запускает тест. Это сигнал сменить модель или её размер.
Сколько памяти нужно
Формула и цифры для Qwen3.8 27B разобраны в статье «Qwen 3.8 27B локально». Веса Q4_K_M занимают около 16,5 ГБ, а кэш контекста в FP16 стоит около 64 КиБ на токен, то есть около 8,6 ГБ на 131 072 токена. На 64k кэш составит около 4,3 ГБ, и с рабочими буферами выйдет 22-23 ГБ. Для видеокарты или Mac с 24 ГБ это впритык, тем более что на Mac часть памяти забирает система. Расчёт сделан по цифрам из карточки модели и остаётся оценкой, не замером. Claude Code на этой модели не запускался.
Если памяти меньше, берите 9b из таблицы шага 2 или модель поменьше. Что даст такой размер в агентной работе, неизвестно, и ответит на это шаг 6.
Вердикт
Работает ли связка? По документации Ollama да, и страница официальная. Поддерживает ли её Anthropic? Нет. Будет ли хорошо на вашем железе? Неизвестно, а гадать по числу параметров не стоит.
Локальный путь имеет смысл при одном из четырёх условий: код не должен покидать машину, нужна работа без сети, подходящее железо уже есть либо интересно опробовать агента, не платя за токены. Платить придётся другим: электричеством и временем. Если нужен уровень Claude или предсказуемость после каждого обновления, локальная связка не обещает ни того, ни другого.
Можно сменить и самого агента. В той же статье про Qwen 3.8 есть команда ollama launch opencode --model qwen3.8, на странице Ollama про CLI тот же шаблон ollama launch показан для других интеграций, а установку OpenCode разбирает статья «OpenCode: установка и модели». Остальные инструменты сравниваются в обзоре альтернатив Claude Code.
Когда локально не хватает
Если не хватает памяти или качества, остаются облачные модели: они обходятся дешевле, чем кажется. Таблица ниже собрана из цен публичного каталога codexkey (канал Premium) на 10 ноября 2026, за 1 млн токенов. В последнем столбце условная задача: 1 млн токенов на входе, 200 тысяч на выходе, без кэша. Допущение нужно для сравнения и замером не является.
| Модель | Вход / выход | Условная задача |
|---|---|---|
deepseek-v4.1-flash-1017-free | $0 / $0 | $0 |
glm-5.3-flash | $0.06 / $0.16 | $0.092 |
deepseek-v4.1-flash | $0.06 / $0.22 | $0.104 |
claude-haiku-5.5 | $0.10 / $0.36 | $0.172 |
claude-sonnet-5-5 | $0.52 / $1.98 | $0.916 |
Приватность локального запуска здесь теряется: запросы уходят стороннему провайдеру, так что не отправляйте туда то, что нельзя показывать посторонним. Бесплатная модель одна, deepseek-v4.1-flash-1017-free, и она не Claude. 29 октября таких было три, список мог измениться снова, поэтому строить на ней рабочий процесс нельзя. Как подключить к Claude Code бесплатную или дешёвую модель, показано в статье «Claude Code бесплатно», о ключах и ценах Claude рассказывает разбор бесплатного Claude API, а как сократить платный счёт, объясняет статья про счёт за Claude Code.
Для бесплатной модели блок ~/.claude/settings.json выглядит так. Адрес пишут без /v1, строки ANTHROPIC_DEFAULT_* нужны все, иначе Claude Code запросит собственные модели:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.codexkey.ru",
"ANTHROPIC_AUTH_TOKEN": "sk_cdx_YOUR_KEY",
"ANTHROPIC_MODEL": "deepseek-v4.1-flash-1017-free",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4.1-flash-1017-free",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4.1-flash-1017-free",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4.1-flash-1017-free",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4.1-flash-1017-free"
}
}
Переменные описаны в гайде по Claude Code, а ключ появляется после регистрации. Сохранённый блок перекрывает экспорт в оболочке по тому же правилу, что в шаге 5, поэтому для опытов с Ollama его придётся убрать.
FAQ
Реально ли запустить Claude Code на своей машине?
Судя по документации Ollama, да: сервер принимает формат Anthropic Messages, а Claude Code можно направить на http://localhost:11434. Anthropic такой режим не поддерживает, а качество на вашем железе не измерялось.
Как направить Claude Code на Ollama?
Можно командой ollama launch claude --model qwen3.5, а можно тремя переменными: ANTHROPIC_AUTH_TOKEN=ollama, пустой ANTHROPIC_API_KEY и ANTHROPIC_BASE_URL=http://localhost:11434. После них запустите claude --model qwen3.5 и проверьте результат в /status. Подробности в шагах выше.
Работает ли Claude Code с локальной моделью без интернета?
Сами обращения к модели идут на локальный адрес. Для установки Claude Code и Ollama сеть нужна, а фоновый трафик Claude Code к Anthropic гасит переменная CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1. Полностью автономный старт не проверялся.
Какую локальную модель взять для Claude Code?
Документация Ollama показывает пример на qwen3.5. Опорных условий два: контекст от 64k, которого Ollama ждёт от локальных моделей, и умение вызывать инструменты (у семейства qwen3.5 в библиотеке есть метка tools). Модели по качеству не сравнивались, так что возьмите три задачи из шага 6 и прогоните по очереди 9b и 27b.
Признаёт ли Anthropic работу Claude Code с не-Claude моделями?
Нет. Об этом прямо сказано в документации по шлюзам: Anthropic не поддерживает направление Claude Code на не-Claude модели через шлюзы. Связка может заработать, но Anthropic ничего не обещает.
Ollama или бесплатная облачная модель: что выбрать?
Всё упирается в задачу. Ollama даёт приватность и работу без платы за токены, но ограничена вашей памятью и контекстом. Бесплатной облачной модели железо не нужно, зато запросы уходят стороннему провайдеру, а список бесплатных моделей меняется. Запуск Claude Code на таких моделях описан в статье про бесплатный Claude Code. Перед выбором прогоните обе на тех же трёх задачах.