SuperAPI AI 工具集

clerk-setup

安全与审计

查看项目

更新于 10-16 06:48

技能介绍

用途:为任意项目添加 Clerk 身份验证,按官方快速入门指南执行。

主要能力:检测框架并匹配对应快速入门文档;执行安装依赖、配置环境变量、添加 Provider 与代理/中间件、创建登录注册路由、测试集成;支持从其他认证方案迁移(先审计再制定迁移计划)。

使用方式:读取 package.json 识别框架(如 next、@remix-run/react、astro、nuxt、react-router、@tanstack/react-start、react、vue、express、fastify、expo 等),用 WebFetch 抓取对应 https://clerk.com/docs/{framework}/getting-started/quickstart 并执行步骤。Next.js 需创建 proxy.ts(Next.js <=15 为 middleware.ts)。若存在 components.json(shadcn/ui),安装 @clerk/ui 并应用 shadcn 主题。API 密钥可走 Keyless 自动生成,或从 dashboard.clerk.com 手动获取,设为 NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY 与 CLERK_SECRET_KEY。

限制与注意:需 Node.js 20.9.0 或更高;Next.js 15+ 中 auth() 为异步需 await;切勿在客户端暴露 CLERK_SECRET_KEY;ClerkProvider 须置于 <body> 内;中间件 matcher 需包含 API 路由并放行 /sign-in、/sign-up。Core 2 与当前 SDK 在包名、主题包、Provider 位置和 Node 版本上存在差异,资料已标注。

适用场景:新项目接入认证、已有认证项目的迁移评估。具体收费、价格与效果资料暂未提供。