본 문서는 영어 원본을 기계 번역한 것입니다. 번역본과 영어 원본 사이에 내용이 상충할 경우 영어 원본이 우선합니다. 영어 원본 보기

문제 해결

작동하지 않는 것이 있나요? 여기서 시작하세요.

브라우저 확장 프로그램 문제

확장 프로그램이 로드되지 않음

  1. Chrome 웹 스토어에서 설치했는지 확인하세요 (개발자 버전이 아님)
  2. chrome://extensions로 이동하여 오류 메시지가 있는지 확인합니다
  3. 확장 프로그램을 비활성화했다가 다시 활성화해 보세요
  4. 그래도 안 되면 Chrome을 완전히 재시작하세요

사이드 패널이 열리지 않음

  1. 도구 모음(우측 상단)의 Caiioo 아이콘을 클릭합니다
  2. 일반 웹페이지에 있는지 확인하세요 (Chrome 설정과 같은 일부 페이지는 확장 프로그램을 허용하지 않습니다)
  3. chrome://extensions에서 Caiioo를 찾아 "새로고침"을 클릭합니다
  4. 아이콘을 다시 클릭해 보세요

업데이트 후 사이드바가 빈 화면이거나 깨짐

  • 브라우저 캐시를 지우고 확장 프로그램을 다시 로드하세요
  • 사이드 패널을 닫았다가 다시 엽니다
  • 해결되지 않으면 확장 프로그램을 비활성화했다가 다시 활성화하세요

로그인 문제

Google / Apple / Microsoft로 로그인할 수 없음

  1. 브라우저가 팝업을 차단하고 있지 않은지 확인하세요 — OAuth는 팝업 창이 필요합니다
  2. iOS에서 Google 로그인이 멈추면 대신 "Apple로 로그인" 옵션을 시도해 보세요
  3. caiioo.ai의 쿠키를 삭제하고 다시 시도하세요
  4. 최근에 비밀번호를 변경했다면 브라우저에서 해당 서비스 로그아웃 후 다시 시도하세요

로그인 후 로그인 화면에서 멈춤

  • 몇 초간 기다려 주세요 — 앱이 프로필을 가져오는 중입니다
  • 계속 멈춰 있으면 앱을 닫았다가 다시 열거나 확장 프로그램을 새로고침하세요
  • 기기 시계가 정확한지 확인하세요 — 시계가 맞지 않으면 OAuth 토큰 검증에 실패합니다

API 키 문제

API 키가 작동하지 않음

  1. 제공자 웹사이트에서 키를 다시 복사하여 앞뒤 공백 없이 신중하게 붙여넣으세요
  2. 계정에 크레딧이 남아 있는지 확인하세요
  3. 새 키를 생성하여 대신 사용해 보세요
  4. 키 형식이 올바른지 확인하세요 — OpenRouter 키는 sk-or-로 시작합니다

API 키를 찾을 수 없음

  • OpenRouter: openrouter.ai/keys
  • Ollama: 키가 필요하지 않습니다 — http://localhost:11434에서 로컬 서버가 실행 중인지 확인하세요

자세한 내용은 AI 제공자 및 API 키를 참조하세요.

선택한 모델에서 "Rate limited(요청 한도 초과)" 또는 "overloaded(과부하)" 발생

이는 키 문제가 아니라 제공자 측의 문제입니다. 선택한 모델에 속도 제한이 걸리거나 과부하가 걸리거나 사용할 수 없는 경우, Caiioo는 임의로 다른 모델로 이동하지 않고 모델 이름과 발생한 상황을 알려줍니다. 1분 정도 기다렸다가 다시 전송하거나 다른 모델을 직접 선택하세요. (Caiioo가 모델을 대신 선택한 경우에는 자동으로 다른 모델로 전환됩니다.)

무료 모델이 요청을 계속 거부함

일부 무료 OpenRouter 모델은 자체 허용 목록에 없는 앱의 요청을 거부합니다. Caiioo는 거부 이력이 있는 모델을 기억하여 선택기에서 표시하고, 다른 모델로 대체할 때 건너뛰며, 차단이 해제되었는지 나중에 다시 확인합니다. 그동안에는 다른 모델을 선택해 사용하세요.

