PandaNpc Work: Bắt đầu nhanh – Kết nối agent đầu tiên của bạn

Bắt đầu sử dụng PandaNpc Work, không gian làm việc AI đa engine. Kết nối một máy tính với PandaPaw, chọn một engine agent và xác minh phiên từ xa.

Cập nhật

Hướng dẫn này kết nối một máy tính với PandaNpc Work và xác minh rằng bạn có thể chạy Claude Code, Codex hoặc PandaCode từ một thiết bị khác. PandaNpc Work là không gian làm việc AI đa engine, nơi bạn giao việc và theo dõi công việc trên nhiều thiết bị. Agent vẫn thực thi trên máy tính đã kết nối; PandaPaw cung cấp cầu nối và runtime cục bộ, trong khi PandaNpc Work cung cấp cho bạn giao diện đồng bộ cho tin nhắn, phê duyệt, câu hỏi và lịch sử phiên.

Lộ trình này phù hợp nhất với những người đã quen với Claude Code, Codex hoặc một tác nhân lập trình tương tự. Hầu hết mọi người nên dùng luồng Thêm thiết bị vì nó tạo lệnh cài đặt dùng một lần đã được liên kết với tài khoản của họ. Bạn nên dành khoảng năm phút, cộng thêm thời gian đăng nhập nhà cung cấp mô hình mà engine lập trình của bạn yêu cầu. Để khám phá giao diện Agent trước khi kết nối máy tính, hãy mở PandaNpc Agent trong trình duyệt.

Trước khi bắt đầu

Bạn cần:

  • Một tài khoản PandaNpc đã mở trong ứng dụng web, ứng dụng máy tính để bàn hoặc ứng dụng iOS.
  • Một máy tính đã kết nối chạy Windows x64, macOS hoặc Linux x86_64.
  • Quyền truy cập internet từ host và quyền cài đặt dịch vụ nền cấp người dùng.
  • Một thư mục dự án mà bạn được phép chỉnh sửa.
  • Một tài khoản Claude, ChatGPT/Codex hoặc mô hình tùy chỉnh nếu engine bạn chọn chưa được xác thực.

Nếu bạn chỉ muốn xem một host đã kết nối, hãy cài đặt hoặc mở client trên thiết bị xem của bạn. PandaPaw thuộc về máy tính đang chạy agent. Xem Cài đặt để biết vai trò client và host.

1. Tạo lệnh cài đặt host

Trong khi đã đăng nhập, hãy mở Thiết bị đã kết nối và chọn Thêm thiết bị. PandaNpc tạo khóa thiết bị dùng một lần và hiển thị lệnh chính xác cho hệ điều hành của bạn.

Sao chép lệnh đó đến máy nơi tác nhân lập trình sẽ chạy. Hãy đối xử với nó như mật khẩu cho đến khi nó được sử dụng: khóa dùng một lần ghép nối một máy và không nên đăng trong chat, ảnh chụp màn hình, issue hoặc bản xuất lịch sử shell.

Nếu bạn thích ủy quyền qua trình duyệt thay vì khóa được chuẩn bị sẵn, hãy dùng trình cài đặt thông thường ở bước tiếp theo. Nó chạy pandapaw login và mở trang ủy quyền cho bạn.

2. Cài đặt PandaPaw trên host

macOS hoặc Linux

Chạy lệnh được chuẩn bị sẵn từ Thiết bị đã kết nối, hoặc dùng trình cài đặt thông thường:

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

Windows PowerShell

Chạy lệnh được chuẩn bị sẵn từ Thiết bị đã kết nối, hoặc dùng:

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

Trình cài đặt thêm PandaPaw và các dịch vụ nền của nó, cài đặt các engine lập trình được hỗ trợ còn thiếu khi có thể, và cung cấp runtime Node.js riêng khi host không có runtime phù hợp. Với khóa thiết bị được chuẩn bị sẵn, việc ghép nối tài khoản diễn ra trong quá trình cài đặt. Với lệnh thông thường, hãy phê duyệt yêu cầu ủy quyền trên trình duyệt khi được nhắc.

Trình cài đặt có thể hoàn tất ngay cả khi ủy quyền tài khoản bị hoãn lại. Nếu nó báo cài đặt thành công nhưng kết nối tài khoản chưa hoàn tất, hãy chạy:

bash
pandapaw login

3. Xác minh các dịch vụ host

