Поставьте из Marketplace расширение Claude Code от Anthropic, откройте пользовательские настройки VS Code в JSON и добавьте в claudeCode.environmentVariables адрес https://api.claudexia.tech без /v1 и ключ sk_cdx_.... Перезагрузите окно и откройте панель Claude Code: окна входа быть не должно. Расширение делит с CLI файл ~/.claude/settings.json и историю разговоров, но проверку входа выполняет до запуска процесса. Поэтому ключ надёжнее держать в настройках самого VS Code, а не в одном файле Claude Code.
Это следует из официальной документации Anthropic, которую мы открыли 10 ноября 2026, и из нашего руководства по Claude Code. На чистой машине с Windows или macOS мы эту связку для статьи не проходили. Там, где поведение расширения со шлюзом мы не проверяли, так и написано.
Расширение и CLI: в чём разница
Расширение даёт панель Claude Code внутри редактора. Внутри оно держит собственную копию CLI, но команду claude в PATH не добавляет: чтобы запускать агента из терминала, нужен отдельно установленный CLI. Общего у двух вариантов много. По документации, файл ~/.claude/settings.json у них один (в нём переменные, хуки, MCP-серверы), разговоры общие, и сессию из расширения можно продолжить в терминале командой claude --resume.
| CLI | Расширение VS Code | |
|---|---|---|
| Команды и skills | Все | Часть, список виден по / |
| Настройка MCP | Да | Да, команда /mcp в панели |
| Checkpoints | Да | Да |
Запуск shell-команды через ! | Да | Нет |
| Автодополнение по Tab | Да | Нет |
В расширении есть то, чего нет в терминале: ссылка на файл с диапазоном строк вставляется сочетанием Option+K (на Windows и Linux Alt+K), например @app.ts#5-10. Что выбрать, зависит от привычки: правки удобно смотреть в редакторе, а ! и Tab нужны тем, кто живёт в терминале. Сравнение с отдельным AI-редактором лежит в статье Claude Code или Cursor.
Шаг 1. Установить расширение
Откройте панель расширений: Ctrl+Shift+X на Windows и Linux, Cmd+Shift+X на Mac. Найдите Claude Code, проверьте, что издатель Anthropic, и нажмите Install. ID расширения anthropic.claude-code. Версия VS Code должна быть не ниже 1.94.0, её видно в Help, About. Номер версии расширения совпадает с версией Claude Code, которую оно привозит с собой.
Панель открывается иконкой-искрой на панели редактора (она видна, пока открыт какой-нибудь файл), иконкой в боковой панели или кнопкой Claude Code в строке состояния. Если после установки ничего не появилось, перезапустите VS Code или выполните Developer: Reload Window.
Шаг 2. Получить ключ Claudexia
Зарегистрируйтесь, пополните баланс и создайте ключ в разделе «API-ключи» кабинета. Платить можно рублями через СБП или картой РФ, аккаунт Anthropic и подписка Claude для этого не нужны. Минимальное пополнение один доллар. Ключ выглядит как sk_cdx_....
Шаг 3. Прописать адрес и ключ
Нажмите Ctrl+Shift+P (Cmd+Shift+P на Mac) и выполните Preferences: Open User Settings (JSON). Добавьте блок:
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.claudexia.tech" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk_cdx_YOUR_KEY" },
{ "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5[1m]" },
{ "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5-5[1m]" },
{ "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5[1m]" },
{ "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-sonnet-5" },
{ "name": "CLAUDE_CODE_SUBAGENT_MODEL", "value": "claude-sonnet-5" }
]
}
Адрес без /v1, это Claude Code, а не OpenAI-совместимый клиент. Первые две строки Anthropic называет для шлюза в документации, остальные взяты из нашего руководства по Claude Code. Строки ANTHROPIC_DEFAULT_* нужны: без них Claude Code запрашивает собственные модели по умолчанию и отвечает «There's an issue with the selected model».
Почему настройки VS Code, а не ~/.claude/settings.json, как в нашем руководстве? Документация Anthropic про шлюзы объясняет: расширение проверяет учётные данные из claudeCode.environmentVariables до запуска, а значения из ~/.claude/settings.json доходят до запущенного процесса, но не до собственной проверки входа расширения. Если вы уже прописали ключ в settings.json по руководству и экран входа не пропал, перенесите переменные в настройки VS Code. Блок env в settings.json остаётся удобным для CLI: там тот же набор.
Две оговорки про сам ключ. Не кладите его в .claude/settings.json внутри проекта: этот файл попадает в репозиторий. И если у вас включена синхронизация настроек VS Code, пользовательские настройки могут уехать в облако вместе с ключом; исключить настройку можно через settingsSync.ignoredSettings.
Шаг 4. Проверить подключение
Выполните Developer: Reload Window, откройте панель Claude Code и напишите: «какие файлы лежат в корне проекта». Должен прийти ответ без экрана Sign in. Если ответ не пришёл, проверьте ключ отдельно от расширения:
curl https://api.claudexia.tech/v1/messages \
-H "x-api-key: sk_cdx_your_key_here" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":100,"messages":[{"role":"user","content":"привет"}]}'
Тут адрес с /v1, потому что это прямой запрос к Messages API, а не настройка Claude Code. В терминальной версии команда /status показывает строки Anthropic base URL и Auth token, по ним видно, какой адрес и какой ключ реально использованы. Есть ли эта команда в панели расширения, мы не проверяли: набор доступных команд виден после ввода /.
Модель и контекст
Суффикс [1m] в имени модели открывает весь контекст в 1M. По нашему руководству, без него Claude Code считает модель 200K и сжимает историю около 190K. Суффикс нужен только в Claude Code и только у моделей с контекстом 1M, в остальных программах имя пишут без него, например в Cline и других расширениях. Сменить модель можно командой /model claude-opus-5-5[1m]. Имена берите из каталога, колонка «ID модели».
Anthropic прямо пишет, что не поддерживает направление Claude Code на не-Claude модели через шлюзы. Поэтому в расширении мы остаёмся на моделях Claude.
Что отключается при работе по ключу
Работа по ключу шлюза вместо входа через аккаунт Claude меняет часть возможностей. Документация Anthropic перечисляет: на стороннем провайдере недоступны индикаторы расхода плана, голосовой ввод и вкладка Web для облачных сессий. При работе по токену добавляются ещё два ограничения. Голосовой ввод не работает, пока задан токен. Remote Control отключён, пока задан токен или ANTHROPIC_BASE_URL указывает не на хост Anthropic. Если без них нельзя, выйдите из режима шлюза: снимите переменные и войдите через claude.ai. Остальная работа агента, то есть чтение файлов, правки, команды, MCP и checkpoints, от этого не зависит.
Настройки расширения, которые стоит знать
Кроме переменных, у расширения есть собственные настройки в разделе Extensions, Claude Code. claudeCode.useTerminal переключает панель в терминальный режим, и тогда расширение выглядит как CLI внутри редактора. initialPermissionMode задаёт режим разрешений при старте: default, plan, acceptEdits или bypassPermissions. Последний обходит запросы разрешений. Настройка allowDangerouslySkipPermissions добавляет его в селектор режимов, и по документации включать её стоит только в песочницах без доступа в интернет. Для начала оставьте default, пока не поймёте, какие команды агент запускает у вас в проекте.
Частые ошибки
| Что видите | Причина | Что делать |
|---|---|---|
| Экран Sign in или «Not logged in · Please run /login» | Расширение не нашло ключ при старте | Задайте переменные в claudeCode.environmentVariables, выполните Developer: Reload Window. Если не помогло, включите claudeCode.disableLoginPrompt: в документации Anthropic настройка описана для сторонних провайдеров, для шлюза мы её не проверяли |
| Переменные заданы в терминале, расширение их не видит | VS Code запущен из меню или Dock и не унаследовал окружение оболочки | Запустите code . из терминала либо перенесите переменные в настройки VS Code |
| «There's an issue with the selected model» | Нет строк ANTHROPIC_DEFAULT_* | Добавьте их по блоку из шага 3 |
401 | Ключ с пробелом, обрезан или не sk_cdx_ | Скопируйте ключ из кабинета заново, проверьте, что он активен |
SSL certificate verification failed | Прокси подменяет сертификаты | Укажите NODE_EXTRA_CA_CERTS, см. раздел про прокси |
«Could not locate the Claude CLI on PATH» или claude не найден в терминале VS Code | Расширение не кладёт claude в PATH | Поставьте CLI отдельно: установка Claude Code |
| Иконка-искра не появилась | Нет открытого файла, VS Code старше 1.94.0, Restricted Mode или конфликт с другим AI-расширением | Откройте файл, обновите VS Code, дайте папке доверие, перезагрузите окно |
Про переменные окружения есть и наблюдение из нашей статьи Claude Code в России: расширения читают окружение при старте, поэтому после правки полностью закройте VS Code (Cmd+Q на macOS, закрытие окна не считается) и откройте заново. Если CLI нужен и на Windows, нативная установка и WSL2 разобраны в статье Установка Claude Code на Windows.
Через прокси
Запрос «claude code в vs code через прокси» встречается, поэтому коротко. По документации Anthropic, Claude Code понимает стандартные HTTPS_PROXY, HTTP_PROXY и NO_PROXY. SOCKS-прокси он не поддерживает, так что локальный SOCKS на localhost:1080 напрямую не подойдёт, нужен HTTP или HTTPS. Те же переменные можно положить в claudeCode.environmentVariables: настройка задаёт окружение процесса Claude.
Если прокси подменяет сертификаты, укажите корневой сертификат: NODE_EXTRA_CA_CERTS с путём к файлу. В документации расширения путь к сертификату задан в блоке env файла ~/.claude/settings.json, а в Windows обратные слэши в пути удваивают. Для ключа Claudexia при этом ничего не меняется: адрес и токен те же.
Cursor и другие форки VS Code
То же расширение ставится и в Cursor: по документации Anthropic есть ссылка cursor:extension/anthropic.claude-code, а для других форков редактора расширение доступно в реестре Open VSX. Не путайте его с моделями самого Cursor: там свой раздел Models и свой адрес с /v1, разбор в статье Cursor с Claude через Claudexia.
FAQ
Как подключить Claude к VS Code?
Установите расширение Claude Code (издатель Anthropic), откройте настройки пользователя в JSON и задайте claudeCode.environmentVariables: адрес https://api.claudexia.tech, ключ sk_cdx_... и строки ANTHROPIC_DEFAULT_*. После перезагрузки окна откройте панель Claude Code.
Нужна ли подписка Claude для расширения Claude Code?
По документации Anthropic, при обычном входе нужен платный план Claude или аккаунт Console. Документация про шлюзы добавляет: пока активна переменная с учётными данными шлюза, запросы идут с ними вместо входа по подписке claude.ai. Прогнать это в расширении на чистой машине мы не успели.
Расширение Claude Code не видит ключ, что делать?
Перенесите переменные в claudeCode.environmentVariables, выполните Developer: Reload Window и при необходимости полностью перезапустите VS Code. Если ключ лежит только в переменных оболочки, запускайте редактор командой code . из того же терминала.
Чем расширение Claude Code отличается от CLI?
Настройки, MCP и история общие. В расширении нет команды ! и автодополнения по Tab, часть команд и skills недоступна, зато есть панель в редакторе и ссылки на файлы с диапазоном строк. Расширение хранит собственную копию CLI и не добавляет claude в PATH.
Можно ли использовать Claude Code в VS Code через прокси?
Да, через HTTP или HTTPS прокси: переменные HTTPS_PROXY, HTTP_PROXY, NO_PROXY. SOCKS Claude Code не поддерживает. Для прокси с подменой сертификатов задайте NODE_EXTRA_CA_CERTS.
Работает ли расширение в Cursor?
Да, оно ставится и в Cursor, и в другие форки VS Code через Open VSX. Настройка адреса и ключа та же.