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

문제 해결

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

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

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

  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 페이지가 연결되지 않는 경우

  • 메인 기기에서 Private Relay가 켜져 있고(설정 > 연결 > 기기 및 릴레이) "연결됨"으로 표시되는지 확인하세요.
  • 원격 브라우저에서 메인 기기와 동일한 계정으로 로그인하세요. 릴레이는 본인의 인스턴스에만 연결됩니다.
  • 원격 브라우저가 제어할 수 있으려면 메인 기기의 확장 프로그램이나 데스크톱 앱이 실행 중이며 온라인 상태여야 합니다.
  • 최초 접속 시 암호화된 세션을 설정하는 동안 몇 초간 "연결 중" 스피너가 표시될 수 있습니다. 새로고침하기 전에 완료될 때까지 기다리세요.

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

  • 암호화된 세션이 설정된 후에만 앱이 부팅되므로 몇 초 정도 기다려 주세요.
  • 계속 멈춰 있는 경우 메인 기기가 온라인 상태이고 Private Relay가 연결되어 있는지 확인한 다음 페이지를 새로고침하세요.

성능 문제

응답이 느림

  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 Bridge 활성화가 켜져 있는지 확인하세요(설정 > 연결 > 기기 및 릴레이). 기본적으로 꺼져 있으며, 꺼져 있는 동안에는 확장 프로그램이 데스크톱 앱에 절대 연결되지 않고 재연결/포트 컨트롤이 회색으로 비활성화됩니다.
  • 브라우저 확장 프로그램과 데스크톱 앱을 둘 다 사용하는 경우, 확장 프로그램은 로컬 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.