Instal PandaNpc dan PandaPaw

Diperbarui

Pengaturan agen pengodean jarak jauh memiliki dua bagian independen:

  • Klien PandaNpc — antarmuka yang Anda gunakan untuk membaca sesi, mengirim perintah, dan menyetujui alat. Berjalan di web, iOS, Windows, macOS, dan Linux.
  • Host PandaPaw — layanan latar belakang di komputer tempat Claude Code, Codex, atau PandaCode benar-benar berjalan.

Instal hanya klien untuk obrolan PandaNpc dan penggunaan desktop lokal. Instal kedua bagian saat Anda ingin menjangkau agen pengodean yang berjalan di mesin lain.

Lihat PandaNpc Desktop untuk mengetahui apa yang ditambahkan aplikasi Windows/macOS/Linux di luar langkah-langkah pemasang di bawah ini, termasuk riwayat rilisnya.

Pilih apa yang akan diinstal

Skenario Klien Host PandaPaw
Menggunakan obrolan PandaNpc di peramban Buka aplikasi web Tidak diperlukan
Mengontrol agen di desktop yang sama Aplikasi desktop Tergantung pada mode lokal/jarak jauh yang dipilih
Mengontrol mesin pengembangan dari ponsel atau peramban Instal/buka klien di perangkat penampil Diperlukan di mesin pengembangan
Menjalankan agen di server tanpa desktop grafis Web, desktop, atau iOS di tempat lain Diperlukan di server

Untuk jalur ujung-ke-ujung terpendek, gunakan Panduan Mulai Cepat.

Instal klien PandaNpc

Gunakan halaman unduhan PandaNpc sebagai sumber kebenaran untuk penginstal saat ini. Hindari situs unduhan pihak ketiga karena mungkin menyediakan paket lama atau yang dimodifikasi.

Web

Buka pandanpc.com/agent di peramban saat ini. Tidak ada yang diinstal. Penyimpanan peramban menyimpan status masuk lokal, sehingga jendela privat/penyamaran mungkin mengharuskan Anda masuk lagi.

iOS

Ikuti tautan App Store di halaman unduhan dan instal PandaNpc. iOS berguna untuk memeriksa progres, menjawab pertanyaan, dan menyetujui alat saat jauh dari host. Proses pengodean tetap berjalan di mesin host yang terhubung. Lihat PandaNpc untuk iOS untuk mengetahui cakupan aplikasi, termasuk riwayat rilisnya.

Windows

  1. Unduh penginstal Windows saat ini.
  2. Jalankan dan ikuti petunjuk penginstal.
  3. Luncurkan PandaNpc dari menu Start.
  4. Jika Windows menampilkan peringatan penerbit atau reputasi, verifikasi bahwa file berasal dari pandanpc.com sebelum melanjutkan.

macOS

  1. Unduh .dmg macOS.
  2. Seret PandaNpc ke Applications.
  3. Luncurkan dari Applications dan selesaikan setiap prompt keamanan macOS.

Build macOS bersifat universal, sehingga paket yang sama mendukung Apple Silicon dan Mac Intel.

Linux

Unduh AppImage x86_64, jadikan dapat dieksekusi, dan jalankan:

bash
chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImage

Jika AppImage tidak dimulai, jalankan dari terminal sekali dan simpan keluaran kesalahan yang tepat. Distribusi lama mungkin tidak memiliki pustaka runtime yang diperlukan oleh shell desktop.

Instal PandaPaw di host agen

PandaPaw saat ini menyediakan penginstal host untuk Windows x64, macOS universal, dan Linux x86_64. Jalankan perintah di komputer yang memiliki file proyek dan yang seharusnya mengeksekusi alat-alat agen.

Rute yang disarankan adalah Perangkat Terhubung: pilih Tambahkan perangkat, lalu salin perintah sekali pakai yang dibuat. Ini memasangkan host dengan akun Anda selama instalasi.

macOS atau Linux

Penginstal biasa dengan otorisasi peramban:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

Formulir kunci sekali pakai yang disiapkan:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxx

Windows PowerShell

Penginstal biasa:

powershell
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

Formulir kunci sekali pakai yang disiapkan:

powershell
$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

