如何配置 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），仅供参考
