이 가이드는 하나의 개발 머신을 PandaNpc에 연결하고 다른 기기에서 Claude Code, Codex 또는 PandaCode를 실행할 수 있는지 확인합니다. 에이전트는 여전히 개발 머신에서 실행됩니다. PandaNpc는 메시지, 승인, 질문 및 세션 기록을 위한 동기화된 원격 인터페이스를 제공합니다.
대부분의 사용자는 기기 추가 흐름을 사용해야 합니다. 이 흐름은 사용자 계정에 이미 연결된 일회성 설치 명령을 생성하기 때문입니다. 약 5분 정도 소요되며, 코딩 엔진에 필요한 모델 제공자 로그인이 추가로 필요할 수 있습니다.
시작하기 전에
필요한 항목:
- 웹 앱, 데스크톱 앱 또는 iOS 앱에서 열린 PandaNpc 계정.
- Windows x64, macOS 또는 Linux x86_64를 실행하는 호스트.
- 호스트에서 인터넷에 접속할 수 있어야 하며 사용자 수준 백그라운드 서비스를 설치할 권한이 있어야 합니다.
- 수정할 수 있는 프로젝트 폴더.
- 선택한 엔진이 아직 인증되지 않은 경우 Claude, ChatGPT/Codex 또는 사용자 지정 모델 계정.
PandaNpc의 기본 제공 채팅만 필요하고 다른 머신에서 에이전트를 제어하고 싶지 않다면 PandaPaw는 필요하지 않습니다. 클라이언트 전용 옵션은 설치를 참조하세요.
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실제 절대 프로젝트 경로를 사용하세요. 디렉터리에 안정적인 Git remote.origin.url이 있으면 Agent Center 프로젝트 연결이 가장 잘 작동합니다.
4. 첫 번째 원격 세션 시작
- 휴대폰, 브라우저 또는 다른 데스크톱에서 PandaNpc Agent를 엽니다.
- 새로 연결된 머신을 찾습니다. 녹색 상태 표시기는 호스트에 현재 연결할 수 있음을 의미합니다.
- Claude Code, Codex 또는 PandaCode를 선택하고 프로젝트 작업 디렉터리를 선택합니다.
- 세션을 시작합니다. 엔진에서 로그인을 요청하면 호스트에서 또는 표시된 로그인 흐름을 통해 해당 제공자의 인증을 완료하세요.
- 비파괴적인 테스트 프롬프트를 보내세요(예:
현재 작업 디렉터리를 표시하고 최상위 파일을 나열하세요. 아무것도 편집하지 마세요.).
응답에 예상 프로젝트 디렉터리가 표시되고, 파일 목록이 호스트와 일치하며, 원격 클라이언트에 승인하거나 거부할 권한 질문이 표시되면 완전히 연결된 것입니다.
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 key를 원할 때 사용자 지정 AI 제공자를 추가하세요.