Что нужно заранее
- Создайте ключ в кабинете на странице «Ключи API». Список моделей в ключе оставьте пустым. Если заполняете, названия должны быть точными, например
claude-opus-5-5, а неclaude. - Оплатите тариф или пополните баланс. Тариф ничем отдельно не подключается: запросы по этому же ключу сначала тратят его лимиты.
Расширение 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 |
|---|---|
| Opus | claude-opus-5-5 |
| Sonnet | claude-sonnet-5-5 |
| Haiku и служебные задачи | claude-haiku-5-5 |
Переключайтесь командой /model. Модели вне тарифа оплачиваются с баланса.
Как проверить
- Запустите Claude Code и введите
/status. Должны быть строка Anthropic base URL с адресомhttps://api.fastsubs.orgи строка Auth token. - Если строк нет, настройка не дошла до Claude Code. В VS Code проверьте настройку из раздела выше и перезапустите окно.
- Если есть строка 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, как показано выше.