Cài đặt PandaNpc và PandaPaw

Cập nhật

Một thiết lập tác nhân lập trình từ xa có hai phần độc lập:

  • PandaNpc client — giao diện bạn dùng để đọc phiên, gửi lời nhắc và phê duyệt công cụ. Nó chạy trên web, iOS, Windows, macOS và Linux.
  • PandaPaw host — dịch vụ nền trên máy tính nơi Claude Code, Codex hoặc PandaCode thực sự thực thi.

Chỉ cài ứng dụng khách cho phiên trò chuyện PandaNpc và sử dụng máy tính để bàn cục bộ. Cài cả hai phần khi bạn muốn kết nối với một tác nhân lập trình đang chạy trên máy khác.

Xem PandaNpc Desktop để biết ứng dụng Windows/macOS/Linux bổ sung gì ngoài các bước cài đặt bên dưới, bao gồm lịch sử phát hành.

Chọn những gì cần cài đặt

Tình huống Ứng dụng khách Máy chủ PandaPaw
Sử dụng PandaNpc chat trong trình duyệt Mở ứng dụng web Không bắt buộc
Điều khiển một tác nhân trên cùng máy tính để bàn này Ứng dụng máy tính để bàn Tùy thuộc vào chế độ cục bộ/từ xa đã chọn
Điều khiển máy phát triển từ điện thoại hoặc trình duyệt Cài đặt/mở ứng dụng khách trên thiết bị xem Bắt buộc trên máy phát triển
Chạy tác nhân trên máy chủ không có màn hình đồ họa Web, máy tính để bàn hoặc iOS ở nơi khác Bắt buộc trên máy chủ

Để có đường đi ngắn nhất từ đầu đến cuối, hãy sử dụng Hướng dẫn bắt đầu nhanh.

Cài đặt ứng dụng khách PandaNpc

Sử dụng trang tải xuống PandaNpc làm nguồn chính thức cho các trình cài đặt hiện tại. Tránh các trang tải xuống bên thứ ba vì chúng có thể cung cấp các gói cũ hoặc đã bị sửa đổi.

Web

Mở pandanpc.com/agent trong trình duyệt hiện tại. Không có gì được cài đặt. Bộ nhớ trình duyệt giữ trạng thái đăng nhập cục bộ, vì vậy cửa sổ riêng tư/ẩn danh có thể yêu cầu bạn đăng nhập lại.

iOS

Theo liên kết App Store trên trang tải xuống và cài đặt PandaNpc. iOS hữu ích để kiểm tra tiến độ, trả lời câu hỏi và phê duyệt công cụ khi bạn không ở gần máy chủ. Quá trình lập trình vẫn chạy trên máy chủ được kết nối. Xem PandaNpc cho iOS để biết ứng dụng bao gồm những gì, bao gồm lịch sử phát hành.

Windows

  1. Tải xuống trình cài đặt Windows hiện tại.
  2. Chạy nó và làm theo hướng dẫn của trình cài đặt.
  3. Khởi chạy PandaNpc từ menu Start.
  4. Nếu Windows hiển thị cảnh báo nhà xuất bản hoặc danh tiếng, hãy xác minh rằng tệp đến từ pandanpc.com trước khi tiếp tục.

macOS

  1. Tải xuống tệp .dmg cho macOS.
  2. Kéo PandaNpc vào Applications.
  3. Khởi chạy nó từ Applications và hoàn tất mọi lời nhắc bảo mật của macOS.

Bản dựng macOS là phổ quát, vì vậy cùng một gói hỗ trợ cả Apple Silicon và Intel Macs.

Linux

Tải xuống AppImage x86_64, làm cho nó có thể thực thi và chạy nó:

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

Nếu AppImage không khởi động, hãy chạy nó từ terminal một lần và giữ lại đầu ra lỗi chính xác. Các bản phân phối cũ có thể thiếu thư viện thời gian chạy mà trình bao máy tính để bàn yêu cầu.

Cài đặt PandaPaw trên máy chủ tác nhân

PandaPaw hiện cung cấp trình cài đặt máy chủ cho Windows x64, macOS universal và Linux x86_64. Chạy lệnh trên máy tính sở hữu các tệp dự án và sẽ thực thi các công cụ của tác nhân.

Cách được khuyến nghị là Thiết bị đã kết nối: chọn Thêm một thiết bị, sau đó sao chép lệnh một lần được tạo. Lệnh này liên kết máy chủ với tài khoản của bạn trong quá trình cài đặt.

macOS hoặc Linux

Trình cài đặt thông thường với xác thực trình duyệt:

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

Biểu mẫu khóa một lần đã chuẩn bị:

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

Windows PowerShell

Trình cài đặt thông thường:

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

Biểu mẫu khóa một lần đã chuẩn bị:

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

Đường ống iwr | iex của PowerShell không thể truyền đối số script thông thường, vì vậy trình cài đặt Windows đọc khóa một lần từ PANDANET_KEY.

