팀을 위한 Codex 구성 자체 호스팅하기
직접 운영하는 HTTPS 엔드포인트에서 Codex에 구성 기본값과 필수 설정을 제공합니다.
사용자가 ChatGPT로 Codex에 로그인하지 않는 경우, 직접 운영하는 HTTPS 서버에서 Codex CLI와 데스크톱 앱에 구성을 배포할 수 있습니다. 사용자가 모델 제공업체에 직접 연결하든 게이트웨이를 통해 연결하든 Codex는 시작 시 설정을 불러옵니다.
클라이언트 제한 사항
데스크톱 앱은 구성 서버에 로그인하라는 메시지를 표시할 수 없습니다. 서버에서 새 로그인을 요구하면 같은 컴퓨터의 터미널에서 codex login을 실행한 다음 앱을 다시 여세요. 앱이 필수 설정을 불러올 수 없으면 시작이 일시 중지됩니다.
서버를 사용하도록 Codex 구성하기
테스트 컴퓨터에서 시스템 requirements.toml을 만들거나 업데이트하세요. 구성 서버의 기본 URL이 포함된 [config_server] 테이블을 추가하세요. 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/bundle200 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 키를 누르세요. - 기본값을 제공하는 경우 구성 계층 스택 에서 이름과 ID를 찾으세요. 위 예제를 사용했다면
enterprise-managed (Default web search, search-default) (enabled)을 찾으세요. - 요구 사항을 제공하는 경우 요구 사항 에서 강제 적용하는 설정을 찾고 옆에 표시된 정책 출처를 확인하세요.
Codex는 캐시된 설정으로 시작한 뒤 백그라운드에서 설정을 새로 고칠 수 있습니다. 서버에서 정책을 변경한 후에는 Codex가 이를 새로 고칠 때까지 기다린 다음 새 세션을 시작하고 확인을 반복한 후 다른 컴퓨터에 배포하세요.