编码智能体模板 (Coding Agent Template)

这是一个用于构建 AI 驱动编码智能体的模板，支持 Claude Code、OpenAI Codex CLI、GitHub Copilot CLI、Cursor CLI、Google Gemini CLI 以及 opencode，并结合 Vercel Sandbox 在你的代码仓库中自动执行编码任务。

部署你自己的版本

你可以通过一键操作将该编码智能体模板部署到 Vercel：

部署过程说明：

• 自动数据库配置：系统会自动创建并连接一个 Neon Postgres 数据库到你的项目。
• 环境变量配置：系统会提示你填写所需的环境变量（Vercel 凭据和加密密钥）。
• OAuth 配置：部署完成后，你需要在项目设置中至少配置一个 OAuth 提供商（GitHub 或 Vercel）以实现用户认证。

功能特性

• 多智能体支持：可选择 Claude Code、OpenAI Codex CLI、GitHub Copilot CLI、Cursor CLI、Google Gemini CLI 或 opencode 来执行编码任务。
• 用户认证：通过 GitHub 或 Vercel OAuth 进行安全登录。
• 多用户支持：每个用户拥有独立的任务、API 密钥和 GitHub 连接。
• Vercel Sandbox：在隔离、安全的沙盒中运行代码（文档）。
• AI Gateway 集成：专为与 Vercel AI Gateway 无缝集成而构建，支持模型路由和可观测性。
• AI 生成分支名称：使用 AI SDK 5 + AI Gateway 自动生成描述性的 Git 分支名称。
• 任务管理：通过实时更新追踪任务进度。
• 持久化存储：任务存储在 Neon Postgres 数据库中。
• Git 集成：自动创建分支并提交代码变更。
• 现代 UI：基于 Next.js 和 Tailwind CSS 构建，界面简洁且支持响应式。
• MCP Server 支持：为 Claude Code 连接 MCP 服务器以扩展功能（仅限 Claude）。

快速开始

详细设置说明请参考下方的本地开发环境设置部分。

简要步骤：

1. 点击上方的 "Deploy with Vercel" 按钮（自动完成数据库配置！）
2. 在项目设置中配置 OAuth（GitHub 或 Vercel）
3. 用户登录后即可开始创建任务

或者在本地运行：

git clone https://github.com/vercel-labs/coding-agent-template.git
cd coding-agent-template
pnpm install
# Set up .env.local with required variables
pnpm db:push
pnpm dev

使用方法

1. 登录：使用 GitHub 或 Vercel 进行认证。
2. 创建任务：输入仓库 URL 并描述你希望 AI 执行的操作。
3. 监控进度：实时查看智能体工作时的日志。
4. 审核结果：查看代码变更记录及所创建的分支。
5. 管理任务：在侧边栏查看所有任务及其状态更新。

任务配置

最长持续时间 (Maximum Duration)

最长持续时间设置控制 Vercel 沙盒从创建时刻起保持活跃的时间。你可以选择 5 分钟到 5 小时之间的超时限制。

• 沙盒在任务开始时创建。
• 超时计时从沙盒创建时开始计算。
• 所有工作（智能体执行、依赖安装等）均在此时间范围内完成。
• 当达到超时时间时，沙盒会自动过期。

保活设置 (Keep Alive Setting)

保活设置决定了任务完成后沙盒的状态。

关闭保活 (默认)

当禁用保活时，沙盒会在任务完成后立即关闭：

时间线：

1. 任务启动并创建沙盒（例如设置 1 小时超时）。
2. 智能体执行任务。
3. 任务成功完成（例如 10 分钟后）。
4. 变更被提交并推送到分支。
5. 沙盒立即关闭（销毁所有进程和环境）。
6. 任务标记为已完成。

适用于：

• 无需迭代的单次代码修改。
• 首次即可成功的简单任务。
• 希望最小化资源消耗和成本的情况。
• 任务完成后无需测试或手动交互代码的情况。

开启保活 (Keep Alive ON)

当开启保活时，任务完成后沙盒将在剩余时间内保持活跃：

时间线：

1. 任务启动并创建沙盒（例如设置 1 小时超时）。
2. 智能体执行任务。