기술 매뉴얼

AI 도구 이용 가이드

먼저 지역 지원 여부와 계정 자격을 확인한 뒤 연결, 스트리밍 전송, API 할당량을 살펴보세요. 페이지 접속 실패, 응답 중단, 모델 호출 불가는 서로 다른 문제일 수 있습니다.

LiuVPN을 처음 설정한다면 사용 가이드에 따라 클라이언트를 설치하고 구독을 가져온 뒤 연결을 확인하세요. 이 매뉴얼은 단계별로 찾아볼 수 있도록 구성되어 있습니다. 아래 목차에서 문제가 발생한 부분을 선택하면 되며, 설치 과정을 처음부터 다시 진행할 필요는 없습니다. 도구별 일반적인 사용 사례는 AI 도구 안내도 참고하세요.

AI 접속 문제 단계별 진단

마지막으로 성공한 단계부터 확인하기

먼저 “도구가 작동하지 않는다”는 말을 재현 가능한 설명으로 바꿔 보세요. 예를 들어 홈페이지에 접속하고 인증 제공업체의 인증도 완료했지만, 제품 페이지로 돌아오면 여전히 로그인되지 않은 상태라고 설명할 수 있습니다. 이렇게 하면 문제의 범위가 드러납니다. 홈페이지 접속과 인증은 완료됐으므로, 다음으로 돌아오는 주소, 브라우저 세션, 작업 공간 선택을 확인해야 합니다. 우선 회선을 바꿀 필요는 없습니다. 마지막으로 성공한 동작, 처음 실패한 동작, 실패 당시 표시된 문구를 기록하세요. 구체적인 안내가 보인다면 막연한 오류명만 적지 말고 해당 문구를 그대로 남기세요.

웹페이지가 열린다는 것은 페이지 리소스나 캐시를 사용할 수 있다는 뜻일 뿐입니다. 메시지를 보낼 때 브라우저는 다른 서비스 주소에 접속할 수 있고, 파일 업로드, 대화 기록 조회, 텍스트 스트리밍에도 서로 다른 연결이 사용될 수 있습니다. 홈페이지가 빠르게 로드되어도 생성 과정까지 안정적이라고 단정할 수 없습니다. 반대로 본문이 계속 갱신되는데 대화 목록만 업데이트되지 않는다면, 생성 서비스 전체가 작동하지 않는다고 판단하지 말고 화면 동기화 문제로 기록하세요. 오래된 대화에서만 문제가 발생한다면 개인정보가 없는 새 대화로 다시 확인하고 기존 대화는 비교용으로 남겨 두세요.

지역·계정·전송 문제를 구분하기

지역 지원 여부는 제품이 사용자의 거주 지역과 해당 계정 또는 조직에서 이용 가능한지를 뜻합니다. 서비스 제공업체는 접속 IP, 계정 정보, 결제 정보의 관할 지역, 조직 소재지 등을 기준으로 판단할 수 있으며, 구체적인 기준은 해당 업체의 정책을 따릅니다. 네트워크 출구 IP는 요청이 서버에 도달할 때 확인되는 정보 중 하나일 뿐, 계정 소속이나 계약상 권한, 결제 자격을 바꾸지는 않습니다. 지역 관련 안내가 표시되면 해당 제품의 공식 설명을 확인하세요. 기본 웹페이지에 접속할 수 있다고 해서 같은 브랜드의 모델, API 또는 기업 기능도 이용할 수 있다고 판단해서는 안 됩니다.

인증 계층은 “누구의 요청인가?”에 답하고, 권한 계층은 “이 계정으로 무엇을 할 수 있는가?”에 답합니다. 개인 계정으로 로그인할 수 있어도 올바른 조직에 가입했다는 뜻은 아닙니다. 조직 구성원으로 화면을 볼 수 있어도 관리자가 필요한 라이선스를 할당했다는 뜻은 아닙니다. 전송 계층은 요청이 서버에 도달하고 응답이 온전히 돌아오는지를 다룹니다. 도메인 이름 확인 실패, 인증서 검증 실패, 프록시 연결 시간 초과는 대개 애플리케이션이 권한을 판단하기 전에 발생합니다. 제품 오류를 식별할 수 있다면 응답 내용을 보존하고, 오류가 제품 자체에서 발생했는지 중간 게이트웨이에서 발생했는지 확인한 뒤 다음 진단 단계를 정하세요.

출구 IP와 위험 판단 이해하기

하나의 네트워크 출구를 여러 사용자의 트래픽이 함께 사용할 수 있습니다. 서버는 요청의 출처와 동작을 관찰하며, 클라이언트에 표시된 지역명이 같다고 모든 세션을 같은 환경으로 취급하지는 않습니다. 한 번의 로그인 중 접속 경로를 반복해서 바꾸면 서비스에서 재인증을 요구할 수도 있습니다. 인증 안내가 나타나면 평소 사용하는 본인 기기와 승인된 네트워크 환경에서 공식 절차를 완료하세요. 계정이 명시적으로 제한된 경우 출구를 자주 바꿔도 권한이 복구되지 않으며, 원래 문제를 추적하기도 더 어려워집니다.

가설을 검증할 변수만 바꾸기

