第25章 v0 预装 Agents 详解：Claude Code 接入与 AI Gateway 路由机制

预装 Agents 直接在 v0 终端中使用 Claude Code 等预装的编码 agent。

v0 沙盒预装了多种编码 agent，你可以在终端中直接调用。这些 agent 让你在 v0 内置 AI 助手之外，还能使用 Claude Code 等工具，在同一项目中灵活选择不同的 agent 工作方式。

工作原理 调用 agent 要使用预装的 agent，在 v0 项目中打开终端，运行对应的 CLI 命令：

claude

agent 会在项目沙盒环境中启动，可以读取、编辑和创建代码库中的文件——就像在本地机器上一样。

流量经 Vercel AI Gateway 路由 默认情况下，所有 agent 流量都会经过 Vercel AI Gateway 路由。这意味着：

模型访问遵循团队配置：适用于你 v0 使用的模型限制和权限，同样适用于 agent 请求。

子处理者合规：经 Gateway 路由的流量只会由 Vercel 子处理者名单中的提供商处理，确保请求始终处于组织批准的数据处理范围内。

用量计费：经 Gateway 路由的 agent 请求会消耗团队的 AI Gateway 额度，与其他 v0 用量一致。

企业版可用性 企业版账户默认禁用预装 agent。企业管理员必须显式选择启用后，团队成员才能使用该功能。这让组织可以先对照自身安全与合规要求评估该功能，再向用户开放。

非企业版账户默认可用预装 agent。

Agent 的访问权限 在 v0 沙盒中运行时，预装 agent 可以访问：

项目代码库：v0 项目内的所有文件和目录。

沙盒文件和对话历史：会话期间生成的所有文件，包括之前的输出和上下文。

环境变量和密钥：项目 Vars 面板中配置的变量在沙盒环境中可用，与本地开发环境一样。

这与沙盒终端中任何进程所拥有的访问权限相同。请像对待本地开发机器一样对待沙盒环境——不要存储你不希望被终端进程读取的密钥。

不受支持的配置 预装 agent 的受支持配置是使用官方提供的 CLI 包装器（如 claude）并经 Vercel AI Gateway 路由流量。以下操作不在受支持配置范围内，风险自负：

直接执行二进制文件 绕过 CLI 包装器直接运行 agent 二进制文件属于不受支持的 v0 终端用法。CLI 包装器负责确保 agent 流量以正确的认证和模型限制经 Gateway 路由。

绕过 Gateway 路由 手动修改 agent 配置，将流量路由到 Vercel 未批准名单之外的提供商——例如提供个人 API 密钥让请求绕过 Gateway——会使 Gateway 路由提供的保护失效。

安装第三方 agent 安装 Vercel 未预装的其他 agent 或 CLI 工具并用其访问项目数据，不属于受支持的配置。Vercel 未对用户安装到沙盒中的第三方工具进行审查或安全评估。

Vercel 的可见性与责任 对于受支持配置之外的 agent 活动，Vercel 不监控、不记录、也不掌握任何可见性。这意味着：

对非 Gateway 流量不承担责任：对于经非 Gateway 通道或不支持的 agent 配置传输的数据，Vercel 不承担任何责任。

可能违反安全策略：不受支持的使用方式可能违反你所在团队或组织的安全策略。用户有责任确保自身行为符合组织要求。

企业管理员注意事项：企业管理员应意识到，拥有终端访问权限的用户在技术上可以执行这些操作。管理员应根据组织的风险承受能力和安全态势来决定是否启用该功能。

第三方声明 Claude Code 等预装 agent 属于第三方服务。在 v0 中使用预装 agent，即表示你确认遵守 Vercel Notices and License Information 中引用的第三方条款。

了解更多 v0 的安全实践 上一篇 MCP Integrations 下一篇 Slack