從寫程式碼,到創作下一幕

探索 字節跳動 - 火山方舟 的 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 重新整理策略,然後啟動新會話並重複檢查,再將其推廣到其他電腦。