Pipeline iwr | iex PowerShell tidak dapat meneruskan argumen skrip normal, sehingga penginstal Windows membaca kunci sekali pakai dari PANDANET_KEY.

Apa yang diubah oleh penginstal host

Penginstal:

  1. Menambahkan PandaPaw ke direktori aplikasi/bin pengguna saat ini dan memperbarui PATH pengguna jika diperlukan.
  2. Mendaftarkan layanan latar belakang yang sesuai untuk mulai otomatis.
  3. Menginstal mesin pengodean yang didukung yang belum ada jika platform mengizinkannya.
  4. Menyediakan runtime Node.js pribadi ketika sistem tidak memiliki versi yang sesuai.
  5. Memulai otorisasi akun atau menukarkan kunci perangkat yang disiapkan.
  6. Mencatat file mana yang dibuatnya sehingga penghapusan instalasi dapat mempertahankan alat kompatibel yang sudah ada.

Menginstal mesin tidak otomatis membeli atau mengautentikasi langganan model. Claude Code dan Codex masih dapat meminta login penyedia mereka sendiri saat pertama kali dijalankan.

Verifikasi instalasi

Buka terminal baru setelah instalasi dan jalankan:

bash
pandapaw status

Kemudian buka Agen PandaNpc. Host akan muncul daring. Mulai sesi di proyek uji dan minta untuk melaporkan direktori kerja saat ini tanpa mengubah file. Ini memverifikasi biner, layanan latar belakang, pemasangan akun, koneksi relay, mesin, dan direktori yang dipilih—bukan hanya langkah unduhan.

Pembaruan

Klien desktop memberi tahu Anda saat pembaruan tersedia. iOS diperbarui melalui App Store.

Perbarui PandaPaw dan mulai ulang layanan yang dikelolanya dengan:

bash
pandapaw update --restart

Pembaru memverifikasi biner yang diunduh terhadap checksum SHA-256 yang dipublikasikan sebelum mengganti salinan yang terinstal. Pemasangan akun dan identitas koneksi yang ada Anda dipertahankan. Menjalankan ulang perintah instalasi juga didukung ketika pembaru itu sendiri tidak tersedia.

Penghapusan instalasi

  • Klien Windows: Settings → Apps → Installed apps → PandaNpc → Uninstall.
  • Klien macOS: keluar dari PandaNpc, lalu pindahkan dari Applications ke Trash.
  • Klien Linux: hapus AppImage dan peluncur apa pun yang Anda buat untuk itu.
  • Host PandaPaw: jalankan pandapaw uninstall di host.

Manifes penghapusan instalasi PandaPaw membedakan alat yang dibuat penginstal dari alat kompatibel yang sudah ada. Ini sengaja konservatif daripada menghapus instalasi Claude Code, Codex, PandaCode, atau Node yang sudah ada sebelumnya.

Masalah instalasi

Perintah selesai tetapi host tidak terhubung

Jalankan pandapaw login. Instalasi host dan otorisasi akun adalah tahap terpisah, dan penginstal dapat selesai meskipun otorisasi peramban ditunda atau terputus.

Shell tidak dapat menemukan `pandapaw`

Buka terminal baru. Di macOS/Linux, periksa ~/.local/bin; di Windows, periksa %LOCALAPPDATA%\Programs\pandapaw. Jangan instal ulang berulang kali sampai Anda memastikan apakah file yang dapat dieksekusi ada dan hanya PATH yang kedaluwarsa.

Mesin pengodean gagal diinstal

Penginstal host memperlakukan unduhan mesin opsional sebagai upaya terbaik sehingga satu gangguan penyedia tidak menghapus instalasi PandaPaw yang berfungsi. Instal atau perbaiki mesin tersebut menggunakan penginstal resminya, autentikasi secara normal, lalu jalankan pandapaw status lagi.

AppImage atau aplikasi desktop tidak mau terbuka

Pastikan Anda mengunduh paket untuk arsitektur yang benar, lalu luncurkan dari terminal untuk menangkap kesalahan pertama. Sertakan kesalahan tersebut dan versi OS Anda saat menghubungi dukungan; tangkapan layar dari jendela yang tertutup biasanya tidak cukup untuk mendiagnosis pustaka runtime yang hilang.

Untuk pemeriksaan koneksi khusus host, lanjutkan dengan panduan PandaPaw atau FAQ.