Codex 云端在云端运行编码任务,即使您的计算机进入睡眠状态,任务也能继续运行。您可以在网页端、移动端或桌面应用中使用 Codex 云端编辑代码、运行命令并查看结果。
每个云任务都在独立的工作空间中运行。如果默认环境可用,您无需选择代码仓库即可启动任务。要在多个任务中使用同一套配置,请选择创建环境,选择任务所需的代码仓库、依赖项、工具和访问设置,然后发布环境。
如需了解基本信息,请参阅 Codex 云端概览。
Codex 云端(旧版) 仍支持代码审查以及与 Linear 和 GitHub 的集成。我们计划弃用旧版。如需为这些工作流创建和管理环境,请参阅旧版指南。
在 Codex 云端启动任务
在网页端或桌面应用中,选择工作位置 > 云端。在移动端,打开 Codex。如果环境选择器中显示默认环境,请选择它并描述任务。
- 不使用项目时,您无需选择代码仓库即可启动任务。例如,可以让 Codex 使用示例数据编写并测试脚本。如果任务后续需要用到现有代码,请告诉 Codex 要克隆哪个代码仓库。
- 从桌面应用中的项目启动任务时,如果项目关联的代码仓库托管在 GitHub.com 上,并且您已连接 GitHub 账号,默认环境就可以自动使用这些代码仓库。这种自动配置方式不适用于 GitLab 代码仓库。
向正在运行的任务添加代码仓库是一项独立操作,不依赖于项目的自动配置。您可以让 Codex 克隆环境有权访问的代码仓库,即使任务是在移动端启动的也可以。要通过代码仓库选择器检出 GitLab.com 上的代码仓库,请在网页端或桌面应用中创建可重复使用的环境。
如果要使用您已准备好的配置或他人与您共享的配置,请选择相应的已发布环境。在 Enterprise 工作空间中,请使用您有权访问的已发布环境。管理员可以检查工作空间访问权限。
创建并发布环境
如果要在多个任务中使用相同的代码仓库、工具或访问设置,您可以在网页端或桌面应用中创建可重复使用的环境。使用您的 ChatGPT 账号登录后,按以下步骤操作:
- 在新任务中选择工作位置 > 云端,打开选择环境,然后选择创建环境。
- 选择要检出的代码仓库。如果出现提示,请连接 GitHub。如果代码仓库选择器中有 GitLab 选项,请选择您的 GitLab.com 连接,然后搜索所需的代码仓库。
- 选择开始。Codex 会检查代码仓库、安装依赖项和工具,并测试工作流。
- 按提示授予缺少的访问权限或补充信息。您也可以指定所需的版本、命令或服务。
- 检查环境设置报告、配置和文件。完成剩余工作,保存更改,然后选择发布。
- 看到环境已发布后,选择启动新任务,并描述您希望 Codex 完成的工作。
您也可以从设置 > Codex 云端 > 环境 > 创建环境开始。
保存操作会存储配置,部分设置会立即对当前正在配置的环境生效。发布操作会保存准备好的文件系统,供新任务使用。共享设置决定谁可以使用该环境。
自定义安装和启动过程
Codex 会根据您的代码仓库识别所需的运行时、软件包版本、工具和服务。您可以在对话中调整配置,无需自行编写安装脚本。
Codex 可以将测试过的配置记录在以下两个字段中:
- 安装脚本: 用于安装依赖项和准备开发资源的命令。
- 启动技能: 用于启动服务并检查服务是否就绪的指令。
重用和更新已保存的状态
- 已发布环境中的新任务: 从该环境准备好的文件系统启动。
- 现有任务: 继续使用自己保存的文件,包括未提交的更改和已安装的工具。
- 代码仓库刷新: 在后台自动运行,保留依赖项缓存,不会重新运行安装或启动命令。
要更新可重复使用的配置,请打开设置 > Codex 云端 > 环境。在环境的 … 菜单中选择编辑。描述所需的更改,让 Codex 准备并测试更改,然后保存更改并选择重新发布。启动新任务即可使用更新后的配置,现有任务会保留各自的状态。
请提交重要更改,或保存您需要的输出。保存任务状态不能替代版本控制。
配置环境变量和网络密钥
Codex 会识别缺少的配置,并请您提供它无法推断的值。在环境配置中,选择管理,该选项位于环境变量或 HTTP 密钥旁边。根据用途选择各个值的提供方式:
| 配置 | 用途 | 传递方式 |
|---|---|---|
| 环境变量 | 程序必须直接读取的值 | 直接传递给环境中的程序。 |
| 网络密钥 | 发送给特定 HTTPS 服务的凭据 | 程序收到的是占位符。对于发往允许的目标的请求,代理会将占位符替换为真实值。 |
对于网络密钥,请设置键、值和允许的域名。网络密钥的键不能与任何直接传递的环境变量同名。在配置环境和运行任务期间,代理都会对符合条件的 443 端口 HTTPS 请求执行替换,原始凭据不会出现在本地进程或文件中。
保存归环境所有的网络密钥时,其目标域名会加入受限互联网访问的允许列表。直接传递的环境变量和个人值不会添加目标域名。测试前,请检查已保存的网络策略。有关工作空间的要求,请参阅智能体安全。
提供个人值
您可以在个人保管库中保存自己的环境变量和网络密钥,供工作空间中的云端环境使用。
共享环境可以要求每位使用者通过自己的账号提供相应的值。共享环境时,这些要求也会一并共享,您的个人凭据则不会共享。
出现提示时,在添加个人密钥中输入必填值,然后选择保存并启动。可选值可以留空。
要提前管理这些值,请按以下步骤操作:
- 打开设置 > Codex 云端,然后选择个人保管库选项卡。
- 选择添加,再选择环境变量或网络密钥作为类型,然后输入与环境要求匹配的键和您自己的值。
- 在适用于下选择所有环境或选定的环境,然后选择保存。
任务只会收到它请求的值。为特定环境设置的值优先于通用默认值。对于个人网络密钥,代理也只会在发往环境所允许目标的请求中,以相同方式替换占位符。
在 Enterprise 工作空间内共享环境
共享准备好的环境后,同事可以基于该环境启动自己的任务:
- 打开环境配置。
- 在隐私 > 谁可以使用下选择您的工作空间。
- 保存更改。如果环境尚未发布,请发布环境。
选择仅自己作为谁可以使用的设置,即可将环境设为私有。每个任务都有独立的工作文件。获得环境的使用权限并不意味着可以访问他人的任务或编辑环境。
共享前,请检查准备好的文件以及归环境所有的凭据。云身份和 VPN 连接也可能让使用者共同访问某些服务。代码仓库的访问权限和可用的个人连接取决于运行任务的账号。
在云端使用 Codex 权限决定谁可以访问任务。管理工作空间环境权限决定谁可以创建和编辑与工作空间共享的环境。请参阅角色和工作空间权限。
智能体安全
环境的互联网访问设置决定其虚拟机可以访问哪些公共互联网目标。VPN 设置独立生效,用于将该虚拟机连接到专用网络上的服务。
在 Enterprise 工作空间中,管理员通过智能体安全设置工作空间对智能体行为、托管执行环境的网络访问以及受支持工具的使用要求。这些要求与各环境保存的域名设置同时生效。有关全局策略以及 Codex 云端支持覆盖的设置,请参阅智能体安全文档。
连接到服务
要配置对工作流所需的软件包注册表、API 和其他服务的访问,请按以下步骤操作:
- 在环境配置中,选择工作流所需的公共互联网访问范围。要允许完全访问,请开启允许访问整个公共互联网。该范围已包含软件包管理器和附加域名设置涵盖的目标,因此这两项范围更窄的设置会被禁用。
- 要限制公共互联网访问,请关闭允许访问整个公共互联网,然后允许访问软件包管理器所需的目标,或在其他允许的域名下添加特定主机。关闭完全访问后,仍可访问这些明确允许的目标。
- 保存配置,并在配置环境期间测试服务。发布或重新发布环境,然后在新任务中验证访问是否正常。
公共互联网访问和 VPN 访问彼此独立。您可以只使用其中一种,也可以同时使用两种。公共互联网设置适用于 Tailscale 之外的连接,即使 Tailscale 子网路由使用公共 IP 地址也是如此。限制公共互联网访问不会禁用已配置的 VPN。
有关工作空间的要求,请参阅智能体安全。允许访问某个目标不会自动提供凭据,也不会授予该服务中的权限。
如果您通过公共互联网访问的服务会按来源 IP 筛选连接,请使用智能体出口 IP 地址列表。请允许列表中发布的所有地址段,每天检查列表,并在地址段发生变化时更新服务的允许列表。多个客户共用这些地址段,因此请保留服务的身份验证和授权控制。
专用网络连接(VPN)
通过 VPN 连接,云任务可以访问您专用网络中的服务。Tailscale 会使用您配置的专用 DNS、子网路由和访问规则。对于通过 Tailscale 访问的目标,包括 HTTP、HTTPS 和其他 TCP 服务,您无需另行配置 Codex IP 或域名允许列表。
- 在环境配置中,选择 Tailscale 旁边的铅笔图标。
- 输入 VPN 提供商提供的连接凭据。
- 在 Tailscale 中配置所需的路由、DNS 和访问规则,使环境的 VPN 身份能够访问目标服务。
- 保存配置,然后发布或重新发布环境。启动新任务并测试服务。
目前支持的 VPN 提供商是 Tailscale。创建 Tailscale 身份验证密钥时,请同时启用可重复使用和临时设备选项。可重复使用的密钥允许新的云任务虚拟机加入您的网络。临时设备离线后,Tailscale 会自动将其移除。我们计划支持更多 VPN 提供商。
云任务支持专用 IPv4 子网路由,也可以使用 Tailscale 的分流 DNS 和 MagicDNS,通过主机名访问专用服务。
如果服务使用组织的内部 DNS,请在 Tailscale 管理控制台中配置分流 DNS,将内部域名的查询发送到您的 DNS 服务器。请使用服务的完全限定主机名,例如 api.corp.example.com,并确保它能解析为 IPv4 地址。您配置的 Tailscale 路由必须能够到达该目标,Tailscale 访问规则也必须允许访问该目标。
共享环境中的任务使用该环境配置的 VPN 身份。
连接到 TCP 服务
使用 VPN 可以连接到数据库或 SSH 等 TCP 服务。TCP 目标必须使用通过 Tailscale 路由的 IPv4 地址。如果使用主机名,解析出的每个 IPv4 地址都必须经由这些路由访问。平台保护的地址仍会被阻止访问。
TCP 客户端必须通过环境中地址为 proxy:8088 的 HTTP CONNECT 代理建立连接,可以直接连接代理,也可以使用本地转发工具。如果目标使用主机名,请保留主机名,让代理执行 DNS 解析。TCP 隧道不会拦截 TLS 或注入网络密钥。客户端必须提供服务凭据,并在适用时验证服务的 TLS 证书。需要替换网络密钥的请求必须使用已配置的 HTTPS 代理,并符合该密钥的允许域名规则。替换仅在 443 端口生效。
更改 VPN 配置后,请保存更改,然后发布或重新发布环境。要让正在运行的环境使用更新后的 VPN 配置,请替换这些环境。启动新任务并测试访问是否正常。从草稿中移除 VPN 不会撤销已有连接。要撤销访问权限,请替换或终止受影响的环境。
使用 OIDC 访问云资源
通过 OpenID Connect(OIDC),任务可以获取访问云资源的短期凭据。您的组织需要在云提供商处配置信任关系,并向该身份授予工作流所需的权限。
- 在已保存的环境中打开高级 > OIDC 设置。
- 选择添加,然后选择可用连接,或选择创建连接…,为受支持的提供商创建连接。
- 如果是新连接,请输入提供商的身份信息并创建连接。在提供商端,使用显示的签发者、受众和主体或声明条件配置信任关系,并授予资源访问权限。
- 确认连接已关联到环境,并检查其别名。保存配置,然后发布或重新发布环境。
- 启动新任务,分别测试一项允许的操作和一项被拒绝的操作。
不同提供商的配置方式有所不同,环境只能关联受支持的连接。访问范围由该身份的权限决定,您在提供商处的个人权限不会转移给该身份。请在网络策略中分别允许访问所需的提供商端点和目标服务。
更改连接的关联设置或别名后,请保存更改,使其在环境配置期间生效。要在新任务中使用这些更改,请发布或重新发布环境。编辑共享身份连接可能会影响使用该连接的其他环境。
运行和继续任务
在聊天中描述您的目标。Codex 可以编辑文件、运行命令并检查结果。在提交更改或创建 pull request 前,请检查更改和测试结果。
在网页端或移动端继续任务
在网页端,选择工作位置 > 云端,然后选择环境。在移动端,打开 Codex 并选择一个可用环境。您可以在网页端或桌面应用中创建新环境。
重新打开同一个任务,即可在不同设备上继续该任务。每个新任务都在独立的工作空间中启动。即使您的计算机进入睡眠状态,Codex 云端任务也能继续运行。
从 Slack 或 Microsoft Teams 启动任务
如果您的 Enterprise 工作空间已启用云端任务委派,您可以在 Slack 或 Microsoft Teams 中请 @ChatGPT 处理某个代码仓库中的工作。Codex 会根据对话上下文选择一个环境,该环境必须已与工作空间共享,并且运行任务的账号有权使用。您可以在提示词中指定首选环境或补充说明。
对于 Slack,如果工作空间启用了 Codex 云端基于角色的访问控制,则必须同时向部署所用的服务账号和发起请求的用户授予 Codex 云端访问权限。有关管理员配置步骤,请参阅为 Slack 启用 Codex 云端。
按提示完成连接和审批,然后在对话中查看结果。请使用同一个已连接的账号发送后续请求以继续任务。其他参与者发起的请求不会自动继续您的任务。
有关工作空间配置,请参阅在 Slack 和 Teams 中管理 ChatGPT。有关如何在 Slack 中控制任务,请参阅在 Slack 中使用 ChatGPT。
虚拟机规格
每个云任务都在虚拟机中运行,默认资源如下:
| ChatGPT 套餐 | vCPU 数量 | 内存 | 磁盘空间 |
|---|---|---|---|
| Plus、Edu Plus | 2 | 8 GiB | 8 GiB |
| Pro、Business、Enterprise | 4 | 16 GiB | 32 GiB |
| Edu、Edu Pro | 4 | 16 GiB | 32 GiB |
默认情况下,从您上次发起一轮对话或恢复任务时算起,任务已保存的虚拟机状态最多可保留 7 天供恢复。
Enterprise 客户可以使用更大规格的虚拟机,也可以自定义规格。请联系您的 OpenAI 客户团队,了解可用配置和价格。
当前限制
云端环境目前尚不支持以下功能,我们已将其列入开发计划:
- 计算机使用
- 自行托管的 GitHub Enterprise Server
云任务可以使用存储在代码仓库中的技能。本地计算机上的个人技能不会同步到云端环境。
排查环境配置和运行时访问问题
环境配置失败或缺少必需的工具
在环境配置对话中找到执行失败的命令。请 Codex 诊断错误,修复后重新运行该命令。例如:“安装 pnpm 并运行项目测试。”
- 如果初始配置失败,请选择重试,使用本次配置会话中已选定的代码仓库再次尝试。
- 如果修复需要更改源文件、软件包清单或锁文件,请先在编码任务中进行更改,然后返回环境配置。
Codex 验证配置后,请发布或重新发布环境。
软件包下载或 HTTPS 请求失败
请分别检查目标主机名和身份验证配置:
- 确认环境的互联网访问设置允许访问该主机。如果私有注册表位于
packages.example.com,请检查允许列表中是否包含这个确切的主机名。如果下载时还会用到downloads.example.com,也需要允许访问该主机。 - 检查软件包管理器或客户端配置的 URL 和凭据。允许访问域名不会授予服务的访问权限。
- 如果使用网络密钥进行身份验证,请确认其允许的域名包含目标域名,并确认请求通过 443 端口使用 HTTPS。
- 在 Enterprise 工作空间中,请管理员同时检查适用的智能体安全要求和环境设置。
保存所有配置更改,并在配置环境期间测试请求。发布或重新发布环境,然后在新任务中验证访问是否正常。
缺少必填值或无法使用该值
请检查是否已在环境配置中的正确位置添加该值:
- 环境变量: 适用于程序需要直接读取的值,例如
APP_MODE=development。 - HTTP 密钥: 适用于发送给允许访问的 HTTPS 服务的凭据,例如私有注册表令牌。程序收到的是占位符,代理会在匹配的请求中将占位符替换为凭据。如果程序需要读取原始值,请将其添加到环境变量中。
如果使用个人值,请检查其键是否与环境请求的键匹配,并确认适用于的范围包含该环境。为特定环境设置的值优先于通用默认值。
有关设置步骤,请参阅环境变量和网络密钥。
VPN 已连接,但无法访问 HTTP 或 HTTPS 服务
- 确认客户端使用环境中配置的 HTTP/HTTPS 代理。使用
curl测试时,请省略--noproxy,以便请求通过该代理发送。 - 对于 Tailscale 目标,请检查 VPN 的路由和访问规则。对于公共互联网目标,请检查环境允许的域名。
- 如果可以通过 IP 地址访问服务,但无法通过主机名访问,请检查 Tailscale DNS 设置。对于公司内部域名,请确认分流 DNS 指向正确的 DNS 服务器,并且可以通过您的 Tailscale 网络访问该服务器。使用服务的完全限定主机名,并确认它能解析为 IPv4 地址。
有关连接配置,请参阅专用网络连接。
任务无法使用某个环境或其更新
在设置 > Codex 云端 > 环境中检查该环境。如果环境带有未发布标记,请完成配置并选择发布,使任务可以使用该环境。
要更改已发布的环境,请打开该环境的编辑界面,让 Codex 准备并测试更改,然后选择重新发布。从更新后的环境启动新任务即可使用新配置。现有任务会保留各自的工作状态。