第26章 v0 预装编码代理:在沙盒中直接使用 Claude Code
预装代理
v0 的沙盒环境自带预装编码代理,你可以直接在终端中调用它们。这些代理允许你使用 Claude Code 等工具,同时配合 v0 内置的 AI 助手,让你能在同一个项目中灵活采用不同的代理范式。
工作原理
调用代理
要开始使用预装代理,请在你的 v0 项目中打开终端,并运行该代理的 CLI 命令:
claude
代理会在项目的沙盒环境中启动,能够读取、编辑和创建代码库中的文件——就像在你的本地机器上一样。
通过 Vercel AI Gateway 路由流量
默认情况下,所有代理流量都通过 Vercel AI Gateway 进行路由。这意味着:
- 模型访问遵循团队配置:应用于 v0 使用的相同模型限制和权限,同样适用于代理请求。
- 子处理器合规性:通过 Gateway 路由的流量仅由 Vercel 子处理器列表上的提供商处理,确保请求保持在组织批准的数据处理边界内。
- 用量计量:通过 Gateway 路由的代理请求会消耗团队的 AI Gateway 额度,与其他 v0 使用方式相同。
企业版可用性
对于企业账户,预装代理默认处于禁用状态。企业管理员必须明确选择加入才能为其团队启用该功能。这允许组织在将功能提供给用户之前,先根据安全性和合规性要求对其进行评估。
对于非企业账户,预装代理默认可用。
代理可以访问什么
在 v0 沙盒中运行时,预装代理可以访问:
- 项目代码库:v0 项目内的所有文件和目录。
- 沙盒文件和对话历史:会话期间生成的任何文件,包括之前的输出和上下文。
- 环境变量和密钥:在项目的 Vars 面板中配置的变量在沙盒环境中可用,就像在本地开发环境中一样。
这与在沙盒终端中运行的任何进程所获得的访问级别相同。请将沙盒环境视为本地开发机器——避免存储那些你不希望终端进程读取的密钥。
不支持的配置
预装代理的支持配置是使用提供的 CLI 包装器(例如 claude),并让流量通过 Vercel AI Gateway 路由。以下操作不属于受支持的配置,使用风险由用户自行承担:
直接执行二进制文件
直接运行代理二进制文件,绕过提供的 CLI 包装器,属于对 v0 终端的不支持用法。CLI 包装器确保代理流量通过 Gateway 进行路由,并具有正确的身份验证和模型限制。
覆盖 Gateway 路由
手动修改代理配置,将流量路由到 Vercel 批准列表之外的提供商(例如,通过提供个人 API 密钥将请求重定向出 Gateway),将移除 Gateway 路由提供的保护。
安装第三方代理
安装 Vercel 未预装的额外代理或 CLI 工具,并使用它们访问项目数据,是不支持的配置。Vercel 未审核或评估用户安装到沙盒中的第三方工具。
Vercel 的可见性与责任
Vercel 不会监控、记录或查看在受支持配置之外进行的代理活动。这意味着:
- 对非 Gateway 流量不承担责任:Vercel 声明对通过非 Gateway 通道或不支持的代理配置传输的数据不承担任何责任。
- 潜在的策略违规:不支持的使用方式可能会违反团队或组织的安全策略。用户有责任确保其操作符合组织的要求。
- 企业管理员注意事项:企业管理员应意识到,拥有终端访问权限的用户在技术上可以执行这些操作。管理员应根据组织的风控偏好和安全态势评估是否启用该功能。
第三方声明
Claude Code 等预装代理属于第三方服务。通过在 v0 中使用预装代理,您即表示已阅读并同意 Vercel《通知与许可信息》中引用的第三方条款。
```