ВойтиПолучить доступ

Инструменты12 минобновлено

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

Коротко: Claude Code Ollama - это запуск Claude Code на открытой модели, которую обслуживает Ollama. Подключается командой ollama launch claude или тремя переменными окружения, ключ Anthropic не нужен. Запросы уходят на твой компьютер, а если выбрана облачная модель - в облако Ollama. Но это уже не Claude: Anthropic такой запуск не поддерживает, а по документации Ollama агенту нужен контекст не меньше 64 тысяч токенов. Команды сверены с документацией 19 ноября 2026 года.

Что такое Claude Code Ollama и чем это отличается от обычного запуска

Claude Code - это агент: программа, которая читает файлы проекта, правит их и запускает команды. Думает за неё модель, обычно Claude на серверах Anthropic. Ollama - программа, которая запускает открытые модели у тебя на компьютере и принимает запросы в формате Anthropic Messages API. В блоге Ollama от 16 января 2026 года это сказано про версии v0.14.0 и новее. Покажи Claude Code адрес Ollama, и он начнёт слать запросы туда.

Обычный Claude Code Claude Code Ollama
Кто отвечает Claude на серверах Anthropic Выбранная тобой открытая модель, у тебя или в облаке Ollama
Вход Аккаунт claude.ai или ключ Anthropic Слово ollama вместо токена
Поддержка Anthropic Anthropic такой запуск не поддерживает
Расход Подписка или токены Anthropic Локальные модели без подписки, облачные платные

Что бесплатно в самом Claude Code, разобрано отдельно: бесплатный доступ. Облачную модель DeepSeek в Claude Code подключают тем же способом: DeepSeek в Claude Code.

Что понадобится

  • Claude Code. По документации Anthropic: macOS 13, Windows 10 версии 1809 или Windows Server 2019, Ubuntu 20.04, от 4 ГБ памяти. Установка - curl -fsSL https://claude.ai/install.sh | bash на macOS и Linux, irm https://claude.ai/install.ps1 | iex в PowerShell. Подробно: установка Claude Code и Windows.
  • Ollama. Страница загрузки: приложение для macOS, OllamaSetup.exe для Windows, для Linux - curl -fsSL https://ollama.com/install.sh | sh. На Windows нужна версия 10 22H2 или новее, права администратора не нужны, под программу нужно не меньше 4 ГБ, под модели - ещё до сотен гигабайт.
  • Память под модель. Каталог Ollama на 19 ноября 2026: qwen3.5 версии 9b - 6,6-7,6 ГБ, 27b - 17-20 ГБ, qwen3-coder 30b - 19 ГБ. Сверху память под контекст: чем он больше, тем больше нужно. Таблицы «сколько памяти под 64 тысячи токенов» в документации Ollama я не нашёл.
  • Папка для пробы с одним текстовым файлом.

Способ 1: команда ollama launch

Самый короткий путь к Claude Code Ollama - одна команда:

ollama launch claude

Команда есть в справочнике Ollama: она настраивает внешнюю программу на модели Ollama и запускает её, в интерактивном режиме предлагая выбрать модель. Сразу с моделью:

ollama launch claude --model qwen3.5

Для скриптов есть режим без вопросов. Пример из документации использует облачную модель:

ollama launch claude --model gemma4:cloud --yes -- -p "how does this repository work?"

Флаг --yes пропускает выбор, скачивает модель при необходимости и требует --model; всё после -- уходит в Claude Code. Ставит ли launch сам Claude Code, документация не уточняет, поэтому поставь его заранее. С какой версии Ollama команда появилась, я не нашёл: если её нет, проверь ollama --version и обнови программу.

Способ 2: переменные вручную

macOS и Linux, по документации Ollama:

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

В PowerShell те же значения задаются в синтаксисе из документации Claude Code для шлюзов:

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

Слово ollama в токене - заглушка: в документации оно помечено «required but ignored», локальный сервер ключи не проверяет. После --model стоит имя модели из Ollama, не из Claude. По документации Claude Code, при заданных адресе и токене он открывается сразу в сессии, без экрана входа.

