Claude Provider Switcher

Switches the official Claude Code extension between model providers in one click — your native Claude subscription, direct provider endpoints (DeepSeek, MiniMax, …), a self-hosted gateway (LiteLLM, etc.) or a local server (LM Studio, Ollama). The active provider lives in the status bar: click it and pick another one from the menu — no panels to open. Per-profile hotkeys are even faster, and a sidebar view is where you add and edit connections (and can switch too).

Pick a provider from the built-in catalog: the endpoint is pre-filled and the model list is fetched from the provider itself, so the only thing you usually type is your API key — while every connection parameter stays hand-editable when you need it.

Languages: English · Русский · 中文

No accounts, no keys bundled. This extension ships zero credentials. Your profiles — including any API keys — live only in your settings and are never sent anywhere. · Никаких аккаунтов и ключей в пакете. Профили (включая ключи) хранятся только в твоих настройках и никуда не отправляются. · 不含任何账号或密钥。 本扩展不附带任何凭据；你的配置（包括 API 密钥）仅保存在你自己的设置中，绝不外发。

English

What it's for

1. Switch providers quickly, inside VS Code — a switch writes the profile's environment variables into Claude Code's claudeCode.environmentVariables setting (read when a session starts). Your ~/.claude/settings.json is not touched.
2. …or keep the CLI in sync — flip on writeClaudeSettings and the active provider is also mirrored into ~/.claude/settings.json, so claude in a plain terminal switches with you.
3. Switch & reload to keep working right away — the Switch provider & reload window command (or switchAction = switchAndReload) switches and reloads in one step, so the next session starts on the new provider immediately. Pair it with auto-fallback: if the target is unreachable, the switch reroutes to its backup provider automatically.
4. Or run providers side by side — with auto-reload off, running sessions keep the provider they started with: switch, open a new Claude Code tab, and work against two providers at once — right in the same VS Code window (or across windows).

Quick start

1. Install this extension and the Claude Code extension.
2. Open the Claude Providers view from the Activity Bar (the dotted icon) and click + Add provider. Pick a template — Custom (blank), Claude Subscription, Claude API, a built-in Anthropic-compatible provider (DeepSeek, Kimi, MiniMax, Qwen, Xiaomi MiMo, Z.ai, …), or a local server (Ollama, LM Studio, llama.cpp, vLLM): the Base URL (and model mapping, where fixed) is pre-filled. Then just add your API key. Every field stays editable (see Profile fields); an empty Base URL = native subscription.
3. Switch by clicking the status bar indicator, with the profile's hotkey, or via the row in the sidebar.
4. Start a new Claude Code session (new chat / Reload Window) so it picks up the change — Claude Code reads the environment when a session starts, not live.

Features

The interface