비교 테스트를 설계할 때는 어떤 조건을 그대로 둘지 명확히 하세요. 브라우저 차단이 의심된다면 계정, 네트워크, 동작은 그대로 두고 깨끗한 브라우저 프로필로 바꿉니다. 접속 불안정이 의심된다면 클라이언트, 작업 공간, 테스트 문구를 유지한 채 허용된 접속 환경에서 같은 동작을 반복합니다. 계정, 기기, 회선을 동시에 바꾸면 성공하더라도 무엇이 효과가 있었는지 알 수 없습니다. 진단 중에는 추가 자동 재시도를 끄세요. 이전 요청이 백그라운드에서 계속 실행되면 다음 테스트 결과에 영향을 줄 수 있습니다.

문제가 발생하는 범위도 기록하세요. 특정 기기에서만 발생하는지, 같은 조직의 구성원 모두에게 발생하는지, 공식 상태 공지에서도 해당 기능의 장애를 알리는지 확인합니다. 범위는 한 번의 속도 측정보다 진단에 더 유용합니다. 특정 기기에서만 실패한다면 기기 시간, 프록시 설정, 브라우저 로그부터 살펴보세요. 조직 구성원 전체가 실패한다면 관리 정책과 프로젝트 상태를 먼저 확인하세요. 공식 장애가 확인되면 영향을 받는 기능을 기록하고 복구될 때까지 기다린 뒤 같은 환경에서 다시 테스트하세요. 일시적인 성공을 설정 변경의 효과로 오해하지 마세요.

플랫폼 지원 여부와 제품별 접속 경로

접속 경로를 확인한 다음 지원 범위 살펴보기

공식 문서를 찾을 때는 브랜드명만 검색하지 말고 제품명과 접속 경로를 정확히 입력하세요. 브라우저용 도구, 개발자 API, 클라우드 호스팅 모델, 기업용 에디터 플러그인은 지원 지역, 계정 유형, 결제 규칙을 각각 따로 정할 수 있습니다. 문서에서 사용자의 거주 지역, 결제 정보, 리소스 배포 지역 중 무엇을 기준으로 하는지 확인하고, 계정 생성이 가능한 것과 특정 기능을 사용할 수 있는 것을 구분하세요. 특정 지역이 언급되어 있더라도 개인 계정과 조직 계정 중 어느 쪽에 적용되는지, 필요한 모델이나 도구까지 해당 지역에서 지원되는지 확인해야 합니다.

플랫폼 접속 경로와 우선 확인 항목
도구혼동하기 쉬운 접속 경로우선 확인할 항목
ChatGPT대화 웹페이지와 개발자 API작업 공간, API 프로젝트, 결제
Claude대화 화면과 개발자 콘솔계정 유형, 조직, 모델 권한
Gemini개인 앱, 개발자 접속 경로, 클라우드 플랫폼계정 유형, 프로젝트, 리소스 위치
CopilotMicrosoft Copilot 및 GitHub Copilot구독, 조직 권한, 에디터 계정
Midjourney웹페이지와 공식 지원 Discord 접속 경로연결된 계정, 구독, 작업 상태
Cursor에디터 기능과 계정 관리 페이지현재 팀, 로그인 상태, 모델 표시 여부

대화형 도구와 개발자 제품을 따로 확인하기

ChatGPT나 Claude를 사용할 때 대화 웹페이지는 작동하지만 프로그램에서 프로젝트 권한이 없다는 오류가 발생한다면, 개발자 콘솔에서 해당 자격 증명이 속한 조직, 사용 가능한 모델, 결제 상태를 확인하세요. 웹 구독 상태로 API 할당량을 판단하거나 웹 세션을 스크립트 인증 정보로 사용하지 마세요. 특정 모델만 실패한다면 같은 프로젝트에서 권한이 확인된 모델과 비교하고 제품이 제공한 오류 코드를 살펴보세요. 이를 통해 프로젝트 전체의 문제, 모델 이름 불일치, 해당 모델 권한 부재를 구분할 수 있습니다.

Gemini 문제를 진단할 때는 개인용 앱, 개발자 제품, 클라우드 플랫폼을 구분해야 합니다. 개인 브라우저에서 대화에 성공해도 클라우드 프로젝트에서 해당 API가 허용된다는 뜻은 아닙니다. 클라우드 프로젝트에서 현재 사용자가 대상 프로젝트를 선택해 작업 중인지 확인한 다음, API가 요구하는 리소스 위치, 계정 역할, 결제 조건을 확인하세요. 조직 관리 계정이 특정 리소스에서만 허용된다면 관리자에게 확인하고 권한을 요청하세요. 조직 데이터를 개인 프로젝트로 처리해서는 안 됩니다. 비교 테스트에는 민감하지 않은 입력을 사용해 승인되지 않은 환경에 진단 샘플이 복사되지 않도록 하세요.

플러그인과 제작 도구의 계정 연결 확인하기

Copilot 문제를 진단할 때는 먼저 Microsoft 제품인지 GitHub 개발 도구인지 명확히 한 뒤, 웹페이지·데스크톱 앱·에디터 중 어디에서 문제가 발생하는지 확인하세요. 브라우저에 로그인된 계정과 에디터 확장 프로그램이 사용하는 계정은 다를 수 있습니다. 확장 프로그램에 로그인 표시가 있어도 계정 정보와 라이선스 출처를 확인하세요. 개인 저장소에서는 자동 완성이 되는데 조직 저장소에서는 안 된다면 조직 정책, 권한 범위, 현재 저장소 설정을 먼저 살펴보세요. 확장 프로그램을 계속 재설치하면 실제 권한 차이를 놓칠 수 있습니다.

