Gunakan panduan ini untuk mengaktifkan Daybreak di Codex CLI, mengonfigurasinya untuk alur kerja otomatis dan integrasi SDK, serta mengatasi masalah akses atau penolakan.

Untuk mengakses perubahan ini, Anda perlu memperbarui Codex CLI ke versi 0.163.0 atau yang lebih baru. Pembaruan CLI bersifat opsional: instalasi yang ada akan tetap berfungsi seperti sebelumnya sampai Anda memperbaruinya.

Jika otomatisasi Anda menginstal @openai/codex@latest, perubahan ini dapat diterapkan pada instalasi atau pembaruan berikutnya. Jika Anda menginstal Codex CLI secara global dengan npm, jalankan npm install -g @openai/codex@latest, lalu jalankan codex --version untuk memastikan pembaruan berhasil.
Untuk menunda perubahan ini, kunci versi ke @openai/codex@0.162.0. Instalasi satu kali menggunakan @latest tidak akan diperbarui secara otomatis. Alur kerja yang dikunci ke versi lama akan tetap berfungsi seperti sebelumnya.
Untuk integrasi TypeScript, perbarui @openai/codex-sdk beserta runtime yang disertakan. Untuk integrasi Python, perbarui openai-codex beserta runtime Codex-nya. Memperbarui CLI global saja belum tentu memperbarui runtime SDK. Jika Anda mengonfigurasi jalur file eksekusi khusus, perbarui juga file eksekusi tersebut.

ID model yang dikonfigurasi secara manual tetapi tidak tercantum dalam katalog yang tersedia akan tetap ditangani secara otomatis seperti sebelumnya di CLI dan Codex Desktop, meskipun Daybreak AKTIF. Tidak tercantumnya ID tersebut dalam katalog saja tidak menghalangi keberhasilan permintaan.

Ketersediaan model siber di pemilih model dapat diluncurkan secara terpisah. Setelah diaktifkan, pengguna yang sudah menggunakan rilis yang didukung tidak perlu mengunduh lagi untuk melihat model yang baru tersedia. Buka kembali pemilih model atau mulai ulang Codex untuk menyegarkan daftar.

Mengaktifkan Daybreak di CLI interaktif

Jalankan Codex dengan autentikasi yang biasa Anda gunakan.
Untuk mengaktifkan Daybreak, masukkan /daybreak.
Codex akan menampilkan Daybreak aktif. Berlaku untuk giliran baru.
Pengaturan ini akan berlaku untuk utas aktif dan disimpan sebagai default untuk sesi baru.
Untuk menonaktifkan Daybreak, jalankan kembali perintah yang sama (/daybreak).

Aktifkan Daybreak di CLI headless

Alur kerja headless berjalan tanpa antarmuka interaktif, biasanya melalui codex exec dalam skrip, tugas terjadwal, atau CI. Tidak ada dialog interaktif “Aktifkan Daybreak” (/daybreak) di sini. Sebagai gantinya, Anda dapat:

Mengaktifkan Daybreak untuk eksekusi CLI tertentu dengan menambahkan -c daybreak=true ke setiap perintah yang ingin dijalankan dengan lebih sedikit penolakan. Misalnya, Anda dapat memasukkan:

codex exec -c daybreak=true "Review the changes in this repository."

Pertahankan prompt dan opsi perintah lain yang sudah Anda gunakan. Tambahkan pengaturan ini ke setiap pemanggilan yang perlu menggunakan Daybreak, termasuk perintah dalam skrip, tugas terjadwal, dan konfigurasi CI.
Menjadikan Daybreak sebagai default untuk sesi dan eksekusi CLI baru dengan menambahkan daybreak=true ke file konfigurasi yang dimuat oleh Codex.
Konfigurasi pengguna default berada di ~/.codex/config.toml. Jika otomatisasi Anda menetapkan CODEX_HOME, gunakan $CODEX_HOME/config.toml sebagai gantinya. Letakkan pengaturan tersebut di tingkat teratas, di luar bagian seperti [features].
Lakukan perubahan di lingkungan tempat otomatisasi benar-benar dijalankan. Memperbarui konfigurasi laptop Anda tidak akan memperbarui runner CI atau mesin jarak jauh.
Pengaturan ini juga berlaku untuk sesi interaktif baru yang menggunakan konfigurasi yang sama. Sesi yang dilanjutkan atau dicabangkan tetap menggunakan pilihan Daybreak yang tersimpan; pengaturan default baru dalam konfigurasi tidak menggantikannya.
Perhatikan bahwa pengaturan pada baris perintah mengesampingkan konfigurasi tersimpan untuk pemanggilan tersebut. Dengan demikian, Anda dapat tetap menyimpan daybreak = true dalam konfigurasi dan menggunakan -c daybreak=false untuk satu eksekusi tertentu.

Mengaktifkan Daybreak dengan penyedia inferensi melalui proksi

