它能做什么
中文摘要
该技能用于将项目部署到 Vercel,默认以预览(preview)模式部署,除非用户明确要求生产环境。它会先检测项目状态(git remote、是否已链接、CLI 是否认证),然后根据状态选择最合适的部署方法:若已链接且有 git remote,则通过 git push 触发部署;若已链接但无 git remote,则直接使用 vercel deploy;若未链接但 CLI 已认证,则先链接再部署;若 CLI 未认证,则安装 CLI、登录、链接并部署;在无法认证的沙盒环境中,可通过无认证脚本获得预览 URL 和 Claim URL。
为什么推荐
推荐理由
推荐该技能因为其提供了完善的 Vercel 部署流程,覆盖多种项目状态和运行环境,包括 git 集成、CLI 部署以及无认证沙盒的备用方案。它自动检测项目状态并选用最佳方法,减少手动操作,同时始终以预览模式部署以保证安全,并能处理多团队选择、构建状态检查等细节。
什么时候用
适用场景
- 用户希望将项目快速部署到 Vercel 并获取预览链接
- 需要在 git push 后自动触发 Vercel 部署的场景
- 在 claude.ai 或 Codex 等沙盒环境中无法完成认证但需要部署的用户
- 开发者想要将现有项目链接到 Vercel 并启用自动部署
使用前先看
主要亮点
- 01
检测项目状态:检查 git remote、.vercel 链接文件、CLI 认证和团队列表
- 02
默认以预览模式部署,避免意外生产发布
- 03
支持通过 git push 触发部署,并自动获取预览 URL
- 04
提供无认证 fallback 脚本,在沙盒环境中生成预览 URL 和 Claim URL
- 05
支持多团队选择,通过 --scope 指定团队
- 06
使用 --no-wait 快速获取部署 URL,并用 vercel inspect 检查状态
- 07
提供详细的故障排除指南,包括网络限制、认证失败等
原始文档
原文摘录
Deploy to Vercel Deploy any project to Vercel. **Always deploy as preview** (not production) unless the user explicitly asks for production. The goal is to get the user into the best long-term setup: their project linked to Vercel with git-push deploys. Every method below tries to move the user closer to that state.