Google 통합 (Pro 등급)

Google에 연결할 수 없음

  1. 설정 > 계정 > 계정 권한 및 승인으로 이동
  2. "Google 계정 연결" 클릭
  3. 요청된 모든 권한을 승인했는지 확인
  4. 계정이 연결된 것으로 표시되는지 확인
  5. 여전히 작동하지 않으면 연결을 해제하고 다시 시도

Google 도구가 작동하지 않음

  1. Google이 연결되어 있는지 확인 (설정 > 계정 > 계정 권한 및 승인)
  2. Google 연결 새로 고침 시도 ("Google 재연결" 버튼)
  3. 특정 도구가 활성화되어 있는지 확인 (설정 > 도구, 모드 및 앱 > 도구 구성)

Private Sync 문제

동기화가 작동하지 않음

  1. 비공개 동기화가 실제로 활성화되어 있는지 확인하세요(설정 > 연결성 > Private Sync)
  2. Google 계정이 연결되어 있는지 확인하세요
  3. Google Drive에 저장 공간이 남아 있는지 확인하세요
  4. 토큰이 만료된 경우 "Google 다시 연결"을 클릭하세요
  5. 동기화를 껐다가 다시 켜보세요

기기간 데이터가 동기화되지 않음

  • Private Sync는 백그라운드에서 작동하므로 몇 초 정도 기다려 주세요
  • 모든 기기에서 동일한 Google 계정을 사용하고 있는지 확인하세요
  • 다른 기기에서도 Private Sync가 켜져 있는지 확인하세요
  • 동기화를 껐다가 다시 켜서 수동으로 새로고침해 보세요

원격 브라우저 접속 문제

relay.caiioo.ai/app 페이지가 연결되지 않음

  • 기본 기기에서 개인 릴레이가 켜져 있고(설정 > 연결성 > 연결) "연결됨"으로 표시되는지 확인
  • 기본 기기와 동일한 계정으로 원격 브라우저에 로그인 — 릴레이는 자신의 인스턴스에만 도달함
  • 원격 브라우저에서 제어하려면 기본 기기의 확장 프로그램 또는 데스크톱 앱이 실행 중이고 온라인 상태여야 함
  • 콜드 오픈 시 암호화된 세션을 설정하는 동안 페이지에 몇 초 동안 "연결 중" 스피너가 표시될 수 있음 — 완료될 때까지 기다린 후 새로 고침

로그인했는데 원격 페이지가 로그인 화면에 멈춰 있는 경우

  • 암호화된 세션이 설정되면 앱을 한 번 부팅하므로 몇 초 기다리기
  • 계속 멈춰 있으면 기본 기기가 온라인 상태이고 개인 릴레이가 연결되어 있는지 확인한 후 페이지 새로 고침

성능 문제

응답이 느림

  1. AI 제공자에 문제가 있는지 확인 (상태 페이지 확인)
  2. 더 빠르고 저렴한 모델(Gemini Flash 또는 Mistral 등) 사용 시도
  3. 오래된 대화가 수백 개라면 보관 처리
  4. 인터넷 연결 확인

대화가 너무 오래 걸림

  • AI가 작업 중입니다. 회전하는 표시기를 확인하세요.
  • 모델마다 속도가 다릅니다. 급하다면 더 빠른 모델로 전환하세요.
  • 몇 분 이상 걸린다면 AI가 멈춘 것일 수 있습니다. 중지 후 다시 시도하세요.

구독 및 결제

"요금제 관리"가 보이지 않음

  • 구독을 보유한 계정으로 로그인했는지 확인
  • iOS에서 구독한 경우 요금제 관리 버튼이 Apple의 구독 설정으로 이동함
  • 웹에서 구독한 경우 Stripe 결제 포털로 이동함
  • 로그아웃 후 다시 로그인하여 구독 상태 새로 고침

