Как подключить Claude Code к FastSubs

Claude Code работает с FastSubs напрямую: нужно указать наш адрес и ваш ключ. Важная особенность: терминал и расширение VS Code настраиваются в разных местах, поэтому ключ, который работает в терминале, расширение может не увидеть.

Обновлено

Что нужно заранее

  1. Создайте ключ в кабинете на странице «Ключи API». Список моделей в ключе оставьте пустым. Если заполняете, названия должны быть точными, например claude-opus-5-5, а не claude.
  2. Оплатите тариф или пополните баланс. Тариф ничем отдельно не подключается: запросы по этому же ключу сначала тратят его лимиты.

Расширение VS Code

Откройте палитру команд (Ctrl+Shift+P, на Mac Cmd+Shift+P), выберите Preferences: Open User Settings (JSON) и добавьте:

{
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.fastsubs.org" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "ВАШ_КЛЮЧ" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5-5" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-5-5" }
  ]
}

Если в файле уже есть другие настройки, добавьте эти строки внутрь общих фигурных скобок. Сохраните файл и перезапустите окно командой Developer: Reload Window.

Для расширения этот способ главный. Документация Claude Code предупреждает: значения только из ~/.claude/settings.json не проходят собственную проверку входа в расширении.

Терминал

Постоянная настройка: откройте файл ~/.claude/settings.json (в Windows %USERPROFILE%\.claude\settings.json) и добавьте:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.fastsubs.org",
    "ANTHROPIC_AUTH_TOKEN": "ВАШ_КЛЮЧ",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}

Для одного сеанса в bash или zsh:

export ANTHROPIC_BASE_URL="https://api.fastsubs.org"
export ANTHROPIC_AUTH_TOKEN="ВАШ_КЛЮЧ"
claude

В PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.fastsubs.org"
$env:ANTHROPIC_AUTH_TOKEN = "ВАШ_КЛЮЧ"
claude

Адрес указывайте без /v1 на конце: Claude Code добавит путь сам. Не кладите ключ в файл .claude/settings.json внутри проекта, он может попасть в git.

Зачем указывать модели

Claude Code сам выбирает модели для основной работы и для служебных задач, например для названий сеансов. Три переменные выше говорят ему использовать наши названия, которые входят в тариф Claude:

Режим в Claude CodeМодель FastSubs
Opusclaude-opus-5-5
Sonnetclaude-sonnet-5-5
Haiku и служебные задачиclaude-haiku-5-5

Переключайтесь командой /model. Модели вне тарифа оплачиваются с баланса.

Как проверить

  1. Запустите Claude Code и введите /status. Должны быть строка Anthropic base URL с адресом https://api.fastsubs.org и строка Auth token.
  2. Если строк нет, настройка не дошла до Claude Code. В VS Code проверьте настройку из раздела выше и перезапустите окно.
  3. Если есть строка Login method с аккаунтом claude.ai, введите /logout.

Проверить сам ключ отдельно от Claude Code можно из терминала:

curl https://api.fastsubs.org/v1/messages \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5-5", "max_tokens": 20, "messages": [{"role": "user", "content": "привет"}]}'

Если пришёл ответ модели, ключ и тариф в порядке, ищите причину в настройках Claude Code.

Частые ошибки

Что видитеЧто сделать
Просит войти в аккаунт, хотя ключ указанВ VS Code задайте ключ в claudeCode.environmentVariables и включите claudeCode.disableLoginPrompt. В терминале проверьте /status.
Ошибка 401, Invalid tokenКлюч не тот или удалён. Скопируйте его заново из раздела «Ключи API», без пробелов и кавычек внутри.
Ошибка про модель или нет доступа к моделиПроверьте три переменные с моделями и список моделей в самом ключе. Названия должны совпадать точно.
Не удаётся подключитьсяПроверьте адрес: https://api.fastsubs.org без /v1. Выполните проверку через curl.
Ошибка 400 про context_management или Extra inputs are not permittedДобавьте переменную CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS со значением 1.
Сообщение про баланс или лимитЛимит тарифа кончился, а на балансе нет денег, либо сработал лимит трат самого ключа. Остаток и время обновления показаны на странице «Баланс».

Что не работает со сторонним ключом

Функции, привязанные к аккаунту claude.ai, недоступны: Remote Control и голосовой ввод. Остальная работа с кодом идёт как обычно.

Частые вопросы

Нужна ли подписка Claude на сайте Anthropic?

Нет. Достаточно тарифа или баланса FastSubs и ключа из кабинета.

Тариф нужно как-то привязывать к ключу?

Нет. Запросы к моделям тарифа по любому вашему ключу сначала тратят лимиты тарифа, а когда они кончаются, баланс.

В терминале работает, а в VS Code нет. Почему?

Расширение проверяет вход до запуска и читает ключ из своей настройки. Задайте его в claudeCode.environmentVariables, как показано выше.

Попробуйте сами

Один аккаунт — все нейросети: текст, картинки, видео и музыка. Платите за запросы или берите тариф, оплата российскими картами.