문제 해결

Mac에서 시스템 설정을 엽니다.

개인 정보 및 보안을 선택합니다.

보안 섹션으로 스크롤하고 Quick에 대한 메시지 옆에 있는 Open Anyway를 선택합니다.

애플리케이션을 열 것인지 확인합니다.

컴퓨터를 다시 시작하고 애플리케이션을 다시 열어 보십시오.

운영 체제가 최소 요구 사항을 충족하는지 확인합니다.

사용 가능한 디스크 공간이 충분한지 확인합니다.

문제가 지속되면 ~/.quickwork/ 디렉터리(macOS) 또는 %USERPROFILE%\.quickwork\ 디렉터리(Windows)를 삭제하고 애플리케이션을 다시 설치합니다.

설정 > 기능 > 연결에서 서비스를 연결 해제합니다.

로그인을 선택하고 인증 흐름을 완료하여 서비스를 다시 연결합니다.

계정에 타사 서비스에서 필요한 권한이 있는지 확인합니다.

인터넷 연결이 활성 상태이고 안정적인지 확인합니다.

인터넷 연결이 활성 상태인지 확인합니다.

설정 > 기능 > 연결에서 서비스를 연결 해제했다가 다시 연결합니다.

문제가 지속되면 타사 서비스가 중단될 수 있습니다. 서비스의 상태 페이지를 확인합니다.

Google 계정은 조직의 관리자 정책에 의해 제한되지 않습니다.

로그인 흐름 중에 필요한 OAuth 권한을 부여했습니다.

올바른 Google 계정으로 로그인합니다.

빠른 응답을 위해 Fast AI 모델 모드로 전환합니다. 채팅 입력 영역에서 모델 선택기를 선택하고 Fast를 선택합니다.

사고 노력 수준을 줄입니다. 사고 노력을 줄이면(꺼짐 또는 낮음) 응답 속도가 빨라집니다.

사용하지 않는 애플리케이션을 닫아 시스템 리소스를 확보합니다.

인터넷 연결 속도를 확인합니다. AI 모델 요청에는 API Gateway에 대한 네트워크 연결이 필요합니다.

설정 > 내 컴퓨터에서 인덱싱된 폴더 수를 줄입니다. 의미 체계 검색은 키워드 검색보다 더 많은 리소스를 사용하기 때문에 필요하지 않은 폴더에 대한 의미 체계 검색을 비활성화합니다.

설정 > 사용자 지정 > 성능에서 최대 병렬 작업 슬라이더를 낮춥니다. 기본값은 50입니다. 이 값을 줄이면 동시 백그라운드 작업 수가 제한됩니다.

애플리케이션을 다시 시작하여 캐시된 데이터를 지웁니다.

설정 > 내 컴퓨터 > 검색 인덱싱에서 검색 인덱싱 한도를 조정합니다. 스토리지 제한, 인덱싱을 위한 최대 파일 크기 또는 인덱싱 슬라이더를 위한 최대 폴더 크기를 낮춥니다.

파일의 상위 폴더가 설정 > 내 컴퓨터 > 로컬 폴더에 추가됩니다. Quick은 명시적으로 액세스 권한을 부여하는 폴더의 파일만 액세스할 수 있습니다.

+ 폴더 추가를 선택하여 추가 폴더에 대한 액세스 권한을 부여합니다.

폴더를 추가한 후 Quick은 폴더의 파일을 즉시 읽을 수 있습니다. 검색에 대한 인덱싱은 백그라운드에서 수행됩니다.

설정 > 내 컴퓨터 > 로컬 폴더의 폴더에 대해 키워드 검색이 켜져 있는지 확인합니다. 폴더를 확장하여 인덱싱 토글을 확인합니다.

인덱싱 상태를 확인합니다. 파일 및 항목 수가 있는 준비 상태는 인덱싱이 완료되었음을 확인합니다.

최근에 새 폴더를 추가한 경우 인덱싱이 완료될 때까지 기다립니다. 상태는 진행 상황을 표시합니다.

설정 > 내 컴퓨터 > 검색 인덱싱에서 파일이 인덱싱 한도의 최대 파일 크기보다 크지 않은지 확인합니다. 이 제한보다 큰 파일은 인덱싱 중에 건너뛰지만 직접 파일 액세스를 통해 에이전트가 계속 사용할 수 있습니다.

더 광범위한 검색을 위해 폴더에서 의미 체계 검색을 활성화하여 자연어 쿼리를 허용합니다.

설정 > 기능 > 시스템에서 브라우저 자동화가 활성화되어 있는지 확인합니다.

"내 Chrome 사용" 모드를 사용하는 경우 설정 > 사용자 지정 > 브라우저에서 설정을 확인합니다. Chrome을 열고 chrome://inspect/#remote-debugging로 이동합니다. 원격 디버깅 활성화를 선택합니다. Quick로 돌아가 연결 테스트를 선택하여 연결을 확인합니다.

기본 모드를 사용하는 경우 Quick은 프로필 사본과 함께 별도의 Chrome 인스턴스를 시작합니다. 시스템에 Chrome이 설치되어 있는지 확인합니다.

예약된 시간에 컴퓨터가 켜져 있고 깨어 있습니다.

Amazon Quick 데스크톱 애플리케이션이 실행 중입니다.

에이전트가 활성화되었습니다. 설정 > 기능 > 예약된 작업에서 토글을 확인하거나 상단 표시줄에서 에이전트 패널을 엽니다.

인터넷 연결이 활성화되었습니다. 연결된 서비스 또는 AI 모델에 액세스하는 에이전트에는 네트워크 연결이 필요합니다.

설정 > 기능 > 예약된 작업을 열고 에이전트를 선택합니다.

프롬프트 탭을 검토하여 에이전트의 지침이 올바른지 확인합니다.

기능 탭을 확인하여 올바른 MCP 서버가 연결되어 있는지 확인합니다.

개요 탭에서 모델을 변경하는 것이 좋습니다. 보다 복잡한 에이전트 작업에는 Balanced 또는 Smart를 사용합니다.

실행 버튼(재생 아이콘)을 선택하여 에이전트를 수동으로 트리거하고 결과를 관찰합니다.

명령이 올바르고 실행 파일이 시스템에 설치되어 있는지 확인합니다.

인수가 공백으로 구분되고 형식이 올바른지 확인합니다.

서버를 시작하는 데 30초 이상 걸리는 경우 제한 시간 값을 늘립니다(5초에서 300초로 구성 가능).

필요한 환경 변수가 올바르게 설정되었는지 확인합니다.

URL이 올바르고 서버가 실행 중인지 확인합니다.

인증이 필요한 경우 토큰 값이 유효한 보유자 토큰인지 확인합니다.

네트워크 연결 및 방화벽 설정을 확인합니다.

구성 파일 경로가 올바른지 확인합니다.

소스 애플리케이션(Kiro, Claude Code, AIM 등)이 올바르게 설치되었는지 확인합니다.