PandaNpc 및 PandaPaw 설치

원격 코딩 에이전트 설정에는 두 가지 독립적인 부분이 있습니다:

• PandaNpc 클라이언트 — 세션을 읽고, 프롬프트를 보내고, 도구를 승인하는 데 사용하는 인터페이스입니다. 웹, iOS, Windows, macOS, Linux에서 실행됩니다.
• PandaPaw 호스트 — Claude Code, Codex 또는 PandaCode가 실제로 실행되는 컴퓨터의 백그라운드 서비스입니다.

PandaNpc 채팅 및 로컬 데스크톱 사용에는 클라이언트만 설치하세요. 다른 컴퓨터에서 실행 중인 코딩 에이전트에 연결하려면 두 부분을 모두 설치하세요.

Windows/macOS/Linux 앱이 아래 설치 단계 외에 추가로 제공하는 기능과 릴리스 기록을 보려면 PandaNpc Desktop을 참조하세요.

설치할 항목 선택

가장 빠른 전체 경로를 원한다면 빠른 시작 가이드를 사용하세요.

PandaNpc 클라이언트 설치

최신 설치 프로그램에 대한 정확한 정보는 PandaNpc 다운로드 페이지를 사용하세요. 타사 다운로드 사이트는 오래되었거나 수정된 패키지를 제공할 수 있으므로 피하세요.

웹

최신 브라우저에서 pandanpc.com/agent를 여세요. 설치되는 것은 없습니다. 브라우저 저장소가 로컬 로그인 상태를 유지하므로 시크릿/비공개 창에서는 다시 로그인해야 할 수 있습니다.

iOS

다운로드 페이지의 App Store 링크를 따라 PandaNpc를 설치하세요. iOS는 호스트에서 떨어져 있을 때 진행 상황 확인, 질문에 답변, 도구 승인에 유용합니다. 코딩 프로세스는 여전히 연결된 호스트 머신에서 실행됩니다. 이 앱이 지원하는 기능과 릴리스 기록은 PandaNpc for iOS를 참조하세요.

Windows

1. 최신 Windows 설치 프로그램을 다운로드하세요.
2. 실행하고 설치 프로그램 안내를 따르세요.
3. 시작 메뉴에서 PandaNpc를 실행하세요.
4. Windows에서 게시자 또는 평판 경고가 표시되면 계속하기 전에 파일이 pandanpc.com에서 온 것인지 확인하세요.

macOS

1. macOS .dmg를 다운로드하세요.
2. PandaNpc를 응용 프로그램 폴더로 끌어다 놓으세요.
3. 응용 프로그램 폴더에서 실행하고 macOS 보안 프롬프트를 완료하세요.

macOS 빌드는 유니버설이므로 동일한 패키지가 Apple Silicon 및 Intel Mac을 지원합니다.

Linux

x86_64 AppImage를 다운로드하고 실행 권한을 부여한 다음 실행하세요:

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

AppImage가 시작되지 않으면 터미널에서 한 번 실행하고 정확한 오류 출력을 유지하세요. 오래된 배포판에는 데스크톱 셸에 필요한 런타임 라이브러리가 없을 수 있습니다.

에이전트 호스트에 PandaPaw 설치

PandaPaw는 현재 Windows x, macOS 유니버설, Linux x86_64용 호스트 설치 프로그램을 제공합니다. 프로젝트 파일을 소유하고 에이전트의 도구를 실행해야 하는 컴퓨터에서 명령을 실행하세요.

권장 방법은 연결된 기기입니다: 기기 추가를 선택한 다음 생성된 일회용 명령을 복사하세요. 설치 중에 호스트를 계정과 페어링합니다.

macOS 또는 Linux

브라우저 인증이 포함된 일반 설치 프로그램:

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

준비된 일회용 키 형식:

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

Windows PowerShell

일반 설치 프로그램:

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

준비된 일회용 키 형식:

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

PowerShell의 iwr | iex 파이프라인은 일반 스크립트 인수를 전달할 수 없으므로 Windows 설치 프로그램은 일회용 키를 PANDANET_KEY에서 읽습니다.

호스트 설치 프로그램이 변경하는 사항

설치 프로그램은:

