Microsoft Claude Code: настройка через Foundry в 2026 году

Под Microsoft Claude Code обычно понимают запуск Claude Code с моделями Claude через Microsoft Foundry. Это корпоративная схема для организаций, которым нужны ресурсы Azure и централизованный доступ. Понадобятся подписка Azure, права на создание ресурса и развёрнутые модели. Результат проверяется командой /status, где провайдер должен отображаться как Microsoft Foundry.

Есть и более простой смысл: Claude Code на Windows или расширение для Visual Studio Code. Эти варианты не требуют Foundry. Установка на ПК разобрана в статье Claude на Windows, а редактор в гайде по VS Code. Дальше речь только о Foundry.

Когда Microsoft Foundry нужен

Используйте Foundry, если организация уже управляет доступом и ресурсами в Azure либо обязана направлять обращения через утверждённую облачную среду. Для личной практики без Azure обычный вход Claude Code проще.

• Подходит: у команды есть действующая подписка Azure и администратор может создать Foundry resource.
• Подходит: доступ сотрудников должен выдаваться через роли Azure, а не через общий ключ.
• Подходит: модели и расходы нужно видеть рядом с другими ресурсами Azure.
• Не подходит: вы хотите лишь установить Claude Code на Windows или открыть его в VS Code.
• Не подходит: подписка не даёт доступ к Claude models in Foundry или организация запретила Marketplace.

Правило выбора: если вы не можете назвать владельца Azure-ресурса, способ выдачи ролей и развёрнутые модели, Foundry пока не готов. Сначала решите эти вопросы, затем настраивайте компьютеры.

Документация Anthropic называет обязательными подписку Azure с доступом к Foundry и права RBAC. Microsoft предупреждает, что нужна оплачиваемая подписка в стране или регионе, где модели Anthropic доступны, и перечисляет ограничения в своём руководстве.

Карта результата перед настройкой

Исходное состояние: Claude Code установлен, у вас есть Azure subscription, разрешённый Foundry resource и хотя бы одно развёртывание Claude. Ожидаемый результат: первый безопасный вызов проходит через этот ресурс, а /status показывает правильного провайдера и модель.

• Обязательные шаги: создать ресурс и модели, выбрать вход, задать переменные, запустить Claude Code, проверить статус.
• Проверка: провайдер, имя ресурса и модель совпадают с порталом Azure.
• Частые сбои: вход выполнен не в тот tenant, имя ресурса осталось шаблонным, имя deployment не совпало с переменной.
• Ограничение: наличие VS Code или Windows не даёт доступ к Foundry автоматически.
• Безопасный выход: закрыть сеанс, убрать переменные из текущей оболочки и проверить обычный вход отдельно.

По теме: Claude Code Review: как проверить изменения перед merge

Как выбрать способ входа

Для командной работы сначала рассмотрите Microsoft Entra ID. Когда не заданы ключ и bearer token, Claude Code использует стандартную цепочку учётных данных Azure. Типовой локальный старт выполняется через az login, это описано и Anthropic, и Microsoft Learn.

• Entra ID: выбирайте для сотрудников, ролей RBAC и централизованного отзыва доступа.
• API key: допустим для короткой проверки, но ключ нельзя хранить в репозитории, истории команд или общем файле.
• Bearer token: подходит, когда внешний процесс уже получает токен Entra. Anthropic требует совместимую версию Claude Code.
• Не смешивайте способы без необходимости. Bearer token имеет приоритет над API key, а API key выключает автоматический вход Azure credentials.

Не вставляйте секрет в CLAUDE.md, .env.example или сообщение агенту. Если ключ использовался для теста, храните его в утверждённом хранилище и удалите из оболочки после проверки.

Как подключить Claude Code к Foundry

Создайте ресурс и deployments в Foundry, затем выпишите точные имена. Anthropic советует закреплять модели и связывать переменные с фактическими именами развёртываний: встроенный псевдоним может указывать на модель, которой нет в вашей подписке.

1. В портале Microsoft Foundry создайте Claude resource и необходимые deployments. Используйте имена своих развёртываний.
2. Установите Azure CLI и выполните az login, если выбран Entra ID. Для нескольких tenant явно укажите нужный tenant.
3. В новой оболочке задайте CLAUDE_CODE_USE_FOUNDRY=1 и точное имя ресурса в ANTHROPIC_FOUNDRY_RESOURCE.
4. Задайте переменные моделей так, чтобы их значения совпали с именами ваших deployments.
5. Откройте небольшой тестовый проект и запустите claude.