Midjourney에서 작업은 제출됐지만 이미지가 나타나지 않는다면, 공식 접속 경로에서 작업이 접수됐는지, 완료됐는지, 미리보기 리소스를 불러올 수 있는지 확인하세요. 이미지 생성은 완료됐지만 다운로드가 실패한 경우와 작업 자체가 서버에 전달되지 않은 경우는 해결 방법이 다릅니다. Cursor 계정 페이지는 작동하지만 에디터에서 특정 모델만 호출할 수 없다면 현재 팀과 모델 권한을 확인한 다음, 문제가 로컬 환경인지 원격 에디터 실행 환경인지 살펴보세요. 에디터에 온라인으로 표시되어도 일부 요청만 성공했을 수 있습니다.

계정 생성과 세션 복구

계정을 만들기 전에 소유 주체 확인하기

본격적으로 작업하기 전에 계정을 누가 관리할지 결정하세요. 개인 테스트에는 본인 계정을, 팀 프로젝트에는 관리자가 지정한 조직 계정을 사용합니다. 정보를 입력하기 전에 공식 접속 경로, 이용 자격, 결제 주체를 확인하세요. 다른 사람의 계정을 빌리거나 출처가 불분명한 대행 채널에 정보를 제출하지 마세요. 저장소를 공유하거나 업무를 인계해야 한다면 개인 계정을 여러 동료와 공유하지 말고 관리자가 조직 권한으로 역할을 할당하도록 하세요. 계정 소유권과 내보내기 권한을 일찍 정해 두면 문제가 발생했을 때 담당자를 찾기 쉽습니다.

LiuVPN은 이메일 주소 없이 사용자 이름과 비밀번호만으로 계정을 만들 수 있습니다. 이는 LiuVPN 사용자 패널의 계정 생성 요건이며, AI 서비스 제공업체의 인증과는 별개입니다. 패널 계정과 타사 계정을 만들 때 서로 다른 비밀번호를 사용하세요. 패널 인증 정보로 타사 서비스에 로그인할 수는 없습니다. 팀원이 LiuVPN 구독을 이용해야 한다면 사용 가이드에 따라 사용자 패널에서 진행하세요. 구독 링크를 AI 대화, 공유 저장소, 공개 문의에 붙여넣지 마세요. 계정 인증 정보와 네트워크 구독 정보는 각각 용도에 맞게 안전하게 보관해야 합니다.

로그인 리디렉션 및 세션 저장 확인하기

싱글 사인온을 사용하면 제품이 브라우저를 인증 제공업체로 보냈다가 인증이 끝난 뒤 다시 제품으로 돌려보냅니다. 인증은 성공했는데 제품으로 돌아와도 로그인되지 않았다면 예상한 도메인으로 돌아왔는지, 인증 전후에 같은 브라우저 프로필을 사용했는지 먼저 확인하세요. 기본 브라우저, 앱 내장 창, 기업 관리 브라우저는 세션 저장소가 서로 다를 수 있습니다. 창을 바꿔 링크를 여는 것 자체는 문제가 아닐 수 있지만, 두 프로필이 세션을 공유하지 않으면 돌아온 인증 정보를 기존 로그인 과정과 연결하지 못할 수 있습니다.

격리된 브라우저 프로필을 사용해 비교할 수 있습니다. 이번에 필요한 공식 접속 경로만 열고, 오래된 사이트 데이터를 복사하지 않으며, 불필요한 확장 프로그램은 사용하지 마세요. 깨끗한 프로필에서 로그인할 수 있다면 기존 프로필의 개인정보 보호 확장 프로그램과 사이트 권한을 확인하세요. 관련 사이트에만 설정을 적용하고, 조직이 관리하는 설정은 관리자에게 맡기세요. 보안 보호 기능을 전역으로 해제해서는 안 됩니다. 사이트 데이터를 지워야 한다면 먼저 로컬 초안이 안전하게 저장됐는지 확인하고 해당 사이트의 데이터만 삭제하세요. 삭제 후에는 제품에서 로그인 절차를 다시 시작하고, 이전 로그인 중 사용한 리디렉션 주소를 재사용하지 마세요.

로그인 성공·세션 만료·권한 거부 구분하기

프로필 사진이 보인다는 것은 화면이 어떤 계정을 인식했다는 뜻일 뿐입니다. 계정 메뉴에서 조직과 작업 공간, 작업에 필요한 역할을 확인하세요. 서로 다른 인증 제공업체로 로그인한 비슷한 계정은 대화 기록과 권한이 다를 수 있습니다. 페이지가 간헐적으로 로그인 화면으로 돌아간다면 세션 만료 여부, 시스템 시간, 인증 제공업체의 공지를 확인하세요. 관리자 승인이 필요하다는 안내가 표시되면 요청 상태와 조직명을 기록해 관리자에게 문의하세요. 반복해서 로그아웃하고 다시 로그인해도 승인 결과는 달라지지 않습니다.