Trình cài đặt máy chủ thay đổi những gì

Trình cài đặt:

  1. Thêm PandaPaw vào thư mục application/bin của người dùng hiện tại và cập nhật PATH của người dùng khi cần thiết.
  2. Đăng ký các dịch vụ nền thích hợp để tự động khởi động.
  3. Cài đặt các công cụ lập trình được hỗ trợ còn thiếu khi nền tảng cho phép.
  4. Cung cấp môi trường thời gian chạy Node.js riêng khi hệ thống không có phiên bản phù hợp.
  5. Bắt đầu xác thực tài khoản hoặc đổi mã thiết bị đã chuẩn bị.
  6. Ghi lại các tệp mà nó đã tạo để gỡ cài đặt có thể giữ lại các công cụ tương thích đã có sẵn.

Việc cài đặt một công cụ không tự động mua hoặc xác thực đăng ký mô hình. Claude Code và Codex vẫn có thể yêu cầu đăng nhập nhà cung cấp riêng của chúng lần đầu tiên chạy.

Xác minh cài đặt

Mở một terminal mới sau khi cài đặt và chạy:

bash
pandapaw status

Sau đó mở PandaNpc Agent. Máy chủ sẽ hiển thị trực tuyến. Bắt đầu một phiên trong một dự án kiểm thử và yêu cầu nó báo cáo thư mục làm việc hiện tại mà không thay đổi tệp. Điều này xác minh tệp nhị phân, dịch vụ nền, liên kết tài khoản, kết nối relay, công cụ và thư mục đã chọn—không chỉ bước tải xuống.

Cập nhật

Ứng dụng khách trên máy tính để bàn thông báo cho bạn khi có bản cập nhật. iOS cập nhật qua App Store.

Cập nhật PandaPaw và khởi động lại các dịch vụ được quản lý của nó bằng:

bash
pandapaw update --restart

Bộ cập nhật xác minh tệp nhị phân đã tải xuống với tổng kiểm tra SHA-256 đã công bố trước khi thay thế bản sao đã cài đặt. Liên kết tài khoản và danh tính kết nối hiện có của bạn được giữ nguyên. Việc chạy lại lệnh cài đặt cũng được hỗ trợ khi bộ cập nhật không khả dụng.

Gỡ cài đặt

  • Ứng dụng khách Windows: Cài đặt → Ứng dụng → Ứng dụng đã cài đặt → PandaNpc → Gỡ cài đặt.
  • Ứng dụng khách macOS: thoát PandaNpc, sau đó di chuyển nó từ Applications vào Thùng rác.
  • Ứng dụng khách Linux: xóa AppImage và mọi trình khởi chạy bạn đã tạo cho nó.
  • Máy chủ PandaPaw: chạy pandapaw uninstall trên máy chủ.

Danh sách gỡ cài đặt của PandaPaw phân biệt các công cụ do trình cài đặt tạo ra với các công cụ tương thích đã tồn tại. Nó cố tình thận trọng thay vì xóa bản cài đặt Claude Code, Codex, PandaCode hoặc Node đã có từ trước.

Sự cố cài đặt

Lệnh hoàn tất nhưng máy chủ không kết nối

Chạy pandapaw login. Việc cài đặt máy chủ và xác thực tài khoản là các giai đoạn riêng biệt và trình cài đặt có thể hoàn tất ngay cả khi xác thực trình duyệt bị hoãn lại hoặc bị gián đoạn.

Shell không thể tìm thấy `pandapaw`

Mở một terminal mới. Trên macOS/Linux, kiểm tra ~/.local/bin; trên Windows, kiểm tra %LOCALAPPDATA%\Programs\pandapaw. Không cài đặt lại nhiều lần cho đến khi bạn xác nhận tệp thực thi có tồn tại và chỉ PATH là lỗi thời.

Một công cụ lập trình không cài đặt được

Trình cài đặt máy chủ coi các bản tải xuống công cụ tùy chọn là cố gắng hết sức để một sự cố nhà cung cấp không làm hỏng bản cài đặt PandaPaw đang hoạt động. Cài đặt hoặc sửa chữa công cụ đó bằng trình cài đặt chính thức của nó, xác thực bình thường, sau đó chạy lại pandapaw status.

AppImage hoặc ứng dụng máy tính để bàn không mở được

Xác nhận bạn đã tải gói đúng kiến trúc, sau đó khởi chạy nó từ terminal để ghi lại lỗi đầu tiên. Khi liên hệ bộ phận hỗ trợ, hãy kèm lỗi đó và phiên bản hệ điều hành của bạn; ảnh chụp màn hình cửa sổ đóng thường không đủ để chẩn đoán thiếu thư viện thời gian chạy.

Để kiểm tra kết nối cụ thể cho máy chủ, hãy tiếp tục với hướng dẫn PandaPaw hoặc FAQ.