문제 해결
오류 증상에 따라 로그인, 연결, 작업 실행, 파일 전송 문제를 해결하세요.
로그인 실패, 세션 만료, 반복 리디렉션이 발생하면 어떻게 하나요?
먼저 오류 유형을 파악한 뒤 현재 페이지나 데스크톱에서 전체 로그인을 다시 시작하세요.
컴퓨터 연결이 끊기거나 Agent가 연결할 수 없으면 어떻게 하나요?
데스크톱이나 CLI를 각각 복구한 뒤 원래 작업, 선택된 환경, 실행 오류를 확인하세요.
브라우저에서 로그인 성공이 표시되지만 데스크톱 앱으로 돌아오지 않으면 어떻게 하나요?
현재 인증 완료 페이지의 복귀 링크를 사용하고 실패하면 데스크톱 앱에서 다시 시작하세요.
데스크톱에서 로그인 전에 업데이트하라고 하는 이유는 무엇인가요?
이전 버전에 현재 로그인 기능이 없으면 앱을 업데이트해야 합니다. 복귀 URL만 바꿔서는 복구할 수 없습니다.
설치 패키지가 다운로드되지 않거나 열리지 않거나 잘못된 버전을 선택하면 어떻게 하나요?
공식 출처와 대상 아키텍처를 먼저 확인하고 다운로드, 시스템 설치, 로그인 문제를 구분하세요.
자동 업데이트가 실패하거나 재시작 후에도 이전 버전이면 어떻게 하나요?
확인, 다운로드, 설치, 재시작 단계를 구분하고 다시 진행하기 전에 현재 작업을 저장하세요.
데스크톱 앱이 열려 있거나 로그인되었는데도 Agent가 컴퓨터를 사용할 수 없다고 표시하는 이유는 무엇인가요?
로그인, 연결 준비, 작업 권한은 독립된 조건입니다. 현재 선택된 컴퓨터를 먼저 복구하세요.
‘명령 복사’가 실패하거나 붙여 넣으면 자리 표시자가 나오면 어떻게 하나요?
복사 버튼으로 전체 명령을 생성하고 준비 실패와 클립보드 실패를 구분하세요.
터미널에서 node, npx, hackcat-local을 찾을 수 없다고 하면 어떻게 하나요?
대상 터미널의 실행 환경을 먼저 고친 뒤 설정의 표준 명령으로 시작하세요.
Local Agent가 토큰 무효 또는 거부를 보고하면 어떻게 복구하나요?
현재 계정의 명령을 다시 받고 필요할 때 자격 증명을 재설정한 뒤 영향을 받은 연결을 복구하세요.
Local Agent가 서비스 주소 누락이나 잘못된 주소를 안내하면 어떻게 하나요?
현재 설정에서 생성한 전체 명령을 다시 복사하세요. 오래된 문서의 백엔드 매개변수를 이어 붙이지 마세요.
웹사이트는 열리지만 Local Agent가 중계 연결 중 멈추거나 시간 초과되면 어떻게 하나요?
웹페이지 접근과 지속적인 명령 연결을 구분하고 대상 컴퓨터의 네트워크 및 프록시 경로를 확인하세요.
터미널에 연결 한도 도달이 나오면 토큰을 재설정해야 하나요?
이 오류는 명령 연결 용량이 제한되었음을 나타냅니다. 클라이언트 반복 실행을 멈추고 안내에 따라 나중에 다시 시도하세요.
서버가 Local Agent의 반복 무응답을 알리고 연결을 중지하는 이유는 무엇인가요?
연결 기록이 있다고 명령이 여전히 응답한다는 뜻은 아닙니다. 클라이언트를 먼저 재시작하고 원래 작업을 확인하세요.
컴퓨터 절전이나 네트워크 전환 후 데스크톱이 계속 재연결 중이면 어떻게 하나요?
대상 컴퓨터와 네트워크를 먼저 복구한 뒤 데스크톱 연결 복구를 시작하고 원래 작업을 확인하세요.
온라인 컴퓨터가 있는데도 선택한 컴퓨터를 사용할 수 없다고 표시되는 이유는 무엇인가요?
사용 가능한 연결과 현재 선택한 연결은 다릅니다. 특히 이전 작업 복원 시 대상 컴퓨터를 주의해서 확인하세요.
프로젝트에서 데스크톱 연결을 요구하거나 연결된 디렉터리를 사용할 수 없으면 어떻게 하나요?
디렉터리 프로젝트에는 적절한 데스크톱 환경이 필요합니다. 연결과 실제 경로를 먼저 확인하세요.
Agent가 연결되었지만 도구 실행 시 ‘command not found’가 나오면 어떻게 하나요?
대상 호스트의 도구 설치, 경로, 실행 사용자를 확인하세요. 도구 오류를 연결 오류로 오해하지 마세요.
같은 명령이 로컬에서는 실행되지만 Agent에서는 문법 오류가 나는 경우 어떻게 하나요?
Agent가 실제 사용하는 셸을 먼저 확인한 뒤 매개변수, 따옴표, 경로를 수정하세요.
로컬 파일이나 명령에서 권한 거부가 나오면 어떻게 처리하나요?
부적절한 권한 상승이나 중복 쓰기를 피하도록 시스템 권한 문제와 데스크톱 파일 연결 오류를 먼저 구분하세요.
Local Agent가 명령을 실행할 수 있는데 브라우저 자동화는 왜 사용할 수 없나요?
로컬 브라우저 기능은 실제 설치에 달려 있습니다. 연결 성공이 브라우저 도구 준비를 뜻하지는 않습니다.
페이지에 오프라인이 표시되면 입력 초안이 사라지나요? 전송은 어떻게 복구하나요?
현재 기기의 텍스트 초안을 유지하고 네트워크 복구 후 재연결한 뒤 작업 상태를 확인하세요.
답변이나 컴퓨터 패널 갱신이 멈추면 작업이 아직 실행 중인지 어떻게 판단하나요?
출력 중단을 작업 완료로 오해하지 않도록 실시간 표시를 먼저 복구하고 원래 작업을 확인하세요.
승인 카드가 계속 재연결 중이거나 허용 후 반응이 없으면 어떻게 하나요?
승인 세션을 먼저 복구한 뒤 명확한 결정을 다시 제출하세요. 연결 오류를 우회하려고 전체 액세스로 바꾸지 마세요.
중지를 클릭했는데 계속 출력됩니다. 중지 성공 여부를 어떻게 확인하나요?
중지 요청은 실패하거나 실행 전환과 겹칠 수 있습니다. 버튼 변화가 모든 작업의 철회를 뜻한다고 생각하지 마세요.
첨부 파일 업로드 실패 시 언제 바로 재시도할 수 있나요?
실패 유형에 따라 재시도, 다시 추가, 권한 및 파일 문제 우선 해결 중 선택하세요.
Agents 전환으로 큰 파일이나 이미지의 업로드 오류가 항상 해결되나요?
Ask, Agent, 이미지 처리 한도를 구분하고 실제 작업에 맞게 파일 크기를 줄이세요.
첨부를 한 번에 너무 많이 추가하면 일부 파일만 보이는 이유는 무엇인가요?
첨부 수는 현재 모드와 이미 추가한 파일을 기준으로 계산됩니다. 항목별로 확인하고 나누어 처리하세요.
데스크톱에서 선택한 로컬 파일을 나중에 찾을 수 없거나 불러오지 못하면 어떻게 하나요?
원본 파일 위치, 실행 컴퓨터, 연결 상태를 확인한 뒤 올바른 파일을 다시 추가하세요.
Agent가 파일을 만들었다고 하지만 미리보기나 다운로드가 안 되면 어떻게 하나요?
생성, 파일 제공, 링크 열기의 세 단계를 구분하고 실패한 부분만 복구하세요.