업무 인계 기록에는 실패한 단계와 민감 정보를 제거한 안내만 적고, 비밀번호, 복구 정보, 세션 값, 계정 정보가 포함된 전체 리디렉션 주소는 첨부하지 마세요. 리디렉션 전후의 공개 도메인, 브라우저 종류, 발생 시각은 기록할 수 있습니다. 낯선 기기에서 작업했다면 완료 후 세션에서 로그아웃하세요. 승인되지 않은 로그인 활동이 발견되면 서비스 제공업체의 계정 복구 절차에 따라 비정상 세션을 해지하고 관련 인증 정보를 점검한 뒤 네트워크 문제를 살펴보세요. 보안 사고와 일반 로그인 실패를 따로 기록해 즉시 대응해야 할 인증 정보 문제를 회선 불안정으로 잘못 분류하지 않도록 하세요.

웹페이지 로딩과 스트리밍 응답

응답이 어느 단계에서 멈추는지 확인하기

대화 결과는 서버가 생성을 끝낸 뒤에야 화면에 표시되는 것이 아닙니다. 스트리밍 API는 보통 클라이언트가 먼저 응답을 받은 다음 서비스의 이벤트 형식에 따라 텍스트와 최종 상태를 이어서 수신하게 합니다. 브라우저는 서버 전송 이벤트나 다른 스트리밍 방식을 사용할 수 있고, 에디터는 이벤트를 확장 프로그램 프로세스로 전달할 수 있습니다. 요청이 전송됐는지, 응답 헤더가 도착했는지, 본문 일부를 받았는지, 종료 표시까지 받았는지 각각 확인하세요. 멈춘 단계에 따라 원인이 달라지므로 화면에 표시된 대기 안내만 봐서는 안 됩니다.

응답 헤더가 오랫동안 도착하지 않으면 연결이 아직 설정되지 않았거나 요청은 도달했지만 서비스가 대기열에서 처리 중일 수 있습니다. 본문 일부를 받았다면 이번 요청에서 응답이 적어도 일부 시작된 것이지만, 생성 중에 중단될 수도 있습니다. 새 내용 없이 일정 시간이 지나면 응답이 끊기는 경우 중간 게이트웨이, 클라이언트의 유휴 시간 제한을 확인하세요. 응답 직후 곧바로 끊긴다면 애플리케이션 오류, 사용자 취소 신호, 작업 프로세스 종료 여부를 살펴보세요. 서비스가 명확한 종료 사유와 함께 완료를 알렸다면 먼저 그 사유를 확인하세요. 출력 한계에 도달한 일을 전송 장애로 기록하지 마세요.

브라우저 네트워크 패널에서 요청 비교하기

공식 웹페이지에서 브라우저 개발자 도구를 열고 네트워크 패널로 이동한 뒤, 개인정보가 없는 짧은 문장을 다시 전송하세요. 시작 시각으로 요청을 찾아 실패 항목의 상태와 타임라인을 살펴보고 제품 화면의 안내와 비교합니다. 네트워크 패널에서 로컬 확장 프로그램이 요청을 차단한 것으로 보이면 관리된 깨끗한 프로필에서 확인하세요. 브라우저의 인증서 검증으로 연결이 차단됐다면 시스템 시간, 신뢰할 수 있는 인증서, 조직 게이트웨이 설정을 확인하세요. 인증서 오류를 무시하고 계속 접속해서는 안 됩니다. 일부 페이지 데이터는 백그라운드 작업 프로세스에서 처리되므로 화면에 오류가 나타난 시점은 실제 요청 실패보다 늦을 수 있습니다.

이어서 같은 모델과 대화 유형으로 조금 더 긴 일반 작업을 테스트하세요. 짧은 작업은 완료되지만 긴 작업이 자주 잘린다면 마지막 텍스트를 받은 시각, 종료 상태, 문제가 발생한 범위를 기록한 다음 일률적인 제한 시간이나 유휴 시간 제한이 있는지 확인하세요. 답변이 항상 종료 시점에 한꺼번에 나타난다면 중간 계층의 버퍼링, 클라이언트 표시 방식, 서비스가 실제로 조각 단위 응답을 지원하는지 살펴보세요. 화면에 텍스트가 표시되는 속도만으로 회선 지연을 판단하지 마세요. 같은 요청의 기록을 확인해 데이터 도착 시점과 화면 표시 시점을 구분해야 합니다.

파일 업로드와 백그라운드 전환을 따로 확인하기

일반 텍스트는 정상인데 첨부 파일에서 실패한다면 플랫폼 규칙에 맞는 민감 정보가 없는 작은 파일로 테스트하세요. 업로드 전, 업로드 후 처리 단계, 생성 단계 중 어디에서 실패했는지 기록합니다. 업로드 전 실패라면 브라우저가 파일을 읽을 수 있는지, 업로드 대상 주소에 연결되는지, 조직에서 업로드를 허용하는지 확인하세요. 업로드 후 실패라면 파일 형식, 서버 처리 결과, 현재 도구의 권한을 확인하세요. 파일을 제거하고 요청이 성공했다고 해서 파일 크기가 너무 크거나 네트워크가 혼잡하다고 단정할 수는 없습니다. 같은 대화에서 파일을 하나씩 비교해야 원인을 찾기 쉽습니다.

