---
title: "发布应用或网站"
description: "说明如何让 Codex 从 repo、screenshot、design brief 或 API doc 出发构建网站并部署 preview。"
verifiedAt: "2026-05-05"
---

Codex 可以从 repo、screenshot、map、design brief、product note、API doc 或 data source 出发，构建或更新网站，再通过 Vercel 部署 preview，并把 live URL 交回来。

官方页面：[https://developers.openai.com/codex/use-cases/deploy-app-or-website](https://developers.openai.com/codex/use-cases/deploy-app-or-website)

## 适合什么任务

| 场景 | Codex 应该做什么 |
|---|---|
| 把 screenshot、map、design brief 或 rough app idea 做成可访问 preview | 使用 `@build-web-apps` 构建或打磨 app，再用 `@vercel` 部署 |
| 部署一个 branch 或 local app，不想手动 wiring Vercel commands | 让 Vercel plugin 处理 preview deployment、deployment inspection 和 build logs |
| 需要 live URL 给别人看 | 本地 build 通过后部署 preview，并回报可访问 URL |

## 使用的能力

| 能力 | 用法 | 链接 |
|---|---|---|
| `build-web-apps` | 构建、review 和准备 web apps，覆盖 React、UI、deployment、payments、database guidance | [https://github.com/openai/plugins/tree/main/plugins/build-web-apps](https://github.com/openai/plugins/tree/main/plugins/build-web-apps) |
| `vercel` | 部署 previews、检查 deployments、读取 build logs、管理 Vercel project settings | [https://github.com/openai/plugins/tree/main/plugins/vercel](https://github.com/openai/plugins/tree/main/plugins/vercel) |

相关官方说明：

- Build Web Apps plugin：[https://github.com/openai/plugins/tree/main/plugins/build-web-apps](https://github.com/openai/plugins/tree/main/plugins/build-web-apps)
- Vercel plugin：[https://github.com/openai/plugins/tree/main/plugins/vercel](https://github.com/openai/plugins/tree/main/plugins/vercel)
- Vercel deployments：[https://vercel.com/docs/deployments/overview](https://vercel.com/docs/deployments/overview)

## 起始提示词

```text
请使用 @build-web-apps，把 [repo、screenshot、design 或 rough app idea] 做成可运行的网站。

然后使用 @vercel 部署 preview，并把 live URL 交给我。

上下文：
- [这个网站应该做什么]
- [要使用的 source data、API、docs 或 assets]
- [style 或 product constraints]
- [哪些内容不要改]

交付前，请先运行 local build，并确认 deployment 已 ready。
```

这个 prompt 要求 Codex 先构建，再 preview deploy，并且在交付前运行 local build。不要跳过本地验证直接要 URL。

## 先明确站点和部署目标

有用的交接应该具体。你可以给 Codex：

- repo。
- screenshot。
- map。
- design brief。
- product note。
- API doc。
- data source。

Codex 应该先 inspect project，再修改。默认部署目标应该是 Vercel preview；只有你明确要求 production，才进入生产发布。

## 检查后再分享

交付前，Codex 应该告诉你：

- 改了什么。
- 用哪条 command build。
- Vercel deployment 是否 ready。
- 是否缺 environment variable。
- 是否需要 team choice、domain setting 或登录步骤。
- 如果 deploy 失败，失败日志在哪里，下一步怎么修。

如果缺少环境变量、团队选择、域名设置或登录步骤，Codex 应该直接说明 blocker，而不是把站点说成已经完成。

## 从 live URL 继续迭代

拿到 preview URL 后，不要换线程。同一线程已经有 repo、deployment 和 build context。

可以继续让 Codex：

- 打开 URL 检查页面。
- 修 mobile layout。
- 更新 copy。
- 接上缺失数据。
- 读取 Vercel failed build logs。
- 修复后重新部署 preview。

好的 follow-up 应该具体：

```text
移动端 layout 太拥挤。请修复并重新部署 preview。
```

```text
继续使用同一个项目，并加入来自 [source] 的最新数据。
```

```text
请读取 failed build logs，并修复 deploy。
```

## 发布边界

preview deployment 是默认动作。production changes 要明确说出来，并在执行前确认：

- 目标 project。
- 目标 branch。
- environment variables。
- domain / alias 设置。
- 是否会影响现有用户。

Codex 适合把构建、部署和日志诊断串起来，但生产发布仍然应该保持显式边界。
