用途:在实现现代身份验证且注重用户体验时,使用该 Clerk 专家技能,覆盖 WebAuthn、通行密钥(passkeys)、无密码流程、预制 UI 组件与多租户组织支持。
主要能力:提供环境变量、ClerkProvider、中间件路由保护、useAuth/useUser 钩子、专用登录注册页、服务端认证、组织管理(OrganizationSwitcher、useOrganizationList、useOrganization)等用法参考;并说明核心 2(Core 2)迁移变更与升级命令。
SDK 版本(截至 2025 年 12 月):@clerk/nextjs 6.x(Core 2)需 Next.js 13.0.4+ 与 React 18+;@clerk/clerk-react 5.x(Core 2)需 React 18+;@clerk/express 1.x;需 Node.js 18.17.0+。
必要用法示例:环境变量 .env.local 需设置 NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY(pk_test 开头)、CLERK_SECRET_KEY(sk_test 开头)、NEXT_PUBLIC_CLERK_SIGN_IN_URL、NEXT_PUBLIC_CLERK_SIGN_UP_URL。中间件在 middleware.ts 中导入 clerkMiddleware,导出默认 clerkMiddleware 调用与 config matcher;路由保护使用 createRouteMatcher 配合 auth.protect()。核心 2 迁移可用 npx @clerk/upgrade --from=core-1。
适用场景:Next.js App Router 与 React 应用的登录注册、路由保护、服务端与路由处理器认证、组织切换与成员管理。与 moai-platform-auth0、moai-platform-supabase、moai-platform-vercel 等配合使用。
限制:高级模式(角色访问控制、webhooks、自定义认证流程、外部服务集成)需查看 modules/advanced-patterns.md;资料未提供价格、性能或具体效果数据。状态为 Production Ready,版本 2.1.0,更新于 2026-01-11。