gh_mirrors/co/coding-agent-template完全手册：从环境配置到任务执行的完整Workflow

GitHub 加速计划（coding-agent-template）是一个强大的多智能体 AI 编码平台，由 Vercel Sandbox 和 AI Gateway 提供支持，能帮助开发者自动执行代码仓库中的编码任务。本文将为你提供从环境配置到任务执行的完整操作指南，让你轻松上手这个高效的 AI 编码工具。## 平台核心功能概览coding-agent-template 作为一款先进的 A

蒋闯中Errol

967人浏览 · 2026-03-02 05:41:28

蒋闯中Errol · 2026-03-02 05:41:28 发布

gh_mirrors/co/coding-agent-template完全手册：从环境配置到任务执行的完整Workflow

【免费下载链接】coding-agent-template Multi-agent AI coding platform powered by Vercel Sandbox and AI Gateway 项目地址: https://gitcode.com/gh_mirrors/co/coding-agent-template

GitHub 加速计划（coding-agent-template）是一个强大的多智能体 AI 编码平台，由 Vercel Sandbox 和 AI Gateway 提供支持，能帮助开发者自动执行代码仓库中的编码任务。本文将为你提供从环境配置到任务执行的完整操作指南，让你轻松上手这个高效的 AI 编码工具。

平台核心功能概览

coding-agent-template 作为一款先进的 AI 编码平台，具备以下核心特性：

多智能体支持：可选择 Claude Code、OpenAI Codex CLI、GitHub Copilot CLI、Cursor CLI、Google Gemini CLI 或 opencode 执行编码任务
用户认证：通过 GitHub 或 Vercel OAuth 实现安全登录
Vercel Sandbox：在隔离、安全的沙箱中运行代码
AI 网关集成：与 Vercel AI Gateway 无缝集成，实现模型路由和可观测性
任务管理：实时跟踪任务进度，查看详细执行日志
Git 集成：自动创建分支并提交更改，生成 AI 驱动的描述性分支名称

coding-agent-template 平台主界面，展示了任务创建和智能体选择功能

快速部署与安装步骤

一键部署到 Vercel

最简单的开始方式是使用 Vercel 一键部署：

点击部署按钮，系统将自动创建 Neon Postgres 数据库并连接到项目
配置所需环境变量（Vercel 凭证和加密密钥）
部署后，在项目设置中配置至少一个 OAuth 提供程序（GitHub 或 Vercel）

本地开发环境搭建

如果你需要在本地开发和调试，可以按照以下步骤操作：

1. 克隆仓库

git clone https://gitcode.com/gh_mirrors/co/coding-agent-template
cd coding-agent-template

2. 安装依赖

pnpm install

3. 配置环境变量

创建 .env.local 文件并设置以下必要变量：

# 数据库连接
POSTGRES_URL=你的PostgreSQL连接字符串

# Vercel沙箱配置
SANDBOX_VERCEL_TOKEN=你的Vercel API令牌
SANDBOX_VERCEL_TEAM_ID=你的Vercel团队ID
SANDBOX_VERCEL_PROJECT_ID=你的Vercel项目ID

# 安全加密配置
JWE_SECRET=$(openssl rand -base64 32)
ENCRYPTION_KEY=$(openssl rand -hex 32)

# 认证提供程序配置
NEXT_PUBLIC_AUTH_PROVIDERS=github,vercel

4. 设置数据库

pnpm db:generate
pnpm db:push

5. 启动开发服务器

pnpm dev

打开 http://localhost:3000 即可访问应用。

环境变量详细配置指南

环境变量配置是确保平台正常运行的关键步骤，以下是详细说明：

核心基础设施变量

这些变量由应用开发者设置，用于核心基础设施：

POSTGRES_URL: PostgreSQL 连接字符串（部署到 Vercel 时通过 Neon 集成自动提供）
SANDBOX_VERCEL_TOKEN: 创建沙箱所需的 Vercel API 令牌
SANDBOX_VERCEL_TEAM_ID: Vercel 团队 ID
SANDBOX_VERCEL_PROJECT_ID: Vercel 项目 ID
JWE_SECRET: 用于会话加密的 Base64 编码密钥（使用 openssl rand -base64 32 生成）
ENCRYPTION_KEY: 用于加密用户 API 密钥和令牌的 32 字节十六进制字符串（使用 openssl rand -hex 32 生成）

用户认证配置

必须配置至少一种认证方法（Vercel 或 GitHub）：

# 启用的认证提供程序
NEXT_PUBLIC_AUTH_PROVIDERS=github,vercel

