Коротко: 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 её нет. Она показывает, что запрос дошёл до модели и агент умеет читать файлы. Что модель справится с большим проектом, она не показывает.
- Создай пустую папку и файл
proverka.txtс одной строкой:метка-7391. Метку придумай свою, чтобы модель не могла её угадать. - Открой терминал в этой папке и запусти Claude Code одним из двух способов.
- Выполни
/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, при заданном адресе они идут в шлюз даже с сохранённым входом, но тогда с лимитами подписки. - Напиши: «Прочитай файл proverka.txt и назови метку из него. Ничего не меняй». Claude Code может спросить разрешение на чтение: это обычная работа его разрешений.
- Пока агент отвечает, в другом окне выполни
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:
- Если подключал вручную: закрой окно терминала, переменные из
exportжили только в нём. Или сними их:unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_API_KEYна macOS и Linux. - Если переменные записаны в файл настроек, удали из блока
envтолько эти три:ANTHROPIC_BASE_URL,ANTHROPIC_AUTH_TOKEN,ANTHROPIC_API_KEY. Остальные настройки блока не трогай: значение файла сильнее терминала, но другие строки к этой связке не относятся. - Запусти
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, чтобы сверить программу курса со своими задачами. Статьи открыты без оплаты, материалы и подключение базы доступны после оплаты.