AIKraft/AI/Войти
AIKraft/Skills/Паттерны расширений Chrome для Clerk

Паттерны расширений Chrome для Clerk

Chrome Extension auth with @clerk/chrome-extension -- popup/sidepanel setup, syncHost for OAuth/SAML via web app, createClerkClient for service workers and headless extensions, stable CRX ID. Triggers on: Chrome extension auth, Plasmo clerk, popup sign-in, syncHost, background service worker token, createClerkClient, headless extension.

clerk official Другое

Что делает навык

Настройка аутентификации в Chrome-расширениях с помощью @clerk/chrome-extension, включая управление popup, sidepanel и service workers. Решает задачи интеграции OAuth/SAML через веб-приложение, получения токенов в фоне и обеспечения стабильного CRX ID.

Когда применять

  • Настройка popup или sidepanel для входа пользователя с делегированием OAuth/SAML на веб-приложение через syncHost.
  • Получение токенов сессии в фоновом service worker или headless-расширении с использованием createClerkClient().
  • Обеспечение стабильного идентификатора расширения (CRX ID) путем настройки ключа в manifest до развертывания.
  • Настройка правильных URL перенаправления (chrome.runtime.getURL) для расширения, так как оно использует chrome-extension://.

Как работает

  1. Настроить syncHost для делегирования аутентификации OAuth/SAML веб-приложению, так как popups и sidepanels не поддерживают эти протоколы напрямую.
  2. Использовать createClerkClient() или message passing в service workers и content scripts, так как Clerk React hooks там недоступны.
  3. Настроить ключ в manifest.json для обеспечения стабильного CRX ID до развертывания, чтобы избежать сброса состояния аутентификации при пересборке.
  4. Отключить защиту от ботов (Bot protection) в Clerk Dashboard, так как Cloudflare bot detection не поддерживается в средах расширений.
  5. Использовать chrome.runtime.getURL('.') для всех URL перенаправления, так как расширения используют протокол chrome-extension://.

Примеры запросов агенту

Как настроить syncHost для входа через Google OAuth в popup Chrome-расширения?
Получить токен сессии в service worker с помощью createClerkClient.
Настроить manifest для стабильного CRX ID и отключить бот-защиту в Clerk.

Что понадобится

  • Пакет @clerk/chrome-extension
  • Ключ API Clerk (для настройки клиента)
  • Доступ к панели управления Clerk (для отключения Bot protection)

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

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

1Скачать навык
# возьмите папку навыка «clerk-chrome-extension-patterns» из репозитория: # https://github.com/clerk/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r clerk-chrome-extension-patterns/ ~/.claude/skills/clerk-chrome-extension-patterns/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.