# GitHub 认证（如果启用）
NEXT_PUBLIC_GITHUB_CLIENT_ID=你的GitHub OAuth应用客户端ID
GITHUB_CLIENT_SECRET=你的GitHub OAuth应用客户端密钥

# Vercel 认证（如果启用）
NEXT_PUBLIC_VERCEL_CLIENT_ID=你的Vercel OAuth应用客户端ID
VERCEL_CLIENT_SECRET=你的Vercel OAuth应用客户端密钥

API 密钥配置（可选）

这些 API 密钥可以全局设置（作为所有用户的备用），或留空让用户在个人资料中提供：

# AI服务API密钥
ANTHROPIC_API_KEY=Anthropic API密钥（用于Claude智能体）
AI_GATEWAY_API_KEY=AI Gateway API密钥
CURSOR_API_KEY=Cursor智能体支持所需的API密钥
GEMINI_API_KEY=Google Gemini智能体支持所需的API密钥
OPENAI_API_KEY=Codex和OpenCode智能体所需的API密钥

任务创建与执行完整流程

使用 coding-agent-template 执行编码任务的完整流程如下：

1. 用户认证

首先通过 GitHub 或 Vercel 账号登录系统：

GitHub 登录：直接获得仓库访问权限
Vercel 登录：需要在个人资料中连接 GitHub 账号以访问仓库

2. 创建任务

在平台主界面，你需要：

输入仓库 URL
描述你希望 AI 执行的任务
选择合适的 AI 智能体（Claude Code、Codex CLI 等）
配置任务参数：
- 最大持续时间：沙箱存活时间（5分钟到5小时）
- 保持活动状态：任务完成后是否保持沙箱运行

任务创建界面，显示智能体选择和任务描述输入框

3. 任务执行与监控

提交任务后，系统将：

创建任务记录并存储到数据库
使用 AI SDK 5 + AI Gateway 生成描述性分支名称
创建 Vercel 沙箱并加载你的仓库
执行所选 AI 智能体分析提示并进行代码更改
将更改提交并推送到 AI 生成的分支

你可以在任务页面实时监控进度，查看详细日志输出。

4. 任务配置选项详解

最大持续时间设置

控制 Vercel 沙箱从创建时刻起的存活时间，可选择 5 分钟到 5 小时。超时从沙箱创建时开始计算，所有工作（智能体执行、依赖安装等）都在此时间范围内进行。

保持活动状态设置

关闭（默认）：任务完成后沙箱立即关闭
- 适用于一次性代码更改，不需要迭代
- 完成后立即释放资源，最小化成本
- 任务完成后无法发送后续消息
开启：任务完成后沙箱保持活动状态直至超时
- 允许通过后续消息迭代代码
- 可以在实时沙箱环境中测试更改
- 如果项目有开发服务器（如 npm run dev），会在后台自动启动
- 适合需要细化或修复问题的场景

高级功能：AI 分支名称生成

系统使用 AI SDK 5 和 Vercel AI Gateway 自动生成描述性 Git 分支名称，具有以下特点：

非阻塞：使用 Next.js 15 的 after() 函数生成名称，不会延迟任务创建
描述性：创建有意义的分支名称，如 feature/user-authentication-A1b2C3
无冲突：添加 6 字符字母数字哈希以防止命名冲突
上下文感知：结合任务描述、仓库名称和智能体上下文生成更准确的名称

分支名称示例

feature/add-user-auth-K3mP9n（对应任务："Add user authentication with JWT"）
fix/resolve-memory-leak-B7xQ2w（对应任务："Fix memory leak in image processing"）
chore/update-deps-M4nR8s（对应任务："Update all project dependencies"）
docs/api-endpoints-F9tL5v（对应任务："Document REST API endpoints"）

技术架构与核心组件

coding-agent-template 基于现代化技术栈构建，主要组件包括：

前端技术

框架：Next.js 15、React 19
样式：Tailwind CSS
UI 组件：shadcn/ui
状态管理：Jotai（见 lib/atoms/）

后端技术

数据库：PostgreSQL 与 Drizzle ORM（见 lib/db/）
认证：Next Auth（OAuth 与 GitHub/Vercel）
AI 集成：AI SDK 5 与 Vercel AI Gateway（见 lib/sandbox/agents/）
沙箱：Vercel Sandbox（见 lib/sandbox/）

核心目录结构

app/                    # Next.js 应用目录
components/             # UI 组件
lib/                    # 核心功能库
  atoms/                # Jotai 原子状态
  db/                   # 数据库相关
  sandbox/              # 沙箱管理
  session/              # 会话管理
  utils/                # 工具函数
public/                 # 静态资源