문제 해결

앱이 설치되지 않거나 열리지 않습니다.

Windows

SmartScreen이 설치 프로그램을 차단하는 경우 추가 정보 → 실행을 선택하세요. 데스크탑 빌드는 코드 서명되어 있으므로 일반적으로 표시되지 않습니다.

macOS

macOS가 앱 열기를 거부하는 경우 시스템 설정 → 개인 정보 보호 및 보안을 열고 허용한 다음 다시 실행하세요.

탑재된 디스크 이미지에서 실행하지 말고, 9xChat을 응용 프로그램으로 끌어다 놓았는지 확인하세요.

Linux

다운로드한 파일이 실행 가능으로 표시되어 있는지 확인하세요. 그렇지 않은 경우 실행 비트를 설정하고 다시 실행하십시오.

모바일

Google Play 또는 App Store를 통해 설치하면 업데이트가 자동으로 도착합니다. 앱이 시작되지 않으면 업데이트한 후 기기를 다시 시작하세요.

응답이 실패하거나 도중에 중지됨

다음을 순서대로 진행하세요.

1. 연결을 확인하세요. 클라우드 모델에는 인터넷 연결이 필요하지만, 로컬 모델은 필요하지 않습니다. 클라우드 요청은 실패하지만 로컬 요청은 작동한다면 9xChat이 아니라 네트워크나 제공업체의 문제입니다.

2. 크레딧 잔액을 확인하세요. 9xChat 크레딧을 사용 중인데 크레딧이 모두 소진되면 요청이 중지됩니다. 충전하거나 내 API 키로 전환하세요.

3. API 키를 확인하세요. 직접 가져온 키라면 해당 키가 아직 유효하고 해당 공급자에 할당량이 남아 있는지 확인하세요.

4. 다른 모델을 사용해 보세요. 한 모델은 실패하고 다른 모델은 성공한다면 문제는 해당 모델이나 제공업체에 있습니다.

모델이 없거나 로드되지 않습니다.

• 클라우드 모델에는 크레딧이나 해당 제공업체의 구성된 API 키가 필요합니다. 라이브러리 → 모델에서 제공업체는 키를 추가할 때까지 비활성으로 표시됩니다. 이 표시로 연결 경로가 없는 제공업체를 가장 빠르게 확인할 수 있습니다.

• 로컬 모델은 로컬 실행 프로그램이 먼저 실행되어 있어야 9xChat에서 연결할 수 있습니다. 먼저 시작한 다음 모델 목록을 다시 엽니다.

API 키가 거부되었습니다

문제는 공급자 쪽에서 발생하므로 해결 방법도 그쪽에 있습니다.

1. 선행 또는 후행 공백 없이 키를 다시 붙여넣습니다.
2. 키가 추가한 공급자에 속하는지 확인하세요.
3. 키가 여전히 존재하며 폐기되거나 교체되지 않았는지 확인하세요.
4. 해당 제공업체에 청구가 설정되어 있고 할당량이 남아 있는지 확인하세요. 잔고가 없는 유효한 키는 잘못된 키와 같은 방식으로 실패합니다.
5. 선택한 모델이 귀하의 계정에서 사용할 수 있는 모델인지 확인하세요. 일부 모델은 공급자 측의 별도 등급이 필요합니다.

키는 컴퓨터에 암호화되어 저장됩니다. 키가 모든 곳에서 작동하지 않으면 9xChat을 다시 설치하는 대신 공급자에서 키를 교체하세요.

로컬 모델이 연결되지 않습니다

1. 로컬 실행기를 시작하고 9xChat 외부에서 응답하는지 확인하세요.
2. 9xChat이 예상하는 주소와 포트에서 연결을 수신 중인지 확인하세요.
3. 실행기가 켜져 있을 뿐 아니라 모델 자체도 내려받아(pull) 로드되어 있는지 확인하세요.
4. 라이브러리 → 모델을 다시 열어 목록을 새로 고치세요.

로컬 모델에는 키나 크레딧이 필요하지 않습니다. 로컬 모델은 작동하고 클라우드 모델은 작동하지 않는 경우 문제는 키, 잔액 또는 네트워크입니다.

도구 또는 MCP 서버가 작동하지 않습니다.

1. 도구가 활성화되어 있는지 확인하세요. 모든 도구에는 아래에 활성화된 스위치가 있습니다. 비활성화합니다.

