从写代码,到创作下一幕

探索 字节跳动 - 火山方舟 的 AI 编程与视频创作活动。

Agent Plan & Coding Plan

一站体验多款热门模型,为 AI 编程与智能体开发提供更多选择。新用户可联系(微信: goo_lvyouyou)免费体验 9.9 agent plan。

Seedance 2.5

让创意,跃然成片。探索 30 秒视频、多模态参考与局部编辑,把脑海中的画面变成下一支作品。

中文

为团队自行托管 Codex 配置

通过你运营的 HTTPS 端点,向 Codex 提供默认配置和强制设置。

如果用户不使用 ChatGPT 登录 Codex,你可以通过自己运营的 HTTPS 服务器向 Codex CLI 和桌面应用分发配置。无论用户是直接连接模型提供商还是通过网关连接,Codex 都会在启动时加载你的设置。

客户端限制

桌面应用无法提示你登录配置服务器。如果服务器要求重新登录,请在同一台计算机的终端中运行 codex login,然后重新打开应用。如果应用无法加载强制设置,启动过程会暂停。

配置 Codex 以使用服务器

在测试计算机上,创建或更新系统级 requirements.toml。添加一个 [config_server] 表,填写配置服务器的基础 URL。在 Linux 和 macOS 上使用 /etc/codex/requirements.toml,在 Windows 上使用 %ProgramData%\OpenAI\Codex\requirements.toml。在 macOS 上,你也可以通过受管偏好设置分发该表。

[config_server]
base_url = "https://codex-config.example.com/team"

只有本地管理员控制的要求配置可以指定配置服务器。将其余策略迁移到端点时,请将此表保留在计算机上。

向配置服务器进行身份验证(可选)

默认情况下,Codex 会尝试在不提供凭据的情况下获取配置。如果服务器要求登录,请在同一个 requirements.toml 文件中添加 [config_server.oauth]。Codex 使用带有 Proof Key for Code Exchange(PKCE)的 OAuth 授权码流程。

[config_server.oauth]
authorization_url = "https://login.example.com/oauth/authorize"
token_url = "https://login.example.com/oauth/token"
client_id = "codex-policy"
redirect_port = 43127

此示例的重定向 URI 为 http://127.0.0.1:43127/callback。如果提供商接受任意可用端口上的回环回调,则可以省略 redirect_port。Codex 会在 Authorization 标头中发送访问令牌。服务器必须先验证令牌,再返回配置包。

提供 Codex 配置

在 HTTPS 端点上托管受管配置。Codex CLI 获取配置包时,会使用本地 requirements.toml 中的基础 URL 发送 GET 请求:

GET {config_server.base_url}/codex/config/bundle

使用上方引导配置示例中的 base_url 时,Codex 会发送以下请求:

GET https://codex-config.example.com/team/codex/config/bundle

返回 200 OK,并在响应正文中提供 JSON 配置包。

配置包格式

配置包将 TOML 条目分为两个数组:

  • config_toml.enterprise_managed 包含要应用的默认值。每个条目的 contents 都是 config.toml 文本。
  • requirements_toml.enterprise_managed 包含要强制执行的要求。每个条目的 contents 都是 requirements.toml 文本。

每个数组条目都有三个字符串字段:id、name(显示名称)和 contents。对于不需要的类别,请使用空数组。

此示例将网页搜索的默认值设为 disabled,并通过 allowed_web_search_modes 强制使用该值。

{
  "config_toml": {
    "enterprise_managed": [
      {
        "id": "search-default",
        "name": "Default web search",
        "contents": "web_search = 'disabled'"
      }
    ]
  },
  "requirements_toml": {
    "enterprise_managed": [
      {
        "id": "search-policy",
        "name": "Allowed web search modes",
        "contents": "allowed_web_search_modes = ['disabled']"
      }
    ]
  }
}

在 Codex 中验证配置

  1. 在测试计算机上,在项目目录中打开终端并运行 codex。如果出现提示,请完成公司登录。
  2. 在 Codex CLI 的交互式提示符下,输入 /debug-config 并按 Enter。
  3. 如果你提供了默认值,请在Config layer stack(配置层堆栈) 下查找其名称和 ID。对于上面的示例,请查找 enterprise-managed (Default web search, search-default) (enabled)。
  4. 如果你提供了要求,请在Requirements(要求) 下找到一项你强制执行的设置,并检查其旁边列出的策略来源。

Codex 可以使用缓存的设置启动,并在后台刷新这些设置。在服务器上更改策略后,请等待 Codex 刷新策略,然后启动新会话并重复检查,再将其推广到其他计算机。