為團隊自行託管 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 中驗證設定
- 在測試電腦上,在專案目錄中開啟終端並執行
codex。如果出現提示,請完成公司登入。 - 在 Codex CLI 的互動式提示符下,輸入
/debug-config並按 Enter。 - 如果你提供了預設值,請在Config layer stack(設定層堆疊) 下尋找其名稱和 ID。對於上面的範例,請尋找
enterprise-managed (Default web search, search-default) (enabled)。 - 如果你提供了要求,請在Requirements(要求) 下找到一項你強制執行的設定,並檢查其旁邊列出的策略來源。
Codex 可以使用快取的設定啟動,並在後臺重新整理這些設定。在伺服器上更改策略後,請等待 Codex 重新整理策略,然後啟動新會話並重複檢查,再將其推廣到其他電腦。