"요금제 관리"가 잘못된 곳을 연 경우

  • iOS 인앱 결제는 caiioo.ai/account가 아니라 설정 > Apple ID > 구독에서 관리됨
  • Stripe 구독은 설정 > 계정 > 사용자 프로필의 포털 링크 또는 caiioo.ai/account에서 관리됨
  • Caiioo는 구독한 위치에 따라 자동으로 라우팅함 — 이는 정상적인 동작임

업그레이드했는데 여전히 이전 등급인 경우

  • Stripe 업그레이드가 반영되는 데 잠시 시간이 걸림 — 앱 새로 고침
  • Apple IAP는 확인하는 데 최대 24시간이 걸릴 수 있음. 속도를 높이려면 설정 > 계정 > 사용자 프로필에서 "구매 복원"을 탭하세요.
  • 다른 플랫폼에서 이미 구독 중인 경우 구독 버튼에 해당 플랫폼에서 관리하라는 메시지가 표시됨

기타 문제

데스크톱 또는 모바일 앱의 빈 화면

  • 앱을 완전히 재시작
  • 인터넷에 연결되어 있는지 확인
  • 앱 캐시 지우기 시도 (플랫폼에 따라 다름)
  • 최신 버전으로 업데이트

도구가 작동하지 않음

  1. 설정 > 도구, 모드 및 앱 > 도구 구성으로 이동하여 도구가 활성화되어 있는지 확인
  2. 일부 도구는 권한이나 설정이 필요함 (Google 도구의 경우 연결된 Google 계정 등)
  3. "권한 필요" 오류가 표시되면 설정 > 계정 > 계정 권한 및 승인에서 제공업체를 다시 연결하고 범위를 재승인

확장 프로그램이 데스크톱 앱에 연결할 수 없음

  • 먼저 Caiioo 브리지 활성화가 켜져 있는지 확인 (설정 > 연결성 > 연결) — 기본적으로 꺼져 있으며, 꺼져 있는 동안에는 확장 프로그램이 데스크톱 앱에 연결되지 않고 재연결/포트 컨트롤이 회색으로 비활성화됩니다.
  • 브라우저 확장 프로그램과 데스크톱 앱을 모두 사용하는 경우, 확장 프로그램은 로컬 WebSocket을 통해 데스크톱 앱에 연결됩니다 (동기화가 아닌 기능 브리지).
  • 데스크톱 앱을 재시작한 다음 확장 프로그램을 새로 고침
  • 데스크톱 앱의 다른 인스턴스가 실행 중이 아닌지 확인 — 여러 인스턴스가 충돌을 일으킴

브라우저가 열려 있는데도 macOS에서 "브라우저가 연결되지 않음" 경고가 표시됨

  • Caiioo 이제 Chrome, Safari, Edge, Firefox를 인식함 — 이 중 하나가 연결되는 즉시 경고가 사라짐
  • Safari는 다른 채널을 통해 연결되며 전경 앱이 아닐 때 잠시 절전 상태가 될 수 있음; 연결은 유지되며 명령이 필요할 때 Caiioo가 자동으로 깨움
  • 경고가 지속되면 브라우저를 한 번 전경으로 가져온 다음 다시 시도

메시지 첨부파일이 업로드되지 않음

  • 파일 형식 지원 여부 확인 (PDF, 이미지, Word 문서, 스프레드시트, 프레젠테이션)
  • 더 작은 파일로 시도
  • 인터넷 연결 확인

도움말 받기

  • 빠른 답변: 헤더의 ? 아이콘 클릭
  • 설정 및 문제 해결: 톱니바퀴 아이콘 클릭
  • 이 가이드: 설정 > 도움말 > 문서 및 법적 고지
  • Caiioo에 버그 리포트 요청: 문제 신고를 요청하면 검토 및 전송할 수 있도록 상세한 내용이 미리 채워진 내장 지원 양식이 열립니다. "그냥 파일로 제출해 줘"라고 말하고 승인하면, 팀이 현상을 재현할 수 있도록 대화의 기술적 세부 정보를 첨부하여 티켓을 직접 제출합니다.

참고 항목

This guide is maintained by the Caiioo team using Slate, our built-in editor.