기기가 화면 전환으로 백그라운드에 들어가거나 절전 상태가 되면 브라우저가 페이지 작업을 일시 중지하거나 시스템이 접속을 바꿀 수 있습니다. 먼저 화면을 켜 둔 상태에서 테스트가 안정적인지 확인한 뒤 전환 상황을 따로 재현하세요. 실패 후에는 기존 대화에 생성 결과가 있는지, 작업이 여전히 실행 중인지 확인하세요. 특히 요금이 발생하거나 동작을 실행할 수 있는 요청을 곧바로 다시 제출하지 마세요. 문의를 제출할 때는 민감 정보를 제거한 상태, 시각, 요청 식별자를 제공할 수 있습니다. 확인하지 않은 네트워크 기록에는 대화 내용, 첨부 파일 주소, 인증 정보가 포함될 수 있으므로 그대로 보내서는 안 됩니다.

API 요청·시간 초과·할당량

웹 테스트와 API 테스트를 분리하기

웹페이지에서는 브라우저가 세션을 관리하지만, API 호출에서는 애플리케이션이 프로젝트용 서비스 자격 증명을 보관하고 API 문서에 지정된 모델, 입력 형식, 응답 방식을 사용합니다. 웹페이지에서 답변이 생성된다는 것은 웹 접속 경로를 사용할 수 있다는 뜻일 뿐입니다. API를 디버깅하기 전에 공식 엔드포인트, API 유형, 프로젝트 환경을 확인하고, 자격 증명이 환경 변수나 비밀 정보 관리 시스템을 통해 전달되며 테스트 프로젝트와 운영 프로젝트가 혼용되지 않았는지 살펴보세요. 자격 증명을 프런트엔드, 테스트 예제, 커밋 기록에 넣지 마세요. 오류를 조사하려고 모든 요청 헤더를 출력해서도 안 됩니다.

문서에서 지원하는 최소한의 비스트리밍 요청을 먼저 실행하세요. 권한이 확인된 모델과 비공개 정보가 없는 짧은 입력을 사용하고, 상태 코드, 서버 요청 식별자, 민감한 필드를 제거한 오류 코드를 기록합니다. 응답이 완전히 돌아오는 것을 확인한 뒤 같은 입력으로 스트리밍 모드를 테스트하세요. 비스트리밍 요청은 성공하지만 스트리밍이 실패한다면 클라이언트가 이벤트 경계를 올바르게 읽는지, 읽기 단위를 완전한 이벤트로 잘못 처리하는지, 게이트웨이가 응답을 버퍼링하는지 확인하세요. 스트리밍 응답의 이벤트는 여러 조각으로 나뉘어 전송될 수 있으므로 임의의 네트워크 청크를 그대로 디코딩하지 말고 프로토콜에 맞게 파싱해야 합니다.

연결·읽기·전체 시간 제한을 각각 설정하기

API 시간 제한의 범위
매개변수 종류적용되는 단계시간 제한 발생 시 먼저 확인할 항목
연결 시간 제한연결을 설정하는 데 걸리는 시간이름 확인, 게이트웨이, 인증서 핸드셰이크
읽기 유휴 시간 제한다음 데이터가 올 때까지 기다리는 유휴 시간버퍼링 동작, 생성 간격, 프록시 유휴 설정
전체 제한 시간작업 한 번에 허용되는 총 시간대기열, 생성 시간, 호출 측 예산

클라이언트마다 시간 제한 매개변수의 이름과 타이머 시작 시점이 다릅니다. SDK를 선택할 때 읽기 제한 시간이 인접한 읽기 사이에 적용되는지, 전체 응답에 적용되는지 확인하세요. 연결 재사용 여부도 시간 계산에 영향을 줍니다. 전체 제한 시간은 비즈니스 요구에 맞춰 정하고 후속 처리 시간을 남겨 두세요. 바깥 작업이 먼저 취소됐는데 내부 클라이언트가 계속 기다리거나 재시도하면 호출이 리소스를 계속 점유합니다. 취소 신호를 내부 호출까지 전달하고 로그에서는 직접 취소, 시간 초과, 원격 종료를 구분하세요. 모두 같은 네트워크 오류로 기록하지 않도록 합니다.

오류를 먼저 확인하고 재시도 여부 결정하기

인증 오류가 발생하면 자격 증명이 현재 프로젝트에 속하는지, 폐기되지 않았는지, 프로세스가 어떤 설정을 불러왔는지 확인하세요. 권한 오류는 모델과 조직 역할을 확인하고, 매개변수 검증 오류는 문서에 맞게 요청 본문을 수정하세요. 조건을 바꾸지 않은 상태에서는 이런 응답을 재시도해도 해결되지 않습니다. 속도 제한에 도달했다면 오류 본문과 서버의 재시도 안내를 확인해 일시적인 동시 요청 초과인지 전체 할당량 소진인지 구분하세요. 전자라면 동시 실행 수를 낮추고 요청을 대기열에 넣을 수 있습니다. 후자라면 작업을 중지하고 예산과 할당량을 확인한 뒤 조건이 회복되거나 공식 신청 절차를 이용할 때까지 기다리세요.

