用途：该技能用于为 Speakeasy CLI 命令设置认证，适用于首次配置 CLI、命令返回 unauthorized 错误、为 CI/CD 或 AI 智能体环境准备认证，以及用户提出“set up API key”“configure auth”“authentication failed”等需求时。
主要能力：提供交互式登录与非交互式环境变量两种认证方式，并给出验证认证状态和常见错误排查方法。
使用方式：推荐交互式登录，运行 speakeasy auth login，会打开浏览器完成认证，凭据保存在 ~/.speakeasy/config.yaml。非交互式场景（CI/AI 智能体）设置环境变量：export SPEAKEASY_API_KEY="<your-api-key>"。API key 可从 Speakeasy Dashboard → Settings → API Keys 获取。环境变量优先级高于配置文件。
验证认证：运行 speakeasy status --output json，已认证时返回 JSON 格式的 workspace 信息，未认证则返回 unauthorized 错误。
常见问题：unauthorized 通常因缺少或无效 API key，可重新执行 speakeasy auth login 或设置 SPEAKEASY_API_KEY；workspace not found 通常是 workspace 配置错误，检查 ~/.speakeasy/config.yaml 中的 workspace ID；Token expired 表示会话超时，需重新执行 speakeasy auth login。
限制：该技能依赖 Speakeasy CLI 与有效的 API key，具体获取方式、价格、权限范围及密钥有效期暂未提供。