2. 요금제를 확인하세요. 에이전트 도구와 실시간 웹 검색에는 Pro가 필요합니다. 자세한 내용은 무료 및 Pro를 참고하세요.

3. 안전 항목을 읽어 보세요. 도구에 필요한 권한이 명시되어 있습니다. 도구가 필요한 대상에 접근할 수 없으면 요청하지 않고 실패합니다.

4. MCP 서버의 경우 필요한 비밀이 제공되었는지 확인하세요. 여전히 구성 필요로 표시된 항목은 아직 설정이 끝나지 않은 것입니다. 구성 미리보기에는 실행되는 정확한 명령이 표시되므로, 서버가 시작되지 않으면 다시 확인해 보세요.

5. 원인을 분리해 보세요. 도구를 비활성화하고 같은 질문을 한 뒤 동작이 달라지는지 확인하세요. 그러면 도구가 관련되어 있는지 알 수 있습니다.

지식 검색으로 아무것도 찾지 못함

컬렉션을 검색하려면 먼저 색인을 생성해야 합니다.

• 파일이 채팅에만 첨부된 것이 아니라 컬렉션에 추가되었는지 확인하세요.
• 지식 검색 도구가 활성화되어 있는지 확인하세요.
• 파일을 추가할 때 임베딩 공급자에 연결할 수 없는 경우 검색은 키워드 일치로 돌아가며 색인이 필요한 모든 항목을 놓치게 됩니다. 공급자에 연결할 수 있게 되면 파일을 다시 추가하세요.

지식과 메모리를 참조하세요.

첨부 파일이 처리되지 않습니다

• 선택한 모델이 해당 파일 형식을 허용하는지 확인하세요. 텍스트 전용 모델 이미지를 읽을 수 없으며 모델 목록에 비전을 처리하는 표시가 있습니다.
• 매우 큰 파일은 모델의 컨텍스트를 초과할 수 있습니다. 더 작은 발췌본이나 컨텍스트 창이 더 큰 모델을 사용해 보세요.
• 파일이 다른 곳에서는 올바르게 열리지만 여기서는 실패하는 경우 해당 파일을 먼저 일반적인 형식으로 변환해 보세요.

이미지 생성 실패

• 이미지 영역 편집, 생성된 이미지 다시 생성, 채팅 내 이미지 사용에는 Pro가 필요합니다. 이미지 작업 공간은 무료입니다.
• 이미지 모델이 선택되어 있는지 확인하세요. 이미지 모델은 채팅 모델과 별도로 선택합니다.
• 9xChat 크레딧을 통해 생성하는 경우 크레딧 잔액을 확인하세요.
• 일부 프롬프트는 9xChat이 아닌 제공업체가 거부합니다. 문구를 바꾸는 것은 일반적으로 다시 시도하는 것보다 빠릅니다.

받아쓰기 또는 소리내어 읽기가 실패함

둘 다 작동하는 오디오 공급자가 필요하며 둘 다 로컬 옵션이 없습니다.

• 설정 → 기본 모델에서 전사 제공업체가 설정되어 있는지 확인하세요.
• 9xChat에 마이크 권한을 허용하려면 운영 체제의 개인정보 보호 설정을 이용하세요. macOS에서는 시스템 설정 → 개인정보 보호 및 보안 → 마이크로 이동하세요.
• 채팅 모델이 로컬인 경우에도 둘 다 연결이 필요합니다.

받아쓰기와 음성 채팅에는 Pro가 필요하며, 읽어주기는 무료입니다.

예상보다 크레딧이 빨리 소진됩니다.

모든 메시지에는 자체 비용, 지연 시간 및 토큰 내역이 표시되며 세션에는 누적 합계가 표시됩니다. 총계가 이상하면 메시지별 수치를 열어 어느 주고받기가 원인인지 확인하세요. 긴 컨텍스트, 추론 토큰, 큰 첨부 파일은 모두 한 턴의 비용을 높입니다.

모델 설정에서 최대 완성 토큰과 컨텍스트 제한을 낮추면 채팅별로 비용을 제한할 수 있으며, 컨텍스트 보호는 메시지마다 다시 전송되는 기록의 양을 줄여 줍니다.

크레딧 지출을 완전히 중단하려면 자체 API 키를 추가하거나 로컬 모델을 사용하세요.

