Короткий путь такой. Установите из Marketplace расширение Claude Code (издатель Anthropic) и в пользовательских настройках VS Code в формате JSON добавьте в claudeCode.environmentVariables пару для адреса, https://api.codexkey.ru без /v1, и пару для ключа sk_cdx_.... После перезагрузки окна панель Claude Code откроется без экрана входа. Расширение работает с тем же ~/.claude/settings.json и теми же разговорами, что и CLI, но вход проверяет раньше, чем стартует процесс Claude, поэтому ключ лучше держать в настройках самого VS Code, а не лишь в файле Claude Code.
Выводы опираются на официальную документацию Anthropic (на 10 ноября 2026) и на руководство по Claude Code из документации codexkey. Связка не проходилась на чистой машине с Windows или macOS. Там, где поведение расширения со шлюзом не проверялось, это сказано прямо.
Расширение или CLI: чем они отличаются
Расширение встраивает панель Claude Code в редактор. Внутри лежит собственная копия CLI, но команду claude в PATH оно не добавляет, так что запускать агента из терминала можно, лишь установив CLI отдельно. Общего у двух вариантов много. По документации, у них один файл ~/.claude/settings.json (переменные, хуки, MCP-серверы) и общие разговоры, а сессию из расширения можно продолжить в терминале командой claude --resume.
| CLI | Расширение VS Code | |
|---|---|---|
| Команды и skills | все | часть, список виден по / |
| Настройка MCP | да | да, команда /mcp в панели |
| Checkpoints | да | да |
Запуск shell-команды через ! | да | нет |
| Автодополнение по Tab | да | нет |
Одна возможность есть только в расширении: ссылка на файл вместе с диапазоном строк вроде @app.ts#5-10. Её вставляют через Option+K (на Windows и Linux через Alt+K). Что выбрать, дело привычки: тем, кто любит смотреть правки в редакторе, удобнее панель, а ! и Tab нужны жителям терминала. С отдельным AI-редактором расширение сравнивает статья Claude Code или Cursor.
Шаг 1. Установите расширение
Панель расширений открывается так: Ctrl+Shift+X на Windows и Linux, Cmd+Shift+X на Mac. Введите Claude Code в поиск, проверьте издателя (должен быть Anthropic) и нажмите Install. Идентификатор расширения anthropic.claude-code. Требуется VS Code 1.94.0 или новее, версия указана в Help, About. Версия расширения совпадает с версией Claude Code, которую оно везёт с собой.
Запустить панель можно иконкой-искрой в правой части панели редактора (она появляется при открытом файле), иконкой на боковой панели или кнопкой Claude Code в строке состояния. Ничего не видно после установки? Перезапустите VS Code или выполните Developer: Reload Window.
Шаг 2. Получите ключ
Обычно встречаются два случая, и со стороны расширения они одинаковы.
Личный ключ. Выдаёт его сам codexkey, поэтому аккаунт Anthropic и подписка Claude не нужны. Зарегистрируйтесь, пополните баланс и создайте ключ в разделе «API-ключи» кабинета. Пополнять можно через СБП, картой РФ или криптовалютой (USDT, BTC, ETH), минимум один доллар. Выглядит ключ как sk_cdx_....
Корпоративный ключ. Если шлюз держит работодатель или кабинет codexkey ведёт тимлид, адрес и учётные данные вы получаете от них, а регистрацию пропускаете. Что у них спросить, описано в разделе про корпоративный прокси ниже.
Шаг 3. Пропишите адрес и ключ
Откройте палитру команд (Ctrl+Shift+P, на Mac Cmd+Shift+P) и запустите Preferences: Open User Settings (JSON). Вставьте такой блок:
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.codexkey.ru" },
{ "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 в документации codexkey. Не убирайте 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. Для CLI блок env в settings.json по-прежнему удобен, набор там тот же.
К самому ключу относятся две предосторожности. Проектный .claude/settings.json для него не годится: файл попадает в репозиторий. Если же включена синхронизация настроек VS Code, пользовательские настройки способны отправиться в облако вместе с ключом, хотя настройку можно исключить через settingsSync.ignoredSettings.
Шаг 4. Проверьте подключение
Перезагрузите окно (Developer: Reload Window), откройте панель Claude Code и спросите: «какие файлы лежат в корне проекта». Ждите ответа без экрана Sign in. Если его нет, проверьте ключ в обход расширения:
curl https://api.codexkey.ru/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 это отношения не имеет. Какие адрес и ключ используются в итоге, показывают строки Anthropic base URL и Auth token в команде /status терминальной версии. Есть ли /status в панели расширения, не проверялось, доступные команды видны после ввода /.
Модель и контекст
Имя модели с суффиксом [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.
Корпоративный ключ за корпоративным прокси
Из этого случая растёт много запросов про расширение со своим адресом: код живёт во внутренней сети компании, трафик к моделям идёт через шлюз, а между ними стоит прокси. Со стороны расширения нужны те же две переменные, остальное зависит от того, что настроили администраторы.
Проверьте, не настроено ли уже
Администраторы могут раздать адрес шлюза и учётные данные через управляемые настройки, и тогда Claude Code подхватит их при старте. Чтобы узнать, запустите claude в терминале. Открылся экран входа: учётные данные не раздавали. Сессия стартовала: выполните /status и найдите две строки, Anthropic base URL и Auth token либо API key. Если в строке Login method назван аккаунт claude.ai, учётные данные до вас не дошли.
Какая переменная для ключа
Документация Anthropic делит случаи по тому, как команда шлюза называет учётные данные:
| Задайте учётные данные в | Когда |
|---|---|
ANTHROPIC_AUTH_TOKEN | Шлюзу нужен bearer-токен, заголовок Authorization |
ANTHROPIC_API_KEY | Шлюзу нужен API-ключ, заголовок x-api-key |
apiKeyHelper | Учётные данные ротируются или приходят из хранилища секретов |
Если никто не подсказал, начните с ANTHROPIC_AUTH_TOKEN, а 401 станет сигналом переключиться. Данные в неверной переменной уходят на шлюз в заголовке, который он не читает. Ключ codexkey кладут в ANTHROPIC_AUTH_TOKEN, как в шаге 3.
Прокси и проверка TLS
Claude Code читает стандартные HTTPS_PROXY, HTTP_PROXY и NO_PROXY. SOCKS он не принимает: локальный SOCKS на localhost:1080 напрямую не годится, нужен HTTP или HTTPS. Если на прокси сложная аутентификация (NTLM, Kerberos), документация предлагает шлюз, который её поддерживает. Когда прокси подменяет сертификаты, корневой должен быть доверенным. Нативный установщик, по документации, берёт хранилище операционной системы, а остальное покрывает NODE_EXTRA_CA_CERTS. У расширения своя копия CLI, и каким рантаймом она пользуется, не проверялось, поэтому при ошибках сертификата переменную лучше указать явно. Те же переменные можно положить в claudeCode.environmentVariables, ведь эта настройка формирует окружение процесса Claude. В документации расширения путь к сертификату записан в блоке env файла ~/.claude/settings.json, а в Windows обратные слэши в нём удваивают.
Набор собран по документации и не запускался. В claudeCode.environmentVariables он состоит из четырёх пар:
ANTHROPIC_BASE_URLсо значениемhttps://llm-gateway.example.com;ANTHROPIC_AUTH_TOKENсо значениемsk-gateway-key;HTTPS_PROXYсо значениемhttp://proxy.example.com:8080;NODE_EXTRA_CA_CERTSсо значением/etc/ssl/certs/corp-ca.pem.
Адрес и токен codexkey остаются прежними.
Список разрешённых хостов и фоновый трафик
Хост шлюза должен быть доступен через прокси, для codexkey это api.codexkey.ru. Кроме пути к шлюзу, Claude Code шлёт фоновый трафик: проверки версий, телеметрию, release notes. В сети, где разрешён только шлюз, эти запросы падают и выглядят как заблокированные соединения. Если вместе с переменными шлюза задать CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1, трафик отключится ценой автообновлений. Проверка домена в инструменте WebFetch всё равно обращается к api.anthropic.com, пока в настройках не стоит skipWebFetchPreflight: true.
Ответ 403 от межсетевого экрана
Если в логах шлюза запроса нет, а клиент получает 403 с HTML в теле, шлюз может блокировать веб-экран приложений (WAF). Документация объясняет: промпты Claude Code содержат XML-подобные теги и исходный код, которые срабатывают на правила против межсайтового скриптинга, поэтому короткий тест curl проходит, а реальные сессии падают. Исправлять нужно на стороне файрвола: исключить путь /v1/messages шлюза из проверки тела.
Две заметки для администраторов. Управляемые настройки могут закрепить адрес параметром allowedProviders со значением ["customEndpoint"], для этого нужен Claude Code v2.1.285 или новее. А шлюз это третья сторона, которая видит промпты и код, поэтому решение отправлять через него рабочий код принимает служба безопасности. Обещаний по обработке данных в статье нет.
Частые ошибки
| Что видите | Причина | Что делать |
|---|---|---|
| Экран 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? Закройте редактор целиком (на macOS Cmd+Q, одного закрытия окна мало) и откройте снова. Для CLI в Windows есть отдельный материал: нативная установка и WSL2 разобраны в статье Установка Claude Code на Windows.
Расширение в Cursor и других форках редактора
Расширение ставится и в Cursor: Anthropic даёт ссылку cursor:extension/anthropic.claude-code, а в остальных форках его берут из реестра Open VSX. С моделями самого Cursor его путать не стоит: у них свой раздел Models и адрес с /v1, подробности в статье Cursor с Claude через codexkey.
FAQ
Как подключить расширение Claude Code со своим адресом?
Поставьте расширение (издатель Anthropic), откройте настройки пользователя в JSON и задайте claudeCode.environmentVariables: в ANTHROPIC_BASE_URL адрес https://api.codexkey.ru, в ANTHROPIC_AUTH_TOKEN (или ANTHROPIC_API_KEY) ключ sk_cdx_..., плюс строки ANTHROPIC_DEFAULT_*. Anthropic рекомендует именно эту настройку для учётных данных шлюза, потому что расширение проверяет её до запуска. После перезагрузки окна откройте панель Claude Code.
Нужна ли подписка Claude для расширения Claude Code?
Обычный вход, по документации Anthropic, требует платного плана Claude или аккаунта Console. Раздел про шлюзы уточняет: пока действует переменная с учётными данными шлюза, запросы идут с ними, а не со входом по подписке claude.ai. На чистой машине в расширении этого не проверяли.
Почему расширение не видит переменные окружения?
Чаще всего VS Code запустили из меню или Dock, и он не увидел экспорт из вашей оболочки. Запустите его командой code . из терминала, где переменные заданы, или положите их в настройки VS Code. Настройки читаются при старте, поэтому нужен полный перезапуск.
Чем расширение отличается от CLI?
Общие у них настройки, MCP-серверы и история. В расширении нет ! и автодополнения по Tab, часть команд и skills недоступна, а взамен вы получаете панель в редакторе и ссылки на файлы с диапазоном строк. У расширения своя копия CLI, а claude в PATH оно не добавляет.
Работает ли расширение через корпоративный прокси?
Да, если прокси HTTP или HTTPS: задайте HTTPS_PROXY, HTTP_PROXY и NO_PROXY. SOCKS Claude Code не поддерживает. Если прокси подменяет сертификаты, добавьте NODE_EXTRA_CA_CERTS.
Работает ли расширение в Cursor?
Да. Расширение ставится в Cursor и другие форки VS Code, откуда его берут через Open VSX, а адрес и ключ задаются так же.