문제 해결
보이는 상황에서 다음 행동을 찾아보세요.
가장 먼저 확인할 네 가지
- 설정 › 정보에서 설치한 버전을 확인합니다.
- 문제가 나는 실행 환경이 내 PC인지 격리인지 확인합니다.
- 현재 계정의 로그인·사용량과 에이전트 설치 상태를 확인합니다.
- 화면의 마지막 오류와 문제가 생긴 직전 동작을 기록합니다.
앱 화면이 열리지 않습니다
Windows에서는 트레이의 「orke 열기」를 확인하고 Mac에서는 앱을 다시 실행해보세요. desktop companion unavailable이면 데스크톱 구성요소를 시작하지 못한 상태입니다. 설치한 버전과 오류를 알려주세요.
AI가 시작되지 않습니다
일반 터미널에서 그 CLI가 실행되는지 확인합니다. 명령 없음은 설치·PATH, 로그인 필요는 계정, 사용 한도는 사용량 문제입니다. 다른 환경에서 실행한 결과를 같은 상태로 생각하지 마세요.
터미널이 안 보이거나 입력이 안 됩니다
작업 목록에서 세션이 살아 있는지 확인하고 다시 엽니다. AI가 입력이나 승인을 기다리면 해당 터미널의 요청을 읽습니다. 종료 결과가 불명확하면 종료 상태를 다시 확인합니다.
패키지가 멈췄습니다
현재 단계와 실행 기록에서 재시도 대기인지 결정 대기인지 확인합니다. 다시 실행하기 전에 외부에 이미 반영된 결과가 있는지 먼저 읽으세요. Packages의 상황별 안내를 참고하세요.
support에서 답을 받지 못합니다
테스트 탭에서 AI를 먼저 시험하고, 실제 플랫폼 요청에서는 질문 받기·API 입구 상태·주소·키를 확인합니다. MCP가 필요하다면 연결 시험과 그 서버의 인증을 확인합니다. support 안내에서 상황별 처리를 설명합니다.
다른 기기에서 접속이 안 됩니다
PC의 실행·네트워크와 원격 연결 상태를 먼저 확인합니다. 현재 공개 주소와 허용 계정으로 로그인했는지 확인하세요. support API 주소와 화면의 ngrok 주소는 다릅니다.
문의할 때 알려주세요
- orke 버전과 OS 버전
- 사용한 AI와 실행 환경
- 어떤 동작을 했고 무엇을 기대했는지
- 실제로 보인 결과·오류 문구
접속 키·API 키 등 비밀값은 가린 뒤 화면을 공유하세요. 지원 페이지에서 문의할 수 있습니다.