Claude Key Switcher

Переключение API-ключей (и base URL) для Claude Code прямо из VS Code — в один клик, с индикатором активного ключа в статус-баре.

Claude Code читает ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN из ~/.claude/settings.json. Плагин держит несколько именованных ключей и переписывает эти две строки, когда вы переключаетесь. Остальные настройки файла (permissions, model, theme, прочие env) не трогаются.

Возможности

• Список ключей в отдельной панели Activity Bar: имя, маска ключа, отметка активного.
• Статус-бар $(key) Claude: work-1 — всегда видно, какой ключ сейчас в конфиге. Если файл правили руками и он разошёлся с плагином, иконка меняется на $(warning).
• Переключение в один клик: клик по статус-бару → QuickPick → готово.
• Свой base URL у ключа (необязательно) + общий URL по умолчанию.
• Проверка ключа — реальный POST /v1/messages, показывает 401/403/429 или OK + задержку.
• Импорт текущего ключа из ~/.claude/settings.json, чтобы не вбивать заново.
• Авто-фейловер (по желанию): раз в N минут проверяет активный ключ и переключается на следующий, если тот отвалился (401/403/429).
• Ключи хранятся в VS Code SecretStorage (шифруются ОС), а не в settings.json открытым текстом.
• Перед записью конфига Claude делается резервная копия ~/.claude/settings.json.bak.

Установка

Из готового .vsix

code --install-extension claude-key-switcher-0.1.0.vsix

Или в VS Code: Extensions → ... → Install from VSIX....

Из исходников (режим разработки)

npm install
npm run compile

Открыть папку плагина в VS Code и нажать F5 — запустится отдельное окно «Extension Development Host» с уже установленным плагином.

Как пользоваться

1. Откройте панель Claude Keys на Activity Bar (иконка ключа).
2. Нажмите $(cloud-download) Импортировать текущий ключ — плагин подхватит то, что уже лежит в ~/.claude/settings.json.
3. Добавьте остальные ключи кнопкой +: имя → ключ → base URL (можно оставить пустым, тогда используется общий).
4. Клик по ключу в списке (или по статус-бару) — он становится активным.
5. Перезагрузите окно, когда плагин предложит: Claude Code читает env при старте процесса.

Проверить ключ, не переключаясь: кнопка «колба» в строке ключа.

Что плагин пишет в конфиг

~/.claude/settings.json до:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://claude.example.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-old-key",
    "DISABLE_LOGIN_COMMAND": "true"
  },
  "model": "opus",
  "theme": "dark"
}

После активации ключа work-2:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://claude.example.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-new-key",
    "DISABLE_LOGIN_COMMAND": "true"
  },
  "model": "opus",
  "theme": "dark"
}

Если в конфиге используется ANTHROPIC_API_KEY вместо ANTHROPIC_AUTH_TOKEN, плагин пишет в ту переменную, которая уже есть, — стиль авторизации не меняется. Если заданы обе, обновляются обе, чтобы старое значение не перебивало выбранный ключ.

ANTHROPIC_BASE_URL плагин пишет только если base URL задан явно (в настройке claudeKeys.baseUrl или у конкретного ключа). Пустое поле = «не трогать»: адрес из ~/.claude/settings.json остаётся как был.

Настройки

Команды

Все доступны из Command Palette (Ctrl+Shift+P → Claude Keys):

Переключить ключ, Добавить ключ, Изменить ключ, Удалить ключ, Проверить ключ, Задать base URL, Импортировать текущий ключ, Показать активный ключ, Открыть settings.json Claude Code, Перезагрузить окно.

Ограничения

• Нужна перезагрузка окна. Claude Code (и его расширение) получает env при старте процесса. Плагин меняет файл, но уже запущенная сессия продолжит работать со старым ключом до перезагрузки окна / нового процесса.
• Переменные окружения ОС имеют приоритет. Если ANTHROPIC_AUTH_TOKEN задан в системных переменных Windows, settings.json его не переопределит. Проверьте: Get-ChildItem Env:ANTHROPIC_*.
• Настройки проекта важнее пользовательских. Если в папке проекта есть .claude/settings.local.json или .claude/settings.json с ANTHROPIC_AUTH_TOKEN, они перебьют ~/.claude/settings.json. Если переключение «не сработало» — проверьте эти файлы в первую очередь.
• Настройка claudeCode.environmentVariables (в настройках VS Code) тоже задаёт env для процесса Claude Code. Если ключ прописан и там, он может перебивать плагин — статус-бар покажет предупреждение. Плагин эту настройку не трогает: держите ключ в одном месте.
• Авто-фейловер реагирует только на явные отказы авторизации/лимита (401/403/429) — он не читает трафик Claude Code, а периодически пингует активный ключ.
• Ключи хранятся в SecretStorage. Если удалить расширение, они пропадут — держите копию в менеджере паролей.

Разработка

npm install        # зависимости (typescript, @types/vscode, vsce)
npm run compile    # tsc -> out/
npm test           # node --test по чистым модулям (без vscode)
npm run package    # .vsix в корне

Структура:

• src/claudeSettings.ts — чтение/запись ~/.claude/settings.json (без зависимости от vscode, покрыт тестами).
• src/profiles.ts — модель именованных ключей, маскирование, валидация.
• src/health.ts — проверочный запрос к /v1/messages.
• src/tree.ts — панель со списком ключей.
• src/extension.ts — команды, статус-бар, авто-фейловер.

Публикация

• npm run package → .vsix (личная установка).
• npm run publish:marketplace → VS Code Marketplace (нужен PAT, см. PUBLISHING.md).
• npm run publish:openvsx → Open VSX (VSCodium, Gitpod, Theia).

Лицензия

MIT