재시도해도 되는 일시적 장애에는 횟수 제한이 있는 지수 백오프와 무작위 간격을 사용해 여러 작업 프로세스가 동시에 요청을 다시 보내지 않도록 하세요. SDK가 이미 재시도하고 있다면 외부 스케줄러가 무한 재투입하지 않게 해야 합니다. 시간 초과가 발생했다고 서버에서 작업을 실행하지 않았다는 뜻은 아닙니다. 작업 생성이나 요금 청구가 발생할 수 있는 요청이라면 먼저 작업 상태를 확인하세요. 서비스 제공업체가 멱등성 식별자를 공식 지원하는 경우에만 안내된 규칙에 따라 사용하세요. 임의의 사용자 지정 헤더가 중복 요청을 제거한다고 가정하면 안 됩니다. 스트리밍 결과를 일부 받은 상태라면 내용이 미완성임을 표시하고, 업무 동작과 텍스트 수신 상태를 따로 관리하세요.

CLI·에디터·CI 설정

실제로 요청을 보내는 프로세스에서 확인하기

CLI, 데스크톱 에디터, 파이프라인은 서로 다른 호스트에서 실행될 수 있습니다. 원격 개발 플러그인은 화면을 로컬에 표시하면서 실제 요청은 원격 머신이나 컨테이너의 확장 프로세스에서 보낼 수 있습니다. 먼저 요청을 보내는 프로세스, 실행되는 네트워크, 사용하는 설정 경로를 확인한 다음 같은 환경에서 기본 진단을 수행하세요. 개발자 로컬 브라우저가 연결된다고 해서 실행 에이전트도 연결된다는 뜻은 아닙니다. 스크립트로 명령을 실행한다면 시작 시 예상한 작업 디렉터리와 설정을 읽는지, 이전 프로세스에 남은 환경을 사용하지 않는지 확인하세요.

curl이 설치된 환경에서는 공개 예제 사이트를 사용해 기본적인 이름 확인, 연결, TLS 경로를 검사할 수 있습니다. 아래 명령은 계정 정보를 전송하지 않으며 AI API에 접속할 필요도 없습니다. 오류 문구를 보면 이름 확인 실패, 접속 게이트웨이 실패, 원격 서버 응답을 구분하는 데 도움이 됩니다. 성공해도 해당 프로세스가 예제 대상에 접속할 수 있다는 뜻일 뿐, 대상 AI 서비스가 지원된다는 뜻도 스트리밍 응답이 끊기지 않는다는 뜻도 아닙니다. 이어서 같은 환경에서 서비스 제공업체가 안내한 최소 API 테스트를 실행하고 공식 문서에 따라 오류를 확인하세요.

curl --silent --show-error --fail --output /dev/null \
  --write-out '%{http_code}\n' \
  https://example.com/

프록시 적용 범위와 인증서 신뢰 확인하기

사용하는 도구가 시스템 프록시를 읽는지, 아니면 프로세스에 HTTPS_PROXY 같은 변수를 직접 지정해야 하는지 확인하세요. 모든 SDK가 같은 이름의 변수를 읽는 것은 아니며 NO_PROXY의 일치 규칙도 런타임에 따라 다를 수 있습니다. 수정하기 전에 해당 도구의 설정 우선순위를 확인하고 명령 인수, 사용자 설정, 환경 변수 중 무엇이 우선하는지 파악하세요. 설정을 바꾼 뒤 대상 프로세스를 다시 시작하고 애플리케이션이 새 설정을 적용했는지 확인하세요. 이미 실행 중인 확장 프로그램이나 작업은 다른 터미널의 새 환경 변수를 자동으로 가져오지 않는 경우가 많습니다.

에디터의 본체, 확장 프로그램, 원격 환경을 각각 확인하세요. 확장 로그에 연결 실패가 표시되면 인증 페이지, 모델 호출, 백그라운드 인덱싱 중 어느 기능의 오류인지 먼저 확인하고 필요한 경우 해당 모듈의 설정 범위를 살펴보세요. 회사 게이트웨이에서 신뢰할 수 있는 인증서를 요구한다면 관리자가 배포하고 검증한 인증서를 실제 요청을 보내는 런타임에 설정하세요. 로컬 브라우저에만 설치해서는 충분하지 않습니다. 오류를 없애려고 인증서 검증을 끄지 마세요. 프록시 규칙이 내부 주소를 조직 네트워크 밖으로 보내는 것 같다면 테스트를 중단하고 관리자에게 규칙 범위를 확인하세요.

CI 접속 정책을 파이프라인 설정에 반영하기

CI에는 전용 프로젝트 계정과 필요한 최소 권한을 사용하고, 자격 증명은 보호된 비밀 정보 저장소에 보관해 승인된 작업에만 주입하세요. 외부 기여로 실행되는 작업에 검토되지 않은 코드가 운영 자격 증명을 사용하게 해서는 안 됩니다. 서비스가 접속 출처 검토를 요구한다면 개인 세션을 파이프라인에 넘기지 말고 관리자가 조직 정책에 따라 실행 에이전트와 출구 규칙을 설정해야 합니다. 로그에는 설정의 존재 여부, 대상 환경 유형, 민감 정보를 제거한 서비스 오류만 출력하세요. 환경 변수를 전부 출력하거나 요청 본문과 원문 응답을 기본 빌드 결과물에 포함하지 마세요.

