用途：为 Nuxt 3 项目集成 @clerk/nuxt 提供认证模式参考，覆盖路由保护、服务端 API 鉴权、组件内组合式函数与 SSR 安全四类任务。
主要能力：references/nuxt-middleware.md 讲路由保护与 clerkMiddleware()；references/server-api-routes.md 讲 Nitro 服务端路由鉴权；references/composables.md 讲 useAuth、useUser、useClerk；references/ssr-auth.md 讲 SSR 水合及服务端与客户端差异。
安装与配置：npm install @clerk/nuxt。环境变量使用 NUXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_... 与 NUXT_CLERK_SECRET_KEY=sk_...。nuxt.config.ts 中写入 modules: ['@clerk/nuxt']，该行会自动配置中间件、插件与组件自动导入。
心智模型：@clerk/nuxt 自动导入全部 Clerk 组件与组合式函数，无需在 script setup 中显式导入。组合式函数（useAuth、useUser）为客户端响应式，用于 script setup；服务端路由使用 clerkClient 与 event.context.auth；中间件 clerkMiddleware 自动注册，用 auth().protect() 锁定路由。
最小用法：页面中 definePageMeta({ middleware: 'auth' }) 使用内置 auth 中间件，配合 useAuth() 取 userId，模板中用 Show when="signed-in"。组织场景可用 useAuth() 的 orgId、orgRole，配合 OrganizationSwitcher。
常见问题：组合式函数在服务端返回 undefined，因 useAuth 仅客户端可用，服务端路由应改用 event.context.auth；路由未受保护通常是缺少 middleware: 'auth' 元信息；clerkClient 不可用多为导入路径错误，应从 @clerk/nuxt/server 导入；水合不匹配需用 ClientOnly 或检查 isLoaded；环境变量未生效多为前缀错误，公开变量需 NUXT_PUBLIC_，服务端需 NUXT_。
限制：资料未提供版本要求、收费与价格、性能数据及完整示例，相关细节暂未提供。