Panduan Cepat PandaNpc Work: Hubungkan Agen Pertama Anda

Mulai gunakan PandaNpc Work, ruang kerja AI multi-mesin. Hubungkan komputer dengan PandaPaw, pilih mesin agen, dan verifikasi sesi jarak jauh.

Diperbarui

Panduan ini menghubungkan satu komputer ke PandaNpc Work dan memverifikasi bahwa Anda dapat menjalankan Claude Code, Codex, atau PandaCode dari perangkat lain. PandaNpc Work adalah ruang kerja AI multi-mesin tempat Anda mendelegasikan pekerjaan dan mengikutinya di berbagai perangkat. Agen tetap dijalankan di komputer yang terhubung; PandaPaw menyediakan jembatan dan runtime lokal, sedangkan PandaNpc Work memberi Anda antarmuka tersinkronisasi untuk pesan, persetujuan, pertanyaan, dan riwayat sesi.

Jalur ini paling cocok untuk orang yang sudah terbiasa dengan Claude Code, Codex, atau agen coding serupa. Sebagian besar orang sebaiknya menggunakan alur Tambahkan perangkat karena alur ini menghasilkan perintah instalasi sekali pakai yang sudah tertaut ke akun mereka. Sediakan waktu sekitar lima menit, ditambah proses masuk penyedia model apa pun yang diperlukan mesin coding Anda. Untuk menjelajahi antarmuka Agen sebelum menghubungkan komputer, buka PandaNpc Agent di browser.

Sebelum Anda mulai

Anda memerlukan:

  • Akun PandaNpc yang dibuka di aplikasi web, aplikasi desktop, atau aplikasi iOS.
  • Komputer yang terhubung yang menjalankan Windows x64, macOS, atau Linux x86_64.
  • Akses internet dari host dan izin untuk memasang layanan latar belakang tingkat pengguna.
  • Folder proyek yang boleh Anda ubah.
  • Akun Claude, ChatGPT/Codex, atau model kustom jika mesin yang Anda pilih belum terautentikasi.

Jika Anda hanya ingin melihat host yang sudah terhubung, pasang atau buka klien di perangkat penampil Anda. PandaPaw berada di komputer yang menjalankan agen. Lihat Instalasi untuk peran klien dan host.

1. Hasilkan perintah instalasi host

Saat sudah masuk, buka Perangkat Terhubung dan pilih Tambahkan perangkat. PandaNpc membuat kunci perangkat sekali pakai dan menampilkan perintah yang tepat untuk sistem operasi Anda.

Salin perintah itu ke mesin tempat agen coding harus berjalan. Perlakukan seperti kata sandi sampai digunakan: kunci sekali pakai memasangkan satu mesin dan tidak boleh diposting di chat, tangkapan layar, issue, atau ekspor riwayat shell.

Jika Anda lebih suka otorisasi browser alih-alih kunci yang disiapkan, gunakan installer biasa di langkah berikutnya. Installer menjalankan pandapaw login dan membuka halaman otorisasi untuk Anda.

2. Pasang PandaPaw di host

macOS atau Linux

Jalankan perintah yang disiapkan dari Perangkat Terhubung, atau gunakan installer biasa:

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

Windows PowerShell

Jalankan perintah yang disiapkan dari Perangkat Terhubung, atau gunakan:

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

Installer menambahkan PandaPaw dan layanan latar belakangnya, memasang mesin coding yang didukung yang belum ada jika memungkinkan, dan menyediakan runtime Node.js privat saat host tidak memiliki runtime yang sesuai. Dengan kunci perangkat yang disiapkan, pairing akun terjadi selama instalasi. Dengan perintah biasa, setujui permintaan otorisasi browser saat diminta.

Installer mungkin selesai meskipun otorisasi akun ditunda. Jika installer mengatakan instalasi berhasil tetapi koneksi akun belum lengkap, jalankan:

bash
pandapaw login

3. Verifikasi layanan host

Di host, jalankan:

bash
pandapaw status

Perintah tersebut harus mengenali layanan yang terpasang dan menampilkan mesin yang terhubung ke akun. Jika shell tidak dapat menemukan pandapaw, buka terminal baru terlebih dahulu agar memuat ulang PATH pengguna yang diperbarui.

