如何配置 GitHub Secrets 让 claude-code-templates 仪表盘主分支自动部署到 Vercel 生产环境【免费下载链接】claude-code-templatesCLI tool for configuring and monitoring Claude Code项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-templates如果你在自己维护的 claude-code-templates 仓库或其派生仓库里希望把仪表盘站点接上自动化部署只要推送到main分支就由 Vercel 完成生产环境部署而不是每次手动执行部署命令。项目自带的部署说明docs/guides/deployment.md给出的机制是在 GitHub 仓库设置里写入三个 Vercel 凭据VERCEL_TOKEN、VERCEL_ORG_ID、VERCEL_PROJECT_ID随后main分支的每次推送都会自动触发生产部署主分支域名指向aitmpl.com。自动部署的工作方式先明确触发与不触发的边界这决定了你配完 Secrets 后如何验证操作部署行为Push 到main分支自动执行生产部署域名aitmpl.com其他分支仅支持手动部署不会自动触发Pull Request不部署也就是说配好 Secrets 之后你的验证动作就是一次main分支的推送非main分支的测试要单独走手动部署路径见后文。第一步获取三个 Vercel 凭据获取 VERCEL_TOKEN文档要求使用你的 Vercel 账号 token路径是 Vercel 控制台的 Account Settings 中的 Tokens 页面创建一个具有相应权限的新 token稍后将其作为VERCEL_TOKEN加入 GitHub Secrets。文档没有给出 token 具体勾选哪些权限的清单只说明appropriate permissions按你账号的实际角色选择即可。获取 VERCEL_ORG_ID 与 VERCEL_PROJECT_ID这两个 ID 不需要在 Vercel 控制台里翻找在项目根目录执行vercel link后会写入本地文件# Link to Vercel project vercel link # Get your IDs from the generated file cat .vercel/project.json在输出的.vercel/project.json内容里复制两个字段orgId→ 作为VERCEL_ORG_ID加入 GitHub SecretsprojectId→ 作为VERCEL_PROJECT_ID加入 GitHub Secrets第二步把凭据写入 GitHub Secrets在你要部署的那个 GitHub 仓库的 Settings → Secrets 中新增三个条目名称必须与上面一致VERCEL_TOKEN上一步创建的 Vercel tokenVERCEL_ORG_ID.vercel/project.json中的orgIdVERCEL_PROJECT_ID.vercel/project.json中的projectId文档要求这三个值都放在仓库的 Secrets 中不要写进任何会提交到仓库的文件。验证推送 main 分支触发生产部署凭据配置完成后按文档给出的部署流程验证向main分支推送一次改动预期结果是 Vercel 自动执行一次生产部署站点更新到aitmpl.com主分支对应的自定义域名在 Vercel dashboard 的 Project Settings → Domains 下配置如果部署失败workflow 参考文档 的排查建议只有一条检查 Vercel token 和环境变量是否正确——即回到第一步核对vercel link生成的 ID 和 token 本身。文档没有给出部署成功后的固定日志或状态码作为成功判定判定依据就是推送main后 Vercel 侧是否出现对应的一次生产部署。可选其他分支的手动部署验证其他分支而不占用生产环境时用文档给出的手动命令# Deploy current branch to preview URL vercel # Deploy current branch to production vercel --prodvercel部署到预览 URL适合分支测试vercel --prod直接打生产环境只在你确认该分支可上线时使用。可选用 scripts/deploy.sh 走生产部署仓库里还有一个现成的部署脚本 scripts/deploy.sh它会执行npx vercel --prod --yes属于直接发生产环境的操作执行前确认当前代码就是你要上线的版本。脚本从项目根目录的.env读取两个变量不存在.env时会报错退出VERCEL_ORG_IDVERCEL_DASHBOARD_PROJECT_ID注意这里的变量名与 GitHub Secrets 里的VERCEL_PROJECT_ID不同脚本内部会把VERCEL_DASHBOARD_PROJECT_ID的值映射为vercel命令使用的VERCEL_PROJECT_ID两者填同一个 project ID 即可。用法# Deploy www app.aitmpl.com ./scripts/deploy.sh已知不一致当前仓库快照中的 deploy.yml 指向 Cloudflare Pages写作时需说明一处文档与仓库文件之间的冲突docs/guides/deployment.md 与 workflow 参考 都描述deploy.yml是push to main → Vercel 生产部署但当前仓库中的 .github/workflows/deploy.yml 实际名为 Deploy to Cloudflare Pages仅监听dashboard/**的 main 推送使用的 Secrets 是CLOUDFLARE_API_TOKEN与CLOUDFLARE_ACCOUNT_ID并未引用上述三个 Vercel Secrets。因此如果你拉取的仓库快照中该 workflow 仍是 Cloudflare 版本按本文配置 Vercel Secrets 不会改变它的行为需要先以 docs/guides/deployment.md 描述的 Vercel 流程为准确认 workflow 已更新或对照该指南检查你的仓库中实际的部署 workflow 内容。两处文档部署指南、workflow 参考都指向 Vercel 流程本文主路径按这两处文档执行。域名与限制的边界主分支的自定义域名是aitmpl.com在 Vercel dashboard 的 Project Settings → Domains 中配置只有main分支是自动部署其他分支和 PR 都不会触发部署文档未说明的失败现象如特定错误码、超时行为不在本文范围内排查入口统一是检查 Vercel token 和环境变量这一条文档明确给出的建议。【免费下载链接】claude-code-templatesCLI tool for configuring and monitoring Claude Code项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-templates创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