격리된 작업 하나부터 시작해 오류를 다시 확인하세요. 먼저 같은 실행 에이전트의 기본 네트워크를 확인하고 최소 API 호출을 테스트한 다음 동시 실행을 복구합니다. 여러 작업이 동시에 시작될 때는 각 작업의 제한만 둘 것이 아니라 스케줄러에서 전체 동시 실행 수를 관리해야 합니다. 개발 브랜치에서는 예측 가능한 테스트 응답으로 오류 처리와 파싱을 확인하는 것이 좋습니다. 실제 호출이 필요하다면 승인된 환경으로 제한하세요. 이렇게 하면 상위 서비스 장애가 발생해도 애플리케이션 회귀, 공유 할당량 부족, 실행 에이전트 접속 문제를 구분할 수 있습니다.

계정 제한과 요청 속도 제한

제한이 적용된 대상을 먼저 확인하기

“계정 정지”라는 표현은 계정 비활성화, 조직 권한 취소, 결제 상태 변경, 작업 전 인증 요구, 할당량에 따른 API 요청 거부 등 여러 상황을 가리킬 수 있습니다. 제품 안내에서 제한의 대상이 계정, 조직, 프로젝트, 자격 증명, 현재 요청 중 무엇인지 먼저 확인하세요. 제품의 공식 알림과 콘솔 상태를 살펴보고 한 번의 페이지 오류만으로 결론 내리지 마세요. 계정 페이지에는 들어갈 수 있지만 팀 리소스가 보이지 않는다면 관리자에게 구성원 계정을 확인해 달라고 하세요. 프로젝트의 모든 구성원이 거부된다면 구성원마다 비밀번호를 재설정하기보다 프로젝트 설정과 결제 상태를 확인해야 합니다.

일시적인 확인 요청이라면 공식 계정 인증 절차를 완료하세요. 완료 후에도 실패한다면 안내에 있는 요청 식별자나 이의 제기 경로를 저장하고 기존 계정으로 공식 지원 채널에 문의하세요. 계정이 비활성화됐다는 안내가 명확하다면 자동 작업을 중단하고 안내와 처리 결과를 기다리세요. 새 계정이나 다른 사람의 계정을 만들어 기존 작업을 계속해서는 안 됩니다. 상태 안내가 없고 특정 작업에서만 오류가 발생한다면 같은 계정으로 권한이 확인된 일반 작업을 시도해 권한 범위를 비교하세요. 거부된 작업을 반복해서 실행해도 유효한 증거가 늘지 않으며 서비스 제공업체의 진단을 방해할 수 있습니다.

예방 가능한 경고 요인 줄이기

위험 판단에는 계정 사용의 연속성, 요청 방식, 이용 패턴 등이 반영될 수 있습니다. 계정 공유, 개인 세션을 백그라운드 스크립트에 사용, 인증을 반복 요청, 짧은 시간에 많은 작업을 갑자기 시작하는 행동은 정상적인 사용도 비정상적으로 보이게 할 수 있습니다. 팀에서는 구성원별로 권한을 부여하고 자동화에는 명시적으로 허용된 API와 프로젝트 계정을 사용하며, 수동 작업과 일괄 처리를 구분하세요. 퇴사나 프로젝트 종료 시 관련 권한을 제때 취소해야 합니다. 브라우저에 저장된 세션을 다른 기기나 프로세스로 옮기지 마세요. 새 클라이언트에서 작업해야 한다면 제품이 제공하는 인증 절차를 사용하세요.

부하가 갑자기 늘었다면 작업 스케줄러가 중복 실행하는지, 여러 실행 프로세스가 같은 자격 증명을 공유하는지, SDK 안팎에서 동시에 재시도하는지 먼저 확인하세요. 할당량에 도달했을 때 같은 작업을 승인되지 않은 다른 프로젝트로 옮겨서는 안 됩니다. 우선순위가 낮은 요청을 일시 중지하고 중복 작업을 하나의 대기열로 합치세요. 재사용할 수 있는 민감하지 않은 결과가 있는지 확인하고 서비스 제공업체의 공식 절차에 따라 할당량을 조정하세요. 한도를 복구하기 전에 요청 급증의 원인이 된 스케줄링 문제를 해결하지 않으면 적체된 작업이 대기열을 다시 가득 채울 수 있습니다.

이의 제기 및 정보 유출 대응 기록 준비하기

서비스 제공업체에 문의할 때 제품 접속 경로, 발생 시각과 시간대, 민감 정보를 제거한 오류 내용, 영향을 받은 작업 공간, 공개 가능한 요청 식별자를 제공하세요. 정상적으로 작동하는 기능도 함께 알려 주면 계정 제한과 특정 기능의 장애를 구분하는 데 도움이 됩니다. 조직 계정은 관리자가 문의 권한을 확인해야 합니다. 타사 AI 서비스의 계정이나 결제 문제라면 LiuVPN에서 권한을 바꾸거나 이의 제기를 대신 처리할 수 없습니다. 네트워크 문제는 별도로 기록해 서로 다른 지원 요청이 검증하기 어려운 하나의 문제로 섞이지 않도록 하세요.

설명할 수 없는 API 호출, 비정상 결제, 프로젝트에 등록된 낯선 자격 증명이 발견되면 유출 가능성에 대비하세요. 영향을 받은 자격 증명 사용을 중단하고 공식 콘솔에서 폐기 및 교체한 뒤 작업 로그, 빌드 결과물, 공유 문서에서 노출 경로가 있었는지 확인합니다. 로그 한 줄을 삭제해도 이미 공개된 자격 증명은 무효화되지 않습니다. 조치가 끝나면 승인된 환경에서 최소 요청을 보내 모니터링에 이전 계정 활동이 남아 있는지 살펴보고, 정상 작업이 새 자격 증명을 사용하도록 바뀌었는지 확인한 다음 운영 트래픽을 재개하세요.

