编码智能体模板 (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 keys 和 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）。

快速开始

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

简要步骤 (TL;DR)：

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
# 根据需要设置 .env.local 环境变量
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. 任务标记为完成。

在以下情况使用“关闭”：

• 你进行的是无需迭代的一次性代码修改。
• 任务较为简单，通常一次即可成功。
• 你希望最大限度降低资源使用和成本。
• 任务完成后不需要测试或手动与代码交互。

保持活跃开启

当启用“保持活跃”时，沙盒在任务完成后会继续保持活跃，直到达到设定的最大持续时间：

时间线：

1. 任务开始，沙盒创建（例如：设置 1 小时超时）。
2. 智能体执行任务...