이 답변은 현재 계정 기반 PandaPaw 설정을 다룹니다. 처음 설치하는 경우 빠른 시작 가이드를 따르세요. 명령어와 실제 성공 확인 방법이 포함되어 있습니다.
일반
PandaNpc란 무엇인가요?
PandaNpc는 코딩 에이전트를 위한 원격 인터페이스이자 오케스트레이션 계층입니다. Claude Code, Codex 또는 PandaCode는 사용자가 제어하는 머신에서 실행되고, 웹, 데스크톱, iOS, Chrome 클라이언트에서 출력을 읽고, 지시를 보내고, 도구를 승인하고, 세션을 재개할 수 있습니다. PandaNpc에는 다중 모델 채팅, 메모, 예약 작업, Agent Center 및 MCP 도구도 포함됩니다.
PandaNpc가 Claude Code 또는 Codex를 대체하나요?
아니요. PandaNpc는 해당 엔진을 제어하고 그 주변에 크로스 디바이스 워크플로우를 추가합니다. 실제 엔진은 호스트에 설치되고 인증되어야 합니다. PandaCode는 OpenAI 또는 Anthropic 호환 모델 백엔드를 직접 선택하려는 경우 번들로 제공되는 대안입니다.
어떤 플랫폼이 지원되나요?
PandaNpc 클라이언트는 웹, iOS, Windows, macOS, Linux에서 사용할 수 있습니다. PandaPaw 호스트 설치 프로그램은 현재 Windows x64, macOS universal, Linux x86_64를 지원합니다. 패키지 세부 정보와 확인 단계는 설치를 확인하세요.
PandaNpc 계정이 필요한가요?
예, 계정 기반 호스트 페어링, 공유 Agent Center 구성, 여러 기기에서 연결된 머신에 대한 접근에 필요합니다. 이메일 코드, Google, GitHub 로그인이 지원됩니다. Claude Code 또는 Codex에서 사용하는 모델 제공자는 별도의 계정입니다.
원격 Claude Code, Codex 및 PandaCode
새 머신을 어떻게 연결하나요?
로그인하고 연결된 기기를 연 다음 기기 추가를 선택하세요. 생성된 일회성 명령을 호스트에서 실행하세요. 머신은 설치 중에 페어링된 후 PandaNpc Agent에 자동으로 나타납니다.
일반 설치 프로그램도 계속 사용할 수 있으며 브라우저 인증을 위해 pandapaw login을 실행합니다. pandapaw qr은 이전 또는 특수 연결을 수동으로 추가하기 위한 호환 경로이며, 새 호스트의 기본 설정이 아닙니다. 일반적으로 Bridge ID와 토큰을 수동으로 복사하지 않아야 합니다.
호스트 머신이 계속 켜져 있어야 하나요?
예. 코딩 엔진과 해당 도구는 그 호스트에서 실행됩니다. PandaPaw는 재부팅 후 자동으로 시작될 수 있지만, 컴퓨터가 꺼져 있거나 절전 모드인 동안 세션을 유지할 수는 없습니다. 전용 서버 또는 장기 실행 작업에 맞게 절전 동작을 적절히 구성하세요.
포트를 열거나 공인 IP가 필요한가요?
일반적으로 아닙니다. 호스트와 뷰잉 클라이언트가 아웃바운드 연결을 시작합니다. PandaNpc를 작동시키기 위해 SSH, 릴레이 포트 또는 로컬 모델 엔드포인트를 공개 인터넷에 노출하지 마세요. 제한적인 기업 네트워크에서는 여전히 아웃바운드 HTTPS 및 WebSocket 트래픽을 허용해야 할 수 있습니다.
동일한 호스트를 휴대폰, 브라우저, 데스크톱에서 제어할 수 있나요?
예. 동일한 PandaNpc 계정으로 로그인하고 저장된 연결을 여세요. 클라이언트는 동일한 원격 호스트와 세션 상태를 표시합니다. 도구 실행은 어떤 뷰잉 기기가 지시를 보내는지와 관계없이 호스트에서 유지됩니다.
뷰잉 기기가 연결이 끊기면 어떻게 되나요?
PandaPaw와 클라이언트는 재연결을 시도하며, 저장된 세션은 기록과 함께 다시 열 수 있습니다. 공백 동안 에이전트가 계속 생성하는지 여부는 엔진과 네트워크 실패 시점에 따라 다릅니다. 재연결 후, 부작용이 있을 수 있는 작업을 반복하기 전에 마지막으로 완료된 도구 호출을 확인하세요.
머신이 목록에 표시되는데 오프라인인 이유는 무엇인가요?
순서대로 확인하세요:
- 호스트가 켜져 있고 깨어 있습니다.
pandapaw status가 서비스와 계정을 인식합니다.- 호스트가 인터넷에 연결될 수 있습니다.
- 방화벽이 아웃바운드 WebSocket/HTTPS 트래픽을 차단하지 않습니다.
- 기기 키 또는 로그인이 현재 보고 있는 동일한 PandaNpc 계정으로 완료되었습니다.
인증 없이 설치가 성공했다면 pandapaw login을 실행하세요. 첫 번째 문제 해결 단계로 인바운드 포트 전달 규칙을 만들지 마세요.
PandaNpc가 기존 Claude Code 또는 Codex 설치를 사용할 수 있나요?
예. 설치 프로그램은 호환되는 엔진을 감지하여 재사용합니다. 제거 매니페스트는 보수적입니다. PandaPaw 이전에 존재했던 도구는 pandapaw uninstall로 제거되지 않아야 합니다.
모델, 구독 및 비용
원격 코딩 세션 비용을 지불하는 계정은 무엇인가요?
호스트에서 엔진에 대해 구성된 계정입니다. 원격 Claude Code는 해당 Claude 구독 또는 백엔드를 사용하고, 원격 Codex는 해당 ChatGPT/Codex 로그인 또는 제공자를 사용하며, PandaCode는 선택한 제공자를 사용합니다. PandaNpc 서비스 요금제와 모델 제공자 비용은 별개입니다. 계정, 요금제 및 AI 청구를 참조하세요.
DeepSeek, Qwen, Kimi 또는 사설 엔드포인트를 사용할 수 있나요?
예, 엔드포인트가 지원되는 OpenAI 또는 Anthropic 호환 프로토콜을 사용하는 경우 PandaCode 또는 PandaNpc 사용자 지정 제공자 구성을 통해 가능합니다. 호환성은 URL을 수락하는 것 이상입니다. 모델 식별자, 인증 헤더, 스트리밍 응답, 도구 호출, 컨텍스트 한도, 출력 한도가 업스트림 서비스와 일치해야 합니다.
PandaNpc는 API Key 없이 AI 모델을 포함하나요?
PandaNpc 내장 채팅은 제공되는 모델 집합을 변경하며 노출합니다. 라이브 선택기가 현재 가용성과 계정 자격에 대한 권위 있는 정보입니다. 이는 일반적으로 엔진 자체 자격 증명을 사용하는 원격 Claude Code 또는 Codex 프로세스와 별개입니다. 지원되는 AI 모델을 참조하세요.
사용자 지정 제공자가 데스크톱에서는 작동하는데 브라우저에서는 실패하는 이유는 무엇인가요?
데스크톱 클라이언트는 네이티브 HTTP 요청을 할 수 있지만, 브라우저는 CORS 및 혼합 콘텐츠 규칙을 따라야 합니다. 웹에서 사용할 때 제공자는 pandanpc.com 출처와 HTTPS를 허용해야 합니다. 또한 localhost는 브라우저를 실행하는 기기를 의미하며, 원격 PandaPaw 호스트가 아님을 기억하세요.
보안 및 공유
명령과 파일 편집은 어디에서 실행되나요?
선택한 호스트 머신에서 실행됩니다. 원격 클라이언트는 지시와 승인을 보냅니다. 프로젝트 전체를 뷰잉 기기로 복사하지는 않습니다. 프롬프트와 참조된 콘텐츠는 선택한 모델 제공자에게 전송될 수 있으며, 원격으로 표시하려면 세션 데이터가 릴레이를 통과해야 합니다. 권위 있는 데이터 설명은 개인정보 처리방침을 읽으세요.
연결 공유는 읽기 전용인가요?
아니요. 연결 공유는 수신자가 해당 에이전트 연결을 구동할 수 있게 하며, 세션에서 사용할 수 있는 도구와 작업 디렉터리를 포함합니다. 보기 전용 접근이 필요하면 대신 세션 기록을 공유하세요. 접근을 허용하기 전에 연결 공유를 읽으세요.
기기 또는 공유 연결을 해지할 수 있나요?
예. 연결된 기기에서 인식되지 않는 호스트를 제거하고 관리 화면에서 활성 연결 공유를 해지하세요. 해지는 해당 자격 증명의 향후 사용을 차단합니다. 호스트에서 이미 실행된 명령이나 파일 변경을 되돌리지는 않습니다.
지원팀에 어떤 정보를 보내야 하나요?
호스트 운영 체제, PandaPaw 버전, 실패한 명령, 정확한 오류 텍스트, 문제가 웹, 데스크톱 또는 iOS에서 발생하는지 여부를 포함하세요. 이메일 인증 코드, 계정 토큰, 기기 키, API Key, 내부 IP 주소, 비공개 저장소 URL 및 문제 재현에 필요하지 않은 소스 코드는 제거하세요.
릴리스별 동작은 PandaPaw 버전 기록을 확인하세요. 여기에서 답변되지 않은 도움이 필요하면 support@pandanpc.com으로 이메일을 보내세요.