PandaNpc 데스크톱은 Windows, macOS, Linux용 네이티브 애플리케이션입니다. 웹 앱과 동일한 채팅, 세션, 에이전트 센터 경험을 제공하며, 브라우저 탭으로는 할 수 없는 두 가지를 추가로 제공합니다. Claude Code, Codex 또는 PandaCode를 로컬에서 에이전트 호스트로 실행할 수 있고, 일반 설치 앱처럼 계속 작동한다는 점입니다 — 독 또는 작업 표시줄 아이콘, 네이티브 알림, 그리고 브라우저를 닫고 다시 열어도 유지되는 창이 있습니다.
코딩 에이전트를 실제로 실행하려는 머신에서 데스크톱 앱을 사용하고, 브라우저 탭보다 지속적인 창을 선호하거나, 페이지를 계속 열어 두는 대신 네이티브 업데이트 및 알림 동작을 원할 때 데스크톱 앱을 사용하세요.
데스크톱 앱 또는 PandaPaw 호스트 — 차이점
이 둘은 서로 다른 문제를 해결하며 함께 사용되는 경우가 많습니다.
- PandaNpc 데스크톱은 클라이언트입니다. 보고 입력하는 창입니다. 모든 플랫폼(웹, iOS, 데스크톱)이 이러한 종류의 클라이언트 역할을 할 수 있습니다.
- **PandaPaw**는 호스트 서비스입니다. 누군가 지금 보고 있든 없든, 머신에서 실제로 Claude Code, Codex 또는 PandaCode를 백그라운드로 실행하는 것이 바로 이것입니다.
데스크톱 앱은 같은 컴퓨터에서 실행 중인 PandaPaw 호스트 또는 완전히 다른 머신에서 실행 중인 호스트와 통신할 수 있습니다. PandaNpc의 다른 모든 곳에서 사용되는 동일한 계정 기반 연결된 기기 흐름입니다. 원격 호스트의 뷰어로 데스크톱 앱을 사용하기 위해 PandaPaw를 설치할 필요는 없습니다.
플랫폼 지원
| 플랫폼 | 패키지 | 아키텍처 |
|---|---|---|
| Windows | NSIS 설치 프로그램 (.exe) |
x86_64 |
| macOS | 범용 .dmg |
Apple Silicon 및 Intel, 단일 패키지 |
| Linux | AppImage | x86_64 |
설치 프로그램에는 서명이 있습니다. Windows 빌드에는 EV 코드 서명 인증서가 포함되어 있고 macOS 빌드는 Apple의 공증을 받았으므로 공식 다운로드 페이지에서 받은 경우 새 설치 시 인식할 수 없는 게시자 경고가 표시되지 않아야 합니다.
설치 및 업데이트
각 플랫폼의 단계별 설치 프로그램 지침은 PandaNpc 및 PandaPaw 설치를 따르세요. 설치가 완료되면 데스크톱 앱은 실행 시 업데이트를 확인하고 제자리에 설치하도록 제안합니다. 일상적인 업데이트를 위해 설치 프로그램을 다시 다운로드할 필요는 없습니다.
각 플랫폼은 독립적으로 릴리스됩니다. Windows, macOS, Linux 빌드가 동일한 시점에 서로 다른 버전 번호를 갖는 것은 정상입니다. 한 플랫폼의 패키징에만 영향을 미치는 수정 사항은 다른 두 플랫폼을 다시 빌드할 필요가 없습니다. 데스크톱 앱 버전 기록을 확인하여 해당 플랫폼에 무엇이 언제 출시되었는지 확인하세요.
웹 앱 대신 데스크톱 앱을 사용하는 이유
둘 다 동일한 기본 인터페이스를 공유하므로 기능 면에서 데스크톱 전용은 없습니다. 데스크톱 앱은 다음을 추가합니다.
- 다른 설치 앱처럼 동작하는 지속적인 창 — 브라우저 탭이 열려 있는 상태에 의존하지 않으며 브라우저 다시 시작이나 충돌에도 유지됩니다.
- 네이티브 OS 통합 — 브라우저 알림 권한 대신 작업 표시줄/독 표시, 창 관리, 플랫폼에 적합한 알림.
- 같은 앱 내 로컬 에이전트 호스트. 사용자가 앉아 있는 바로 그 머신에서 Claude Code, Codex 또는 PandaCode를 실행하려는 경우 데스크톱 앱은 동일한 설치를 통해 클라이언트이자 연결된 호스트가 될 수 있으며 별도의 터미널 세션이 필요하지 않습니다.
아무것도 설치하지 않으려는 머신에서 주로 원격 세션을 확인한다면 웹 클라이언트가 설치할 것 없이 동일한 계정과 세션을 처리합니다.
보안 경계
데스크톱 앱 자체는 연결된 에이전트 세션이 할 수 있는 작업을 확장하지 않습니다. PandaPaw의 보안 경계에 설명된 동일한 도구 승인 및 작업 디렉터리 규칙이 어느 클라이언트에서 보든 적용됩니다. 데스크톱 앱을 설치해도 인바운드 네트워크 포트가 열리지 않습니다. 모든 PandaNpc 클라이언트 및 호스트와 마찬가지로 아웃바운드 인증 연결만 만듭니다.
문제 해결
인식할 수 없는 게시자 경고로 설치 프로그램이 차단됨
파일이 미러나 타사 아카이브가 아닌 pandanpc.com에서 다운로드되었는지 확인하세요. 공식 페이지의 서명된 설치 프로그램은 일반적으로 이 경고를 트리거하지 않습니다. 그래도 발생하면 무조건 실행을 선택하는 대신 다시 다운로드하세요.
앱이 열리지만 세션이 표시되지 않음
데스크톱 앱은 클라이언트입니다. 현재 계정에 연결된 호스트(로컬 또는 원격 PandaPaw)의 세션을 표시합니다. 앱 자체가 고장 났다고 가정하기 전에 연결된 기기를 열어 호스트가 온라인인지 확인하세요.
업데이트가 적용되지 않음
앱을 완전히 종료(창을 닫는 것만이 아니라)하고 다시 실행하세요. 업데이트는 다음 전체 시작 시 설치됩니다. 이후 표시되는 버전이 여전히 버전 기록의 최신 항목과 일치하지 않으면 다음 자동 업데이트 주기를 기다리는 대신 다운로드 페이지의 현재 패키지로 재설치하세요.