Claude Code локально: подключение API и проверка проекта
Claude Code локально запускает клиент на вашем компьютере и работает с доступными ему файлами проекта. При подключении к Relay запросы к модели уходят на API Relay: это не запуск весов Claude на вашем устройстве и не автономная работа без сети. Если под «локально» вы понимаете полностью офлайн-режим, эта схема не подходит.
Для подключения используйте протокол Anthropic Messages и корневой адрес https://relay-llm.ru, без /v1 в базовом адресе клиента. Начните с отдельного тестового каталога и короткого запроса, прежде чем давать клиенту рабочий репозиторий.
Коротко
Локальный клиент выполняет разрешённые действия с файлами и командами.
Модель получает контекст через сетевой API.
API-ключ не определяет права клиента на вашем компьютере.
Что означает Claude Code локально
В этой схеме есть клиент, модель и инструменты. Клиент собирает сообщения и показывает ответ. Модель анализирует полученный контекст. Локальные инструменты читают файлы или выполняют команды в пределах разрешений клиента и операционной системы.
Не считайте выбранный каталог гарантированной изоляцией. Реальные права зависят от настроек, разрешений и доступных инструментов. Проверяйте предложенную команду и её рабочий каталог, особенно перед удалением, установкой зависимостей или доступом к внешнему сервису.
Содержимое запроса может включать инструкции, фрагменты исходников и результаты команд. Не добавляйте в тестовый проект ключи и файлы с секретами. Если клиент умеет исключать файлы из контекста, проверьте механизм в руководстве своей версии, а для первого опыта используйте каталог, где секретов вообще нет.
Как проверить API отдельно от клиента
Создайте отдельный ключ в кабинете и выберите модель с протоколом anthropic_messages в каталоге. Пример использует claude-opus-4-6. Модель, доступная только по OpenAI Chat, для этого запроса не подходит.
curl -sS -i https://relay-llm.ru/v1/messages \
-H "x-api-key: $RELAY_API_KEY" \
-H 'anthropic-version: 2023-06-01' \
-H 'Content-Type: application/json' \
-d '{"model":"claude-opus-4-6","max_tokens":128,"messages":[{"role":"user","content":"Ответь коротко: соединение работает."}]}'Перед запуском экспортируйте RELAY_API_KEY со своим ключом. При успехе в теле будет ответ Messages API. Сохраните x-request-id на случай диагностики, затем переходите к клиенту.
Полный путь в curl содержит /v1/messages. Базовый адрес Claude Code содержит только корень: клиент сам дописывает путь. Эти два значения нельзя механически подменять друг другом. Описание формата есть на странице Messages API.
Как настроить подключение Claude Code
Если клиент ещё не установлен, возьмите способ установки из его официального руководства. В этой статье не требуется конкретная версия или флаг установки. Порядок подключения шлюза описан также в документации Anthropic.
В интеграции Relay для Claude Code приведена полная настройка: ANTHROPIC_BASE_URL указывает на https://relay-llm.ru, а ключ передаётся через ANTHROPIC_AUTH_TOKEN. Сверьте её с руководством своей версии клиента.
Проверьте модель сеанса и настройки моделей для дополнительных задач и псевдонимов. Даже если основная модель выбрана правильно, другой встроенный идентификатор может отсутствовать в каталоге Relay. Не копируйте набор переменных из старой статьи без проверки актуальной страницы интеграции.
Храните секрет вне Git. Если используете пользовательский файл настроек, следите, чтобы его содержимое не попало в снимок экрана или диагностический архив. При смене ключа проверьте, не остаётся ли старое значение в другом источнике конфигурации.
Как испытать работу с файлами без риска для проекта
Создайте небольшой текстовый файл с функцией или заметкой и попросите объяснить его без изменений. Проверьте, что ответ относится к содержимому файла. Затем разрешите одну маленькую правку и прочитайте дифф.
Для кода подготовьте тест до изменения. Команда теста должна проверять конкретное поведение. Простого запуска интерпретатора недостаточно. Если клиент сообщает «тесты прошли», откройте вывод и убедитесь, что нужный тест выполнялся и вернул успешный статус.
Не выдавайте широкое разрешение на команды ради первого запроса. Начните с чтения и точечного изменения; доступ к сети, установку пакетов и запись за пределами проекта проверяйте отдельно по своей задаче.
Как разобрать ошибку и ограничить расходы
Если отдельный curl работает, а клиент показывает экран входа или отказ авторизации, проверьте, получил ли процесс нужные переменные. Редактор и терминал могут запускаться с разным окружением. Сверьте адрес и источник секрета по руководству клиента.
При 404 различайте неизвестный путь и неизвестную модель. Лишний /v1 в базовом адресе требует правки адреса; отсутствующий идентификатор требует сверки каталога. При 402 проверьте баланс и лимит ключа по справочнику ошибок.
Задайте ключу предел расходов. Агент может делать несколько вызовов ради одной правки, включая чтение результатов инструментов и повтор после ошибки. Проверяйте сумму и модель в истории запросов, а не оценивайте расход по числу видимых сообщений в чате.
Можно ли запустить Claude Code локально без отправки контекста в API?
В описанной схеме нет: модель вызывается через Relay по сети. Работа без удалённой модели требует другого решения.
Почему base URL без /v1, а curl с /v1/messages?
curl получает полный URL метода. Клиенту задают корень, а путь метода он добавляет сам.
Ключ Relay разрешает клиенту любые команды?
Нет. Ключ отвечает за API-доступ; разрешения на файлы и команды задаются отдельно в клиенте и системе.
Можно ли выбрать любую модель каталога?
Для этого подключения нужна поддержка Anthropic Messages. Проверьте протокол выбранной модели, а затем совместимость с клиентом.