Расширение Claude Code для VS Code со сторонним API: настройка environmentVariables

Wokey Team · 2026-09-24

Коротко: чтобы подключить расширение Claude Code для VS Code к стороннему API, пропишите ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN в claudeCode.environmentVariables в пользовательских настройках VS Code и включите claudeCode.disableLoginPrompt. Переменные, экспортированные в терминале, до расширения, как правило, не доходят. Файла ~/.claude/settings.json тоже недостаточно: проверка входа, которую расширение выполняет перед запуском, его не читает, поэтому экран входа появляется снова и снова.

Настройка

1. Установите расширение. Нужен VS Code 1.94.0 или новее. Найдите «Claude Code» (издатель: Anthropic) в панели Extensions (Cmd/Ctrl+Shift+X). В Cursor можно установить то же расширение, а редакторы вроде VSCodium могут получить его из Open VSX.
2. Откройте пользовательские настройки. Нажмите Cmd/Ctrl+Shift+P и выполните Preferences: Open User Settings (JSON).
3. Добавьте настройки. Внутри самых внешних {} добавьте:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" }
  ],
  "claudeCode.disableLoginPrompt": true
}

4. Перезагрузите окно. Выполните Developer: Reload Window из палитры команд, затем откройте панель Claude Code.

На что обратить внимание:

• ANTHROPIC_BASE_URL — только домен, без /v1; расширение само добавляет /v1/messages.
• Это нужно прописать в пользовательских настройках, а не в .vscode/settings.json рабочей области, который часто коммитят в репозиторий.
• disableLoginPrompt пропускает запрос на вход. В официальном описании сказано, что он предназначен «for third-party provider setups» (для конфигураций со сторонними провайдерами).

Почему export и settings.json не помогают

Прежде чем запустить процесс Claude, расширение проверяет, есть ли доступные учётные данные. Эта проверка читает только claudeCode.environmentVariables:

• VS Code, открытый из Dock, меню «Пуск» или с ярлыка на рабочем столе, не получает переменные, которые вы экспортируете в ~/.zshrc.
• Блок env в ~/.claude/settings.json доходит до процесса Claude, который запускает расширение, но не до собственной проверки входа расширения.

Поэтому если есть только settings.json, а disableLoginPrompt выключен, типичный симптом — расширение постоянно просит войти. Чтобы разово воспользоваться переменными оболочки, выполните code . в терминале, где они заданы. Для повседневной работы надёжнее пользовательские настройки, описанные выше.

Убедитесь, что запросы идут через Wokey

Выполните /status в поле ввода расширения (нужен Claude Code v2.1.280 или новее). На вкладке Status в поле Anthropic base URL должно быть https://api.wokey.ai.

Выбор моделей

Выберите Switch model… в меню команд или нажмите на название модели под полем ввода. Чтобы закрепить, какая модель используется для каждого из уровней Opus, Sonnet и Haiku, добавьте переменные в тот же список:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" }
  ]
}

Что недоступно при работе через сторонний API

Со сторонним API расширение не предлагает функции, которым нужен аккаунт claude.ai:

• Шкалы использования тарифа, голосовой ввод и вкладка Web для облачных сессий.
• В меню нет пункта Sign out (выйти).
• Отправка /bug показывает ошибку и ничего не отправляет.

Аккаунт claude.ai, в который вы ранее вошли через /login, остаётся сохранённым, но не используется.

По сравнению с CLI в терминале расширение к тому же поддерживает только часть команд, и в нём нет сочетания ! для Bash и автодополнения по Tab.

Устранение неполадок

Экран входа появляется снова и снова. claudeCode.environmentVariables отсутствует или находится не там (например, в настройках рабочей области), либо вы не перезагрузили окно после изменения. Также проверьте, что disableLoginPrompt равен true.

invalid x-api-key. Запрос ушёл на собственный адрес Anthropic, потому что ANTHROPIC_BASE_URL не применился. Wokey никогда не возвращает такое сообщение; смотрите руководство по ошибке invalid x-api-key.

404 с упоминанием /v1/v1/messages. В base URL лишний /v1. Замените его на https://api.wokey.ai.

Нет ни ответа, ни ошибки. Официальный совет — запустить claude в терминале, чтобы увидеть более подробные ошибки. Расширение поставляется со своим CLI, но не добавляет claude в PATH, поэтому установите CLI отдельно и задайте его переменные, как в руководстве по base URL для Claude Code.

Пользователям JetBrains

Плагин для JetBrains не включает в себя CLI. Он запускает установленную у вас команду claude во встроенном терминале IDE; путь можно изменить в Settings → Tools → Claude Code [Beta] → Claude command. Поэтому JetBrains настраивается так же, как CLI: пропишите ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN в блок env файла ~/.claude/settings.json. Смотрите руководство по base URL для Claude Code.