Переменные в окне терминала живут одну сессию. Файл настроек сохраняет их навсегда, но значение из файла сильнее терминала; как записать блок env, показано в статье про DeepSeek в Claude Code, механика та же. Сначала проверь связку в одном окне.

Облако вместо своего компьютера. Модели с суффиксом :cloud работают на серверах Ollama. Через вошедший в аккаунт сервер Ollama на компьютере их вызывают по имени, например gemma4:cloud. Есть и прямое подключение без установки Ollama: адрес https://ollama.com и ключ Ollama в ANTHROPIC_AUTH_TOKEN. Облако принимает только заголовок с токеном, поэтому ANTHROPIC_API_KEY остаётся пустым. Это уже не свой компьютер и не бесплатно.

Контекст для Claude Code Ollama: не меньше 64 тысяч токенов

Контекст - объём текста, который модель держит в памяти за раз. Документация Ollama: для агентов, веб-поиска и кодовых инструментов нужно не меньше 64 000 токенов. По умолчанию значение зависит от видеопамяти:

Видеопамять Контекст по умолчанию
Меньше 24 ГиБ 4 тысячи
24-48 ГиБ 32 тысячи
48 ГиБ и больше 256 тысяч

Если видеопамяти меньше 24 ГиБ, по документации без настройки будет 4 тысячи токенов. Поднять контекст можно ползунком длины контекста в настройках приложения Ollama или, если они недоступны, запуском сервера командой OLLAMA_CONTEXT_LENGTH=64000 ollama serve.

Потом проверь, как модель загрузилась: ollama ps показывает колонки PROCESSOR и CONTEXT. Документация советует не допускать, чтобы модель частично ушла на процессор: если в PROCESSOR видна доля CPU, памяти не хватило, и работа замедлится. Облачные модели идут с максимальным контекстом. Ставит ли ollama launch нужное значение сам, в документации не сказано, смотри ollama ps.

Какую модель выбрать

На странице интеграции Ollama написано: выбирай модель с достаточным контекстом под твой репозиторий, для локальных - окно от 64 тысяч токенов, а инструменты работают на совместимых моделях. Что стоит в примерах и каталоге на 19 ноября 2026 года:

Модель Где работает Что известно из документации и каталога
qwen3.5 Локально Пример запуска в документации. Метки tools, vision, thinking; сборки от 0,8b до 122b, версия 9b - 6,6-7,6 ГБ
qwen3-coder Локально Метка tools; версия 30b - 19 ГБ, 480b - 290 ГБ
gemma4:cloud, kimi-k2.7-code:cloud Облако Ollama Примеры в документации, платные
glm-5.3-flash Облако, прямое подключение Пример прямого подключения без установки Ollama

В январе блог Ollama советовал gpt-oss:20b и qwen3-coder, сегодня в примерах страницы интеграции стоит qwen3.5: список меняется, сверяй с документацией в день запуска. Какая модель справится с твоим проектом, документация не обещает.

Проверка связки Claude Code Ollama за пять минут

Эту проверку придумали мы, в документации Ollama её нет. Она показывает, что запрос дошёл до модели и агент умеет читать файлы. Что модель справится с большим проектом, она не показывает.

  1. Создай пустую папку и файл proverka.txt с одной строкой: метка-7391. Метку придумай свою, чтобы модель не могла её угадать.
  2. Открой терминал в этой папке и запусти Claude Code одним из двух способов.
  3. Выполни /status. Строка Anthropic base URL должна показывать http://localhost:11434, строка Auth token - называть ANTHROPIC_AUTH_TOKEN. Нет строки с адресом - возможно, переменная не дошла до сессии. Если вместо Auth token стоит Login method с аккаунтом claude.ai, значит, активен сохранённый вход claude.ai, а не токен ollama: до сессии не дошла переменная ANTHROPIC_AUTH_TOKEN. Куда идут запросы, показывает только строка с адресом: по документации Claude Code, при заданном адресе они идут в шлюз даже с сохранённым входом, но тогда с лимитами подписки.
  4. Напиши: «Прочитай файл proverka.txt и назови метку из него. Ничего не меняй». Claude Code может спросить разрешение на чтение: это обычная работа его разрешений.
  5. Пока агент отвечает, в другом окне выполни ollama ps: твоя модель должна стоять в списке загруженных.

