Если ваша организация маршрутизирует Claude через внутренний шлюз LLM, подключенный к AWS Bedrock, Google Cloud Vertex AI или Microsoft Azure, вы можете использовать надстройки Claude for Excel и Claude for PowerPoint без учетной записи Claude.
Это тот же паттерн шлюза, который используется Claude Code. Если ваша организация уже запускает Claude Code через шлюз LLM, вы можете направить надстройки Office на ту же конечную точку — новая инфраструктура не требуется.
Требования
Установлены Claude for Excel или Claude for PowerPoint (из Microsoft Marketplace или развернуты администратором)
URL шлюза и токен API от вашей IT-команды
Шлюз управляется IT-командой вашей организации. Если у вас нет этих учетных данных, свяжитесь с ними — Anthropic не может предоставить или сбросить их для вас.
Инструкции по подключению шлюза для конечных пользователей
Администратор должен развернуть Claude for Excel или PowerPoint в вашей организации, прежде чем вы сможете подключиться. Инструкции см. в следующих разделах:
После развертывания надстроек администратором выполните следующие действия:
Откройте Excel или PowerPoint и запустите надстройку 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 — по этой причине вводите только токены, выданные шлюзом, а не необработанные учетные данные поставщика облачных услуг.
Изменение или обновление вашего шлюза
Если срок действия вашего токена API истек или IT-команда предоставила вам новый URL, перейдите в «Параметры» на боковой панели надстройки, введите новые значения и выберите «Проверить соединение».
Требования к шлюзу для IT-команд
Надстройки Office поддерживают только формат Anthropic Messages API через унифицированную конечную точку. Это более специфично, чем Claude Code, который также поддерживает форматы Bedrock InvokeModel и Vertex rawPredict напрямую.
Требуемые конечные точки
Ваш шлюз должен предоставлять эти две конечные точки:
Конечная точка | Описание |
| Отправка сообщений Claude. Поддерживает как потоковые, так и непотоковые ответы. |
| Получение списка доступных моделей. |
Требуемые заголовки
Шлюз должен пересылать следующие заголовки запроса от надстройки поставщику выше по потоку:
anthropic-beta— включает бета-функции, необходимые надстройке.anthropic-version— указывает версию API для формата запроса/ответа.
Невыполнение пересылки этих заголовков может привести к снижению функциональности или помешать работе надстройки.
Обнаружение моделей
При входе надстройка проверяет токен через GET /v1/messages, а затем пытается обнаружить доступные модели Claude через GET /v1/models. Если ваш шлюз не предоставляет список моделей по этому пути, надстройка переходит к запросу у пользователя вручную ввести ID модели.
Различия от настройки шлюза Claude Code
Аспект | Claude Code | Claude for Excel и PowerPoint |
Поддерживаемые форматы API | Anthropic Messages, Bedrock InvokeModel, Vertex rawPredict | Только Anthropic Messages (унифицированная конечная точка) |
Типы конечных точек | Унифицированные и сквозные | Только унифицированные |
Хранилище учетных данных | Цепочка ключей ОС или переменные окружения | localStorage браузера (изолированный iframe) |
Конфигурация аутентификации | Переменные окружения, файл параметров, вспомогательные скрипты | Ручной ввод в интерфейс надстройки (URL и токен) |
Обновление токена | Поддерживает вспомогательные скрипты для ротации | Ручной повторный ввод в параметрах |
Пользовательские имена моделей | Настраиваются через переменные окружения | Не настраиваются в v1 |
Пример конфигурации шлюза с LiteLLM
Многие организации используют LiteLLM в качестве своего шлюза. Ниже приведена минимальная конфигурация litellm_config.yaml для маршрутизации запросов надстроек Office к Anthropic, Bedrock или Vertex.
Примечание: LiteLLM — это стороннее программное обеспечение с открытым исходным кодом и не поддерживается Anthropic.
Маршрутизация непосредственно к 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
# Включить унифицированную конечную точку Anthropic
# Это то, что будет вызывать надстройка Office
Маршрутизация к 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
Обновите ваш litellm_config.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
Обновите ваш litellm_config.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
Когда вы используете надстройки через шлюз, Anthropic собирает информацию в соответствии с условиями AWS Bedrock, Google Cloud Vertex AI или Microsoft Azure и в соответствии с договоренностями Anthropic с клиентами. Anthropic не имеет доступа к экземпляру AWS, Google или Microsoft клиента, включая содержащиеся в нем подсказки или выходные данные. Anthropic не обучает генеративные модели с использованием такого контента и не использует его в других целях. Anthropic может получать доступ к метаданным — таким как использование инструментов, количество токенов и другие элементы — и использовать такие метаданные для аналитических и целей улучшения продукта.
Для получения информации о том, что регистрирует шлюз вашей организации, свяжитесь с вашей IT-командой.
Чем это отличается от входа с учетной записью Claude
Когда вы входите с учетной записью Claude, надстройки подключаются непосредственно к Anthropic. Когда вы подключаетесь через шлюз, надстройки отправляют запросы в инфраструктуру вашей организации, и ваша IT-команда контролирует, как этот трафик маршрутизируется и регистрируется.
Некоторые функции, которые требуют наличия учетной записи Claude, пока недоступны через шлюз, но мы работаем над добавлением поддержки в ближайшее время:
Функция | Учетная запись Claude | Корпоративный шлюз |
Чат с вашей электронной таблицей или презентацией | ✓ | ✓ |
Чтение и редактирование ячеек, слайдов, формул | ✓ | ✓ |
Соединители (S&P, FactSet и т. д.) | ✓ | — |
Работа между приложениями | ✓ | — |
Навыки | ✓ | — |
Загрузка файлов | ✓ | — |
Память | ✓ | — |
Веб-поиск | ✓ | Только Vertex |
Если вашей команде нужны эти функции, поговорите с администратором Claude о том, какой способ входа подходит для вашей организации.
Устранение неполадок
«Соединение отклонено» или ошибка сети
URL шлюза недоступен из сети пользователя. Проверьте правильность URL, работает ли шлюз и нет ли ограничений брандмауэра или VPN, блокирующих соединение.
401 Unauthorized или «Недействительный токен»
Токен аутентификации недействителен или истек. Подтвердите токен у вашей IT-команды. Токены шлюза управляются вашей организацией, а не Anthropic.
403 Forbidden или «Доступ запрещен»
Токен действителен, но не имеет необходимых разрешений. Для Bedrock проверьте, что роль IAM шлюза имеет разрешения bedrock:InvokeModel. Для Vertex проверьте, что учетная запись службы имеет разрешения aiplatform.endpoints.predict. Обратитесь к администратору IT для получения правильных разрешений.
404 Not Found
Надстройка не смогла достичь ожидаемого пути API. Проверьте, что URL шлюза является базовым URL (например, https://litellm-server:4000) — не включайте /v1/messages в поле URL.
500 или другие ошибки сервера
Шлюз столкнулся с внутренней ошибкой. Проверьте журналы шлюза (например, docker logs litellm при использовании LiteLLM) на предмет ошибок поставщика выше по потоку. Повторите попытку запроса и свяжитесь с администратором IT, если проблема сохраняется.
«Нет доступных моделей»
Надстройка не смогла найти модели Claude на вашем шлюзе. Ваш шлюз может не предоставлять список моделей в GET /model/info. Ваша IT-команда может либо настроить шлюз для предоставления списка моделей, либо дать вам конкретный ID модели для ручного ввода при появлении запроса.
Потоковые ответы не работают или зависают
Проверьте, что ваш шлюз поддерживает сквозную передачу Server-Sent Events (SSE). Некоторые конфигурации прокси удаляют или буферизируют соединения SSE, что препятствует достижению потоковых ответов надстройкой.
Функция, которую я ожидал, отсутствует
Соединители, навыки, загрузка файлов и память недоступны через корпоративный шлюз. Если они вам нужны, попросите администратора рассмотреть возможность входа с учетной записью Claude.