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_residency diaktifkan 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:

  1. 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.
  2. Untuk eksekusi Codex lokal, periksa apakah konfigurasi yang berlaku memuat pengaturan eksplisit features.guardian_approval = false dan 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.
  3. 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 --version

Untuk mendapatkan versi Codex yang disertakan bersama aplikasi desktop ChatGPT, gunakan jalur bundel kompatibilitas Codex.app yang dipertahankan:

/Applications/Codex.app/Contents/Resources/codex --version

Umpan 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:

  1. Temukan masalah yang sudah ada di repositori GitHub Codex.
  2. 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:

  1. Periksa apakah Codex sedang menunggu persetujuan.
  2. Buka terminal dan jalankan perintah dasar seperti git status.
  3. 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

  1. Tutup panel terminal.
  2. Buka kembali dengan Ctrl+`.
  3. Jalankan kembali perintah dasar seperti pwd atau git 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.