Агент назвал точную метку и модель есть в ollama ps - связка Claude Code Ollama работает. Нет метки или модель не загружалась - смотри таблицу ниже.

Я сам плачу за Claude картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить картуРеклама. ООО "Капибара". ИНН 9703231520. erid: CQH36pWzJqNS1hfhQNyQNjbmhaUSfywWpWF3LE48uoYyEF

Что не поддерживается в Claude Code Ollama

Страница совместимости Ollama называет функции API Anthropic, которых нет: подсчёт токенов /v1/messages/count_tokens, принудительный выбор инструмента tool_choice, метаданные запроса, кеширование промптов, пакетный режим, ссылки-цитаты, PDF и сообщения об ошибках внутри потока ответа. Картинки принимаются только в виде base64, а у «мышления» параметр budget_tokens принимается, но не соблюдается. Число токенов Ollama считает приближённо. Как каждый пункт скажется на работе Claude Code, документация не разбирает. На странице интеграции перечислено, что работает: чат, команды с запросом разрешений, вызов инструментов на совместимых моделях, правка файлов, субагенты, веб-поиск через Ollama и картинки.

Главное ограничение другое. В документации Claude Code про шлюзы на 19 ноября 2026 года написано, что Anthropic не поддерживает направление Claude Code на модели не от Claude через любой шлюз и не проверяет сторонние шлюзы. Ты работаешь с открытой моделью в оболочке Claude Code, и ответственность за результат на тебе.

Что уходит в сеть и сколько это стоит

  • Локальная модель. Запросы идут на localhost:11434, по странице цен Ollama от 19 ноября 2026 это тариф без подписки.
  • Облачные модели. Имя с :cloud отправляет запрос в облако Ollama, даже когда Claude Code ходит на localhost. По их FAQ, содержимое запросов не хранится и не используется для обучения. Облачные модели платные, бесплатного плана для них на странице цен нет; цены меняются, смотри ollama.com/pricing.
  • Веб-поиск. Идёт через API Ollama и требует бесплатной учётной записи и ключа.

Что ещё отправляет сам Claude Code, кроме запросов к модели, я не проверял, поэтому «полностью без сети» не обещаю. Про лимиты подписки Claude: пока задан токен, запросы идут не по входу claude.ai (документация Claude Code).

Как вернуться на Claude

Чтобы отключить связку Claude Code Ollama:

  1. Если подключал вручную: закрой окно терминала, переменные из export жили только в нём. Или сними их: unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_API_KEY на macOS и Linux.
  2. Если переменные записаны в файл настроек, удали из блока env только эти три: ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY. Остальные настройки блока не трогай: значение файла сильнее терминала, но другие строки к этой связке не относятся.
  3. Запусти claude, при необходимости выполни /login и проверь /status: строки Anthropic base URL быть не должно, в Login method должен стоять твой аккаунт.

Куда ollama launch записывает свои настройки, в документации не описано. Поэтому закрытие окна после ollama launch может не вернуть прежнее состояние: ориентируйся на /status.

Если не работает

