1. 项目定位与用途
这是一个用于快速构建 AI 驱动编码平台的项目模板，基于 Vercel Sandbox 和 AI Gateway 构建。它允许开发者通过自然语言描述编程任务，由集成的主流 AI 编码工具（如 Claude Code、OpenAI Codex CLI 等）自动执行代码生成、修改和提交。模板提供完整的用户认证、任务管理、Git 集成和沙箱执行环境，可一键部署到 Vercel 或本地运行，适用于需要将 AI 编码能力集成到工作流中的团队和个人开发者。
项目档案模板 / Starter
AI 编码平台模板 - 基于 Vercel Sandbox 的多智能体自动化编程工具（支持一键部署与本地开发）
vercel-labs/coding-agent-template：这是一个基于 Vercel Sandbox 和 AI Gateway 的多智能体 AI 编码平台模板，支持 Claude Code、OpenAI本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
这是一个基于 Vercel Sandbox 和 AI Gateway 的多智能体 AI 编码平台模板，支持 Claude Code、OpenAI Codex CLI 等多种 AI 编码工具，可一键部署并安全执行自动化编程任务。
中文项目介绍
本项目是一个基于 Vercel Sandbox 和 AI Gateway 构建的多智能体 AI 编码平台模板，旨在帮助开发者快速搭建支持多种 AI 编码工具的自动化编程系统。它解决了传统开发中集成 AI 编码助手复杂、代码执行环境不安全、多模型切换困难等问题。
该模板支持 Claude Code、OpenAI Codex CLI、GitHub Copilot CLI、Cursor CLI、Google Gemini CLI 和 opencode 等多种主流 AI 编码工具，用户可通过自然语言描述任务，由 AI 自动完成代码编写、提交和 PR 创建。
适用场景包括：个人 AI 辅助编程、团队自动化代码任务执行、多智能体编码技术研究、以及需要安全沙箱环境运行不可信代码的协作开发。
技术实现上，项目采用 Next.js 16 App Router 架构，使用 Drizzle ORM 连接 Neon Postgres 数据库进行数据持久化，通过 @vercel/sandbox 提供隔离的代码执行环境，并集成 AI Gateway 实现模型路由和观测。前端基于 Tailwind CSS 和 Radix UI 构建响应式界面，支持 GitHub 和 Vercel 双渠道 OAuth 认证，API 密钥加密存储，以及基于用户的速率限制机制。
详细信息与使用说明
2. 解决的问题
传统 AI 编码工具集成面临环境配置复杂、代码执行不安全、多模型切换困难等挑战。本模板通过预置 Vercel Sandbox 提供隔离的代码执行环境，确保 AI 生成的代码在安全沙箱中运行；通过 AI Gateway 统一管理多个 AI 模型服务，简化模型切换和观测；内置 GitHub/Vercel OAuth 认证和 Neon 数据库，省去用户自行搭建认证系统和数据存储的麻烦。同时，模板提供任务状态跟踪、实时日志和 PR 创建等完整工作流，让开发者能专注于 AI 能力的应用而非基础设施。
3. 适用场景
该模板主要适用于：1）希望快速验证 AI 编码助手产品的创业团队；2）需要为内部开发团队提供自动化编程工具的科技公司；3）进行多智能体编码技术研究的学术或工程团队；4）个人开发者希望体验 AI 辅助编程的完整流程；5）需要安全执行第三方代码或 AI 生成代码的协作项目。由于采用沙箱执行机制，也适合处理涉及敏感代码或需要严格隔离的执行环境。
4. 安装部署方式
支持两种部署方式：一键 Vercel 部署或本地开发。Vercel 部署需点击部署按钮，自动创建 Neon 数据库，然后配置环境变量（SANDBOX_VERCEL_TEAM_ID、SANDBOX_VERCEL_PROJECT_ID、SANDBOX_VERCEL_TOKEN、JWE_SECRET、ENCRYPTION_KEY）并设置 OAuth 提供商（GitHub 或 Vercel）。本地开发需执行：git clone 项目、pnpm install 安装依赖、配置 .env.local 环境变量、运行 pnpm db:push 初始化数据库、最后 pnpm dev 启动开发服务器。数据库操作还提供 drizzle-kit 相关命令（db:generate、db:migrate、db:studio）。
5. 使用方式
用户使用流程：首先通过 GitHub 或 Vercel 账户登录；在主页输入目标 GitHub 仓库 URL 和自然语言任务描述；选择 AI 编码工具（Claude Code、Codex CLI 等）、设置沙箱最大时长（5 分钟至 5 小时）和 Keep Alive 选项；提交后实时查看执行日志和进度；任务完成后可查看代码变更差异、AI 创建的分支，并可直接在 GitHub 上创建 PR。所有任务在侧边栏集中管理，支持按状态筛选。用户还可在设置页面管理各 AI 服务的 API 密钥。
6. 实现特点与扩展
项目采用模块化设计，核心模块包括认证（OAuth 流程与会话管理）、API 密钥管理（加密存储多提供商密钥）、任务管理（创建、状态跟踪、日志）、沙箱执行（Vercel Sandbox 集成）、Git 操作（分支创建、提交、PR）和数据层（Neon Postgres + Drizzle ORM）。前端使用 Jotai 状态管理，UI 组件基于 Radix UI 和 Tailwind CSS。扩展性方面，支持通过 MCP 服务器为 Claude Code 增加自定义能力，AI Gateway 集成便于添加新模型提供商，数据库模型可通过 Drizzle 迁移进行结构演化。
思维导图
coding-agent-template
核心功能
多智能体支持
用户认证
任务管理
沙箱执行
Git 集成
技术栈
Next.js 16
Drizzle ORM
Neon Postgres
Vercel Sandbox
AI Gateway
Tailwind CSS
模块组成
认证模块
API 密钥管理
会话与速率限制
沙箱配置
数据库操作
部署方式
Vercel 一键部署
本地开发环境
使用流程
用户登录
创建任务
监控进度
查看结果
管理任务
常见问题
这个模板支持哪些 AI 编码工具？
支持 Claude Code、OpenAI Codex CLI、GitHub Copilot CLI、Cursor CLI、Google Gemini CLI 和 opencode 等多种主流 AI 编码工具，用户可在创建任务时选择。
如何部署这个项目？
支持两种方式：一键部署到 Vercel（点击部署按钮，配置环境变量和 OAuth），或本地开发（克隆仓库、安装依赖、配置环境、初始化数据库、启动开发服务器）。
代码执行环境是否安全？
是的，所有代码在 Vercel Sandbox 中执行，提供隔离的容器环境，任务完成后可根据设置自动销毁，确保安全。
如何管理不同 AI 服务的 API 密钥？
用户登录后可在设置页面添加、更新或删除各 AI 服务（如 OpenAI、Anthropic、Google 等）的 API 密钥，密钥在数据库中加密存储。
是否支持团队协作？
是的，模板设计为多用户系统，每个用户有独立的任务、API 密钥和 GitHub 连接，适合团队内部使用。