이 가이드는 한 대의 컴퓨터를 PandaNpc Work에 연결하고 다른 기기에서 Claude Code, Codex 또는 PandaCode를 실행할 수 있는지 확인합니다. PandaNpc Work는 여러 엔진을 지원하는 AI 워크스페이스로, 작업을 위임하고 여러 기기에서 이를 추적할 수 있습니다. 에이전트는 여전히 연결된 컴퓨터에서 실행됩니다. PandaPaw는 브리지와 로컬 런타임을 제공하고, PandaNpc Work는 메시지, 승인, 질문 및 세션 기록을 위한 동기화된 인터페이스를 제공합니다.
이 경로는 Claude Code, Codex 또는 유사한 코딩 에이전트에 이미 익숙한 사람에게 가장 적합합니다. 대부분의 사용자는 기기 추가 흐름을 사용해야 합니다. 이 흐름은 계정에 이미 연결된 일회성 설치 명령을 생성합니다. 약 5분 정도 시간을 두고, 코딩 엔진에서 요구하는 모델 제공자 로그인 시간도 고려하세요. 컴퓨터를 연결하기 전에 Agent 인터페이스를 살펴보려면 브라우저에서 PandaNpc Agent를 여세요.
시작하기 전에
필요한 것:
- 웹 앱, 데스크톱 앱 또는 iOS 앱에서 열린 PandaNpc 계정.
- Windows x64, macOS 또는 Linux x86_64를 실행하는 연결된 컴퓨터.
- 호스트의 인터넷 액세스 및 사용자 수준 백그라운드 서비스를 설치할 권한.
- 수정이 허용된 프로젝트 폴더.
- 선택한 엔진이 아직 인증되지 않은 경우 Claude, ChatGPT/Codex 또는 사용자 정의 모델 계정.
이미 연결된 호스트를 보기만 하려면 보는 기기에 클라이언트를 설치하거나 여세요. PandaPaw는 에이전트를 실행하는 컴퓨터에 있어야 합니다. 클라이언트와 호스트 역할은 Installation을 참조하세요.
1. 호스트 설치 명령 생성
로그인한 상태에서 연결된 기기를 열고 기기 추가를 선택하세요. PandaNpc는 일회성 기기 키를 생성하고 운영 체제에 맞는 정확한 명령을 표시합니다.
코딩 에이전트를 실행할 컴퓨터에 해당 명령을 복사하세요. 사용될 때까지 비밀번호처럼 취급하세요. 일회성 키는 한 대의 컴퓨터를 페어링하며, 채팅, 스크린샷, 이슈 또는 셸 기록 내보내기에 게시해서는 안 됩니다.
준비된 키 대신 브라우저 인증을 선호하는 경우, 다음 단계에서 일반 설치 프로그램을 사용하세요. 이는 pandapaw login을 실행하고 인증 페이지를 열어줍니다.
2. 호스트에 PandaPaw 설치
macOS 또는 Linux
연결된 기기에서 준비된 명령을 실행하거나 일반 설치 프로그램을 사용하세요:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | shWindows PowerShell
연결된 기기에서 준비된 명령을 실행하거나 다음을 사용하세요:
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex설치 프로그램은 PandaPaw와 백그라운드 서비스를 추가하고, 가능한 경우 누락된 지원 코딩 엔진을 설치하며, 호스트에 적합한 Node.js 런타임이 없으면 비공개 Node.js 런타임을 제공합니다. 준비된 기기 키를 사용하면 설치 중에 계정 페어링이 이루어집니다. 일반 명령을 사용하면 메시지가 표시될 때 브라우저 인증 요청을 승인하세요.
계정 인증이 연기되더라도 설치 프로그램이 완료될 수 있습니다. 설치가 성공했다고 표시되지만 계정 연결이 완료되지 않은 경우 다음을 실행하세요:
pandapaw login3. 호스트 서비스 확인
호스트에서 다음을 실행하세요:
pandapaw status이 명령은 설치된 서비스를 인식하고 계정에 연결된 컴퓨터를 표시해야 합니다. 셸에서 pandapaw를 찾을 수 없으면 먼저 새 터미널을 열어 업데이트된 사용자 PATH를 다시 로드하세요.
Git 프로젝트의 경우 Agent Center가 프로젝트 루트를 인식하는지 확인할 수도 있습니다:
pandapaw agent status --root /path/to/your/project실제 절대 프로젝트 경로를 사용하세요. Agent Center 프로젝트 바인딩은 디렉터리에 안정적인 Git remote.origin.url이 있을 때 가장 잘 작동합니다.
4. 첫 번째 원격 세션 시작
- 휴대폰, 브라우저 또는 다른 데스크톱에서 PandaNpc Agent를 여세요.
- 새로 연결된 컴퓨터를 찾으세요. 녹색 상태 표시기는 호스트에 현재 연결할 수 있음을 의미합니다.
- Claude Code, Codex 또는 PandaCode를 선택하고 프로젝트 작업 디렉터리를 선택하세요.
- 세션을 시작하세요. 엔진에서 로그인을 요청하면 호스트에서 또는 표시된 로그인 흐름을 통해 해당 제공자의 인증을 완료하세요.
- 다음과 같은 비파괴 테스트 프롬프트를 보내세요:
Show the current working directory and list the top-level files. Do not edit anything.
응답에 예상 프로젝트 디렉터리가 명시되고, 파일 목록이 호스트와 일치하며, 모든 권한 질문이 원격 클라이언트에 나타나 승인 또는 거부할 수 있으면 완전히 연결된 것입니다.
5. 재연결 동작 확인
보는 클라이언트를 닫고 몇 초 기다린 후 동일한 세션을 다시 여세요. 기존 기록이 반환되고 호스트가 온라인 상태로 유지되어야 합니다. 이는 설치 프로그램이 성공적으로 다운로드되었음을 증명하는 대신 실제 원격 경로를 확인합니다.
이 테스트 중에는 호스트를 절전 모드로 전환하지 마세요. 절전 모드이거나 전원이 꺼진 호스트는 저장된 연결이 계정에 계속 표시되더라도 에이전트를 실행할 수 없습니다.
문제 해결
컴퓨터가 Agent에 나타나지 않음
호스트에서 pandapaw status를 실행하세요. 설치가 성공했지만 계정이 연결되지 않은 경우 pandapaw login을 실행하세요. 준비된 키를 사용했는데 이미 사용되었거나 만료된 경우 연결된 기기에서 새 키를 생성하고 표시된 명령을 다시 실행하세요.
`pandapaw`가 인식되지 않음
새 터미널을 여세요. macOS/Linux에서는 ~/.local/bin이 PATH에 있는지 확인하세요. Windows에서는 설치 프로그램이 %LOCALAPPDATA%\Programs\pandapaw를 사용자 PATH에 추가합니다. 설치 전에 열린 터미널은 새 값을 보지 못합니다.
컴퓨터가 나열되지만 오프라인임
호스트의 전원이 켜져 있고, 깨어 있으며, 인터넷에 연결할 수 있는지 확인하세요. 그런 다음 pandapaw status를 확인하세요. 기업 방화벽은 아웃바운드 HTTPS/WebSocket 트래픽을 허용해야 합니다. 인바운드 포트 포워딩 규칙을 만들면 안 됩니다.
연결은 작동하지만 엔진이 인증을 요청함
PandaPaw 페어링과 모델 제공자 로그인은 별개입니다. 페어링은 호스트가 PandaNpc 계정에 속함을 증명합니다. Claude Code 또는 Codex는 여전히 자체 구독 로그인 또는 API 구성이 필요할 수 있습니다. 엔진의 일반 로그인을 완료한 후 세션을 다시 시도하세요.
에이전트가 잘못된 폴더에서 열림
해당 테스트 세션을 종료하고 의도한 작업 디렉터리로 새 세션을 만드세요. 도구 사용을 승인하기 전에 에이전트에게 현재 디렉터리를 출력하도록 요청하세요. 원격 연결은 그 자체로 파일 시스템 샌드박스를 추가하지 않습니다. 엔진의 도구 권한과 선택한 작업 디렉터리는 여전히 중요합니다.
다음 단계
- 업데이트, 서비스 확인 및 연결 아키텍처에 대한 자세한 내용은 PandaPaw 호스트 가이드를 읽어보세요.
- 각 세션에 대해 어떤 구독 또는 제공자가 비용을 지불하는지 이해하려면 계정 및 결제를 검토하세요.
- OpenAI 호환 엔드포인트, 자체 호스팅 모델 또는 별도의 API 키를 원할 때 사용자 정의 AI 제공자를 추가하세요.