Pemecahan masalah
Tanya jawab dan solusi untuk masalah umum aplikasi desktop ChatGPT
Pertanyaan yang sering diajukan
File yang tidak diedit Codex muncul di panel samping
Jika proyek Anda berada di dalam repositori Git, panel tinjauan secara otomatis menampilkan perubahan berdasarkan status Git proyek, termasuk perubahan yang tidak dibuat oleh Codex.
Di panel tinjauan, Anda dapat beralih antara perubahan yang telah di-stage dan perubahan yang belum di-stage, serta membandingkan cabang Anda dengan main.
Jika Anda hanya ingin melihat perubahan dari giliran Codex terakhir, alihkan panel diff ke tampilan Last turn.
Pelajari lebih lanjut cara menggunakan panel tinjauan.
Menghapus proyek dari bilah samping
Untuk menghapus proyek dari bilah samping, arahkan kursor ke nama proyek Anda, pilih ikon tiga titik, lalu pilih Hapus. Untuk memulihkannya, tambahkan kembali proyek menggunakan tombol Tambahkan proyek baru di samping Percakapan atau menggunakan
Cmd+O.
Menemukan chat yang diarsipkan
Chat yang diarsipkan dapat ditemukan di Settings. Saat Anda membatalkan pengarsipan chat, chat tersebut muncul kembali di lokasi asalnya pada bilah samping.
Percakapan Work tidak muncul di perangkat lain
- Pastikan Anda masuk dengan ChatGPT menggunakan akun dan ruang kerja yang sama di setiap perangkat.
- Minta pemilik ruang kerja Anda memastikan bahwa Work Cloud dan Izinkan akses komputer lokal diaktifkan. Jika
enforce_residencydiaktifkan dalam kebijakan cloud mana pun, Izinkan akses komputer lokal dinonaktifkan untuk Work maupun dots. Pengamanan ini tidak mengatur residensi ruang kerja atau, dengan sendirinya, menonaktifkan Work Cloud maupun dots. - Periksa kapan tugas dibuat. Sinkronisasi berlaku untuk tugas baru yang dibuat setelah sinkronisasi diaktifkan. Tugas yang sudah ada, termasuk tugas dalam proyek, tidak dimigrasikan dan tetap berjalan seperti semula, yaitu hanya secara lokal atau di cloud tanpa file lokal.
Untuk perusahaan, tombol alih Local/Cloud dalam aplikasi beserta pengaturan defaultnya tetap tidak berubah saat peluncuran. Posisi tombol alih atau mode default tertentu saja tidak memastikan apakah suatu percakapan dapat disinkronkan. Saat mencari percakapan Work, bedakan riwayat Codex dari riwayat Work. Lihat Akses komputer lokal untuk Work Cloud dan dots untuk penyiapan dan FAQ admin Work untuk pertanyaan umum.
Tugas yang disinkronkan tidak dapat menggunakan file atau alat di komputer
Pastikan komputer tetap online dan terhubung. Jika komputer tidak tersedia saat giliran baru dimulai, tugas tersinkron yang memenuhi syarat dapat berlanjut dalam kontainer cloud tanpa akses ke file atau alat di komputer. Giliran yang sedang berjalan tidak otomatis berpindah dari komputer ke cloud.
Giliran berhenti setelah Akses komputer lokal dengan Work Cloud dinonaktifkan
Menonaktifkan Akses komputer lokal dengan Work Cloud akan menghentikan giliran yang sedang berjalan. Jika Anda masih memiliki akses Work, kirim pesan baru untuk memulai giliran berikutnya. Dalam percakapan cloud yang sudah ada, giliran tersebut secara otomatis menggunakan Work Cloud tanpa akses ke file lokal.
Pembaruan kebijakan otomatis tidak tersedia
Gunakan API kebijakan untuk mengelola pengaturan Global. Untuk mengelola pengaturan Local atau Codex Cloud, gunakan antarmuka Agent Security. Alur kerja API Global yang sudah ada tetap tersedia setelah migrasi. Uji skrip dan integrasi Terraform Anda, lalu pastikan penetapan dan urutan kebijakan tidak berubah.
Hanya sebagian chat yang muncul di bilah samping
Bilah samping memungkinkan Anda memfilter chat berdasarkan status proyek. Jika ada chat yang tidak terlihat, pilih ikon filter di samping Chats, lalu pilih Chronological. Jika chat masih tidak terlihat, buka Settings dan periksa Archived chats.
Kode tidak berjalan di worktree
Worktree dibuat di direktori yang berbeda dan secara default mewarisi file yang telah dimasukkan ke
Git. Bergantung pada cara Anda mengelola dependensi dan alat untuk
proyek Anda, Anda mungkin perlu menjalankan skrip penyiapan di worktree menggunakan
lingkungan lokal atau menyalin file penyiapan yang diabaikan
menggunakan .worktreeinclude.
Anda juga dapat melakukan checkout perubahan di proyek lokal yang biasa Anda gunakan. Lihat
dokumentasi worktree untuk mempelajari lebih lanjut.
Aplikasi tidak mengenali lingkungan lokal bersama milik rekan satu tim
Konfigurasi lingkungan lokal harus berada di dalam folder .codex pada
root proyek. Jika Anda bekerja dalam monorepo dengan lebih dari satu
proyek, pastikan Anda membuka proyek pada direktori yang berisi
folder .codex.
Codex meminta akses ke Apple Music
Bergantung pada tugas, Codex mungkin perlu menavigasi sistem file. Direktori tertentu di macOS, termasuk Music, Downloads, atau Desktop, memerlukan persetujuan tambahan dari pengguna. Jika Codex perlu membaca direktori home Anda, macOS akan meminta Anda menyetujui akses ke folder tersebut.
Tugas terjadwal membuat banyak worktree
Tugas terjadwal yang sering berjalan dapat membuat banyak worktree seiring waktu. Arsipkan proses terjadwal yang tidak lagi Anda perlukan dan hindari menyematkan proses kecuali Anda bermaksud mempertahankan worktree-nya.
Memulihkan prompt setelah memilih target yang salah
Jika Anda tidak sengaja memulai chat dengan target yang salah (Local, Worktree, atau Cloud), Anda dapat membatalkan proses saat ini dan memulihkan prompt sebelumnya dengan menekan tombol panah atas di penyusun.
Setujui untuk saya tidak muncul atau dinonaktifkan
Untuk menggunakan peninjauan otomatis, pilih Setujui untuk saya dari kontrol izin di bawah kolom penulisan pesan. Jika mode tersebut tidak muncul atau dinonaktifkan:
- Perbarui aplikasi desktop dan periksa menu izin dalam percakapan tempat Anda ingin menggunakan peninjauan otomatis. Pilihan yang tersedia dapat berbeda antara lingkungan lokal dan cloud.
- Untuk eksekusi Codex lokal, periksa apakah konfigurasi yang berlaku memuat
pengaturan eksplisit
features.guardian_approval = falsedan tinjau profil izin, kebijakan persetujuan, serta peninjau persetujuan yang dikonfigurasi. Lihat Dasar-dasar konfigurasi untuk urutan prioritas konfigurasi. Konfigurasi lokal tidak mengontrol lingkungan eksekusi cloud terkelola. - Jika suatu mode dinonaktifkan atau tidak muncul di ruang kerja terkelola, minta administrator Anda memeriksa profil izin, mode sandbox, kebijakan persetujuan, serta peninjau persetujuan yang diizinkan. Kebijakan organisasi atau perangkat dapat membatasi pilihan ini; pengaturan lokal tidak dapat mengesampingkannya.
Jika mode tersebut masih tidak tersedia padahal seharusnya tersedia, sertakan versi aplikasi, sistem operasi, lingkungan eksekusi, serta keterangan apakah opsi tersebut tidak muncul atau dinonaktifkan dalam masukan Anda.
Fitur berfungsi di Codex CLI tetapi tidak di aplikasi desktop ChatGPT
Aplikasi desktop ChatGPT dan Codex CLI dapat menyertakan versi Codex yang berbeda, sehingga fitur mungkin tersedia di salah satu antarmuka lebih dahulu daripada yang lain.
Untuk mendapatkan versi Codex CLI di sistem Anda, jalankan:
codex --versionUntuk mendapatkan versi Codex yang disertakan bersama aplikasi desktop ChatGPT, gunakan
jalur bundel kompatibilitas Codex.app yang dipertahankan:
/Applications/Codex.app/Contents/Resources/codex --versionUmpan balik dan log
Ketik / di penyusun pesan untuk memberikan umpan balik kepada tim. Jika Anda memicu umpan balik dalam chat yang sudah ada, Anda dapat memilih untuk membagikan sesi tersebut bersama umpan balik. Setelah mengirim umpan balik, Anda akan menerima ID sesi yang dapat dibagikan kepada tim.
Untuk melaporkan masalah:
- Temukan masalah yang sudah ada di repositori GitHub Codex.
- Buka masalah GitHub baru
Log tambahan tersedia di lokasi berikut:
- Log aplikasi (macOS):
~/Library/Logs/com.openai.codex/YYYY/MM/DD - Transkrip sesi:
$CODEX_HOME/sessions(default:~/.codex/sessions) - Sesi yang diarsipkan:
$CODEX_HOME/archived_sessions(default:~/.codex/archived_sessions)
Jika Anda membagikan log, tinjau terlebih dahulu untuk memastikan log tersebut tidak berisi informasi sensitif.
Status macet dan pola pemulihan
Jika chat tampak macet:
- Periksa apakah Codex sedang menunggu persetujuan.
- Buka terminal dan jalankan perintah dasar seperti
git status. - Mulai chat baru dengan prompt yang lebih kecil dan lebih terfokus.
Jika Anda tidak sengaja membatalkan pembuatan worktree dan kehilangan prompt, tekan tombol panah atas di penyusun untuk memulihkannya.
Masalah terminal
Terminal tampak macet
- Tutup panel terminal.
- Buka kembali dengan Ctrl+`.
- Jalankan kembali perintah dasar seperti
pwdataugit status.
Jika perintah berperilaku berbeda dari yang diharapkan, periksa direktori saat ini dan branch di terminal terlebih dahulu.
Jika tetap macet, tunggu hingga chat aktif selesai, lalu mulai ulang aplikasi.
Font tidak dirender dengan benar
Codex menggunakan font yang sama untuk panel tinjauan, terminal terintegrasi, dan kode lain yang ditampilkan di dalam aplikasi. Anda dapat mengatur font di panel Settings sebagai Code font.
Lingkungan mengizinkan akses jaringan, tetapi tindakan diblokir
Periksa prioritas kebijakan sebelum membandingkan masing-masing pengaturan. Kebijakan dengan prioritas lebih tinggi mengesampingkan kebijakan dengan prioritas lebih rendah, meskipun kebijakan berprioritas lebih rendah lebih spesifik. Dalam satu kebijakan, penggantian pengaturan lingkungan khusus OS didahulukan daripada penggantian pengaturan lingkungan untuk semua OS, lalu diikuti oleh Global.
Beberapa persyaratan jaringan memiliki aturan penggabungan khusus per bidang dan batasan runtime. Runtime cloud tidak mendukung port listener HTTP/SOCKS terkelola dan listener proksi non-loopback; dukungan aturan soket bergantung pada jalur eksekusi. Perilaku penggabungan untuk eksekusi lokal diatur secara terpisah.
Bandingkan kebijakan yang berlaku dan uji tindakan yang seharusnya diizinkan maupun diblokir. Lihat Konfigurasi terkelola untuk rincian kasus. Jangan memperluas cakupan izin dasar global untuk menyiasati pengujian yang gagal.