문제 해결
에이전트 연결, 대화 공유, 작업 승인, Git 변경, WSL과 업데이트 문제를 확인합니다.
문제가 생기면 먼저 실행 환경, AI 제공자 계정, 프로젝트 경로를 확인하세요. 같은 화면에서도 로컬 PC와 원격 서버는 파일·인증·대화 저장 위치가 다릅니다. 이 문서는 v1.0.0의 화면과 동작을 기준으로 합니다.
에이전트가 설치되지 않았다고 나옵니다
- 설정 → AI 제공자에서 문제가 있는 제공자와 실행 환경을 선택합니다.
- 실행 파일 경로를 확인합니다. Codex와 Claude는 데스크톱 앱에 포함된 CLI를 먼저 찾고, 없으면 해당 환경의
PATH를 확인합니다. - 감지된 실행 파일을 선택하거나 설치한 실행 파일의 전체 경로를 지정합니다.
- 설치가 필요하면 별도 CLI 설치 → 설치 명령 보기의 안내를 따릅니다.
Windows에 설치한 CLI는 WSL이나 SSH 서버에 자동으로 설치되지 않습니다. 원격 환경을 선택했다면 그 환경에서 실행할 수 있는 경로여야 합니다. 자세한 연결 절차는 AI 제공자와 모델을 참고하세요.
로그인 창이 열리지 않거나 인증이 끝나지 않습니다
제공자 화면에 로그인 링크 복사가 있으면 링크를 복사해 브라우저에서 직접 엽니다. 아래 터미널에서 로그인을 완료하세요라는 안내가 나오면 해당 터미널의 절차를 끝내야 합니다.
브라우저에서 로그인한 뒤에는 Liverary의 인증 상태도 확인하세요. 다른 계정이나 다른 실행 환경에 로그인한 경우 현재 대화에서는 인증이 완료되지 않은 것으로 보일 수 있습니다. 추가 계정은 별도의 홈 폴더를 사용하므로 기본 CLI 계정과 구분해야 합니다.
다른 앱의 대화가 보이지 않습니다
수동 가져오기 버튼을 찾는 대신 다음 순서로 확인합니다.
- 원래 대화를 만든 컴퓨터와 Liverary의 실행 환경이 같은지 확인합니다.
- 같은 제공자 계정과 세션 저장소를 사용하고 있는지 확인합니다.
- 설정 → AI 제공자 → 세션 공유에서 자동 조회 지원 여부와 최근 오류를 확인합니다.
- 원래 앱의 작업이 아직 실행 중이라면 끝낸 뒤 Liverary에서 이어 씁니다.
Cursor SDK 저장소는 Cursor IDE·CLI의 대화 목록과 다르고, Antigravity의 원래 IDE 세션은 자동 공유하지 않습니다. 제공자 홈 경로를 바꾼 뒤 이전 대화가 이어지지 않으면 원래 사용하던 저장소 경로를 확인하세요. 전체 지원 범위는 대화 이어쓰기에 있습니다.
새 모델이 목록에 없습니다
먼저 제공자가 연결·인증된 상태인지 확인합니다. 설정 → AI 제공자의 모델 설정에서 해당 모델을 선택기에 숨기지 않았는지 확인하세요.
AI 제공자 버전 확인은 설치된 CLI의 새 버전과 모델 목록을 확인합니다. 이 설정을 끄면 새 모델이 바로 나타나지 않을 수 있습니다. 모델을 목록에 추가하는 것과 해당 계정에서 사용할 권한을 갖는 것은 별개입니다. 제공자가 반환한 인증·사용량 오류가 있다면 그 내용을 함께 확인하세요.
응답이 멈춘 것처럼 보입니다
| 보이는 상태 | 확인할 내용 |
|---|---|
| 승인 대기 | 해당 대화를 열어 실행할 명령이나 파일 변경 요청을 확인합니다. |
| 입력 대기 | 에이전트가 질문이나 선택지에 대한 답을 기다리는지 확인합니다. |
| 사용량 제한 | 제공자가 표시한 한도와 재개 가능 시점을 확인합니다. |
| 연결 오류 | 선택한 실행 환경과 제공자의 연결 상태를 확인합니다. |
| 실행 중 | 진행 메시지와 도구 실행 상태를 확인합니다. 메시지 접수가 곧 작업 완료는 아닙니다. |
전체 권한을 선택했더라도 제공자 자체 규칙이나 생략할 수 없는 확인 절차가 적용될 수 있습니다. 승인 카드에 **승인을 요청하는 이유는 무엇인가요?**가 표시되면 그 설명을 확인하세요.
작업 방향을 바꿔야 한다면 중단 또는 화면에 표시된 중지 동작으로 현재 작업을 멈춘 뒤 요청을 조정합니다. 권한과 계획 모드의 차이는 대화와 작업 진행에서 설명합니다.
변경 내용이나 파일이 기대와 다릅니다
먼저 현재 대화가 사용하는 프로젝트 경로와 워크트리를 확인합니다. 워크트리에서 한 수정은 원래 체크아웃과 다른 폴더에 있습니다.
변경 내용 패널의 범위도 확인하세요. 커밋하지 않음과 최근 작업, 특정 커밋은 비교 대상이 다릅니다. 작업이 끝나기 전에는 턴별 변경 내용과 체크포인트 정리가 아직 진행 중일 수 있습니다. Git 저장소가 아닌 폴더에서는 Git 체크포인트를 만들지 않습니다.
파일 미리보기가 일부만 표시되면 화면의 크기·행·페이지 제한 안내를 확인하고, 필요한 경우 다른 프로그램으로 엽니다. 미리보기 제한을 파일 내용이 삭제된 것으로 판단하지 마세요.
되돌리기 전에 파일 변경을 유지하고 대화 되돌리기와 파일도 함께 되돌리기의 차이를 확인하세요. 자세한 변경 검토와 복원 범위는 파일·터미널·Git에 정리했습니다.
WSL 프로젝트가 사라진 것처럼 보입니다
설정 → 공유 및 접근 → WSL 백엔드와 선택한 배포판을 확인합니다. WSL을 꺼도 그 안의 프로젝트와 대화는 배포판에 남아 있으며, 해당 환경을 다시 켜면 사용할 수 있습니다.
WSL만 사용에서는 Windows 환경의 프로젝트에 접근하지 않습니다. Windows 프로젝트도 필요하면 Windows와 WSL 함께 실행을 확인하세요. 배포판을 전환하면 현재 배포판의 실행 중 세션이 중단되므로 작업을 마친 뒤 변경합니다. 실행 환경 연결에서 각 방식의 차이를 확인할 수 있습니다.
업데이트 후에도 버전이 그대로입니다
설정 → 앱 정보에서 현재 Liverary 버전을 확인합니다. T3 Code 기반 버전과 혼동하지 마세요.
다운로드가 완료되어도 재시작·설치를 아직 하지 않았다면 실행 중인 버전은 그대로입니다. 업데이트 버튼의 상태를 확인하고 다시 시작하여 업데이트를 진행합니다. 업데이트가 적용되지 않았습니다가 표시되면 해당 업데이트의 설치를 다시 시도합니다.
이전 버전 체계의 T3 Custom·Ondam·Liverary에서 2026년 11월 14일의 새 v1.0.0으로 전환하는 경우에는 최신 EXE를 직접 실행해야 합니다. 설정과 업데이트의 전환 절차를 따르세요.
해결되지 않으면
문제를 재현한 뒤 아래 정보를 함께 정리하면 원인을 확인하기 쉽습니다.
- 앱 정보의 Liverary 버전과 사용 중인 운영체제
- 로컬·SSH·WSL 등 실행 환경, 사용한 제공자와 모델
- 어떤 동작을 했는지, 기대한 결과와 실제 결과
- 화면의 오류 문구와 필요한 경우 해당 대화 ID
설정 → 유지 관리에서 진단 보기를 눌러 프로세스와 로그를 확인하거나 명령 팔레트의 문제 진단을 실행할 수 있습니다. 문제 진단은 선택한 에이전트와 진단 자료를 사용해 원인을 조사하는 기능입니다. GitHub 이슈에 올릴 때는 내용을 확인하고 인증 정보나 불필요한 개인 파일 내용은 제외하세요.