문제 해결
문제가 생기면 먼저 현재 조직, 프로젝트, 작업과 화면의 오류 문구를 확인하세요. 아래에서 해당 증상을 찾아 확인 순서대로 진행합니다.
로그인과 조직 선택
| 증상 | 확인과 조치 |
|---|---|
| 로그인 창을 닫았거나 앱이 준비되지 않음 | Aru의 브라우저 대화상자에서 인증을 끝냈는지 확인합니다. 창을 닫았다면 로그인이 취소되므로 시작 화면에서 다시 시도합니다. |
| 현재 네트워크에서 접근할 수 없음 | 조직이 허용한 네트워크인지 확인합니다. 필요한 사내 접속 환경은 관리자에게 확인합니다. |
| 가입 승인 대기 중·비활성 멤버십 | 해당 조직의 가입·멤버십 상태를 관리자에게 확인합니다. |
| 키체인 접근 오류 | macOS의 접근 요청 상태를 확인합니다. 앱 재시작으로 다시 요청받고 로그인 정보 접근을 허용합니다. |
| 작업 환경을 시작하지 못함 | 연결과 앱 버전을 확인하고 다시 시도를 선택합니다. 계속 실패하면 오류 문구와 버전을 기록합니다. |
다른 조직을 사용할 수 있다면 조직을 변경해 해당 조직의 환경을 확인할 수 있습니다. 진행 중인 작업은 전환 전에 정리하세요.
모델이 없거나 요청을 시작할 수 없음
모델 없음 또는 사용 가능한 모델이 없어요가 표시되면 현재 조직을 확인합니다. 조직의 플랜·크레딧과 모델 허용 설정을 관리자에게 확인하세요.
입력창에서 사용 가능한 모델을 선택했는지도 확인합니다. Aru는 조직에서 제공하는 모델을 사용하므로, 모델이 계속 보이지 않으면 관리자에게 사용 권한을 문의하세요.
작업이 멈춘 것처럼 보임
- 권한 필요 또는 입력 필요 상태인지 확인합니다.
- 대화에 열린 승인 카드나 질문에 응답합니다.
- 현재 도구가 실행 중이거나 재시도 중인지 확인합니다.
- 진행을 중단하려면 중지를 선택합니다.
- 중지 후 완료된 변경과 남은 실행을 확인하고 후속 요청을 보냅니다.
도구 호출이 오래 걸리는 경우 결과를 기다리는 상태일 수 있습니다. 중지하기 전에 대화의 실행 상태를 확인하세요. 외부 서비스에 생성·수정 요청을 보냈다면 재요청 전에 실제 서비스에서 처리됐는지 확인합니다.
MCP를 사용할 수 없음
| 상태 | 확인과 조치 |
|---|---|
| 목록에 원하는 서비스가 없음 | 현재 조직의 카탈로그와 접근 권한을 확인합니다. |
| 인증 필요 | 항목을 열고 인증 또는 재인증을 완료합니다. |
| 연결 실패 | 서버 주소·실행 명령·필수 설정과 네트워크를 확인하고 테스트를 사용합니다. |
| 설치돼 있지만 도구가 제공되지 않음 | 활성화 상태와 사용 가능 프로젝트에 현재 프로젝트가 포함되는지 확인합니다. |
| 적용 대기 중 | 진행 중인 응답이나 도구 실행이 끝나면 연결 상태를 다시 확인합니다. |
| 설정 적용 실패 | 로컬 적용 다시 시도를 선택합니다. |
| 설치 여부를 확인하지 못함 | 새로고침으로 상태를 확인한 뒤 필요한 동작만 다시 수행합니다. |
| 정책으로 차단됨 | 조직의 사용 정책과 권한을 관리자에게 확인합니다. |
플러그인에 포함된 MCP는 플러그인의 켜짐과 인증 상태도 확인합니다. 자세한 과정은 MCP 연결을 참고하세요.

플러그인·스킬 오류
플러그인 설치가 실패하면 표시된 설치 결과, 앱 버전과 네트워크를 확인합니다. 카탈로그 조회가 실패해도 이미 설치된 항목이 유지될 수 있으므로 목록과 오류를 함께 확인하세요.
선택한 플러그인을 사용할 수 없습니다가 표시되면 활성화하거나 입력창에서 해당 선택을 제거합니다. 스킬이 보이지 않으면 추가한 위치와 사용 여부, 해당 스킬이 포함된 플러그인의 상태를 확인합니다.
스킬 가져오기가 실패하면 SKILL.md를 포함한 올바른 폴더·ZIP인지 확인합니다. 추가했지만 활성화하지 못했습니다 안내는 추가와 활성화를 나눠 확인하세요.
파일을 열거나 저장할 수 없음
프로젝트·워크트리와 실제 파일 경로를 확인합니다. 파일이 삭제되거나 폴더가 이동했는지, 운영체제에서 해당 폴더 접근이 허용되는지도 확인하세요.
미리보기 미지원이면 기본 앱에서 열기를 사용합니다. 큰 파일은 일부 미리보기가 제한될 수 있습니다. 저장 오류가 있으면 쓰기 권한과 편집기의 저장 상태를 확인하세요.
Git 되돌리기에 일부 파일만 실패했다면 남은 파일의 상태를 다시 확인합니다. 이미 되돌린 파일을 포함해 전체 동작을 반복하기 전에 결과를 확인하는 것이 좋습니다.
브라우저 문제
- 페이지 접근 실패: 내장 브라우저의 로그인 상태와 사이트 접근 권한을 확인합니다.
- 페이지 조작 실패: 현재 페이지를 확인하고 직접 필요한 단계를 처리한 뒤 이어서 요청합니다.
- 업로드 실패: 실제 파일 경로와 사이트가 허용하는 형식·크기를 확인합니다.
- 다운로드 결과가 보이지 않음: 저장 과정이 끝났는지와 실제 저장 위치를 확인합니다.
- GPU 가속을 사용할 수 없음: 그래픽 드라이버·가속 설정을 확인한 뒤 앱을 다시 시작합니다.
브라우저 데이터 초기화가 필요한 경우 설정 → 정보에서 정리할 수 있습니다. 쿠키와 사이트 저장소, 권한이 초기화돼 사이트에서 다시 로그인해야 할 수 있습니다.
이미지·Office 결과 문제
이미지 편집은 원본이 첨부됐는지와 PNG·JPEG 형식인지 확인합니다. 생성 기능 자체가 사용할 수 없으면 조직의 기능 제공 상태를 확인하세요.
Office 문서를 만들 수 없으면 필요한 플러그인의 설치와 켜짐 상태를 확인합니다. 앱 미리보기와 Office 앱의 표시가 다르면 실제 사용할 앱에서 결과를 확인하고 수정할 위치를 지정해 요청합니다.
업데이트 실패
네트워크와 운영체제의 설치 권한을 확인하고 표시되는 재시도 절차를 사용합니다. 업데이트에서 설치와 최신 다운로드를 안내합니다.

문의할 때 전달할 내용
계속 해결되지 않으면 프로필 메뉴의 도움말이나 조직의 지원 경로로 문의하세요. 다음 내용을 준비하면 원인을 확인하기 쉽습니다.
- 운영체제와 Aru 버전
- 문제가 발생한 기능과 실행 순서
- 실제 오류 문구와 발생 시각
- 기대한 결과와 실제 결과
- 다시 시도한 조치
화면이나 로그를 공유할 때는 계정 정보, 인증 토큰과 업무 자료가 포함되지 않았는지 확인하세요.