• 🔌 Status bar — the active provider is always visible at the bottom of the window; one click opens the switch menu, no panels needed. After a switch it tints and reminds you to restart the session (toggle with showRestartHint).
• ⌨️ Per-profile hotkeys — each profile can own a shortcut (Ctrl+Alt+1…Ctrl+Alt+9, Ctrl+Alt+0); new profiles get the next free slot automatically and the binding is written to your keybindings.json for you. Plus cycle: Ctrl+Alt+] / Ctrl+Alt+[ (macOS Cmd+Alt+…).
• 🎛️ Menu — Claude Provider: Select provider… from the palette, or via the status bar item.
• 🗂️ Sidebar — a Claude Providers view in the Activity Bar to add / edit / delete / duplicate / reorder / switch providers. Field-by-field editor with dropdowns — no hand-editing settings.json, no codes to remember.
• 🌐 UI in English / Русский / 中文 — the language setting; auto follows VS Code.

Setting up providers

• 📇 Built-in catalog — Claude Subscription, Claude API, Anthropic-compatible providers (DeepSeek, Kimi, MiniMax, Qwen, Xiaomi MiMo, Z.ai, …) and local servers (Ollama, LM Studio, llama.cpp, vLLM), with Base URLs and fixed model mappings pre-filled.
• 🧩 Pick models from a list — the Opus/Sonnet/Haiku fields fetch the provider's model catalog (GET /v1/models) so you choose from a dropdown instead of typing the id.
• ➕ Add your own providers — a table editor (Manage custom providers…) covers anything not in the catalog; your entries appear in the Add provider menu tagged (custom). Backed by the customProviders setting.
• 🔐 Secure keys — API keys are stored in VS Code SecretStorage, never in settings.json; the editor shows them masked.
• ⚡ Test connection — check that an endpoint is reachable and your API key is accepted, right from the row.
• 🟢 Health indicator — a 🟢/🔴 tint shows each provider's reachability. Refresh on demand (❤ button) or set healthCheck to periodic. The check uses GET /v1/models — no inference, zero tokens.
• 📊 Usage statistics — each provider's tooltip shows how many times you switched to it, how long it has been active, and its token usage today, over the last 7 days and the last 30 days (input / output / cache), including a per-model breakdown next to each mapped Opus/Sonnet/Haiku line. Tokens are read from Claude Code's session transcripts and attributed to whichever provider was active when each session started. Tracked locally (in globalState, not settings.json); clear it with Reset usage statistics, or hide it with showUsageStats / showTokenStats (the latter also stops transcript reading).
• 🧪 Extra environment variables — set any other variable Claude Code reads (e.g. ANTHROPIC_CUSTOM_HEADERS, CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY) per profile, without hand-editing settings.json.
• 📤 Import / Export — share or back up your profiles as JSON (keys excluded by default).

Switching, day to day

• ⚙️ Switch action — a setting controls every switch: just switch (switch, the default), or switch and immediately reload the window (switchAndReload). A dedicated Switch provider & reload window command always does both in one step, regardless of the setting.
• 🔀 Auto-fallback — give a profile a fallback provider; Switch with fallback probes the target and, if it's down, switches to the fallback (following the chain). Flip on autoFallbackOnApply to apply this to every switch.
• 📌 Pin to workspace — bind a provider to a folder; opening that workspace auto-switches to it (stored per-workspace, not in settings.json). Right-click → Pin to this workspace.
• 🖥️ Mirror to the CLI — writeClaudeSettings also writes the active provider into ~/.claude/settings.json, so claude in a plain terminal uses it too. Only the keys this extension manages are touched; the rest of the file is preserved.
• 📝 Gateway tip — profiles whose Base URL looks like a third-party LLM gateway get a short tooltip note about Claude Code's /model and ANTHROPIC_DEFAULT_*_MODEL behaviour for gateways.
• ∞ Unlimited profiles (hotkeys cover the first 10 slots; the rest are switched via the sidebar/menu).

Managing providers (sidebar)

The active provider is marked with a filled dot. Editing is field-by-field: pick a field, set its value, repeat, then Done. Color and Hotkey are chosen from a dropdown — no codes to remember.

Adding a provider that isn't in the list

The Add provider menu ships a built-in catalog (loaded from a bundled providers.json), but you can add your own. Run Manage custom providers… — from the Add provider menu (bottom entry), the view title-bar … overflow, or the command palette — to open a small table editor:

Click + Add provider, fill the row, then Save. Your providers then show up in the Add provider menu tagged (custom), and their endpoints are matched for logos and health checks just like the built-ins. The table maps one-to-one onto the claudeProviderSwitcher.customProviders setting, so you can edit that JSON directly too. API keys aren't entered here — you add them per profile (kept in SecretStorage) after picking the provider.

Hotkeys

• Assigned per profile. Defaults to the next free Ctrl+Alt+<n> on Add; change it anytime via Edit → Hotkey (or set None).
• The extension keeps your User keybindings.json in sync automatically (it only manages its own claudeProviderSwitcher.switchToIndex entries and never touches your other shortcuts).

Profile fields

Inside Claude Code you can still switch tiers with /model.

When do you need extra environment variables?

Most setups never need these — the dedicated fields cover the common case. The Extra environment variables field is an escape hatch for third-party endpoints and gateways that need a per-provider tweak Claude Code reads from the environment. Common ones:

These take effect on the next Claude Code session (start a new chat or reload the window). They don't fix a resumed session, which keeps the model and settings from its saved transcript.

Example provider configs

You normally add these via the sidebar, but here are the values to enter (replace YOUR_*_KEY):

Native Claude subscription — leave every field empty (Base URL empty).

DeepSeek (direct, Anthropic-compatible):

MiniMax (direct; models must be explicit):

Local LM Studio (offline) — enable the server (Developer → Start Server, port 1234); use the exact model id from http://localhost:1234/v1/models; token = any non-empty string:

Self-hosted gateway (LiteLLM / OpenAI-compatible proxy) — one endpoint, switch models with /model:

"claudeProviderSwitcher.profiles": [
  { "name": "Subscription", "color": "🟢", "hotkey": "Ctrl+Alt+1", "env": {} },
  {
    "name": "DeepSeek", "color": "🟣", "hotkey": "Ctrl+Alt+2",
    "env": {
      "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
      "ANTHROPIC_AUTH_TOKEN": "YOUR_DEEPSEEK_API_KEY",
      "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
      "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
      "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash"
    }
  },
  {
    "name": "MiniMax", "color": "🟡", "hotkey": "Ctrl+Alt+3",
    "env": {
      "ANTHROPIC_BASE_URL": "https://api.minimax.io/anthropic",
      "ANTHROPIC_AUTH_TOKEN": "YOUR_MINIMAX_API_KEY",
      "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M3",
      "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M3",
      "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7"
    }
  },
  {
    "name": "LM Studio", "color": "🟠", "hotkey": "Ctrl+Alt+4",
    "env": {
      "ANTHROPIC_BASE_URL": "http://localhost:1234",
      "ANTHROPIC_AUTH_TOKEN": "lmstudio",
      "ANTHROPIC_DEFAULT_OPUS_MODEL": "your-loaded-model-id",
      "ANTHROPIC_DEFAULT_SONNET_MODEL": "your-loaded-model-id",
      "ANTHROPIC_DEFAULT_HAIKU_MODEL": "your-loaded-model-id"
    }
  }
]

Settings

Notes

• Start a new session after switching. Claude Code reads claudeCode.environmentVariables when a session starts, not live — so after switching, open a new chat. A resumed chat (and a window reload, which restores the conversation) keeps the model and settings from its saved transcript, so a reload alone may not pick up a model change. Set claudeProviderSwitcher.switchAction to switchAndReload, or use the Switch provider & reload window command, to reload automatically — but a fresh chat is the reliable way to apply a provider/model change.
• Running sessions keep their provider. A switch only affects sessions started afterwards — which is exactly what lets you run different providers in parallel Claude Code tabs, in the same VS Code window or across windows (keep switchAction at switch for that).
• Prefer ANTHROPIC_AUTH_TOKEN over ANTHROPIC_API_KEY for third-party endpoints (Bearer header).
• Local servers (Ollama, LM Studio, llama.cpp, vLLM): the preset fills the Base URL and a throwaway token — set the model to your loaded model id. For llama.cpp, start llama-server with --jinja, otherwise tool calls won't work and Claude Code stops acting like an agent.
• Reasoning models may return an empty final message when max_tokens is too low (tokens go into reasoning) — provider behavior, not the switcher.

Русский

Переключает официальное расширение Claude Code между провайдерами моделей в один клик: нативная подписка Claude, прямые эндпоинты (DeepSeek, MiniMax, …), свой шлюз (LiteLLM и т.п.) или локальный сервер (LM Studio, Ollama). Активный провайдер всегда виден в статус-баре: клик по индикатору — и выбираешь другого из меню, никакие панели открывать не нужно. Ещё быстрее — хоткеи на профиль; а подключения заводятся и редактируются в сайдбаре (переключаться оттуда тоже можно).

Провайдер выбирается из встроенного каталога: эндпоинт уже подставлен, а список моделей подтягивается с самого провайдера — так что обычно вводить нужно только API-ключ. При этом каждый параметр подключения остаётся доступным для ручного редактирования.

Основные сценарии

1. Быстро переключать провайдеров внутри VS Code — при переключении переменные профиля пишутся в настройку claudeCode.environmentVariables расширения Claude Code (читается при старте сессии). Твой ~/.claude/settings.json не затрагивается.
2. …или синхронно с CLI — включи writeClaudeSettings, и активный провайдер дополнительно зеркалится в ~/.claude/settings.json, так что claude в обычном терминале переключается вместе с тобой.
3. Переключиться и сразу продолжить работу — команда Переключиться и перезагрузить окно (или switchAction = switchAndReload) делает оба шага сразу, и новая сессия стартует на новом провайдере без лишних действий. В паре с авто-фолбэком недоступный провайдер автоматически заменяется резервным — переключение остаётся устойчивым.
4. Или работать с разными провайдерами параллельно — без авто-перезагрузки запущенные сессии сохраняют своего провайдера: переключись, открой новую вкладку Claude Code — и работай с двумя провайдерами одновременно прямо в одном окне VS Code (или в соседних окнах).

Быстрый старт

1. Установи это расширение и Claude Code.
2. Открой панель Claude Providers в Activity Bar (иконка из точек) → + Add provider. Выбери шаблон — Custom (пусто), Claude Subscription, Claude API, встроенный Anthropic-совместимый провайдер (DeepSeek, Kimi, MiniMax, Qwen, Z.ai, …) или локальный сервер (Ollama, LM Studio, llama.cpp, vLLM): Base URL (и маппинг моделей, где он фиксирован) подставится сам. Останется только вписать свой API-ключ. Все поля остаются редактируемыми (см. Поля профиля); пустой Base URL = нативная подписка.
3. Переключайся кликом по индикатору в статус-баре, хоткеем профиля или по строке в сайдбаре.
4. Запусти новую сессию Claude Code (новый чат / Reload Window) — переменные читаются при старте сессии, не на лету.

Возможности

Интерфейс

• 🔌 Статус-бар — активный провайдер всегда виден внизу окна; один клик открывает меню переключения, никакие панели не нужны. После переключения индикатор подсвечивается и напоминает перезапустить сессию (отключается настройкой showRestartHint).
• ⌨️ Хоткей на профиль — у каждого профиля своя комбинация (Ctrl+Alt+1…Ctrl+Alt+9, Ctrl+Alt+0); новому профилю автоматически выдаётся ближайший свободный слот, биндинг сам прописывается в твой keybindings.json. Плюс цикл: Ctrl+Alt+] / Ctrl+Alt+[ (на macOS Cmd+Alt+…).
• 🎛️ Меню — Claude Provider: Select provider… из палитры или через индикатор в статус-баре.
• 🗂️ Сайдбар — панель Claude Providers в Activity Bar: добавить / изменить / удалить / дублировать / переместить / переключить провайдера. Редактирование по полям с выпадающими списками — без правки settings.json руками и без кодов, которые надо помнить.
• 🌐 Интерфейс на English / Русский / 中文 — настройка language; auto следует языку VS Code.

Настройка провайдеров

• 📇 Встроенный каталог — Claude Subscription, Claude API, Anthropic-совместимые провайдеры (DeepSeek, Kimi, MiniMax, Qwen, Xiaomi MiMo, Z.ai, …) и локальные серверы (Ollama, LM Studio, llama.cpp, vLLM); Base URL и фиксированные маппинги моделей подставляются сами.
• 🧩 Выбор модели из списка — поля Opus/Sonnet/Haiku подтягивают каталог моделей провайдера (GET /v1/models), и ты выбираешь из выпадающего списка, а не вводишь id вручную.
• ➕ Свои провайдеры — табличный редактор (Manage custom providers…) для всего, чего нет в каталоге; твои записи появляются в меню Add provider с пометкой (custom). Хранится в настройке customProviders.
• 🔐 Безопасные ключи — API-ключи хранятся в SecretStorage VS Code, а не в settings.json; в редакторе показываются замаскированными.
• ⚡ Проверка соединения — прямо из строки профиля проверить, что эндпоинт доступен и ключ принят.
• 🟢 Индикатор здоровья — цвет 🟢/🔴 показывает доступность каждого провайдера. Обновляй по кнопке (❤) или включи healthCheck = periodic. Проверка идёт через GET /v1/models — без инференса, ноль токенов.
• 📊 Статистика использования — в подсказке каждого провайдера видно, сколько раз ты на него переключался, сколько времени он был активен и сколько токенов израсходовано за сегодня, за 7 дней и за 30 дней (вход / выход / кэш), с разбивкой по моделям рядом с каждой замапленной строкой Opus/Sonnet/Haiku. Токены читаются из транскриптов сессий Claude Code и относятся к тому провайдеру, который был активен на старте сессии. Считается локально (в globalState, не в settings.json); сбросить — командой Сбросить статистику использования, скрыть — настройками showUsageStats / showTokenStats (вторая также отключает чтение транскриптов).
• 🧪 Доп. переменные окружения — задай любую другую переменную, которую читает Claude Code (напр. ANTHROPIC_CUSTOM_HEADERS, CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY), на уровне профиля и без ручной правки settings.json.
• 📤 Импорт / экспорт — поделиться профилями или сделать бэкап в JSON (ключи по умолчанию исключаются).

Переключение в работе

• ⚙️ Действие при переключении — настройка определяет, что происходит при каждом переключении: просто переключить (switch, по умолчанию) или переключить и сразу перезагрузить окно (switchAndReload). Отдельная команда Переключиться и перезагрузить окно всегда делает оба шага, независимо от настройки.
• 🔀 Авто-фолбэк — задай профилю резервный провайдер; Switch with fallback проверит его и, если он недоступен, переключится на резервный (по цепочке). Включи autoFallbackOnApply, чтобы так работало при каждом переключении.
• 📌 Привязка к workspace — закрепи провайдера за папкой; при открытии этого workspace расширение автоматически переключится на него (хранится по workspace, не в settings.json). ПКМ → Pin to this workspace.
• 🖥️ Зеркалирование в CLI — writeClaudeSettings дополнительно пишет активного провайдера в ~/.claude/settings.json, чтобы claude в обычном терминале использовал его же. Трогаются только ключи, которыми управляет расширение; остальное в файле сохраняется.
• 📝 Подсказка про шлюз — у профилей с Base URL, похожим на сторонний LLM-шлюз, в тултипе появляется короткая заметка о поведении Claude Code для шлюзов (/model и ANTHROPIC_DEFAULT_*_MODEL).
• ∞ Без лимита на число профилей (хоткеи покрывают первые 10 слотов; остальные — через сайдбар/меню).

Управление провайдерами (сайдбар)

Активный провайдер помечен закрашенной точкой. Редактирование — по полям: выбрал поле, задал значение, повторил, потом Done. Color и Hotkey выбираются из списка — никаких кодов запоминать не надо.

Добавление провайдера, которого нет в списке

Меню Add provider содержит встроенный каталог (грузится из вшитого providers.json), но можно добавить и своего. Запусти Manage custom providers… — из меню Add provider (нижний пункт), из меню «…» в шапке панели или из палитры команд — откроется табличный редактор:

Нажми + Add provider, заполни строку, затем Save. Провайдеры появятся в меню Add provider с пометкой (custom), а их эндпоинты так же сопоставляются с логотипами и health-check, как встроенные. Таблица один-в-один соответствует настройке claudeProviderSwitcher.customProviders — этот JSON можно править и напрямую. Ключи здесь не вводятся — их добавляешь в профиль (хранятся в SecretStorage) уже после выбора провайдера.

Хоткеи

• Назначаются на профиль. При Add ставится ближайший свободный Ctrl+Alt+<n>; сменить можно в любой момент через Edit → Hotkey (или None).
• Расширение само поддерживает твой User keybindings.json в актуальном виде (трогает только свои записи claudeProviderSwitcher.switchToIndex, чужие шорткаты не задевает).

Поля профиля

Внутри Claude Code уровни можно менять командой /model.

Когда реально нужны доп. переменные окружения?

Большинству они не нужны — штатных полей хватает для обычных случаев. Поле Доп. переменные окружения — это «отвёртка» для сторонних эндпоинтов и шлюзов, которым нужна донастройка на уровне провайдера, читаемая Claude Code из окружения. Частые:

Применяются в следующей сессии Claude Code (новый чат или перезагрузка окна). Возобновлённую сессию они не меняют — она тянет модель и настройки из сохранённого transcript.

Примеры провайдеров

Обычно их добавляют через сайдбар, но вот значения для ввода (вместо YOUR_*_KEY — свои ключи):

• Нативная подписка — все поля пустые (пустой Base URL).
• DeepSeek: Base URL https://api.deepseek.com/anthropic, токен YOUR_DEEPSEEK_API_KEY, Opus/Sonnet/Haiku = deepseek-v4-pro / deepseek-v4-flash / deepseek-v4-flash.
• MiniMax: Base URL https://api.minimax.io/anthropic, токен YOUR_MINIMAX_API_KEY, Opus/Sonnet/Haiku = MiniMax-M3 / MiniMax-M3 / MiniMax-M2.7.
• LM Studio: Base URL http://localhost:1234, токен lmstudio, модель = точный id из http://localhost:1234/v1/models (включи сервер: Developer → Start Server).
• Свой шлюз: Base URL https://your-gateway.example, токен YOUR_GATEWAY_KEY, модели — алиасы твоего шлюза.

Полный пример settings.json см. в свёрнутом блоке английской секции выше.

Настройки

Заметки

• После переключения начни новую сессию. Claude Code читает claudeCode.environmentVariables при старте сессии, а не на лету — поэтому после переключения открой новый чат. Возобновлённый чат (и перезагрузка окна, которая восстанавливает беседу) держит модель и настройки из сохранённого transcript, так что один лишь reload может не подхватить смену модели. Можно включить claudeProviderSwitcher.switchAction = switchAndReload или использовать команду Переключиться и перезагрузить окно для авто-reload — но надёжно применяет смену провайдера/модели именно новый чат.
• Запущенные сессии сохраняют своего провайдера. Переключение влияет только на сессии, начатые после него — именно это позволяет работать с разными провайдерами в параллельных вкладках Claude Code, в одном окне VS Code или в соседних (для этого держи switchAction = switch).
• Для сторонних эндпоинтов используй ANTHROPIC_AUTH_TOKEN, не ANTHROPIC_API_KEY (заголовок Bearer).
• Локальные серверы (Ollama, LM Studio, llama.cpp, vLLM): пресет подставляет Base URL и токен-заглушку — задай модель = id своей загруженной модели. Для llama.cpp запускай llama-server с флагом --jinja, иначе не работают вызовы инструментов и Claude Code перестаёт вести себя как агент.
• Reasoning-модели при малом max_tokens могут вернуть пустой финальный ответ — это поведение провайдера, не переключателя.

中文

让官方 Claude Code 扩展在不同模型服务商之间一键切换 —— 原生 Claude 订阅、服务商直连端点（DeepSeek、MiniMax 等）、 自建网关（LiteLLM 等）或本地服务（LM Studio、Ollama）。当前服务商始终显示在状态栏：点击 指示器即可从菜单中选择另一个，无需打开任何面板。每个配置的快捷键更快一步；侧边栏则用于添加和 编辑连接（也能在那里切换）。

从内置目录中选择服务商：端点已预填，模型列表直接从服务商拉取，通常只需输入你的 API 密钥 —— 同时所有连接参数仍可随时手动编辑。

主要场景

1. 在 VS Code 内快速切换服务商 —— 切换时把配置的环境变量写入 Claude Code 扩展的 claudeCode.environmentVariables 设置（会话启动时读取），不会触碰你的 ~/.claude/settings.json。
2. ……或与 CLI 保持同步 —— 开启 writeClaudeSettings，当前服务商会同时镜像到 ~/.claude/settings.json，让终端里的 claude 跟着一起切换。
3. 切换并立即继续工作 —— 切换服务商并重新加载窗口 命令（或 switchAction = switchAndReload） 一步完成切换与重载，新会话直接运行在新服务商上。配合自动回退：目标不可达时自动改用其备用服务商， 切换始终稳定可靠。
4. 或并行使用多个服务商 —— 不开自动重载时，已运行的会话保持各自的服务商：切换后新开一个 Claude Code 标签页，即可在同一个 VS Code 窗口里同时使用两个服务商（跨窗口也可以）。

快速开始

1. 安装本扩展和 Claude Code 扩展。
2. 从活动栏打开 Claude Providers 视图（圆点图标），点击 + Add provider，选择一个模板 —— Custom（空白）、Claude Subscription、Claude API、内置的 Anthropic 兼容服务商（DeepSeek、Kimi、MiniMax、Qwen、Xiaomi MiMo、Z.ai 等）或本地服务（Ollama、LM Studio、llama.cpp、vLLM）：Base URL（以及 固定的模型映射）会自动填好，你只需填入自己的 API 密钥。所有字段仍可编辑（见下方 配置字段）；Base URL 留空 = 原生订阅。
3. 点击状态栏指示器、用配置的快捷键，或点击侧边栏中的行来切换。
4. 启动新的 Claude Code 会话（新对话 / 重载窗口）使其生效 —— Claude Code 在会话启动时读取环境变量， 不会实时刷新。

功能特性

界面

• 🔌 状态栏 —— 当前服务商始终显示在窗口底部；一次点击即打开切换菜单，无需任何面板。切换后会高亮 并提醒你重启会话（可用 showRestartHint 关闭）。
• ⌨️ 每个配置独立快捷键（Ctrl+Alt+1…Ctrl+Alt+9、Ctrl+Alt+0）；新配置自动分配下一个空闲槽位， 快捷键自动写入你的 keybindings.json。另有循环切换：Ctrl+Alt+] / Ctrl+Alt+[（macOS 为 Cmd+Alt+…）。
• 🎛️ 菜单 —— 命令面板中的 Claude Provider: Select provider…，或通过状态栏项。
• 🗂️ 侧边栏 —— 活动栏中的 Claude Providers 视图，可添加 / 编辑 / 删除 / 复制 / 重排 / 切换 服务商。逐字段编辑、下拉选择 —— 无需手动改 settings.json，无需记任何代码。
• 🌐 界面支持 English / Русский / 中文 —— language 设置；auto 跟随 VS Code。

配置服务商

• 📇 内置目录 —— Claude Subscription、Claude API、Anthropic 兼容服务商（DeepSeek、Kimi、MiniMax、Qwen、Xiaomi MiMo、Z.ai 等）和本地服务（Ollama、LM Studio、llama.cpp、vLLM）；Base URL 与固定的模型映射 自动预填。
• 🧩 从列表选择模型 —— Opus/Sonnet/Haiku 字段会从服务商拉取模型目录（GET /v1/models）， 让你从下拉列表中选择，而无需手动输入 id。
• ➕ 添加自定义服务商 —— 表格编辑器（Manage custom providers…）可添加目录中没有的任意服务商； 自定义项以 (custom) 标记出现在 Add provider 菜单中。由 customProviders 设置存储。
• 🔐 密钥安全 —— API 密钥存储在 VS Code SecretStorage 中，而非 settings.json；编辑器中以掩码显示。
• ⚡ 测试连接 —— 直接在行内检查端点是否可达、API 密钥是否被接受。
• 🟢 健康指示器 —— 用 🟢/🔴 颜色显示每个服务商的可达性。可按需刷新（❤ 按钮），或将 healthCheck 设为 periodic。检测使用 GET /v1/models —— 不触发推理、零 token 消耗。
• 📊 使用统计 —— 每个服务商的悬浮提示会显示你切换到它的次数、它处于活跃状态的时长，以及今天、最近 7 天和最近 30 天的 token 用量（输入 / 输出 / 缓存），并在每个映射的 Opus/Sonnet/Haiku 行旁显示该模型的细分用量。token 数据读取自 Claude Code 的会话记录，并归属到会话开始时处于活跃状态的服务商。统计在本地进行（存于 globalState，而非 settings.json）；可用 重置使用统计 命令清除，或用 showUsageStats / showTokenStats 隐藏（后者还会停止读取会话记录）。
• 🧪 额外环境变量 —— 按配置设置 Claude Code 读取的任意其他变量（如 ANTHROPIC_CUSTOM_HEADERS、 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY），无需手动编辑 settings.json。
• 📤 导入 / 导出 —— 以 JSON 形式分享或备份配置（默认不含密钥）。

日常切换

• ⚙️ 切换行为设置 —— 控制每次切换时执行的操作：仅切换（switch，默认），或切换并立即重新加载窗口 （switchAndReload）。专用的 切换服务商并重新加载窗口 命令始终一步完成两者，不受设置影响。
• 🔀 自动回退 —— 为配置指定一个回退服务商；Switch with fallback 会先探测目标，若不可达则切换到 回退服务商（沿链依次尝试）。开启 autoFallbackOnApply 可让每次切换都执行此操作。
• 📌 绑定到工作区 —— 将服务商绑定到某个文件夹；打开该工作区时自动切换到它（按工作区存储， 不写入 settings.json）。右键 → Pin to this workspace。
• 🖥️ 同步到 CLI —— writeClaudeSettings 会把活动服务商同时写入 ~/.claude/settings.json，让普通 终端中的 claude 也使用它。仅修改本扩展管理的键，文件其余内容保持不变。
• 📝 网关提示 —— Base URL 看起来像第三方 LLM 网关的服务商，其悬停提示会附上关于 Claude Code 在 网关上对 /model 和 ANTHROPIC_DEFAULT_*_MODEL 行为的简短说明。
• ∞ 配置数量不限（快捷键覆盖前 10 个槽位，其余通过侧边栏/菜单切换）。

管理服务商（侧边栏）

当前服务商以实心圆点标记。编辑是逐字段进行的：选择字段、填值、重复，最后 Done。颜色与快捷键 都从下拉列表选择 —— 无需记任何代码。

添加内置列表中没有的服务商

Add provider 菜单自带一份内置目录（从打包的 providers.json 加载），但你也可以添加自己的。运行 Manage custom providers… —— 从 Add provider 菜单（底部项）、视图标题栏「…」菜单或命令面板 —— 打开一个表格编辑器：

点击 + Add provider，填好一行，然后 Save。你的服务商会以 (custom) 标记出现在 Add provider 菜单中，其端点也会像内置项一样用于标志匹配和健康检测。该表格与 claudeProviderSwitcher.customProviders 设置一一对应，你也可以直接编辑该 JSON。这里不填密钥 —— 选择服务商后在每个配置中单独添加（保存在 SecretStorage 中）。

快捷键

• 按配置分配。添加时默认取下一个空闲的 Ctrl+Alt+<n>；随时可在 Edit → Hotkey 修改（或设为 None）。
• 扩展会自动同步你的用户 keybindings.json（只管理自己的 claudeProviderSwitcher.switchToIndex 条目，绝不触碰你的其他快捷键）。

配置字段

在 Claude Code 内部仍可用 /model 切换档位。

什么时候真的需要额外环境变量？

大多数场景都用不到 —— 专用字段已覆盖常见需求。额外环境变量字段是为第三方端点和网关准备的「应急口」， 用于设置 Claude Code 从环境读取的、针对单个服务商的调整。常见的有：

这些在下一个 Claude Code 会话生效（新建对话或重新加载窗口）。它们不会改变恢复的会话 —— 后者沿用其已保存 transcript 中的模型与设置。

服务商示例（用自己的密钥替换 YOUR_*_KEY）

• 原生 Claude 订阅 —— 所有字段留空（Base URL 为空）。
• DeepSeek： Base URL https://api.deepseek.com/anthropic，令牌 YOUR_DEEPSEEK_API_KEY， Opus/Sonnet/Haiku = deepseek-v4-pro / deepseek-v4-flash / deepseek-v4-flash。
• MiniMax： Base URL https://api.minimax.io/anthropic，令牌 YOUR_MINIMAX_API_KEY， Opus/Sonnet/Haiku = MiniMax-M3 / MiniMax-M3 / MiniMax-M2.7。
• 本地 LM Studio： Base URL http://localhost:1234，令牌 lmstudio，模型 = http://localhost:1234/v1/models 返回的精确 id（启动服务：Developer → Start Server）。
• 自建网关： Base URL https://your-gateway.example，令牌 YOUR_GATEWAY_KEY，模型 = 你网关的模型别名。

设置项

说明

• 切换后请开始新会话。 Claude Code 在会话启动时读取 claudeCode.environmentVariables，而非实时刷新 —— 因此切换后请新建对话。恢复的对话（以及会恢复对话的窗口重载）会沿用其已保存 transcript 中的 模型与设置，所以仅重载窗口可能无法应用模型变更。可将 claudeProviderSwitcher.switchAction 设为 switchAndReload，或使用 切换服务商并重新加载窗口 命令来自动重载 —— 但可靠地应用服务商/模型变更的方式 是新建对话。
• 已运行的会话保持原服务商。 切换只影响之后启动的会话 —— 正因如此，你可以在并行的 Claude Code 标签页中使用不同的服务商，同一个 VS Code 窗口内或跨窗口均可（此时请保持 switchAction 为 switch）。
• 第三方端点优先用 ANTHROPIC_AUTH_TOKEN 而非 ANTHROPIC_API_KEY（Bearer 头）。
• 本地服务（Ollama、LM Studio、llama.cpp、vLLM）：预设会填好 Base URL 和一个占位令牌 —— 请把模型 设为你已加载模型的 id。对于 llama.cpp，启动 llama-server 时要加 --jinja，否则工具调用无法 工作，Claude Code 会不再像智能体一样运行。
• 推理类模型在 max_tokens 过小时可能返回空的最终消息（token 都用于推理）—— 这是服务商行为，与本扩展无关。

Privacy / Конфиденциальность / 隐私

This extension stores nothing remotely and bundles no credentials. It reads claudeProviderSwitcher.profiles, keeps API keys in VS Code SecretStorage (not settings.json), writes claudeCode.environmentVariables (including the active provider's key, which Claude Code reads there), and manages its own entries in your keybindings.json. Test connection sends one request to the endpoint you configured — nowhere else. · Расширение ничего не хранит удалённо и не содержит ключей. Оно читает claudeProviderSwitcher.profiles, хранит API-ключи в SecretStorage VS Code (а не в settings.json), пишет claudeCode.environmentVariables (включая ключ активного провайдера, откуда его читает Claude Code) и ведёт свои записи в keybindings.json. Проверка соединения отправляет один запрос только на указанный тобой эндпоинт. · 本扩展不在远端存储任何内容，也不附带凭据。它读取 claudeProviderSwitcher.profiles，将 API 密钥保存在 VS Code SecretStorage（而非 settings.json）， 写入 claudeCode.environmentVariables（含当前服务商的密钥，Claude Code 在此读取），并维护 keybindings.json 中属于自己的条目。测试连接 仅向你配置的端点发送一个请求。

Trademarks / Товарные знаки / 商标

Provider names and logos (DeepSeek, MiniMax, Qwen, Z.ai, Vercel, Poe, …) are trademarks of their respective owners and are used here for identification only. This extension is independent and not affiliated with, endorsed by, or sponsored by any of these providers. · Названия и логотипы провайдеров (DeepSeek, MiniMax, Qwen, Z.ai, Vercel, Poe и др.) — товарные знаки их владельцев и используются только для идентификации. Расширение независимо и не аффилировано ни с одним из провайдеров, не одобрено и не спонсируется ими. · 各服务商名称与标志（DeepSeek、MiniMax、Qwen、Z.ai、Vercel、Poe 等）为其各自所有者的商标，此处仅用于 标识。本扩展独立运作，与上述任何服务商无隶属、背书或赞助关系。

License

MIT