PandaPaw: Host Jarak Jauh untuk Claude Code, Codex, dan PandaCode

PandaPaw mengubah mesin Windows, macOS, atau Linux yang Anda kendalikan menjadi host agen PandaNpc. Mesin pengkodean, file proyek, shell, dan peralatan tetap berada di host tersebut; klien PandaNpc memberi Anda antarmuka yang tersinkronisasi dari ponsel, peramban, atau desktop lain.

Gunakan PandaPaw ketika mesin yang melakukan pekerjaan berbeda dari perangkat yang Anda pegang, ketika Anda ingin host tetap bertahan saat klien terputus, atau ketika beberapa mesin pengkodean harus berbagi pengaturan berbasis akun dan konfigurasi Pusat Agen yang sama.

Apa yang Dikelola PandaPaw

• Koneksi agen jarak jauh untuk Claude Code, OpenAI Codex, dan PandaCode.
• Layanan latar belakang dan mulai otomatis sehingga host dapat kembali setelah reboot normal.
• Otorisasi mesin berbasis akun tanpa menyalin secara manual Bridge ID, token, atau kunci penandatanganan yang berumur panjang.
• Bantuan pemasangan mesin ketika mesin pengkodean yang didukung tidak ada.
• Proyeksi Pusat Agen yang merender panduan, keterampilan, memori, dan definisi agen setiap mesin dalam tata letak aslinya.
• Jaringan perangkat pribadi untuk mesin yang bergabung melalui alur Perangkat Terhubung.
• Pencatatan pembaruan dan pencopotan pemasangan sehingga peralatan yang sudah ada sebelum PandaPaw tetap dipertahankan.

PandaPaw tidak menyediakan langganan model dengan sendirinya. Claude Code, Codex, dan PandaCode tetap menggunakan kredensial penyedia dan batas yang dikonfigurasi untuk mesinnya.

Cara Kerja Eksekusi Jarak Jauh

Kedua sisi memulai koneksi keluar, sehingga pengaturan rumah atau kantor normal tidak memerlukan aturan firewall masuk, alamat IP publik, penerusan port router, atau server SSH yang terekspos publik. Relai mengangkut pesan, status, dan persetujuan; eksekusi alat terjadi di host.

Jika host tertidur, mati, atau kehilangan jalur jaringan keluar, koneksi yang tersimpan tetap ada di akun Anda tetapi tidak dapat mengeksekusi pekerjaan sampai host kembali.

Platform Host yang Didukung

Klien penampil PandaNpc memiliki matriks platform yang lebih luas. Lihat Menginstal PandaNpc dan PandaPaw saat memilih paket klien dan host.

Instalasi yang Disarankan

1. Masuk ke PandaNpc.
2. Buka Perangkat Terhubung.
3. Pilih Tambah perangkat. Kunci sekali pakai diterbitkan dan dialog menampilkan satu perintah untuk sistem operasi yang terdeteksi.
4. Salin perintah itu ke host dan jalankan di sana.
5. Biarkan dialog tetap terbuka jika Anda ingin dialog tersebut mendeteksi mesin baru secara otomatis.

Kunci yang disiapkan adalah sekali pakai. Salin seluruh perintah, jaga kerahasiaannya, dan buat yang baru jika kedaluwarsa atau sudah digunakan.

Penginstal macOS/Linux Biasa

Gunakan formulir ini ketika Anda menginginkan otorisasi peramban alih-alih kunci yang disiapkan:

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

Penginstal Windows PowerShell Biasa

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

Penginstal biasa menjalankan pandapaw login. Setujui mesin di halaman peramban yang terbuka. Jika otorisasi terputus, biner dan layanan tetap dapat diinstal; jalankan pandapaw login nanti untuk menyelesaikan koneksi akun.

Verifikasi Host

Pertama, periksa host itu sendiri:

pandapaw status

Kemudian buka Agen PandaNpc dan pastikan mesin memiliki indikator online hijau. Mulai sesi di direktori uji sekali pakai atau hanya-baca dan tanyakan:

Prompt uji: Cetak direktori kerja saat ini dan daftar file tingkat atas. Jangan ubah apa pun.

Balasan yang berhasil membuktikan lebih dari sekadar lampu status hijau: ini memverifikasi pemasangan akun, konektivitas relai, mesin yang dipilih, autentikasi penyedia, dan pemetaan direktori kerja.

Untuk proyek Pusat Agen, jalankan:

pandapaw agent status --root /absolute/path/to/project

Ini menunjukkan apakah proyek terikat dan apakah konfigurasi terkelola tersedia secara lokal. Remote Git yang stabil membantu PandaPaw mengidentifikasi proyek yang sama di berbagai mesin.

Otorisasi Akun dan Identitas Koneksi

pandapaw login menggunakan sesi otorisasi perangkat peramban. Setelah Anda menyetujuinya, host menerima kredensial khusus perangkat dan kunci verifikasi Pusat Agen melalui TLS, menulis konfigurasi mesinnya di bawah ~/.pandapaw/, mendaftarkan koneksi mesin yang didukung, dan mengikat proyek Git yang dapat dikenali.

