Host sendiri konfigurasi Codex untuk tim Anda
Sajikan konfigurasi default dan pengaturan wajib ke Codex dari endpoint HTTPS yang Anda operasikan.
Jika pengguna Anda tidak masuk ke Codex dengan ChatGPT, Anda dapat mendistribusikan konfigurasi ke Codex CLI dan aplikasi desktop dari server HTTPS yang Anda operasikan. Codex memuat pengaturan Anda saat dimulai, baik pengguna terhubung langsung ke penyedia model mereka maupun melalui gateway.
Keterbatasan klien
Aplikasi desktop tidak dapat meminta Anda masuk ke server konfigurasi. Jika server Anda mengharuskan proses masuk baru, jalankan codex login di terminal pada komputer yang sama, lalu buka kembali aplikasi. Jika aplikasi tidak dapat memuat pengaturan wajib, proses mulai akan dijeda.
Konfigurasikan Codex untuk menggunakan server
Pada komputer uji, buat atau perbarui requirements.toml sistem. Tambahkan tabel [config_server] dengan URL dasar server konfigurasi Anda. Gunakan /etc/codex/requirements.toml di Linux dan macOS, atau %ProgramData%\OpenAI\Codex\requirements.toml di Windows. Di macOS, Anda juga dapat mendistribusikan tabel melalui preferensi terkelola.
[config_server]
base_url = "https://codex-config.example.com/team"Hanya persyaratan lokal yang dikendalikan administrator yang dapat memilih server. Pertahankan tabel ini di komputer saat Anda memindahkan bagian kebijakan lainnya ke endpoint.
Autentikasi ke server konfigurasi (opsional)
Secara default, Codex mencoba mengambil konfigurasi tanpa kredensial. Jika server Anda mengharuskan pengguna masuk, tambahkan [config_server.oauth] ke file requirements.toml yang sama. Codex menggunakan alur kode otorisasi OAuth dengan Proof Key for Code Exchange (PKCE).
[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 = 43127URI pengalihan untuk contoh ini adalah http://127.0.0.1:43127/callback. Anda dapat menghilangkan redirect_port jika penyedia Anda menerima callback loopback pada port mana pun yang tersedia. Codex mengirimkan token akses dalam header Authorization. Server Anda harus memverifikasinya sebelum mengembalikan bundel.
Sajikan konfigurasi Codex
Host konfigurasi terkelola Anda pada endpoint HTTPS. Saat Codex CLI mengambil bundel, Codex CLI mengirimkan permintaan GET menggunakan URL dasar dari requirements.toml lokal:
GET {config_server.base_url}/codex/config/bundleDengan base_url dari contoh bootstrap di atas, Codex mengirimkan permintaan ini:
GET https://codex-config.example.com/team/codex/config/bundleBerikan respons dengan 200 OK dan bundel konfigurasi JSON dalam isi respons.
Format bundel konfigurasi
Bundel mengelompokkan entri TOML ke dalam dua array:
config_toml.enterprise_managedberisi default yang akan diterapkan.contentssetiap entri berupa teksconfig.toml.requirements_toml.enterprise_managedberisi persyaratan yang akan diberlakukan.contentssetiap entri berupa teksrequirements.toml.
Setiap entri array memiliki tiga kolom string: id, name (nama tampilan), dan contents. Gunakan array kosong untuk kategori yang tidak Anda perlukan.
Contoh ini menetapkan default pencarian web ke disabled dan memberlakukan nilai tersebut dengan 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']"
}
]
}
}Verifikasi konfigurasi di Codex
- Pada komputer uji, buka terminal di direktori proyek Anda dan jalankan
codex. Selesaikan proses masuk perusahaan jika diminta. - Pada prompt interaktif Codex CLI, ketik
/debug-configlalu tekan Enter. - Jika Anda menyajikan default, temukan nama dan ID-nya di bagian Tumpukan lapisan konfigurasi. Dengan contoh di atas, cari
enterprise-managed (Default web search, search-default) (enabled). - Jika Anda menyajikan persyaratan, temukan pengaturan yang Anda berlakukan di bagian Persyaratan dan periksa sumber kebijakan yang tercantum di sebelahnya.
Codex dapat dimulai dengan pengaturan yang tersimpan dalam cache dan memperbaruinya di latar belakang. Setelah Anda mengubah kebijakan di server, tunggu hingga Codex memperbaruinya, lalu mulai sesi baru dan ulangi pemeriksaan sebelum menerapkannya ke komputer lain.