Если ваша организация использует AWS Bedrock, Google Cloud Vertex AI, Azure AI Foundry или шлюз LLM для доступа к Claude, вы можете использовать надстройки Claude for Excel, Claude for PowerPoint и Claude for Word без учетной записи Claude. Надстройка подключается через инфраструктуру вашей организации, поэтому ваши запросы и ответы остаются в пределах существующей границы доверия.
Существует четыре пути подключения в зависимости от того, как ваша организация получает доступ к Claude:
Шлюз LLM: надстройка отправляет запросы на ваш шлюз (LiteLLM, Portkey, Kong и т. д.), который маршрутизирует их выбранному вами поставщику. Это тот же паттерн, используемый Claude Code. Если ваша организация уже запускает Claude Code через шлюз LLM, вы можете направить надстройки Office на ту же конечную точку — новая инфраструктура не требуется.
Bedrock напрямую: надстройка проходит аутентификацию через Microsoft Entra ID и вызывает AWS Bedrock напрямую, без промежуточного шлюза.
Vertex AI напрямую: надстройка проходит аутентификацию через Google OAuth и вызывает Vertex AI напрямую.
Foundry напрямую: надстройка проходит аутентификацию через ресурс Azure AI Foundry напрямую, используя его ключ API.
Ваш IT-администратор выбирает путь во время развертывания. Как конечный пользователь, ваш опыт одинаков независимо от того, какой путь использует ваша организация.
Требования
Требования различаются в зависимости от пути подключения.
Все пути:
Claude for Excel, Claude for PowerPoint или Claude for Word установлены (из Microsoft AppSource или развернуты вашим администратором)
Microsoft 365 с Entra ID (для согласия администратора и, в прямых облачных путях, выдачи токенов)
Шлюз LLM:
URL шлюза и токен API от вашей IT-команды
Bedrock напрямую:
Учетная запись AWS с включенным доступом к модели Claude в целевом регионе
Поставщик удостоверений IAM OIDC и роль, настроенные на доверие токенам Microsoft Entra ID
Vertex AI напрямую:
Проект Google Cloud с включенным API Vertex AI и доступом к модели Claude в целевом регионе
Клиент Google OAuth, настроенный с URI перенаправления надстройки
Foundry напрямую:
Ресурс Azure AI Foundry с развернутой по крайней мере одной моделью Claude (Claude Opus 4.6, Opus 4.5, Sonnet 4.6 или Sonnet 4.5)
Имена развертываний должны оставаться как идентификаторы моделей по умолчанию (например, claude-opus-4-6); пользовательские имена развертываний пока не поддерживаются. Адаптер проверяет по идентификатору модели, поэтому переименованное развертывание не будет найдено.
Ключ API ресурса из Azure Portal → ваш ресурс Foundry → Keys and Endpoint → KEY 1
Ресурсами управляет IT-команда вашей организации. Если у вас нет необходимых учетных данных, свяжитесь с ними — Anthropic не может предоставить или сбросить их для вас.
Список разрешенных сетевых адресов
Надстройке необходимо получить доступ к определенным доменам для функционирования. Какие домены зависят от того, использует ли ваша организация API Anthropic напрямую (1P) или сторонней платформы (3P). Поделитесь применимой таблицей с вашей сетевой или командой безопасности, чтобы они могли добавить эти домены в список разрешенных.
Важно: во всех конфигурациях — включая сторонние — ваши запросы и ответы Claude передаются только выбранному вами поставщику вывода (вашему шлюзу, Bedrock, Vertex AI или Azure AI Foundry). Домены, указанные ниже, которые указывают на Anthropic (такие как pivot.claude.ai), обслуживают интерфейс надстройки, конфигурацию функций и операционную телеметрию. Они не содержат содержимое запросов или ответов.
API Anthropic (1P)
Используйте эту таблицу, если люди в вашей организации входят с учетной записью Claude и вывод идет на api.anthropic.com.
Домен | Требуется когда | Назначение |
pivot.claude.ai | Всегда | Хост надстройки. Обслуживает пользовательский интерфейс области задач и проксирует аналитику, поиск значков, загрузки навыков и телеметрию. |
claude.ai | Всегда | Вход в OAuth Anthropic и оценка флагов функций. |
api.anthropic.com | Всегда | API вывода Claude, загрузки файлов, контейнеры выполнения кода и реестр соединителей MCP. |
appsforoffice.microsoft.com | Всегда | Скрипт среды выполнения Microsoft Office.js. Требуется для каждой надстройки Office. |
o1158394.ingest.us.sentry.io | Опционально | Отчеты об ошибках и сбоях. Блокировка этого ухудшает диагностику только; надстройка все еще работает. |
mcp-proxy.anthropic.com | При использовании соединителей MCP | Прокси для вызовов инструментов соединителя MCP. |
bridge.claudeusercontent.com | При использовании функции работы между приложениями | WebSocket-мост для функции работы между приложениями. |
Сторонние платформы (3P)
Используйте эту таблицу, если пользователи вашей организации входят с помощью Microsoft Entra ID и вывод идет на ваш шлюз LLM, Bedrock или Vertex AI.
Домен | Требуется когда | Назначение |
pivot.claude.ai | Всегда | Хост надстройки. Обслуживает пользовательский интерфейс области задач и проксирует аналитику, поиск значков и телеметрию. |
claude.ai/api/ | Всегда | Оценка флагов функций. Без входа; надстройка только получает свою конфигурацию отсюда. |
appsforoffice.microsoft.com | Всегда | Скрипт среды выполнения Microsoft Office.js (требуется для каждой надстройки Office). |
login.microsoftonline.com | Всегда | Вход в Microsoft Entra ID через вложенную аутентификацию приложения. Читает конфигурацию шлюза, подготовленную администратором, и выдает токены для прямой облачной аутентификации. |
o1158394.ingest.us.sentry.io | Необязательно | Отчеты об ошибках и сбоях. Блокировка этого ухудшает диагностику; надстройка все еще работает. |
URL вашего шлюза LLM | При использовании шлюза LLM | Шлюз LLM вашей организации (LiteLLM, Portkey, Kong и т. д.). Вывод идет сюда вместо api.anthropic.com. |
sts.amazonaws.com | При прямом использовании Bedrock | AWS STS. Обменивает токен Entra ID на временные учетные данные Bedrock. |
bedrock-runtime..amazonaws.com | При прямом использовании Bedrock | Конечная точка вывода Bedrock. Замените на ваш настроенный регион AWS (например, us-east-1). |
accounts.google.com | При прямом использовании Vertex AI | Экран согласия Google OAuth. |
oauth2.googleapis.com | При прямом использовании Vertex AI | Обмен токенами Google OAuth и их обновление. |
aiplatform.googleapis.com | При прямом использовании Vertex AI | Глобальная конечная точка вывода Vertex AI. |
-aiplatform.googleapis.com | При прямом использовании Vertex AI | Региональная конечная точка вывода Vertex AI. Замените на ваш настроенный регион GCP (например, us-east5). |
.services.ai.azure.com
| При прямом использовании Foundry | Конечная точка вывода Azure AI Foundry. Замените на имя вашего ресурса. |
Развертывание надстройки для использования третьими сторонами (администраторы IT)
Используйте плагин claude-in-office для настройки и развертывания надстройки в вашей организации. Этот инструмент обрабатывает подготовку облачных ресурсов (при использовании Bedrock или Vertex AI напрямую), создание манифеста надстройки и получение согласия администратора в едином управляемом потоке.
Используйте мастер установки
Установите плагин и запустите интерактивный мастер установки:
claude plugin marketplace add anthropics/financial-services-plugins
claude plugin install claude-in-office@financial-services-plugins
/claude-in-office:setup
Мастер проведет вас через путь подключения:
Шлюз LLM: собирает URL-адрес и токен вашего шлюза, определяет, какой формат API использовать, создает манифест и обрабатывает согласие администратора Azure.
Bedrock напрямую: создает поставщика удостоверений IAM OIDC и роль, создает манифест и обрабатывает согласие администратора Azure.
Vertex AI напрямую: проведет вас через создание клиента Google OAuth, создает манифест и обрабатывает согласие администратора Azure.
Foundry напрямую: захватывает
azure_resource_nameиazure_api_key, затем создает манифест.
Когда мастер завершит работу, надстройка готова к развертыванию на уровне клиента.
Примечание: пути Bedrock и Vertex AI требуют Node.js для создания и проверки манифеста. Мастер проверяет его наличие и предлагает установить его, если он отсутствует.
Вы можете использовать следующие команды в сеансе claude-in-office:
Команда | Что она делает |
| Интерактивный мастер — подготавливает облачные ресурсы, согласие администратора, записывает манифест |
| Создает настраиваемый XML-манифест надстройки |
| Создает URL-адрес согласия администратора Azure для регистрации приложения надстройки |
| Записывает конфигурацию для каждого пользователя через атрибуты расширения Microsoft Graph |
Что подготавливает мастер
Мастер автоматизирует создание ресурсов на основе пути подключения. Вот что он настраивает:
Шлюз LLM: облачные ресурсы не требуются. Мастер собирает URL-адрес и токен вашего шлюза, затем создает манифест.
Bedrock напрямую: создает поставщика удостоверений IAM OIDC, который доверяет токенам Microsoft Entra ID, роль с разрешениями bedrock:InvokeModel и bedrock:InvokeModelWithResponseStream, а также политику доверия, ограниченную ID приложения надстройки Claude.
Vertex AI напрямую: проведет вас через создание клиента Google OAuth в консоли GCP (этот шаг не может быть автоматизирован через CLI), включает API Vertex AI и захватывает ID клиента и секрет для манифеста.
Foundry напрямую: облачные ресурсы не требуются; мастер собирает имя ресурса и ключ API для манифеста.
Конфигурация для каждого пользователя
Если некоторые значения различаются для каждого пользователя — например, разные токены шлюза или разные роли AWS для разных команд — мастер может записать конфигурацию для каждого пользователя через атрибуты расширения Microsoft Graph. Запустите /claude-in-office:update-user-attrs с ключами для каждого пользователя после начальной настройки.
Развертывание в Microsoft 365
После того как мастер создаст ваш манифест:
Откройте Центр администрирования Microsoft 365 и перейдите в Параметры > Интегрированные приложения > Загрузить пользовательские приложения.
Выберите «Office Add-in» в качестве типа приложения, затем загрузите файл manifest.xml.
Выберите, кто получит надстройку:
Если все пользователи используют одну и ту же конфигурацию, выберите «Вся организация».
Если вы записали атрибуты для каждого пользователя на предыдущем шаге, назначьте Конкретным пользователям/группам, точно совпадающим с теми, кто был настроен. Все остальные откроют надстройку без конфигурации.
Примите разрешения и завершите развертывание.
Распространение на пользователей занимает до 24 часов (обычно намного быстрее). Надстройка появляется в разделе Главная > Надстройки в Excel, PowerPoint и Word после развертывания.
Примечание: начните с пилотной группы, чтобы подтвердить, что надстройка работает, затем расширьте назначение. Вы можете изменить назначение позже без повторного развертывания.
После развертывания надстройки ваши пользователи могут подключиться, выполнив следующие шаги.
Инструкции по подключению для конечных пользователей
Шлюз LLM
Откройте Excel, PowerPoint или Word и запустите надстройку Claude.
На экране входа выберите «Enterprise gateway».
Введите URL-адрес шлюза и токен API, предоставленные вашей IT-командой.
URL-адрес шлюза: базовый URL-адрес HTTPS вашего прокси-сервера LLM (например, https://llm-gateway.yourcompany.com).
Токен API: токен-носитель, который ожидает ваш прокси-сервер. Надстройка отправляет его в заголовке Authorization: Bearer <token> с каждым запросом.
Надстройка проверяет подключение, отправляя тестовый запрос на шлюз. Если он успешен, вы увидите основной интерфейс приложения.
Ваши учетные данные хранятся локально в localStorage браузера в изолированном iframe надстройки. Они не синхронизируются с серверами Anthropic. Поскольку надстройка Office работает внутри изолированного iframe в приложении Microsoft, она не может использовать цепочку ключей ОС так же, как Claude Code — по этой причине вводите только токены, выданные шлюзом, а не необработанные учетные данные поставщика облачных услуг.
Bedrock, Vertex AI или прямое подключение к Foundry
Откройте Excel, PowerPoint или Word и запустите надстройку Claude.
Выполните аутентификацию, используя метод вашего поставщика:
Bedrock или Vertex AI: Войдите, используя рабочую учетную запись Microsoft. Надстройка использует ваш токен Entra ID для аутентификации у вашего облачного поставщика — отдельные облачные учетные данные не требуются.
Foundry: Если администратор предварительно заполнил имя ресурса Azure и ключ API, надстройка подключается автоматически. В противном случае введите значения, предоставленные вашей командой IT, и выберите «Подключить».
Надстройка читает конфигурацию, подготовленную администратором, и подключается к Bedrock или Vertex AI напрямую.
Если при входе появляется ошибка, подтвердите у своей команды IT, что ваша учетная запись находится в группе, назначенной для надстройки.
Изменение или обновление подключения
Если срок действия вашего токена API истек или ваша команда IT предоставила вам новый URL, перейдите в раздел «Параметры» на боковой панели надстройки, введите новые значения и выберите «Проверить подключение».
Требования к шлюзу для команд IT
Надстройки Office поддерживают те же три формата API, что и Claude Code. Установите gateway_api_format в манифесте надстройки, чтобы указать надстройке, какой формат использует ваш шлюз.
Требования CORS
Область задач надстройки загружается из https://pivot.claude.ai. Каждый запрос к вашему шлюзу является кросс-доменным, и браузер автоматически отклонит любой ответ без заголовков CORS.
Ваш шлюз должен возвращать Access-Control-Allow-Origin: https://pivot.claude.ai (или *) для каждого ответа: GET, POST, OPTIONS и всех ответов об ошибках. Установка только на предварительный запрос OPTIONS недостаточна. Для предварительного запроса верните Access-Control-Allow-Headers: *.
Требуемые конечные точки
Конечные точки, которые должен предоставлять ваш шлюз, зависят от того, какой формат API он использует. Установите gateway_api_format в манифесте в соответствии с этим.
gateway_api_format: anthropic (по умолчанию)
Конечная точка | Описание |
POST /v1/messages | Отправляйте сообщения Claude. Поддерживает как потоковые, так и непотоковые ответы. |
GET /v1/models | Список доступных моделей. |
gateway_api_format: bedrock
Конечная точка | Описание |
POST /model/{model-id}/invoke | Отправьте сообщение и получите полный ответ. |
POST /model/{model-id}/invoke-with-response-stream | Отправьте сообщение и получите потоковый ответ. |
Встроенный проход InvokeModel Bedrock. gateway_url должен указывать на префикс проходного соединения (например, https://litellm.example.com/bedrock).
gateway_api_format: vertex
Конечная точка | Описание |
POST /projects/{project}/locations/{region}/publishers/anthropic/models/{model-id}:rawPredict | Отправьте сообщение и получите полный ответ. |
POST /projects/{project}/locations/{region}/publishers/anthropic/models/{model-id}:streamRawPredict | Отправьте сообщение и получите потоковый ответ. |
Встроенный проход Vertex. gateway_url должен включать сегмент версии API (например, https://litellm.example.com/vertex_ai/v1). Также требует gcp_project_id и gcp_region, чтобы надстройка могла построить путь.
Требуемый заголовок
Для форматов anthropic и vertex шлюз должен передавать заголовок запроса anthropic-version поставщику выше по потоку.
Для формата bedrock SDK помещает anthropic_version в тело запроса — шлюз должен сохранить его там.
Невозможность передать заголовок или сохранить поле тела может привести к снижению функциональности или помешать работе надстройки.
Заголовок авторизации
Надстройка может отправить токен авторизации вашего шлюза либо в заголовке x-api-key, либо в заголовке Authorization.
Обнаружение модели
При входе надстройка пытается обнаружить доступные модели Claude через GET /v1/models. Если ваш шлюз не предоставляет список моделей по этому пути, надстройка переходит к запросу у пользователя вручную ввести идентификатор модели.
Различия от настройки шлюза Claude Code
Аспект | Claude Code | Claude для Excel, PowerPoint и Word |
Хранилище учетных данных | Цепочка ключей ОС или переменные окружения | Локальное хранилище браузера (изолированный iframe) |
Конфигурация аутентификации | Переменные окружения, файл параметров, вспомогательные скрипты | Ручной ввод в пользовательском интерфейсе надстройки (шлюз), Entra ID (прямое облако) или ключ API Azure (Foundry) |
Обновление токена | Поддерживает вспомогательные скрипты для ротации | Ручной повторный ввод в параметрах (шлюз) или автоматический через Entra ID (прямое облако) |
Пользовательские имена моделей | Настраивается через переменные окружения | Не настраивается в v1 |
Пример конфигурации шлюза с LiteLLM
Предупреждение: версии LiteLLM PyPI 1.82.7 и 1.82.8 были скомпрометированы вредоносным ПО для кражи учетных данных. Не устанавливайте эти версии. Если вы уже их установили:
Удалите пакет
Ротируйте все учетные данные на затронутых системах
Следуйте шагам восстановления в BerriAI/litellm#24518
LiteLLM — это сторонний прокси-сервис. Anthropic не одобряет, не поддерживает и не проверяет безопасность или функциональность LiteLLM. Это руководство предоставляется в информационных целях и может устаревать. Используйте на свой риск.
Многие организации используют LiteLLM в качестве своего шлюза. Ниже приведена минимальная конфигурация litellm_config.yaml для маршрутизации запросов надстройки Office к Anthropic, Bedrock или Vertex.
Маршрутизация непосредственно к Anthropic
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: claude-sonnet-4-5-20250929
api_key: os.environ/ANTHROPIC_API_KEY
litellm_settings:
drop_params: true
Маршрутизация к Amazon Bedrock
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: bedrock/anthropic.claude-sonnet-4-5-20250929-v1:0
aws_region_name: us-east-1
litellm_settings:
drop_params: true
Маршрутизация к Google Cloud Vertex AI
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: vertex_ai/claude-sonnet-4-5-20250929
vertex_project: your-gcp-project-id
vertex_location: us-east5
litellm_settings:
drop_params: true
Маршрутизация к Azure
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: azure_ai/claude-sonnet-4-5-20250929
api_base: https://your-resource.services.ai.azure.com/anthropic
api_key: os.environ/AZURE_API_KEY
extra_headers:
x-api-key: os.environ/AZURE_API_KEY
litellm_settings:
drop_params: true
Подробные инструкции по настройке см. в документации LiteLLM по формату Anthropic.
Что собирает Anthropic
Даже когда вывод проходит через вашу собственную инфраструктуру, надстройка взаимодействует с pivot.claude.ai для загрузки интерфейса и с claude.ai/api/ для оценки флагов функций. Эти соединения передают операционную телеметрию — такую как используемые функции, время выполнения и частоту ошибок — чтобы Anthropic мог поддерживать и улучшать работу надстройки. Они не передают ваши подсказки или ответы Claude.
Anthropic собирает информацию в соответствии с условиями AWS Bedrock, Google Cloud Vertex AI или Microsoft Azure, согласованными с договоренностями Anthropic с клиентами. Anthropic не имеет доступа к экземпляру AWS, Google или Microsoft клиента, включая содержащиеся в нем подсказки или выходные данные. Anthropic не обучает генеративные модели с использованием такого контента и не использует его в других целях. Anthropic может получать доступ к метаданным — таким как использование инструментов, количество токенов и аналогичные элементы — и использовать такие метаданные в целях аналитики и улучшения продукта.
Для получения информации о том, что регистрирует шлюз вашей организации или поставщик облачных услуг, обратитесь к своей ИТ-команде.
Чтобы маршрутизировать полный журнал аудита — включая подсказки, входные данные инструментов, выходные данные инструментов и ссылки на документы — в вашу собственную инфраструктуру, см. Настройка пользовательского сборщика OpenTelemetry для агентов Office.
Чем это отличается от входа с учетной записью Claude
Когда вы входите с учетной записью Claude, надстройки подключаются непосредственно к Anthropic. Когда вы подключаетесь через стороннюю платформу, надстройки отправляют запросы вывода в инфраструктуру вашей организации, и ваша ИТ-команда контролирует, как этот трафик маршрутизируется и регистрируется.
Некоторые функции, которые зависят от наличия учетной записи Claude, еще недоступны через сторонние платформы, но мы работаем над добавлением поддержки:
Функция | Учетная запись Claude | Сторонняя платформа |
Чат с вашей электронной таблицей, презентацией или документом | ✓ | ✓ |
Чтение и редактирование ячеек, слайдов, формул и текста документа | ✓ | ✓ |
Соединители (S&P, FactSet и т. д.) | ✓ | Скоро |
Работа между приложениями | ✓ | — |
Навыки | ✓ | Скоро |
Загрузка файлов | ✓ | — |
Веб-поиск | ✓ | Только Vertex |
Если вашей команде нужны эти функции, обратитесь к администратору Claude о том, какой способ входа подходит вашей организации.
Устранение неполадок
"Соединение отклонено" или ошибка сети
URL шлюза или облачная конечная точка недоступны из сети пользователя. Проверьте правильность URL, работает ли служба и нет ли ограничений брандмауэра или VPN, блокирующих соединение. Проверьте раздел Список разрешённых сетей выше, чтобы убедиться, что все необходимые домены разрешены.
401 Несанкционированный доступ или "Недействительный токен"
Токен аутентификации недействителен или истёк. Для подключений через шлюз подтвердите токен у своей IT-команды. Для прямых облачных подключений проверьте, находится ли учётная запись Entra ID пользователя в назначенной группе и правильно ли настроены доверие OIDC или клиент OAuth. Для Foundry повторно создайте ключ в Azure Portal → Keys and Endpoint.
403 Доступ запрещён или "Доступ запрещён"
Токен действителен, но не имеет необходимых разрешений. Для Bedrock проверьте, имеет ли роль IAM разрешения bedrock:InvokeModel. Для Vertex проверьте, имеет ли учётная запись службы разрешения aiplatform.endpoints.predict. Для шлюзов проверьте область действия токена у администратора IT. Для Foundry проверьте правила сетевого взаимодействия ресурса или подтвердите, что ключ принадлежит правильному ресурсу.
404 Не найдено
Надстройка не смогла достичь ожидаемого пути API. Для шлюзов проверьте, что URL является базовым URL (например, https://litellm-server:4000)—не включайте /v1/messages в поле URL.
500 или другие ошибки сервера
Шлюз или поставщик облачных услуг столкнулся с внутренней ошибкой. Проверьте журналы шлюза (например, docker logs litellm при использовании LiteLLM) на предмет ошибок вышестоящего поставщика. Повторите запрос и обратитесь к администратору IT, если проблема сохранится.
"Нет доступных моделей"
Надстройка не смогла найти модели Claude. Для шлюзов ваш шлюз может не предоставлять список моделей в GET /v1/models. Ваша IT-команда может либо настроить шлюз на предоставление списка моделей, либо дать вам конкретный ID модели для ручного ввода. Для Bedrock или Vertex подтвердите, что в вашей учётной записи и регионе включена хотя бы одна модель Claude (Claude Sonnet 4.5 или позже). Для Foundry подтвердите, что в ресурсе развёрнута хотя бы одна модель Claude (каталог моделей).
Потоковые ответы не работают или зависают
Убедитесь, что ваш шлюз поддерживает сквозную передачу Server-Sent Events (SSE). Некоторые конфигурации прокси удаляют или буферизуют соединения SSE, что препятствует достижению потоковых ответов надстройкой.
Функция, которую я ожидал, недоступна
Соединители, навыки, загрузка файлов и работа между приложениями пока недоступны через сторонние платформы. Если они вам нужны, попросите администратора разрешить вход с помощью учётной записи Claude.