Bắt đầu nhanh: Chạy Claude Code hoặc Codex từ xa

Cập nhật

Hướng dẫn này kết nối một máy phát triển với PandaNpc 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. Tác tử vẫn thực thi trên máy phát triển của bạn; PandaNpc cung cấp cho bạn một giao diện từ xa đồng bộ để xem tin nhắn, phê duyệt, câu hỏi và lịch sử phiên.

Hầu hết mọi người nên sử dụng quy trình Thêm thiết bị vì nó tạo ra một lệnh cài đặt một lần đã liên kết với tài khoản của bạn. Dành khoảng năm phút, cộng với thời gian đăng nhập nhà cung cấp mô hình mà công cụ lập trình của bạn yêu cầu.

Trước khi bắt đầu

Bạn cần:

  • Một tài khoản PandaNpc được 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 chủ chạy Windows x64, macOS, hoặc Linux x86_64.
  • Quyền truy cập Internet từ máy chủ và quyền cài đặt mộ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 sửa đổi.
  • Một tài khoản Claude, ChatGPT/Codex, hoặc mô hình tùy chỉnh nếu công cụ bạn chọn chưa được xác thực.

Nếu bạn chỉ cần tính năng trò chuyện tích hợp của PandaNpc và không muốn điều khiển một tác tử trên máy khác, PandaPaw là không bắt buộc. Xem Cài đặt để biết các tùy chọn chỉ dành cho máy khách.

1. Tạo lệnh cài đặt máy chủ

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 một khóa thiết bị 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 mà tác tử lập trình sẽ chạy. Hãy coi nó như mật khẩu cho đến khi được sử dụng: khóa một lần chỉ ghép nối một máy và không nên được đăng trong chat, ảnh chụp màn hình, vấn đề, hoặc xuất lịch sử shell.

Nếu bạn thích ủy quyền qua trình duyệt thay vì khóa đã chuẩn bị, hãy sử dụng trình cài đặt thông thường trong 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 máy chủ

macOS hoặc Linux

Chạy lệnh đã chuẩn bị từ Thiết bị đã kết nối, hoặc sử 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 đã chuẩn bị từ Thiết bị đã kết nối, hoặc sử 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 công cụ lập trình được hỗ trợ còn thiếu nếu có thể, và cung cấp một môi trường chạy Node.js riêng khi máy chủ không có môi trường phù hợp. Với khóa thiết bị đã chuẩn bị, 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 qua trình duyệt khi được nhắc.

Trình cài đặt có thể hoàn tất ngay cả khi việc ủy quyền tài khoản bị hoãn lại. Nếu nó báo rằng 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ụ máy chủ

Trên máy chủ, chạy:

bash
pandapaw status

Lệnh này phải 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.

Đối với một dự án Git, bạn cũng có thể kiểm tra xem Trung tâm tác tử có nhận diện thư mục gốc của dự án hay không:

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

Sử dụng một đường dẫn tuyệt đối thực cho dự án. Việc liên kết dự án trong Trung tâm tác tử hoạt động tốt nhất khi thư mục có một remote.origin.url Git ổn định.

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

  1. Mở Tác tử PandaNpc trên điện thoại, trình duyệt, hoặc máy tính để bàn khác.
  2. Tìm máy vừa kết nối. Một chỉ báo trạng thái màu xanh lá nghĩa là máy chủ hiện đang truy cập được.
  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 công cụ 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 máy chủ hoặc thông qua quy trình đăng nhập được hiển thị.
  5. Gửi một lời nhắc thử nghiệm không phá hủy như: Show the current working directory and list the top-level files. Do not edit anything.

Bạn đã kết nối hoàn toàn khi câu trả lời nêu tên thư mục dự án dự kiến, danh sách tệp khớp với máy chủ và bất kỳ câu hỏi cấp quyền nào xuất hiện trên máy khách 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 máy khách đang xem, chờ vài giây và mở lại phiên tương tự. Lịch sử hiện có sẽ quay lại và máy chủ sẽ vẫn trực tuyến. Điều 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 đặt máy chủ ở chế độ ngủ trong khi kiểm tra. Một máy chủ đang ngủ hoặc đã tắt nguồn không thể chạy tác tử ngay cả khi kết nối đã lưu vẫn xuất hiện trong tài khoản của bạn.

Xử lý sự cố

Máy không xuất hiện trong Tác tử

Chạy pandapaw status trên máy chủ. Nếu cài đặt thành công nhưng không có tài khoản được đính kèm, hãy chạy pandapaw login. Nếu bạn đã sử dụng khóa đã chuẩn bị và nó đã được sử dụng hoặc hết hạn, hãy tạo một 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 máy chủ đang bật nguồn, thức và có thể truy cập Internet. Sau đó kiểm tra pandapaw status. Tường lửa của công ty phải cho phép lưu lượng HTTPS/WebSocket đi ra; bạn không nên tạo quy tắc chuyển tiếp cổng đi vào.

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

Việ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 máy chủ thuộc về 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 đăng ký riêng hoặc cấu hình API. Hoàn tất quy trình đăng nhập thông thường của công cụ, sau đó thử lại phiên.

Tác tử mở trong thư mục sai

Kết thúc phiên kiểm tra đó và tạo một phiên với thư mục làm việc dự định. Trước khi phê duyệt việc sử dụng công cụ, hãy yêu cầu tác tử in thư mục hiện tại. Một kết nối từ xa không tự động thêm môi trường cô lập hệ thống tệp; quyền công cụ và thư mục làm việc đã chọn của công cụ vẫn quan trọng.

Các bước tiếp theo