Trên host, hãy chạy:

bash
pandapaw status

Lệnh này sẽ nhận diện các dịch vụ đã cài đặt và hiển thị máy đã kết nối tài khoản. Nếu shell không tìm thấy pandapaw, hãy mở một terminal mới trước để nó tải lại PATH người dùng đã cập nhật.

Với một dự án Git, bạn cũng có thể kiểm tra xem Agent Center có nhận diện thư mục gốc dự án không:

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

Hãy dùng đường dẫn dự án tuyệt đối thật. Liên kết dự án của Agent Center hoạt động tốt nhất khi thư mục có remote.origin.url Git ổn định.

4. Bắt đầu phiên từ xa đầu tiên

  1. Mở PandaNpc Agent trên điện thoại, trình duyệt hoặc một máy tính để bàn khác.
  2. Tìm máy vừa được kết nối. Chỉ báo trạng thái màu xanh có nghĩa là host hiện có thể truy cập.
  3. Chọn Claude Code, Codex hoặc PandaCode và chọn thư mục làm việc của dự án.
  4. Bắt đầu một phiên. Nếu engine yêu cầu bạn đăng nhập, hãy hoàn tất ủy quyền của nhà cung cấp đó trên host hoặc thông qua luồng đăng nhập được hiển thị.
  5. Gửi một prompt thử nghiệm không phá hoại như: Show the current working directory and list the top-level files. Do not edit anything.

Bạn đã được kết nối đầy đủ khi câu trả lời nêu đúng thư mục dự án mong đợi, danh sách tệp khớp với host, và bất kỳ câu hỏi cấp quyền nào đều xuất hiện trên client từ xa để bạn phê duyệt hoặc từ chối.

5. Xác nhận hành vi kết nối lại

Đóng client đang xem, đợi vài giây, rồi mở lại cùng phiên đó. Lịch sử hiện có sẽ trở lại và host sẽ vẫn trực tuyến. Thao tác này kiểm tra đường dẫn từ xa thực tế thay vì chỉ chứng minh rằng trình cài đặt đã tải xuống thành công.

Không đưa host vào chế độ ngủ trong quá trình kiểm tra này. Một host đang ngủ hoặc đã tắt nguồn không thể chạy agent dù kết nối đã lưu vẫn xuất hiện trong tài khoản của bạn.

Khắc phục sự cố

Máy không xuất hiện trong Agent

Chạy pandapaw status trên host. Nếu cài đặt thành công nhưng chưa có tài khoản nào được gắn, hãy chạy pandapaw login. Nếu bạn đã dùng khóa được chuẩn bị sẵn và khóa đó đã được sử dụng hoặc hết hạn, hãy tạo khóa mới trong Thiết bị đã kết nối và chạy lại lệnh được hiển thị.

`pandapaw` không được nhận diện

Mở một terminal mới. Trên macOS/Linux, xác nhận rằng ~/.local/bin nằm trong PATH. Trên Windows, trình cài đặt thêm %LOCALAPPDATA%\Programs\pandapaw vào PATH người dùng; một terminal được mở trước khi cài đặt sẽ không thấy giá trị mới.

Máy được liệt kê nhưng ngoại tuyến

Xác nhận host đã bật nguồn, đang thức và có thể truy cập internet. Sau đó kiểm tra pandapaw status. Tường lửa của doanh nghiệp phải cho phép lưu lượng HTTPS/WebSocket ra ngoài; bạn không nên tạo quy tắc chuyển tiếp cổng vào.

Kết nối hoạt động nhưng engine yêu cầu xác thực

Ghép nối PandaPaw và đăng nhập nhà cung cấp mô hình là riêng biệt. Ghép nối chứng minh host thuộc tài khoản PandaNpc của bạn; Claude Code hoặc Codex vẫn có thể yêu cầu đăng nhập gói đăng ký riêng hoặc cấu hình API. Hoàn tất đăng nhập thông thường của engine, rồi thử lại phiên.

Agent mở sai thư mục

Kết thúc phiên thử nghiệm đó và tạo một phiên với thư mục làm việc mong muốn. Trước khi phê duyệt việc sử dụng công cụ, hãy yêu cầu agent in thư mục hiện tại. Kết nối từ xa không tự động thêm sandbox hệ thống tệp; quyền công cụ của engine và thư mục làm việc đã chọn vẫn quan trọng.

Các bước tiếp theo