Claude Code나 Codex에게 수학 설명을 요청하면 터미널에 다음과 같이 표시됩니다:

H(p) = $-\sum_{i} p_{i} \log p_{i}$

이것은 LaTeX입니다. 브라우저는 이것을 깔끔한 방정식으로 렌더링하지만, 터미널은 실행할 수학 엔진이 없기 때문에 달러 기호 노이즈로 표시됩니다. 작업 내용(ML, 통계, 최적화, 증명 등)이 수학적으로 무거울수록, 가장 명확해야 할 바로 그 지점에서 출력이 더 나빠집니다.

해결책은 'LaTeX 렌더링'이 아닙니다

그것은 어렵고 아직 풀리지 않은 문제입니다. Kitty나 SIXEL 같은 그래픽 백엔드가 필요하며, SSH와 tmux를 위한 폴백(fallback)도 필요합니다. 더 저렴한 방법이 있습니다. 모델이 아예 LaTeX를 출력할 필요가 없습니다.

유니코드에는 이미 대부분의 인라인 수학 기호가 포함되어 있습니다: ∑, ∫, √, ≤, ≥, ∈, α, β, σ, x², pᵢ, 집합 표기법, 심지어 작은 행렬까지도요. 터미널은 이것들을 모두 텍스트로 인식하고 렌더링합니다. 따라서 모델에게 LaTeX를 건너뛰고 유니코드를 직접 방출하도록 가르치면 됩니다:

이전: H(p) = $-\sum_{i} p_{i} \log p_{i}$
다음: H(p) = − ∑ᵢ pᵢ · log pᵢ

claude-math

claude-math가 정확히 이 역할을 수행합니다. 런타임이 필요하지 않으며, 에이전트가 로드하는 SKILL.md 파일로 구성되어 있고, 일관된 매핑을 위해 글리프 치트시트를 포함하고 있습니다. 복사 및 검색에 안전하며(페이지 내 찾기 기능에서 깨지는

npx claude-math install # Claude Code
npx claude-math install --codex # Codex CLI

에이전트를 재시작하면 수학 공식이 읽을 수 있는 텍스트 형태로 돌아옵니다.

다만, 분명히 말씀드리자면: 이것은 네이티브 렌더링(native rendering)이 아니라 임시 해결책입니다. 복잡한 유도 과정(dense derivation)은 여전히 조판된 수학 공식(typeset math)으로 더 명확하며, 이미 LaTeX를 렌더링하는 GUI 환경에서 원하는 것은 Unicode가 아니라 LaTeX 자체여야 합니다. claude-math는 의도적으로 터미널 도구입니다. 하지만 에이전트의 답변을 채워주기 때문에 즉각적인 개선 효과를 가져옵니다.

저장소(Repo): https://github.com/vladimirrott/claude-math

만약 Unicode 매핑이 잘못되어 보이는 경우가 있다면, 바로 그런 종류의 문제를 듣고 싶습니다.