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 = 43127

URI 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/bundle

Dengan base_url dari contoh bootstrap di atas, Codex mengirimkan permintaan ini:

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

Berikan 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_managed berisi default yang akan diterapkan. contents setiap entri berupa teks config.toml.
  • requirements_toml.enterprise_managed berisi persyaratan yang akan diberlakukan. contents setiap entri berupa teks requirements.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

  1. Pada komputer uji, buka terminal di direktori proyek Anda dan jalankan codex. Selesaikan proses masuk perusahaan jika diminta.
  2. Pada prompt interaktif Codex CLI, ketik /debug-config lalu tekan Enter.
  3. 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).
  4. 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.