기능이 회색으로 표시되거나 누락되었습니다.

무료 계정에서 Pro가 필요한 기능을 사용하면 Pro 기능 대화 상자가 열리고, Pro 설정에는 프리미엄 표시가 붙습니다. 여러 탭, 채팅 창, 빠른 어시스턴트, 에이전트 도구, 실시간 웹 검색, 이미지 편집, 받아쓰기, 음성 채팅 등이 해당됩니다. 전체 구분은 무료 및 Pro를 확인하세요.

이미 결제했다면 이 기기에 구독이 연결된 UID로 로그인했는지 확인하세요. 프로필을 열어 요금제와 남은 일수를 확인하세요. 기기를 연결하거나 전환하거나 제거하는 방법은 UID 및 기기를 참고하세요.

"이 요청에 필요한 크레딧이 부족합니다"

요청 비용이 남은 잔액보다 많습니다. 크레딧 구매를 선택하거나, 채팅 모델을 내 API 키를 사용하는 모델 또는 로컬 모델로 바꾸세요. 이 모델들은 크레딧을 사용하지 않습니다. 잔액은 프로필에서 확인할 수 있습니다.

"기기 한도에 도달했습니다"

UID의 기기 슬롯을 모두 사용 중입니다. 무료 계정이나 체험 기간에는 1대, Pro에서는 3대까지 사용할 수 있습니다. 기기 관리를 선택하고 더 이상 사용하지 않는 기기를 제거한 뒤 다시 로그인하세요. iOS에서는 브라우저에서 라이선스 페이지를 이용하세요. 새 UID는 만들지 마세요. 기존 요금제나 크레딧이 이전되지 않습니다. UID 및 기기를 참고하세요.

"결제를 찾을 수 없음"

브라우저에서 결제한 뒤 결제 확인을 선택하면 9xChat이 계정을 확인합니다. 결제를 찾을 수 없음이 표시되면 아직 결제 처리 중일 수 있습니다. 1분 정도 기다렸다가 다시 시도를 선택하세요. 실수로 결제 페이지를 닫았다면 결제 페이지 열기를 선택하세요. Google Play 또는 App Store에서 구매한 항목은 요금제 화면의 구매 복원으로 복원할 수 있습니다.

핸드오프 코드가 작동하지 않아요

• 코드는 몇 분 후 만료되며 한 번만 사용할 수 있습니다. 보내는 기기에서 취소하고 페어링 코드 받기를 다시 선택하세요.
• 받는 기기의 채팅 받기… 에 6자리 숫자를 모두 입력하세요.
• 전송이 끝날 때까지 두 기기의 대화 상자를 열어 두고 인터넷 연결을 유지하세요.

핸드오프를 참고하세요.

다른 기기에서 무언가 빠져 있습니다

작업 공간은 각 기기에 로컬로 저장되므로 동일한 UID로 로그인한 두 번째 컴퓨터는 채팅, 노트, 메모리를 이어받지 않습니다. 오류가 아니라 정상적인 동작입니다.

• 메모리는 기기별로 저장됩니다. 새로 설치하면 아무것도 없는 상태에서 시작됩니다.
• 핸드오프는 하나의 대화를 위해 두 기기를 연결하며, 작업 공간의 나머지는 복사하지 않습니다.
• 자료를 직접 이동하려면 설정 → 데이터 및 내보내기를 사용하세요.

구독은 UID를 따르므로, 콘텐츠는 옮겨지지 않더라도 해당 UID로 확인하는 기기에서는 Pro가 적용됩니다.

여기서 해결되지 않았다면

문의할 때 진단 정보 포함에 체크하세요. 버전, 저장 공간 수치, 항목 수, 최근 오류의 유형이 첨부되며 프롬프트, 제목, 파일 이름, 키는 절대 포함되지 않습니다. 추가 질문 없이 빠르게 문제를 파악하는 데 도움이 됩니다. 정확히 어떤 정보가 전송되는지는 개인정보 보호에서 확인할 수 있습니다.

지원팀에 다음 내용을 알려 주세요.

• 운영 체제와 9xChat 버전,
• 귀하가 사용하고 있던 모델과 공급자,
• 크레딧, 직접 입력한 키, 로컬 모델 중 무엇을 사용했는지,
• 수행한 작업과 화면에 표시된 정확한 오류.