Jalankan pandapaw login --force hanya saat sengaja berpindah akun atau mengganti kredensial host yang kedaluwarsa. Mengotorisasi ulang mesin yang sehat tanpa alasan dapat membuat identitas duplikat atau tergantikan yang membingungkan.

pandapaw qr masih membuat tautan koneksi manual berumur pendek untuk kompatibilitas dan kasus khusus. Ini bukan alur utama untuk host baru; Perangkat Terhubung lebih mudah diaudit dan tidak mengharuskan pengguna memahami Bridge ID.

Sinkronisasi Pusat Agen

Pusat Agen berbasis peristiwa pada kondisi stabil:

1. Perubahan file terkelola lokal terdeteksi dan dipublikasikan ke proyek yang terikat.
2. Rilis bertanda tangan tiba melalui aliran peristiwa.
3. Manifes dan blob konten yang tidak berubah digunakan kembali daripada diunduh lagi.
4. Pemeriksaan pemulihan berkala menangkap peristiwa yang terlewat selama pemutusan sementara.

Claude Code, Codex, dan PandaCode menerima proyeksi terpisah karena mereka mengharapkan direktori dan format instruksi yang berbeda. PandaCode menyiapkan rilis terverifikasi terbaru sebelum merakit prompt sesi baru, sehingga konfigurasi yang ditarik saat startup dapat memengaruhi sesi yang sama.

Jika Pusat Agen untuk sementara tidak tersedia, mesin melanjutkan dengan rilis lokal terverifikasi terakhir. Kegagalan jaringan tidak boleh secara diam-diam mengganti konfigurasi bertanda tangan dengan konten yang tidak diverifikasi.

Perintah yang Berguna

pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall

Periksa riwayat versi PandaPaw ketika perintah atau UI berbeda dari tangkapan layar atau tutorial yang lebih lama.

Batas Keamanan

• Operator jarak jauh dapat menggunakan alat dan direktori kerja apa pun yang diizinkan oleh sesi agen yang dipilih. Akses jarak jauh tidak otomatis hanya-baca.
• Jauhkan perintah perangkat sekali pakai, tautan koneksi manual, kunci penyedia, dan token akun dari log dan tangkapan layar.
• Jangan buka port router masuk hanya untuk membuat PandaPaw dapat dijangkau.
• Hapus host yang tidak lagi Anda miliki dari Perangkat Terhubung.
• Tinjau persetujuan alat dan verifikasi direktori kerja sebelum mengizinkan pengeditan atau perintah shell.
• Saat berbagi koneksi langsung, penerima mengonsumsi kuota mesin pemilik host dan dapat bertindak di host. Baca Berbagi Koneksi terlebih dahulu.

Pemecahan Masalah

`pandapaw` tidak ditemukan setelah instalasi

Buka terminal baru agar memuat ulang PATH pengguna. Lokasi normalnya adalah ~/.local/bin di macOS/Linux dan %LOCALAPPDATA%\Programs\pandapaw di Windows. Pastikan file tersebut ada sebelum menjalankan ulang penginstal.

Instalasi berhasil, tetapi tidak ada mesin yang muncul

Jalankan pandapaw status. Jika mesin tidak memiliki otorisasi akun, jalankan pandapaw login. Jika kunci sekali pakai yang disiapkan digunakan, buat kunci baru daripada mencoba ulang perintah yang sudah digunakan.

Mesin muncul tetapi tetap offline

Pastikan host aktif dan memiliki akses internet. Periksa status PandaPaw secara lokal. Proxy atau firewall perusahaan harus mengizinkan jalur HTTPS/WebSocket keluar; port masuk tidak menyelesaikan koneksi keluar yang diblokir.

Host online, tetapi Claude Code atau Codex tidak merespons

Memasangkan host tidak mengautentikasi setiap penyedia model. Buka mesin secara lokal atau ikuti prompt login yang ditampilkan di sesi jarak jauh. Juga pastikan model yang dipilih ada untuk akun tersebut dan batas penggunaannya belum habis.

Sesi terbuka di proyek yang salah

Akhiri pengujian, pilih direktori kerja absolut yang dimaksud, dan minta agen untuk mencetaknya sebelum menyetujui alat. PandaPaw tidak menebak repositori mana yang Anda maksud dan tidak menambahkan sandbox sistem file di luar model izin mesin itu sendiri.

Perubahan Pusat Agen tidak muncul

Jalankan pandapaw agent status --root /path/to/project dari root Git yang benar. Pastikan proyek terikat, host masuk, dan file lokal adalah bagian dari proyeksi terkelola. Biarkan rilis terverifikasi terakhir tetap di tempatnya saat menyelidiki, jangan menghapus direktori terkelola.

Pembaruan dan Pencopotan Pemasangan

pandapaw update --restart mengunduh biner saat ini, memverifikasi checksum SHA-256-nya, mengganti salinan terinstal, dan memulai ulang layanan terkelola agar versi tersebut aktif. Pemasangan akun yang ada tetap dipertahankan.

pandapaw uninstall menggunakan manifes instalasi untuk menghapus item yang dibuat PandaPaw. Instalasi Claude Code, Codex, PandaCode, atau Node yang kompatibel yang sudah ada sebelumnya sengaja dipertahankan. Setelah mencopot pemasangan, hapus host dari Perangkat Terhubung jika tidak lagi tepercaya.