문제 해결

대부분의 문제는 금방 해결됩니다. 여기에 없는 문제라면 OS, PATerminal 버전(설정 → 업데이트), 시도해 본 내용을 적어 지원팀에 이메일을 보내 주세요.

PATerminal v1.8.3 기준

설치하고 열기

Windows: “Windows의 PC 보호”
추가 정보를 클릭한 뒤 실행을 누르세요. SmartScreen은 새로 나온 앱에 경고를 표시합니다. 확실히 하고 싶다면 Windows 설치 가이드의 SHA-256과 비교하세요.
macOS가 열기 전에 확인을 요청함
열기를 선택하세요. 앱은 Developer ID로 서명되어 있고 Apple의 공증을 받았습니다.

Git 오류가 표시됨

컴퓨터 환경 때문에 git이 동작하지 않으면 PATerminal이 이 컴퓨터에서 Git을 실행할 수 없습니다와 함께 해결 방법을 보여 줍니다. 흔한 경우는 다음과 같습니다.

원인해결 방법
macOS: Xcode 라이선스 미동의(Xcode 업데이트 직후에 자주 발생)sudo xcodebuild -license accept
macOS: Command Line Tools가 없거나 손상됨xcode-select --install
Git이 설치되지 않음Git을 설치하세요(Windows: winget install Git.Git). PATerminal이 자동으로 인식합니다.
다른 드라이브나 네트워크 공유에서 “dubious ownership”git config --global --add safe.directory <path> — 신뢰하는 폴더에만 사용하세요.
Windows: 경로가 너무 김git config --global core.longpaths true

풀 리퀘스트나 이슈가 로드되지 않음

gh가 설치되어 있고 로그인되어 있는지(gh auth status), 저장소에 GitHub 원격이 있는지 확인하세요. 해결한 뒤 다시 시도를 누르세요.

세션이 계속 “실행 중”으로 남음

  • 개발 서버, 감시 프로세스, 스피너 등 무언가가 아직 출력하고 있습니다. 실제 출력이므로 상태는 정확합니다.
  • PATerminal이 tui.whimsy = false를 저장하기 전에 시작된 Codex 0.154.0 이상: 그 Codex 세션을 재시작하세요. 프로젝트 수준이나 명령줄에서 명시적으로 지정한 설정이 이를 덮어쓸 수 있습니다. Codex 사용자를 위한 참고를 확인하세요.

알림이 오지 않음

  • 설정 → 알림이 켜져 있는지 확인하세요.
  • OS 설정에서 PATerminal의 알림을 허용하고, 집중 모드 / 방해 금지 모드를 확인하세요.
  • 알림은 보고 있지 않은 세션에 대해서만 보내집니다.

대화가 재개되지 않음

  • 에이전트가 대화를 저장하기 전에 종료되었을 수 있습니다. 대신 기록에서 여세요.
  • Claude Code를 관련 없는 폴더로 옮기려면 Claude Code v2.1.223 이상이 필요합니다.
  • 원래 명령줄에서만 지정한 옵션은 다시 적용되지 않습니다.

업데이트가 실패함

서명된 업데이트를 설치할 수 없으면 PATerminal은 재시작하지 않으며 아무것도 바뀌지 않습니다. 나중에 다시 시도하거나, 다운로드 페이지에서 최신 설치 프로그램을 받아 현재 버전 위에 설치하세요. 세션과 설정은 그대로 유지됩니다.

데이터는 어디에 있나요?

세션, 그룹, 메모, 상용구, 설정은 컴퓨터의 로컬 파일로 저장되며, 에이전트 대화는 에이전트 자체 폴더(예: ~/.claude, ~/.codex)에 남습니다. 서버와 동기화되는 것은 없으며 PATerminal에는 텔레메트리가 없습니다.

아직 해결되지 않았나요?

FAQ를 확인하거나 OS, PATerminal 버전, 시도해 본 내용을 적어 이메일로 문의해 주세요. 모든 메일에 답장해 드립니다.

FAQ 보기지원팀에 이메일 보내기