Расширение Claude Code для VS Code: API-ключ и свой шлюз
На 2026-10-07 официальная документация Claude Code называет надёжный способ подключить расширение VS Code к своему шлюзу: прописать ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN в claudeCode.environmentVariables в пользовательских настройках VS Code, потому что расширение проверяет учётные данные из этой настройки перед запуском. Те же два значения стоит добавить в блок env файла ~/.claude/settings.json, чтобы ими пользовался и CLI в терминале. Для QCode это https://api.qcode.cc/api и ключ, начинающийся с cr_. На странице — шаги, связь расширения с CLI и три частые проблемы: ключ не находится, снова просит войти, выбор модели.
Обновлено 2026-10-08
Четыре вещи, которые важно знать
Всё, что нужно для QCode
ANTHROPIC_BASE_URL = https://api.qcode.cc/api (до /api, без слеша в конце) и ANTHROPIC_AUTH_TOKEN = ключ cr_, созданный в консоли.
Надёжное место для ключа шлюза
По официальной документации, расширение перед запуском проверяет учётные данные из claudeCode.environmentVariables; значения из ~/.claude/settings.json доходят до запущенного процесса, но не до собственной проверки входа расширения.
Общая конфигурация с CLI
~/.claude/settings.json общий для расширения и CLI. Пропишите в его блоке env те же два значения, и claude в терминале пойдёт через тот же шлюз. Не кладите их в .claude/settings.json проекта: этот файл коммитится.
Контекстное окно за своим base URL
С версии 2.1.285 сессии за своим ANTHROPIC_BASE_URL сразу работают с окном 1M на Opus 4.7+, Sonnet 5+ и Fable; если шлюз ограничен 200K, официальный журнал изменений советует выполнить /autocompact 200k.
Как расширение VS Code читает настройки
На 2026-10-07 короткий ответ такой: у расширения два вида настроек. Согласно официальной документации, настройки расширения в VS Code управляют его поведением, а ~/.claude/settings.json общий для расширения и CLI и хранит переменные окружения, разрешённые команды, hooks и MCP-серверы. Для своего шлюза официальная документация по шлюзам предлагает класть учётные данные в claudeCode.environmentVariables в пользовательских настройках VS Code, потому что расширение проверяет их там перед запуском. Расширение содержит собственную копию CLI для панели чата, но не добавляет claude в PATH; чтобы запускать claude во встроенном терминале, CLI нужно установить отдельно. Требуется VS Code 1.94.0 или новее. При входе через платную подписку Claude или аккаунт Console API-ключ не нужен; со шлюзом вход в claude.ai заменяет переменная с учётными данными.
Последние изменения, касающиеся VS Code (на 2026-10-07)
На 2026-10-07 последний релиз в GitHub Releases — 2.1.292, опубликован 2026-10-06 (UTC). Что касается шлюзов: с 2.1.285 сессии за своим ANTHROPIC_BASE_URL используют окно 1M у моделей, где оно есть (Opus 4.7+, Sonnet 5+, Fable), а в журнале изменений сказано выполнить /autocompact 200k, если шлюз останавливается на 200K; в 2.1.280 в VS Code появился диалог Status — наберите /status, чтобы увидеть версию, аккаунт, модель и данные сервера; с 2.1.277 там, где лимиты тарифа не действуют (в журнале перечислены Vertex, Bedrock, Foundry и API key), диалог Account & usage показывает стоимость и расход токенов сессии; в 2.1.290 исправлено, что вход и новые сессии не объясняли причину, когда Claude Code не может найти или запустить свою программу.
Хронология версий
Выход 2.1.261 (UTC): исправлено появление экрана входа в VS Code при включённой настройке Disable Login Prompt, когда Claude Code сообщает об отсутствии входа или запрос не проходит из-за его отсутствия.
Выход 2.1.280 (UTC): в VS Code добавлен диалог Status. Наберите /status в панели, чтобы увидеть версию, аккаунт, модель и данные сервера текущей сессии, — так проще проверить, что настройки применились.
Выход 2.1.285 (UTC): сессии за своим ANTHROPIC_BASE_URL теперь сразу работают с окном 1M на моделях, где оно есть (Opus 4.7+, Sonnet 5+, Fable).
Подтверждено и не задокументировано
Подтверждено (дословно в документации)
Всё это можно проверить дословно в официальной документации Claude Code, журнале изменений или документации QCode: VS Code 1.94.0 или новее; расширение содержит CLI, но не добавляет его в PATH; ~/.claude/settings.json общий для расширения и CLI; переменные шлюза пишутся в claudeCode.environmentVariables, и расширение проверяет эти учётные данные перед запуском; Disable Login Prompt пропускает запросы входа; ANTHROPIC_AUTH_TOKEN отправляется в заголовке Authorization: Bearer, ANTHROPIC_API_KEY — в x-api-key; переменная с учётными данными важнее сохранённого входа claude.ai; один ANTHROPIC_BASE_URL без учётных данных не заменяет вход по подписке; расширение и CLI делят историю диалогов; переход на окно 1M по умолчанию в 2.1.285; значения QCode https://api.qcode.cc/api и ключ cr_.
Не задокументировано или не проверено
По трём пунктам страница выводов не делает. Первое: на 2026-10-07 в официальной таблице настроек расширения отдельная настройка для API-ключа или base URL не указана; здесь описаны только места настройки из официальной документации, другие способы через отдельные файлы конфигурации в рамки страницы не входят. Второе: в официальной документации сказано, что Claude Code не может определить более низкий лимит, заданный шлюзом, так что пропускает ли ваш шлюз 1M, покажут его документация или ваши собственные тесты. Третье: названия настроек и кнопок расширения меняются от версии к версии; страница опирается на официальную документацию от 2026-10-07 без проверки каждой версии, ориентируйтесь на свою.
Куда класть и как это связано с CLI
environmentVariables или settings.json
Проще всего заполнить оба. claudeCode.environmentVariables — пользовательская настройка VS Code, задающая переменные окружения для процесса Claude; расширение проверяет её учётные данные перед запуском, поэтому официальная документация по шлюзам кладёт ключ сюда. Блок env в ~/.claude/settings.json общий для расширения и CLI в терминале, и официальная документация VS Code рекомендует его для общей конфигурации. Если заполнить только второе, значения дойдут до процесса, но не до проверки входа расширения; если только первое, конфигурация не будет общей с CLI в терминале.
Расширение VS Code или CLI в терминале
Оба читают одни и те же файлы настроек и делят историю диалогов: claude --resume в терминале продолжает диалог из расширения. Разница в возможностях. По официальной таблице, в CLI есть все команды и skills, а в расширении — часть (наберите /, чтобы увидеть); ярлык ! для Bash и автодополнение по Tab есть только в CLI. Расширение не добавляет claude в PATH, поэтому CLI ставится отдельно; если расширение не показывает причину ошибки, официально советуют запустить claude в терминале и посмотреть подробные сообщения.
Пять шагов к своему шлюзу
① Установите расширение: откройте панель расширений (Cmd+Shift+X / Ctrl+Shift+X), найдите Claude Code и нажмите Install или выполните в терминале code --install-extension anthropic.claude-code; нужен VS Code 1.94.0 или новее. ② Выполните в палитре команд Preferences: Open User Settings (JSON) и добавьте claudeCode.environmentVariables с двумя записями: name ANTHROPIC_BASE_URL и value https://api.qcode.cc/api; name ANTHROPIC_AUTH_TOKEN и value — ваш ключ cr_. ③ Если экран входа всё равно появляется, откройте настройки, найдите Claude Code login и отметьте Disable Login Prompt (официально она описана как пропуск запросов входа для сторонних конфигураций). ④ Чтобы CLI в терминале использовал те же значения, добавьте их в блок env файла ~/.claude/settings.json (в Windows %USERPROFILE%\.claude\settings.json); не кладите их в .claude/settings.json проекта. ⑤ Выполните Developer: Reload Window, наберите /status в панели, проверьте версию, аккаунт, модель и данные сервера, затем отправьте тестовое сообщение.
На QCode
На QCode оба значения берутся из документации QCode: ANTHROPIC_BASE_URL=https://api.qcode.cc/api (до /api, без слеша в конце) и ANTHROPIC_AUTH_TOKEN — ключ, начинающийся с cr_ (создаётся в консоли); Claude Code отправляет его как Bearer-токен. Модели Claude работают только через эндпоинт с протоколом Anthropic, и именно этот протокол использует расширение VS Code. Среди моделей Claude, которые можно вызывать через QCode, — claude-sonnet-5-5, claude-opus-5-5 и claude-sonnet-5; оплата по токенам, цена каждой модели — на /models, у семейства Claude нет отдельного тарифа для длинного контекста. В Северной Америке и Европе можно использовать us.qcode.cc (Лос-Анджелес), для сетей в материковом Китае документация советует asia.qcode.cc; путь тот же, ключ общий. Каждый запрос можно посмотреть на probe.qcode.cc, введя свой ключ.
Частые вопросы
Где в VS Code указать API-ключ и свой base URL для Claude Code?
В claudeCode.environmentVariables в пользовательских настройках VS Code. Выполните в палитре команд Preferences: Open User Settings (JSON) и добавьте две записи — ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN; для QCode это https://api.qcode.cc/api и ваш ключ cr_. На 2026-10-07 в официальной таблице настроек расширения отдельная настройка для API-ключа или base URL не указана, а официальная документация по шлюзам пишет, что расширение проверяет учётные данные из этой настройки перед запуском, поэтому это надёжное место для ключа шлюза.
Я сделал export в терминале, но расширение всё равно не находит ключ. Почему?
Скорее всего, переменные не дошли до VS Code. В официальной документации сказано, что export в shell действует только в этой сессии терминала и в запущенных из неё программах, а редактор, открытый из Dock или меню «Пуск», их не видит. Одного блока env в ~/.claude/settings.json тоже мало: эти значения доходят до запущенного процесса, но не до собственной проверки входа расширения. Пропишите оба значения в claudeCode.environmentVariables, выполните Developer: Reload Window и проверьте через /status в панели.
Почему после настройки всё равно просит войти?
Обычно проверка входа расширения не видит учётных данных. Сначала убедитесь, что ключ лежит в claudeCode.environmentVariables и что задан не только ANTHROPIC_BASE_URL: по официальной документации один base URL без переменной с учётными данными не заменяет подписку, и активным остаётся сохранённый вход claude.ai. Если экран входа всё ещё появляется, найдите в настройках Claude Code login и отметьте Disable Login Prompt; в 2.1.261 исправили появление экрана входа вопреки этой настройке, так что старые версии сначала обновите. Если при запуске появляется предупреждение с двумя источниками учётных данных, заканчивающееся на auth may not work as expected, официальное решение — выполнить /logout, чтобы остался только ключ шлюза.
Могут ли расширение VS Code и CLI в терминале использовать одну конфигурацию?
Да, через ~/.claude/settings.json. В официальной документации сказано, что терминал, расширения для VS Code и JetBrains и десктопное приложение читают одни и те же файлы настроек; пропишите ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN в блоке env, и claude в терминале пойдёт через тот же шлюз. Если одна и та же переменная задана и через export, и в блоке env файла настроек, действует значение из файла. История диалогов тоже общая: claude --resume в терминале продолжает диалог из расширения. Учтите, что расширение не добавляет claude в PATH — CLI нужно установить отдельно.
Как выбрать модель и что делать, если нужной нет в списке?
Нажмите на метку модели под полем ввода или наберите /model; также можно задать переменную ANTHROPIC_MODEL или поле model в файле настроек. По официальной документации, /model сохраняет выбор как модель по умолчанию для новых сессий в поле model пользовательских настроек, поэтому расширение и CLI читают одно и то же значение по умолчанию. Если имён моделей шлюза нет во встроенном списке Claude Code, официальное решение — CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1: тогда список выбора заполняется моделями шлюза. На QCode можно указать claude-sonnet-5-5, claude-opus-5-5 или claude-sonnet-5; актуальный список — на /models.
Что использовать: ANTHROPIC_AUTH_TOKEN или ANTHROPIC_API_KEY?
Для QCode — ANTHROPIC_AUTH_TOKEN. По официальной документации, он отправляется в заголовке Authorization: Bearer, а ANTHROPIC_API_KEY — в x-api-key; ключ в неправильной переменной приходит в заголовке, который шлюз не читает, и запрос завершается ошибкой 401 — тогда попробуйте другую переменную. В документации QCode ключ по договорённости кладётся в ANTHROPIC_AUTH_TOKEN, а инструменты, которые читают только ANTHROPIC_API_KEY, тоже работают с тем же ключом cr_. Ещё одно отличие: ANTHROPIC_API_KEY в интерактивном режиме нужно один раз подтвердить, а ANTHROPIC_AUTH_TOKEN сразу получает приоритет над сохранённым входом.
Источники
Места настройки и поведение расширения: официальная документация Claude Code, страница о VS Code (code.claude.com: требования, таблица настроек расширения, шаги для сторонних конфигураций, сравнение с CLI и частые проблемы), а также страницы о подключении к LLM-шлюзу, обзор LLM-шлюзов, аутентификация, настройки, переменные окружения и настройка моделей — всё получено 2026-10-07. Изменения версий: CHANGELOG и время публикации в GitHub Releases (UTC) репозитория anthropics/claude-code, получены в тот же день. Значения QCode: страницы документации QCode о переменных окружения (обновлена 2026-09-25), об эндпоинтах и форматах API, об интеграции с VS Code (обновлена 2026-09-18) и страница /models, получены в тот же день.
Подключите VS Code к QCode
Две переменные и один ключ cr_ — общие для расширения и CLI в терминале. Оплата по токенам, цены моделей — на /models.
Читайте также
Настройка ANTHROPIC_BASE_URL и AUTH_TOKEN
Как направить Claude Code на свой эндпоинт: две переменные окружения и форма settings.json.
Руководство пользователя Claude Code
Полный курс от установки до повседневной работы.
Claude Code в Китае: полное руководство
Подключение Claude Code и Codex API для разработчиков из материкового Китая и оплата через Alipay.
Шаги и цитаты на этой странице сверены 2026-10-07 с официальной документацией Claude Code, журналом изменений и документацией QCode; изменения на стороне вендора возможны без предупреждения. Экраны и названия настроек расширения меняются от версии к версии — ориентируйтесь на свою версию; доступность моделей смотрите на /models.