국제 회선 선택 및 재검증

지역명만으로 판단하지 말고 실제 작업으로 확인하기

LiuVPN은 120+ 국가 / 220+ 회선을 지원합니다. 회선 페이지에서 지역과 회선 유형을 확인한 다음 클라이언트에서 현재 선택할 수 있는 항목을 살펴보세요. 직결, 중계, IEPL 전용 회선은 경로 구성 방식을 나타낼 뿐, 타사 AI 계정의 이용 자격을 직접 결정하지 않습니다. 직결 성능은 접속 환경과 상대 서버에 따라 달라집니다. 중계는 추가 전달 단계가 필요하며, 전용 회선 표시가 로컬에서 타사 서비스까지 모든 구간이 동일한 전용 경로라는 뜻은 아닙니다. 회선을 고르기 전에 지역 지원 여부와 조직 네트워크 정책을 확인하고 전체 작업 결과를 비교하세요.

권한이 확인된 같은 작업 공간을 사용해 비교하세요. 주로 텍스트 대화를 한다면 로그인, 새 대화 생성, 첫 응답, 종료 상태, 대화 다시 열기 여부를 기록하세요. 에디터 협업이 주된 용도라면 로그인 상태, 모델 호출 한 번, 정상적인 취소가 예상대로 작동하는지 확인합니다. 파일을 사용하는 경우에는 민감 정보가 없는 샘플로 업로드와 접근 결과를 따로 테스트하세요. 접속 경로만 바꾸고 나머지 조건은 유지하세요. 회선을 바꾼 뒤 끝나지 않은 요청을 재사용하지 말고 기존 요청의 상태를 확인한 다음 새 테스트를 시작하세요.

회선 현상·이용 권한·용량 구분하기

불안정 문제가 재현되면 클라이언트에 표시된 회선명, 사용한 플랫폼, 발생 시간대, 관찰한 동작을 기록하세요. 한 번 성공하거나 실패한 결과만으로 장기적인 성능을 단정하지 마세요. 같은 회선에서 여러 대상의 연결이 끊긴다면 로컬 접속 환경과 클라이언트 상태를 추가로 확인할 수 있습니다. 특정 제품의 특정 기능만 실패하고 명확한 권한 또는 결제 안내가 표시된다면 제품 콘솔로 돌아가 확인하세요. 모바일 네트워크에서 Wi-Fi로 바꿔 테스트했다면 원래 환경으로 돌아가 비교해 접속 환경의 변화와 타사 서비스 문제를 혼동하지 않도록 하세요.

동시 접속 기기 수에는 제한이 없습니다. 여러 기기에서 교차 검증할 때는 플랫폼별 차이를 기록하고 각 기기의 세션과 권한이 자동으로 동기화된다고 가정하지 마세요. 용량은 자신의 사용 기록을 기준으로 가늠해야 합니다. 짧은 텍스트, 파일 업로드, 이미지 다운로드, 에디터 백그라운드 작업은 각각 사용하는 데이터 양이 다르며 모델 요금이나 입력 문자 수로 네트워크 데이터 사용량을 계산할 수 없습니다. 비교가 필요하면 같은 유형의 작업에서 실제 사용량을 살펴보고 백그라운드 업데이트 같은 무관한 트래픽은 기록에서 제외한 뒤 요금제 페이지에서 월 구독과 데이터 패키지 규칙을 확인하세요.

복구 기준을 기록에 남기기

재검증 기록에는 최소한 환경, 문제를 일으킨 동작, 원래 관찰된 신호, 변경 내용, 재검증 결과가 명확히 들어가야 합니다. 환경에는 기기, 접속 경로, 조직을 포함하세요. 신호에는 공개된 오류 코드, 발생 단계, 시각을 기록할 수 있습니다. 비밀 정보는 남기지 말고 변경 내용은 동작을 다시 수행할 수 있을 만큼 구체적으로 적으세요. 복구를 판단할 때는 원래 실패한 동작을 반복하고 결과가 실제로 사용 가능한지 확인해야 합니다. 웹페이지는 프로필 사진만 보지 말고, 스트리밍 응답은 시작 부분만 보지 말며, API 작업은 요청이 전송됐다는 사실만으로 판단하지 마세요. 문제가 계속 재현되지 않는다면 관찰 대기 상태로 표시하고 일시적인 정상 작동을 완전한 해결로 기록하지 마세요.

클라이언트의 기본 연결 확인을 아직 마치지 않았다면 첫 사용 점검 목록에 따라 구독 가져오기와 연결 상태를 확인한 뒤 이 매뉴얼로 돌아오세요. LiuVPN 클라이언트나 회선 문제로 확인됐다면 사용자 패널 문의로 민감 정보를 제거한 기록을 제출하세요. 타사 서비스의 이용 자격, 계정, 모델 권한 문제라면 해당 서비스 제공업체나 조직 관리자에게 문의해야 합니다. 이번에 확인한 조건은 그대로 보존하고 다음에는 아직 확인하지 않은 단계부터 진행하세요. 전체 설정을 다시 바꿀 필요는 없습니다.