Mulai Cepat: Menjalankan Claude Code atau Codex dari Jarak Jauh

Diperbarui

Panduan ini menghubungkan satu mesin pengembangan ke PandaNpc dan memverifikasi bahwa Anda dapat menjalankan Claude Code, Codex, atau PandaCode dari perangkat lain. Agen tetap berjalan di mesin pengembangan Anda; PandaNpc memberi Anda antarmuka jarak jauh yang tersinkronisasi untuk pesan, persetujuan, pertanyaan, dan riwayat sesi.

Sebagian besar pengguna sebaiknya menggunakan alur Tambah perangkat karena alur ini menghasilkan perintah instalasi sekali pakai yang sudah tertaut ke akun mereka. Berikan waktu sekitar lima menit, ditambah proses masuk ke penyedia model yang diperlukan oleh mesin pengodean Anda.

Sebelum memulai

Anda memerlukan:

  • Akun PandaNpc yang dibuka di aplikasi web, aplikasi desktop, atau aplikasi iOS.
  • Host 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 diautentikasi.

Jika Anda hanya memerlukan obrolan bawaan PandaNpc dan tidak ingin mengontrol agen di mesin lain, PandaPaw tidak diperlukan. Lihat Instalasi untuk opsi khusus klien.

1. Buat perintah instalasi host

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

Salin perintah tersebut ke mesin tempat agen pengodean akan dijalankan. Perlakukan seperti kata sandi sampai perintah tersebut digunakan: kunci sekali pakai memasangkan satu mesin dan tidak boleh dibagikan di obrolan, tangkapan layar, laporan masalah, atau ekspor riwayat shell.

Jika Anda lebih memilih otorisasi browser daripada kunci yang sudah disiapkan, gunakan penginstal biasa pada langkah berikutnya. Perintah ini menjalankan pandapaw login dan membuka halaman otorisasi untuk Anda.

2. Pasang PandaPaw di host

macOS atau Linux

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

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

Windows PowerShell

Jalankan perintah yang sudah disiapkan dari Perangkat Terhubung, atau gunakan:

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

Penginstal menambahkan PandaPaw dan layanan latar belakangnya, memasang mesin pengodean yang didukung bila memungkinkan, dan menyediakan runtime Node.js privat jika host tidak memiliki runtime yang sesuai. Dengan kunci perangkat yang sudah disiapkan, pemasangan akun terjadi selama instalasi. Dengan perintah biasa, setujui permintaan otorisasi browser saat diminta.

Penginstal dapat selesai bahkan ketika otorisasi akun ditunda. Jika penginstal menyatakan instalasi berhasil tetapi koneksi akun belum lengkap, jalankan:

bash
pandapaw login

3. Verifikasi layanan host

Di host, jalankan:

bash
pandapaw status

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

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 bekerja paling baik ketika direktori memiliki remote.origin.url Git yang stabil.

4. Mulai sesi jarak jauh pertama

  1. Buka PandaNpc Agent di ponsel, browser, atau desktop lain.
  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 masuk yang ditampilkan.
  5. Kirim prompt pengujian yang tidak merusak seperti: Tampilkan direktori kerja saat ini dan daftarkan file tingkat atas. Jangan mengubah apa pun.

Anda terhubung sepenuhnya ketika balasan menyebutkan direktori proyek yang diharapkan, daftar file cocok dengan host, dan pertanyaan izin 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 seharusnya kembali dan host harus tetap daring. Ini memeriksa jalur jarak jauh yang sebenarnya, bukan hanya membuktikan bahwa penginstal berhasil diunduh.

Jangan tidurkan host selama pengujian ini. Host yang tertidur atau mati tidak dapat menjalankan agen meskipun koneksi yang disimpan 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 terpasang, jalankan pandapaw login. Jika Anda menggunakan kunci yang sudah disiapkan dan kunci tersebut sudah digunakan atau kedaluwarsa, buat kunci baru di Perangkat Terhubung dan jalankan ulang perintah yang ditampilkan.

`pandapaw` tidak dikenali

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

Mesin terdaftar tetapi luring

Pastikan host dalam keadaan menyala, tidak tertidur, dan dapat mengakses internet. Kemudian periksa pandapaw status. Firewall perusahaan harus mengizinkan lalu lintas HTTPS/WebSocket keluar; Anda tidak perlu membuat aturan penerusan port masuk.

Koneksi berfungsi tetapi mesin meminta autentikasi

Pemasangan PandaPaw dan login penyedia model adalah dua hal yang terpisah. Pemasangan membuktikan host milik akun PandaNpc Anda; Claude Code atau Codex mungkin masih memerlukan login langganan atau konfigurasi API sendiri. Selesaikan proses masuk normal mesin tersebut, lalu coba lagi sesinya.

Agen terbuka di folder yang salah

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

Langkah berikutnya

  • 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 ketika Anda menginginkan endpoint yang kompatibel dengan OpenAI, model yang dihosting sendiri, atau API Key terpisah.