Anda dapat menggunakan Daybreak di Codex CLI sambil mengarahkan permintaan inferensi melalui proksi yang sudah Anda gunakan. Codex melakukan pencarian terpisah di katalog model untuk mengetahui model mana yang mendukung Daybreak untuk proyek Anda.

Sebelum memulai, pastikan Anda memiliki penyedia proksi yang berfungsi di Codex CLI, kunci API OpenAI dari proyek yang memiliki akses ke Daybreak dan model yang ingin digunakan, serta Codex CLI v0.167.0.Dokumentasi OpenAI tentang akses proyek ke Daybreak

Perbarui penyedia proksi Anda dengan membuka ~/.codex/config.toml dan mencari bagian [model_providers.<id>] untuk proksi Anda. Tambahkan dua baris terakhir dari contoh di bawah ke bagian tersebut. Pertahankan ID penyedia, URL proksi, dan pengaturan autentikasi yang sudah ada.

[model_providers.proxy]
name = "Proxied with Cyber"
base_url = "https://<your-proxy>/v1"
model_catalog_url = "<https://chatgpt.com/backend-api/codex/models>"
capabilities.cyber_access_programs = true

Jika konfigurasi Anda sudah memiliki bagian [model_providers.<id>.capabilities], letakkan cyber_access_programs = true di sana dan biarkan model_catalog_url tetap berada di bagian induk penyedia.Referensi konfigurasi Codex
Autentikasi pencarian katalog dengan memilih opsi yang sesuai dengan kredensial yang digunakan CLI Anda.
1. Jika Codex menggunakan kunci API OpenAI, pertahankan URL katalog OpenAI dari langkah 1. Jalankan Codex dengan kunci dari proyek Anda yang telah mengaktifkan Daybreak agar Codex dapat melakukan autentikasi langsung ke katalog.
2. Jika Codex menggunakan kredensial proksi Anda, tetapkan model_catalog_url ke URL lengkap rute katalog pada proksi Anda. Konfigurasikan rute tersebut untuk:
  1. Mengautentikasi permintaan CLI menggunakan kredensial proksi yang biasa Anda gunakan.
  2. Meneruskan permintaan ke https://chatgpt.com/backend-api/codex/models menggunakan kunci API OpenAI dari proyek Anda yang telah mengaktifkan Daybreak.
  3. Mengembalikan respons katalog ke Codex.
Aktifkan Daybreak dengan memulai sesi Codex CLI baru menggunakan penyedia proksi Anda. Pilih model yang memenuhi syarat untuk menggunakan Daybreak, lalu masukkan /daybreak untuk mengaktifkannya.
1. Jika Daybreak tidak tersedia, periksa pencarian katalog terlebih dahulu. Inferensi dapat berhasil meskipun permintaan katalog gagal. Pastikan permintaan sampai ke OpenAI dengan kunci dari proyek yang dituju dan proyek tersebut memiliki akses ke Daybreak maupun model yang dipilih.

Mengaktifkan Daybreak melalui SDK TypeScript

Teruskan pengaturan Daybreak melalui konfigurasi klien:

import { Codex } from "@openai/codex-sdk";
const codex = new Codex({
config: { daybreak: true },
});
const thread = codex.startThread();
const result = await thread.run("Review the changes in this repository.");
console.log(result.finalResponse);

Gunakan daybreak: false untuk menonaktifkan Daybreak dan menerapkan perilaku penolakan normal. Pertahankan konfigurasi autentikasi yang sudah Anda gunakan.

Mengaktifkan Daybreak melalui server aplikasi atau SDK Python

1. Baca nilai availableAccessPrograms.cyber untuk model yang dipilih dari model/list, lalu atur cyberAccessProgram dalam parameter turn/start.

a. Untuk model utama dan akun dengan akses Daybreak Blue:

{ "cyberAccessProgram": "daybreakBlue" }

b. Untuk model siber dan akun dengan akses Daybreak Red:

{ "cyberAccessProgram": "daybreakRed" }

c. Untuk perilaku penolakan normal:

{ "cyberAccessProgram": "standard" }

2. Sertakan pilihan ini pada setiap giliran yang harus menggunakannya; jangan berasumsi bahwa menghilangkan parameter akan menonaktifkan Daybreak. Klien yang terhubung langsung ke server aplikasi harus mengaktifkan kapabilitas experimentalApi saat inisialisasi agar dapat menggunakan parameter ini.

3. CodexClient tingkat rendah pada SDK Python dapat meneruskan parameter yang sama:

from openai_codex.client import CodexClient
with CodexClient() as client:
client.initialize()
thread = client.thread_start()
turn = client.turn_start(
thread.thread.id,
"Review the changes in this repository.",
params={"cyberAccessProgram": "daybreakBlue"},
)
client.wait_for_turn_completed(turn.turn.id)

4. Contoh ini mengasumsikan bahwa Daybreak Blue tersedia untuk model yang dipilih. Klien Python mengaktifkan kapabilitas API eksperimental secara default. Preferensi utas yang tersimpan saja tidak menentukan program untuk giliran di server aplikasi.