az login
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE='my-foundry-resource'
export ANTHROPIC_DEFAULT_SONNET_MODEL='my-sonnet-deployment'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='my-haiku-deployment'
export ANTHROPIC_DEFAULT_OPUS_MODEL='my-opus-deployment'
cd /path/to/test-project
claude

Замените значения my-* своими именами. Если организация разрешила одну модель, укажите её явно при запуске и согласуйте фоновые задачи с администратором. Не придумывайте отсутствующие deployments.

По теме: Cowork или Claude Code: что выбрать для работы в 2026

Как проверить результат

Внутри Claude Code выполните /status. Anthropic указывает, что API provider должен содержать Microsoft Foundry, а рядом показывается ресурс или base URL. Затем попросите описать структуру тестового проекта без изменений.

1. Сверьте API provider: ожидается Microsoft Foundry.
2. Сверьте resource name или base URL с порталом Azure.
3. Сверьте модель с реально существующим deployment.
4. Попросите прочитать один безопасный файл и убедитесь, что нет ошибки входа.
5. Только после этого разрешайте правки и подключайте рабочий репозиторий.

Это проверяемый чек-лист. Если один из первых трёх пунктов не совпал, вы ещё не доказали, что обращения идут через нужный контур.

Диагностика типовых ошибок

Ошибка получения токена Azure.

Проверьте az login, активный tenant и доступ учётной записи. Если Entra ID не настроен, Anthropic предлагает настроить его либо явно использовать ANTHROPIC_FOUNDRY_API_KEY по политике организации.

Первый вызов завершается сетевой ошибкой.

Сверьте ANTHROPIC_FOUNDRY_RESOURCE. Если там остался шаблон или опечатка, Claude Code строит неверный адрес. Для нестандартного адреса используйте утверждённый ANTHROPIC_FOUNDRY_BASE_URL.

Модель недоступна.

Откройте deployment details и сравните имя со значением ANTHROPIC_DEFAULT_*_MODEL. Доступность моделей меняется, поэтому не переносите старые имена из чужого скрипта.

Расширение VS Code не видит переменные.

Закройте VS Code, задайте переменные в терминале и запустите редактор из этой оболочки через code .. Microsoft также описывает поле Claude Code: Environment Variables в настройках расширения.

По теме: Oh My Claude Code: что это и как безопасно попробовать

Когда способ не подходит

Foundry не нужен только ради Windows или VS Code. Он также не снимает региональные ограничения. Если подписка, страна, тип billing account или политика Marketplace не допускают Claude models, остановитесь на этапе доступности и обратитесь к администратору Azure.

Не используйте личный ключ как замену корпоративным ролям. Другие маршруты собраны в статье ИИ для вайбкодинга, а контроль изменений в процессе Claude и Git.

Как безопасно отключить Foundry

Закройте Claude Code и удалите только переменные Foundry из текущей оболочки. Не удаляйте Azure resource и deployments без разрешения владельца: ими может пользоваться команда.

unset CLAUDE_CODE_USE_FOUNDRY
unset ANTHROPIC_FOUNDRY_RESOURCE
unset ANTHROPIC_FOUNDRY_BASE_URL
unset ANTHROPIC_FOUNDRY_API_KEY
unset ANTHROPIC_FOUNDRY_AUTH_TOKEN
unset ANTHROPIC_DEFAULT_SONNET_MODEL
unset ANTHROPIC_DEFAULT_HAIKU_MODEL
unset ANTHROPIC_DEFAULT_OPUS_MODEL

Откройте новый терминал и снова проверьте /status. Если переменные записаны в .zshrc, .bashrc, VS Code или корпоративный launcher, удаляйте их только из места, которое меняли сами.

Частые вопросы

Microsoft выпускает отдельный Claude Code?

Нет. Claude Code выпускает Anthropic. Foundry предоставляет маршрут к моделям и управление ресурсами Azure.

Нужен ли Foundry для Windows?

Нет. Foundry нужен только при осознанном выборе Azure как провайдера моделей.

Можно ли настроить Foundry только в VS Code?

Да, но сначала удобнее проверить ресурс в терминале. Так легче отделить проблему провайдера от запуска редактора.

Какой вход безопаснее?

Для команды обычно предпочтителен Entra ID с индивидуальными ролями. Решение принимает администратор безопасности.

Что проверить перед рабочим проектом?

Провайдера, ресурс, модель, tenant, роли и чтение без изменений. Затем подключайте рабочие файлы.