用途：clerk 是访问 Clerk Backend API 与 Platform API 的预认证命令行入口，同时提供项目级工具（认证、关联、环境变量拉取、实例配置）。涉及 Clerk 资源时应优先使用它，而非手写 curl。
主要能力：会话与项目层支持 auth login、link/unlink、whoami、env pull、doctor；实例配置支持 config pull、config schema、config patch、config put；Backend API 通过 clerk api <path> 访问用户、组织、会话、邀请、JWT 模板、Webhook 等运行时数据；Platform API 加 --platform 访问应用、实例、账单等账户级数据。可用 clerk api ls 动态发现端点。
使用方式：会话开始先运行 clerk --version 与 clerk doctor --json 检查健康状态。调用前确定二进制：优先全局 clerk，版本不符时按项目锁文件回退到 bunx/npx/pnpm dlx/yarn dlx 并固定版本。变更操作先用 --dry-run 预览，再正式执行（必要时加 --yes）。大输出先写入文件再用 jq 或 Python/Node 查询，避免占用上下文。
适用场景：在 AI 编码代理或脚本中管理 Clerk 用户、组织、会话、实例配置与部署验证。
限制：CLI 依赖宿主环境（系统钥匙串、用户主目录状态、仓库 git 远程、本地 .env、网络、浏览器与 localhost 回调）。沙箱中可能误报未登录、未关联或网络失败，出现宿主能力警告时应在宿主 shell 重跑后再信任结果。代理模式下交互提示被禁用，需显式传参。具体版本、命令标志与行为以 clerk <command> --help 为准。