Claude Code

Как подключить Claude Code к Флоктору: установка, settings.json с ANTHROPIC_BASE_URL, алиасы моделей и решение частых ошибок.

Claude Code обращается к Anthropic-совместимому API Флоктора. Всё подключение — это один файл настроек: в нём меняется адрес и подставляется ваш ключ.

Шаг 1. Установите Claude Code

Способ установки выберите в официальном руководстве: их несколько, и подходящий зависит от вашей системы.

Для Visual Studio Code есть официальное расширение. В его настройках поставьте галочку «Disable Login Prompt», иначе расширение будет предлагать войти в аккаунт Anthropic, который вам не нужен.

Шаг 2. Пропишите настройки

Настройки Claude Code лежат в файле ~/.claude/settings.json. Откройте его, а если файла нет — создайте:

macOS и Linux: выполните mkdir -p ~/.claude и создайте в этой папке settings.json.
Windows: нажмите Win + R, введите %userprofile%\.claude и создайте там файл settings.json.

Содержимое:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.floctor.com",
    "ANTHROPIC_AUTH_TOKEN": "flk_••••••••••••••••",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Вместо flk_•••••••••••••••• подставьте свой ключ.

В ANTHROPIC_BASE_URL указывается корневой адрес — без /v1 на конце. Claude Code дописывает путь сам. Если добавить /v1, запросы уйдут на /v1/v1/messages и вернутся с 404.

Шаг 3. Выберите модели

Шаг необязательный. Claude Code переключает модели алиасами — opus, sonnet, haiku и вариант Default. Какая модель Флоктора стоит за каждым алиасом, задают эти переменные:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.floctor.com",
    "ANTHROPIC_AUTH_TOKEN": "flk_••••••••••••••••",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "ANTHROPIC_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

ANTHROPIC_MODEL — основная модель диалога. claude-fable-5-1 самая сильная, для повседневной работы часто хватает claude-opus-5.
ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL — что подставляется под соответствующий алиас.
ANTHROPIC_DEFAULT_HAIKU_MODEL используется ещё и для фоновых мелочей вроде заголовков сессий, поэтому там имеет смысл оставить модель подешевле.

Подробнее про алиасы — в документации Claude Code.

Шаг 4. Проверьте подключение

Перезапустите терминал и запустите Claude Code в любом проекте:

claude

Если диалог отвечает, всё настроено. Запросы появятся в статистике ключа в личном кабинете.

Что делать, если не работает

401, Unauthorized. Ключ не принят. Чаще всего он скопирован не целиком — проверьте начало flk_ и конец строки. Вторая по частоте причина: ключ отозван.

404, model not found. Такой модели нет. Имя модели у нас указывает ровно на одну модель, без сокращений и алиасов: новая версия приезжает под новым именем, старое исчезает. Сверьтесь со списком в личном кабинете, см. «Модели».

Обрывы потока, таймауты. Сначала проверьте своё соединение. Если оно в порядке, причиной может быть нагрузка — на стороне модели или на нашей. Если повторяется, напишите в поддержку.

Полный разбор кодов ошибок — в разделе «Ошибки».