AI-агенты на коротком поводке
Anthropic не любит, когда её детище используют там, где не ждали. Региональные ограничения Claude Code — головная боль для разработчиков из стран, которых нет в официальном списке. Но внутри инструмента спрятан рычаг: переменная ANTHROPIC_BASE_URL. Никаких упоминаний в документации, ни строчки в релиз-нотах. Чистый backdoor, о котором молчат, но который уже вовсю эксплуатируют.
Суть механизма: подменив базовый URL API, вы заставляете Claude Code отправлять запросы не в облачные дата-центры Anthropic, а на любой указанный адрес — локальный инстанс vLLM, прокси-сервер или даже китайский эндпоинт.
Как это работает (без кода)
При старте Claude Code считывает ANTHROPIC_BASE_URL из окружения. Если переменная задана — весь HTTPS-трафик летит туда. Аутентификация? Зависит от сервера. Для локальной модели это может быть пустой ключ. Для прокси — токен от Anthropic, но уже без географической привязки. Элегантно, грубо, эффективно.
Сообщество быстро подхватило трюк: достаточно поднять vLLM с любой открытой моделью (Llama 3.2, Qwen 2.5) и указать локальный адрес. Claude Code даже не дёрнется в сторону Anthropic. Проверка региона исчезает. Цензура — тоже (если модель не зашивала своих рамок).
Но есть нюанс: часть запросов всё равно уходит на серверы Anthropic. Речь о телеметрии, проверке лицензий и обновлениях. Claude Code течет как решето — и ANTHROPIC_BASE_URL не перекрывает эту утечку.
Двойной стандарт: свобода vs безопасность
С одной стороны, переменная даёт свободу. Разработчики из ЮАР, Индии, ОАЭ — везде, где API Anthropic официально не доступен, — получили шанс. Статья про глобальный вывод Claude 4.5 в AWS Bedrock показала, что можно обойти даже AWS-регионы. А китайские модели вроде Kimi и GLM уже подключили через ANTHROPIC_BASE_URL с восьмикратной экономией.
С другой — это дыра. Если вы ставите локальную модель без фильтров, Claude Code может сгенерировать всё что угодно. Anthropic теряет контроль над контентом. И главное — вы теряете защиту: ваши данные больше не шифруются на стороне вендора. Каждый промпт идёт через ваш собственный сервер, который может быть скомпрометирован.
А что говорит лицензия?
Формально — ни слова. Переменная не документирована, её использование не запрещено. Но если вы замените API и при этом используете платный тариф Claude Code, вы всё равно платите? Увы, да — лицензия остаётся привязана к аккаунту. Пиратства не выйдет. ANTHROPIC_BASE_URL лишь перенаправляет запросы модели, но не отключает проверку подписки. Без действующего ключа Claude Code даже не запустится.
Гибрид под капотом
Самый умный сценарий — гибрид. Для простых задач используете локальную модель через ANTHROPIC_BASE_URL. Для сложных — переключаетесь на официальный API (например, меняя URL обратно на api.anthropic.com). Так делают те, кто экономит $200 в месяц, заменяя Cursor Pro. Ollama + Claude API через одну переменную — и региональные ограничения сняты, а производительность не падает.
Не верь, но проверяй
На практике есть подводные камни. Во-первых, совместимость API: локальные модели реализуют не все эндпоинты (например, streaming или tool use могут баговаться). Во-вторых, производительность: vLLM или Ollama на домашнем GPU не сравнятся с облачными TPU. Контекстное окно быстро забивается — выход есть в отдельном гайде. В-третьих — регион. Если ваш прокси находится в США, а вы в России, задержка может убить интерактивность.
complete и stream. Иначе Claude Code просто упадёт с ошибкой 404.Что будет завтра
Anthropic наверняка знает об этом клозете. Может, даже специально оставили для партнёров. Но с ростом числа инцидентов (утечки через локальные инстансы, генерация опасного контента) компания может запатчить механизм — добавить валидацию сертификатов, проверку доменов, обязательный API-ключ. Пока же ANTHROPIC_BASE_URL остаётся легальным, хотя и полулегальным ключом к свободе. И каждый разработчик решает сам: пользоваться им или ждать, пока Anthropic закрутит гайки.
А если не хотите ждать — возьмите готовый репозиторий с инструкцией и замените один URL. За 10 минут. Без регистрации и смс. Но с осознанием, что ваш AI-агент теперь ходит без намордника.