Что видишь Что проверить
В /status нет строки Anthropic base URL Возможно, переменные не дошли до сессии. Запусти claude из того же окна, где задал их, и проверь файлы настроек: значение там главнее терминала
«Model not found» или похожий ответ Проверь, скачана ли модель: ollama list, при необходимости ollama pull qwen3.5. Для имён с :cloud Ollama на компьютере должен быть с входом в аккаунт
Агент не читает файлы Причин несколько. Проверь, есть ли у модели в каталоге метка tools, ответил ли ты на запрос разрешения на чтение в Claude Code и запущен ли он в папке с нужным файлом
Агент забывает начало задачи и путает файлы Посмотри колонку CONTEXT в ollama ps: она показывает фактический контекст. Если он меньше 64 тысяч, задай больше. Если нормальный, причина может быть в самой модели или в размере задачи, документация Ollama это не разбирает
Каждый шаг идёт минуты Посмотри PROCESSOR в ollama ps: доля CPU означает, что часть модели ушла на процессор (документация Ollama советует этого избегать). Можно взять сборку меньше или уменьшить контекст
Облако отвечает отказом Прямое подключение принимает только заголовок с токеном: проверь, что ключ Ollama стоит в ANTHROPIC_AUTH_TOKEN, а ANTHROPIC_API_KEY пустой
Инструмент просит модель с именем Anthropic Документация Ollama: скопируй свою модель под нужное имя, например ollama cp qwen3-coder claude-3-5-sonnet

Что дальше

Если запуск удался, решай, где нужна локальная модель, а где Claude: когда это оправдано и какое железо тянет локального агента, разобрано в статье про локального ИИ-агента. Другие агенты на Ollama - Codex и Copilot CLI.

Как собрана эта статья

Команды, версии, ограничения и условия сверены 19 ноября 2026 года с документацией Ollama (интеграция с Claude Code, совместимость с API Anthropic, длина контекста, справочник команд, Windows, цены, FAQ облака, веб-поиск), каталогом моделей Ollama и документацией Claude Code (шлюзы, подключение, установка). Пересказы блогов за источник не брались. Команды сверены с документацией, на отдельном компьютере в этой статье они не запускались; проверку на контрольном файле придумали мы.

Хочешь понять, какую модель брать под какую задачу, не переплачивая? В ClaudeBase есть урок «Какую модель выбрать: Claude, GPT, китайские». Открой страницу доступа ClaudeBase, чтобы сверить программу курса со своими задачами. Статьи открыты без оплаты, материалы и подключение базы доступны после оплаты.

Спрашивают

Пять вопросов по теме

Нужна ли подписка Claude, чтобы запустить Claude Code с Ollama?

Ключ Anthropic не нужен: в документации Ollama вместо него стоит слово ollama, а локальный сервер ключи не проверяет. Пока задан этот токен, запросы идут не по входу claude.ai, и лимиты подписки на них не действуют. Локальные модели по странице цен Ollama от 19 ноября 2026 идут без подписки, облачные платные.

Какую модель Ollama взять для Claude Code?

Нужна модель с поддержкой инструментов, иначе агент будет только писать текст. В документации Ollama примеры идут на qwen3.5 и облачных моделях; в каталоге у qwen3.5 есть метка tools, сборка 9b весит 6,6-7,6 ГБ. Справится ли она с твоим проектом, документация не обещает: проверь на контрольной задаче.

Какой контекст нужен и как его включить?

Документация Ollama советует не меньше 64 тысяч токенов для агентов и кодовых инструментов. По умолчанию на видеокарте с памятью меньше 24 ГиБ контекст равен 4 тысячам. Поменять его можно ползунком в приложении Ollama или запуском сервера командой OLLAMA_CONTEXT_LENGTH=64000 ollama serve, результат смотри в ollama ps.

Поддерживает ли Anthropic такой запуск Claude Code?

Нет. В документации Claude Code про шлюзы на 19 ноября 2026 сказано, что Anthropic не поддерживает направление Claude Code на модели не от Claude через любой шлюз и не проверяет сторонние шлюзы. Если что-то сломалось, отвечать будет документация Ollama и сообщество, а не поддержка Anthropic.

Работает ли Claude Code с Ollama без интернета?

Обещать это нельзя. Локальная модель отвечает на твоём компьютере, но облачные модели Ollama и веб-поиск идут через ollama.com, а что ещё отправляет сам Claude Code, кроме запросов к модели, в этой статье не проверялось. Подробнее о том, что уходит наружу, написано в разборе локального ИИ-агента.

Источники