Pemecahan masalah
Sebagian besar masalah punya perbaikan cepat. Jika masalah Anda tidak ada di sini, kirim email ke dukungan berisi OS, versi PATerminal (Pengaturan → Pembaruan), dan apa yang sudah Anda coba.
Ditulis untuk PATerminal v1.8.3
Memasang dan membuka
- Windows: “Windows melindungi PC Anda”
- Klik Info selengkapnya, lalu Tetap jalankan. SmartScreen memperingatkan tentang aplikasi baru; bandingkan SHA-256 di panduan instalasi Windows jika ingin memastikan.
- macOS bertanya sebelum membuka
- Pilih Buka. Aplikasi ini ditandatangani dengan Developer ID dan dinotarisasi oleh Apple.
Git menampilkan galat
Saat sesuatu di komputer Anda menghentikan git, PATerminal menampilkan Git tidak dapat dijalankan di komputer ini beserta perbaikannya. Kasus yang umum:
| Penyebab | Perbaikan |
|---|---|
| macOS: lisensi Xcode belum disetujui (sering tepat setelah pembaruan Xcode) | sudo xcodebuild -license accept |
| macOS: Command Line Tools tidak ada atau rusak | xcode-select --install |
| Git belum terpasang | Pasang Git (Windows: winget install Git.Git); PATerminal mendeteksinya secara otomatis. |
| “Dubious ownership” di drive lain atau share jaringan | git config --global --add safe.directory <path> — hanya untuk folder yang Anda percayai. |
| Windows: path terlalu panjang | git config --global core.longpaths true |
Pull request atau issue tidak termuat
Pastikan gh sudah terpasang dan login (gh auth status), dan repositori punya remote GitHub. Tekan Coba lagi setelah memperbaikinya.
Sesi tetap “Berjalan”
- Ada sesuatu di dalamnya yang masih mencetak keluaran — server dev, watcher, atau spinner. Itu keluaran sungguhan, jadi statusnya benar.
- Codex 0.154.0 atau lebih baru dimulai sebelum PATerminal menyimpan
tui.whimsy = false: mulai ulang sesi Codex itu. Pengaturan eksplisit di tingkat proyek atau baris perintah bisa menimpanya. Lihat Catatan untuk pengguna Codex.
Tidak ada notifikasi
- Pastikan Pengaturan → Notifikasi aktif.
- Izinkan notifikasi untuk PATerminal di pengaturan OS Anda, dan periksa Focus / Jangan Ganggu.
- Notifikasi hanya dikirim untuk sesi yang tidak sedang Anda lihat.
Percakapan tidak berlanjut
- Agen mungkin keluar sebelum menyimpan percakapan. Buka dari Riwayat sebagai gantinya.
- Memindahkan Claude Code ke folder yang tidak terkait memerlukan Claude Code v2.1.223 atau lebih baru.
- Opsi yang hanya Anda berikan di baris perintah awal tidak diulang.
Pembaruan gagal
Jika pembaruan yang ditandatangani tidak bisa dipasang, PATerminal tidak dimulai ulang dan tidak ada yang berubah. Coba lagi nanti, atau unduh penginstal terbaru dari halaman unduhan dan pasang di atas versi saat ini — sesi dan pengaturan Anda tetap tersimpan.
Di mana data saya?
Sesi, grup, catatan, frasa, dan pengaturan disimpan sebagai berkas lokal di komputer Anda; percakapan agen tetap di folder milik agen itu sendiri (misalnya ~/.claude dan ~/.codex). Tidak ada yang disinkronkan ke server, dan PATerminal tidak memiliki telemetri.
Masih buntu?
Lihat tanya jawab, atau kirim email berisi OS, versi PATerminal, dan apa yang sudah Anda coba. Kami membalas setiap pesan.