Jika Anda menambahkan katalog model lokal sebelum perubahan ini

Jika sebelumnya model yang Anda harapkan tidak muncul saat masuk dengan kunci API, Anda mungkin telah menambahkan katalog lokal menggunakan model_catalog_json di config.toml. Codex menggunakan file lokal tersebut, bukan katalog otomatis, sehingga daftar model Anda bisa menjadi usang. Setelah dukungan katalog otomatis tersedia di lingkungan Anda, ikuti langkah-langkah berikut untuk beralih kembali:

Buka config.toml. Untuk Codex CLI, buka ~/.codex/config.toml (atau $CODEX_HOME/config.toml jika Anda mengatur CODEX_HOME). Di Codex Desktop, buka Pengaturan > Konfigurasi, lalu pilih Buka config.toml.
Nonaktifkan katalog lokal untuk sementara. Tambahkan # di awal baris model_catalog_json, simpan file, lalu mulai ulang Codex dengan akun atau kunci API yang sama. Biarkan URL katalog yang diwajibkan oleh organisasi Anda tetap terpasang.
Verifikasi akses Anda. Di CLI, jalankan codex, lalu masukkan /daybreak dalam sesi tersebut. Di Desktop, buka pemilih model Lanjutan dan aktifkan Daybreak. Jika Anda memiliki akses Daybreak Red, pastikan model siber yang diharapkan muncul dan Anda dapat mengirim permintaan menggunakan model tersebut.
Pertahankan konfigurasi yang berfungsi. Jika pemeriksaan berhasil, hapus baris yang Anda nonaktifkan dan simpan file. Jika gagal, hapus #, simpan, lalu mulai ulang Codex untuk memulihkan pengaturan sebelumnya.

Mengatasi penolakan di CLI

Jalankan tugas yang mewakili beban kerja Anda dengan kredensial, model, dan konfigurasi yang sama dengan yang digunakan oleh otomatisasi Anda.
Jika Daybreak tidak tersedia, pastikan bahwa:
- Akun atau proyek API Anda memiliki akses Daybreak.
- Model yang dipilih mendukung Daybreak.
Di CLI interaktif, pastikan Daybreak aktif. CLI interaktif dapat menampilkan pesan penolakan ketika Daybreak tersedia tetapi NONAKTIF: Daybreak saat ini nonaktif. Jika Anda melakukan pekerjaan keamanan yang diizinkan, aktifkan Daybreak dan coba kirim permintaan Anda lagi.
- Pesan konfirmasi akan menanyakan Aktifkan Daybreak untuk permintaan Anda berikutnya? dan menawarkan pilihan Aktifkan Daybreak atau Jangan sekarang.
- Pilih Aktifkan Daybreak untuk mengaktifkannya bagi permintaan berikutnya, lalu coba kirim permintaan tersebut lagi. Perlu diketahui bahwa permintaan yang ditolak tidak dicoba ulang secara otomatis; Anda harus mengirimkannya lagi. Beberapa permintaan mungkin tetap ditolak meskipun Daybreak AKTIF.
- Pilih Jangan sekarang agar Daybreak tetap NONAKTIF.
Untuk otomatisasi, pastikan daybreak=true diteruskan ke proses Codex yang benar-benar dijalankan dan tidak ditimpa oleh pengaturan baris perintah lainnya.

Gunakan Daybreak dengan Codex Security CLI

Codex Security CLI menggunakan @openai/codex-security untuk pemindaian keamanan. Opsi program aksesnya terpisah dari contoh Codex CLI umum di atas.

Untuk autentikasi dengan kunci API, gunakan kunci dari proyek API yang telah mengaktifkan Daybreak dan pilih secara eksplisit program yang telah disetujui untuk proyek tersebut. Untuk Daybreak Blue:

npx @openai/codex-security scan . --auth api-key --cyber-access-program daybreak_blue

Gunakan daybreak_red hanya jika proyek Anda telah disetujui untuk Daybreak Red, atau standard untuk perlindungan standar. Memilih program tidak memberikan akses ke program tersebut atau ke model tambahan.

Lihat referensi Codex Security CLI untuk opsi autentikasi dan pemindaian.

Gunakan Daybreak dengan Codex Security SDK

Codex Security TypeScript SDK (@openai/codex-security) menjalankan pemindaian keamanan dari aplikasi atau alat pengembang. SDK ini terpisah dari Codex SDK umum yang dijelaskan di atas.

Gunakan kredensial akun atau proyek API Anda yang telah disetujui. Beberapa permintaan keamanan siber dan temuan yang dilindungi memerlukan Trusted Access for Cyber. Menginstal SDK atau memilih model tidak memberikan akses ke Daybreak.

Ikuti panduan Codex Security SDK untuk mengetahui metode autentikasi yang didukung, konfigurasi, dan contoh pemindaian.

Menggunakan Daybreak di Codex CLI