나는 LaTeX 오류 로그를 두려워하는 것을 멈췄다 — 변한 점은 이렇다

I’m happy to translate the article for you, but I’ll need the text of the article itself. Could you please paste the content you’d like translated (excluding the source link, which I’ll keep unchanged)? Once I have the article text, I’ll provide a Korean translation while preserving the original formatting, markdown, and any code blocks or URLs.

익숙한 LaTeX 악몽

오후 11시입니다. 하루 종일 글을 쓰고 Compile 버튼을 눌러 차를 마시러 잠시 떠났다가 로그를 확인하면 다음과 같은 내용이 보입니다:

! Package inputenc Error: Unicode character 的 (U+7684)
(inputenc)                not set up for use with LaTeX.

See the inputenc package documentation for explanation.
Type  H   for immediate help.
 ...
l.1847 ...rithm based on the work of Li et al. 的

중국어 문자를 입력한 적이 없습니다. 참고문헌 항목, 주석, 혹은 자동으로 무언가를 삽입하는 패키지에 숨겨져 있었던 걸까요? 로그가 수백 줄에 달할 때 진짜 어려운 점은 각 메시지를 해독하는 것이 아니라, 연쇄적으로 발생하는 오류들 중에서 근본 원인을 찾아내는 triage입니다.

수동 디버깅 vs. AI 지원

전형적인 수동 워크플로우

1. 로그를 연다.
2. ! 를 검색한다.
3. 오류를 복사하고, 구글에 검색한다.
4. 상황과 거의 일치하는 StackOverflow 답변을 읽는다.
5. 수정해 보고, 다시 컴파일하고, 반복한다.

ChatGPT를 사용하더라도, 붙여넣는 코드 조각에만 제한됩니다. 모델은 전체 프로젝트, 로드한 패키지, 사용자 정의 명령을 볼 수 없기 때문에 제안이 종종 일반적이며 (“amsmath가 로드되었는지 확인하세요”) 실제 근본 원인을 놓칩니다.

TeX64와 AI 어시스턴트 Axiom 소개

TeX64는 macOS용 로컬‑우선 LaTeX 편집기입니다. 내장된 AI 어시스턴트 Axiom은 다음에 직접 접근할 수 있습니다:

• 프로젝트 내 모든 .tex 파일
• 전체 컴파일 로그
• 당신의 .bib 파일들

Axiom이 전체 코드베이스를 보기 때문에 진단이 훨씬 더 정확합니다.

실제 사례

한 프로젝트에서 23개의 오류가 발생했습니다. Axiom 채팅에 “이 오류들을 분석해줘”라고 입력하자 어시스턴트가 다음과 같이 답했습니다:

근본 원인 1 (18개 오류) – macros.tex 34줄에서 \proof를 \newcommand로 정의했지만, amsthm 패키지가 이미 proof 환경을 제공하고 있습니다.
근본 원인 2 (4개 오류) – chapter4.tex 209줄에서 table 환경을 열었지만 대응되는 \end{table}이 없습니다.
근본 원인 3 (1개 오류) – bibliography.bib 항목 Zhang2019의 title 필드에 닫히지 않은 {가 있습니다.
“각 수정에 대한 diff를 보여드릴게요. 근본 원인 1부터 시작할까요?”

수동으로 로그를 한 시간 동안 읽어야 했던 작업을 20 초 만에 처리했습니다.

Diff 기반 제안

Axiom은 파일을 조용히 수정하지 않습니다. 모든 제안은 diff 형태로 제시됩니다, 예를 들어:

% macros.tex, line 34
- \newcommand{\proof}[1]{\textit{Proof.} #1 \qed}
+ \newcommand{\myproof}[1]{\textit{Proof.} #1 \qed}

“이 변경을 적용할까요?”

각 수정 사항을 검토하고, 이해하고, 승인할 수 있습니다.

오류 수정 그 너머

• Generate LaTeX math: 수식을 영어로 설명하십시오 (“the limit as n → ∞ of the sum from k=1 to n of 1/k²”) 그리고 깔끔한 LaTeX 코드를 받으세요.
• Bibliography lookup: 논문 제목을 제공하면 Axiom이 arXiv을 검색하고 .bib 파일에 BibTeX 항목을 삽입합니다.
• Package conflict diagnosis: cleveref를 hyperref보다 먼저 로드하는 등 순서 문제를 감지하고 올바른 순서를 제안합니다.

Platform and setup notes

• macOS 전용 – Windows와 Linux 사용자는 다른 솔루션이 필요합니다.
• TeX64는 그저 편집기일 뿐이며; LaTeX 배포판(MacTeX 또는 TeX Live)을 별도로 설치해야 합니다. 앱에는 설정을 안내하는 진단 기능이 포함되어 있습니다.
• AI 기능은 인터넷이 필요합니다; 실제 컴파일은 로컬에서 실행되며 오프라인에서도 작동합니다. M2 MacBook Air에서 120‑페이지 문서는 약 8 초에 컴파일됩니다.

가격

• 무료 티어가 시작하기 위해 제공됩니다.
• 더 많은 Axiom 사용량은 유료 플랜으로 커버됩니다.

워크플로우에 미치는 영향

심리적 변화가 눈에 띕니다: 오류에 대한 불안이 감소하면 컴파일을 더 자주 하게 되고, 문제를 조기에 감지하며, 더 빠른 작성을 위한 선순환이 형성됩니다.

요약

Mac 사용자이며 LaTeX에 많은 시간을 투자한다면, TeX64(및 그 Axiom 어시스턴트)를 사용해 보는 것이 충분히 가치가 있습니다.

tex64.com