1. PandaPaw를 현재 사용자의 응용 프로그램/bin 디렉터리에 추가하고 필요할 때 사용자 PATH를 업데이트합니다.
2. 자동으로 시작되도록 적절한 백그라운드 서비스를 등록합니다.
3. 플랫폼이 허용하는 경우 누락된 지원 코딩 엔진을 설치합니다.
4. 시스템에 적합한 버전이 없는 경우 전용 Node.js 런타임을 제공합니다.
5. 계정 인증을 시작하거나 준비된 기기 키를 사용합니다.
6. 생성한 파일을 기록하여 제거 시 이미 있던 호환 도구를 보존할 수 있게 합니다.

엔진을 설치해도 모델 구독이 자동으로 구매되거나 인증되지는 않습니다. Claude Code와 Codex는 처음 실행할 때 자체 제공자 로그인을 요청할 수 있습니다.

설치 확인

설치가 끝나면 새 터미널을 열고 다음을 실행하세요:

pandapaw status

그런 다음 PandaNpc Agent를 여세요. 호스트가 온라인으로 표시되어야 합니다. 테스트 프로젝트에서 세션을 시작하고 파일을 변경하지 않고 현재 작업 디렉터리를 보고하도록 요청하세요. 이렇게 하면 다운로드 단계뿐만 아니라 바이너리, 백그라운드 서비스, 계정 페어링, 릴레이 연결, 엔진, 선택한 디렉터리가 모두 확인됩니다.

업데이트

데스크톱 클라이언트는 업데이트가 있으면 알려줍니다. iOS는 App Store를 통해 업데이트됩니다.

PandaPaw를 업데이트하고 관리 서비스를 다시 시작하려면 다음을 실행하세요:

pandapaw update --restart

업데이트 프로그램은 설치된 복사본을 교체하기 전에 다운로드한 바이너리를 게시된 SHA-256 체크섬과 대조하여 검증합니다. 계정 페어링과 기존 연결 ID는 유지됩니다. 업데이트 프로그램 자체를 사용할 수 없는 경우 설치 명령을 다시 실행하는 것도 지원됩니다.

제거

• Windows 클라이언트: 설정 → 앱 → 설치된 앱 → PandaNpc → 제거.
• macOS 클라이언트: PandaNpc를 종료한 다음 응용 프로그램 폴더에서 휴지통으로 이동하세요.
• Linux 클라이언트: AppImage와 해당 항목을 위해 만든 런처를 제거하세요.
• PandaPaw 호스트: 호스트에서 pandapaw uninstall을 실행하세요.

PandaPaw의 제거 매니페스트는 설치 프로그램이 만든 도구와 이미 존재했던 호환 도구를 구분합니다. 기존의 Claude Code, Codex, PandaCode 또는 Node 설치를 삭제하기보다는 의도적으로 보수적으로 동작합니다.

설치 문제

명령은 완료되었지만 호스트가 연결되지 않음

pandapaw login을 실행하세요. 호스트 설치와 계정 인증은 별도의 단계이며, 브라우저 인증이 연기되거나 중단되어도 설치 프로그램은 완료될 수 있습니다.

셸에서 `pandapaw`를 찾을 수 없음

새 터미널을 여세요. macOS/Linux에서는 ~/.local/bin을 확인하고, Windows에서는 %LOCALAPPDATA%\Programs\pandapaw를 확인하세요. 실행 파일이 존재하고 PATH만 오래된 것인지 확인하기 전까지 반복해서 재설치하지 마세요.

코딩 엔진 설치 실패

호스트 설치 프로그램은 선택적 엔진 다운로드를 최선의 노력으로 처리하므로 한 제공자의 장애가 작동 중인 PandaPaw 설치를 망치지 않습니다. 해당 엔진을 공식 설치 프로그램으로 설치하거나 복구하고, 정상적으로 인증한 다음 pandapaw status를 다시 실행하세요.

AppImage 또는 데스크톱 애플리케이션이 열리지 않음

올바른 아키텍처용 패키지를 다운로드했는지 확인한 다음 터미널에서 실행하여 첫 번째 오류를 캡처하세요. 지원팀에 연락할 때 해당 오류와 OS 버전을 포함하세요. 닫힌 창의 스크린샷만으로는 누락된 런타임 라이브러리를 진단하기에 부족한 경우가 많습니다.

호스트별 연결 확인은 PandaPaw 가이드 또는 FAQ에서 계속하세요.