Untuk proyek Git, Anda juga dapat memeriksa apakah Agent Center mengenali akar proyek:

bash
pandapaw agent status --root /path/to/your/project

Gunakan jalur proyek absolut yang sebenarnya. Pengikatan proyek Agent Center paling baik bekerja saat direktori memiliki Git remote.origin.url yang stabil.

4. Mulai sesi jarak jauh pertama

  1. Buka PandaNpc Agent di ponsel, browser, atau desktop lain Anda.
  2. Temukan mesin yang baru terhubung. Indikator status hijau berarti host saat ini dapat dijangkau.
  3. Pilih Claude Code, Codex, atau PandaCode dan pilih direktori kerja proyek.
  4. Mulai sesi. Jika mesin meminta Anda masuk, selesaikan otorisasi penyedia tersebut di host atau melalui alur login yang ditampilkan.
  5. Kirim prompt pengujian non-destruktif seperti: Show the current working directory and list the top-level files. Do not edit anything.

Anda terhubung sepenuhnya saat balasan menyebutkan direktori proyek yang diharapkan, daftar file cocok dengan host, dan pertanyaan izin apa pun muncul di klien jarak jauh untuk Anda setujui atau tolak.

5. Konfirmasi perilaku koneksi ulang

Tutup klien penampil, tunggu beberapa detik, dan buka kembali sesi yang sama. Riwayat yang ada harus muncul kembali dan host harus tetap online. Ini memeriksa jalur jarak jauh yang sebenarnya, bukan hanya membuktikan bahwa installer berhasil diunduh.

Jangan buat host tidur selama pengujian ini. Host yang tidur atau mati tidak dapat menjalankan agen meskipun koneksi yang tersimpan masih muncul di akun Anda.

Pemecahan Masalah

Mesin tidak muncul di Agen

Jalankan pandapaw status di host. Jika instalasi berhasil tetapi tidak ada akun yang terlampir, jalankan pandapaw login. Jika Anda menggunakan kunci yang disiapkan dan kunci itu sudah ditukarkan atau kedaluwarsa, buat kunci baru di Perangkat Terhubung dan jalankan kembali perintah yang ditampilkan.

`pandapaw` tidak dikenali

Buka terminal baru. Di macOS/Linux, pastikan bahwa ~/.local/bin ada di PATH. Di Windows, installer menambahkan %LOCALAPPDATA%\Programs\pandapaw ke PATH pengguna; terminal yang dibuka sebelum instalasi tidak akan melihat nilai baru.

Mesin terdaftar tetapi offline

Pastikan host menyala, terjaga, dan dapat menjangkau internet. Lalu periksa pandapaw status. Firewall korporat harus mengizinkan lalu lintas HTTPS/WebSocket keluar; Anda tidak boleh membuat aturan port-forwarding masuk.

Koneksi berfungsi tetapi mesin meminta autentikasi

Pairing PandaPaw dan login penyedia model terpisah. Pairing membuktikan host milik akun PandaNpc Anda; Claude Code atau Codex mungkin masih memerlukan login langganan atau konfigurasi API-nya sendiri. Selesaikan proses masuk normal mesin, lalu coba lagi sesi.

Agen terbuka di folder yang salah

Akhiri sesi pengujian itu dan buat sesi dengan direktori kerja yang dimaksud. Sebelum menyetujui penggunaan alat, minta agen mencetak direktori saat ini. Koneksi jarak jauh tidak dengan sendirinya menambahkan sandbox filesystem; izin alat mesin dan direktori kerja yang dipilih tetap penting.

Langkah selanjutnya

  • Baca panduan host PandaPaw selengkapnya untuk pembaruan, pemeriksaan layanan, dan arsitektur koneksi.
  • Tinjau Akun dan penagihan untuk memahami langganan atau penyedia mana yang membayar setiap sesi.
  • Tambahkan penyedia AI kustom saat Anda menginginkan endpoint yang kompatibel dengan OpenAI, model yang di-host sendiri, atau API Key terpisah.