문제 해결
대부분의 빌드 실패는 TeX 환경 또는 누락된 패키지와 관련이 있습니다. 본 가이드는 증상별 해결책을 제시합니다.
진단 명령
터미널을 열고 다음을 실행합니다:
TeX64 내에서도 확인: 설정 > 환경에서 환경 상태를 검증합니다
TeX 환경 문제
"latexmk not found"
원인: TeX 배포판이 설치되지 않았거나 PATH에 없음
해결:
- https://www.tug.org/mactex/ 에서 MacTeX 설치
- 또는: sudo tlmgr install latexmk
- 확인: which latexmk
- 설치 후 TeX64 재시작
"lualatex not found"
원인: TeX 배포판이 설치되지 않음
해결: MacTeX 설치 (lualatex 포함)
"latexindent not found"
해결:
참고: latexindent는 선택 사항(코드 포매팅용)이며, 빌드는 없이도 동작합니다
"synctex not found"
해결: MacTeX에 기본 포함, 또는: sudo tlmgr install synctex
synctex가 없으면 SyncTeX 내비게이션이 동작하지 않습니다
.sty 패키지 누락
오류: "File xxx.sty not found"
해결:
검색:
PATH 문제
확인: echo $PATH
MacTeX의 /Library/TeX/texbin 또는 Homebrew의 /opt/homebrew/bin이 포함되어야 합니다
해결: ~/.zshrc에 추가: export PATH="/Library/TeX/texbin:$PATH"
터미널과 TeX64 재시작
빌드 문제
빌드 실패와 오류
빌드 출력 패널에서 오류 메시지를 확인합니다. 오류를 클릭하면 소스 행으로 이동합니다.
일반적인 원인: LaTeX 명령어 오타, 중괄호 불일치, 패키지 누락
팁: AI(Axiom)로 진단하세요 - 오류를 붙여넣거나 채팅으로 문의
PDF가 갱신되지 않음
PDF는 성공한 빌드에서만 갱신됩니다. 빌드 출력에서 오류를 확인하세요.
툴바의 빌드 버튼으로 재빌드합니다.
빌드가 느림
이미지가 많은 대형 프로젝트는 시간이 더 걸립니다.
latexmk는 증분 컴파일을 사용합니다 - 두 번째 빌드는 더 빠릅니다.
첫 빌드는 패키지 다운로드로 느릴 수 있습니다
SyncTeX 문제
SyncTeX 작동 안 함
synctex 설치 확인: which synctex
툴바의 빌드 버튼으로 프로젝트를 재빌드하여 .synctex.gz 파일을 생성합니다
설정 > 환경에서 초록 체크 확인
SyncTeX가 잘못된 위치로 이동
일부 LaTeX 패키지가 소스 매핑을 방해합니다
다중 파일 프로젝트: \input/\include 경로가 올바른지 확인
macOS 문제
Gatekeeper
Control+클릭(우클릭) → 열기 또는: 시스템 설정 > 개인 정보 보호 및 보안 > 허용
화면 기록 권한 (OCR용)
시스템 설정 > 개인 정보 보호 및 보안 > 화면 기록 > TeX64 활성화
권한 부여 후 TeX64 재시작이 필요할 수 있습니다
"App is Damaged"
DMG를 다시 다운로드합니다. 아키텍처가 올바른지 확인하세요(Apple Silicon vs Intel)
AI/Axiom 문제
AI 기능을 사용할 수 없음
먼저 로그인 상태를 확인한 뒤 계정 > 결제를 확인하세요
AI(채팅·자동완성)는 모든 플랜에서 제공되며, 무료 플랜에도 매월 소량의 체험 한도가 포함됩니다. 작동이 멈추는 가장 흔한 원인은 월간 토큰 한도를 모두 사용했거나(또는 결제가 연체된) 경우입니다 — 충전하거나 다음 주기를 기다리세요.
토큰 할당량 확인: 계정 > 사용량
인터넷 연결 확인
AI 응답이 느리거나 타임아웃
인터넷 연결 확인
서버 부하 가능성 - 잠시 후 다시 시도하세요
레이트 리미트: 분당 30회 요청
계정 및 로그인
Google 로그인 실패
인터넷 연결 확인. 브라우저 쿠키/캐시 삭제 후 다시 로그인하세요.
구독이 반영되지 않음
결제 변경 사항이 반영되는 데 몇 분이 걸릴 수 있습니다
결제가 실패한 경우, Stripe 빌링 포털에서 결제 수단을 갱신하세요
유예 기간: 결제 실패 후 3일 동안 기능이 비활성화되지 않습니다
갤러리 문제
게시 한도: Free=10건, Basic=100건, Pro=500건
일일 게시 한도: 하루 10건
이미지 크기: 최대 20MB. TeX 소스: 최대 500,000자. 태그: 게시당 최대 8개.
도움 받기
AI 채팅으로 문제를 설명하세요(컴파일 로그를 읽을 수 있습니다)
/feedback 에서 지원에 문의
포함할 정보: macOS 버전, TeX64 버전, 오류 메시지, 재현 절차
설정 > 개인정보에서 오류 진단을 선택적으로 활성화할 수 있습니다