교과서
LLM 위키
LLM 을 실제로 쓸 때 찾아보는 실전 레퍼런스 31쪽이다. 개념·모델·프롬프팅·API·에이전트·플레이북·용어로 나눠 쪽마다 함정과 검증일을 함께 적었다.
31쪽 · 7부 · 다 읽으면 204분
Start here — "지금 뭐 하려는데?"
| 하려는 것 | 열 문서 |
|---|---|
| 어떤 모델 쓸지 고르기 | 2026 LLM 지형도 — 모델 한눈에 → 어떤 모델을 써야 하나? |
| 오픈웨이트·"우리 모델"·한국 LLM | 오픈웨이트로 만든 게 "우리 모델"인가 — 가중치, 만들기의 사다리, 한국의 독자 LLM — 가중치가 뭔지부터 독파모까지 |
| Claude 제대로 쓰기 | Claude 패밀리 — 모델별 선택과 API 함정 — effort·thinking 이 모델마다 다르다 |
| API 처음 붙이기 | LLM API 퀵스타트 (Anthropic + AI SDK) → Anthropic Messages API 심화 |
| 프롬프트 쓰는 중 | 프롬프트 패턴 치트시트 → 안 먹으면 프롬프팅 안티패턴 카탈로그 |
| JSON 으로 받아야 함 | 구조화 출력 강제하기 |
| 툴/함수 호출 붙이기 | 툴 콜링 붙이기 — 처음부터 끝까지 |
| 문서 검색해서 답하게 | RAG 파이프라인 만들기 |
| 에이전트 만들기 | 에이전트 설계 패턴 → 에이전트 프레임워크, 어느 걸 쓰나 (대개는 안 쓰는 게 답) |
| MCP 붙이거나 만들기 | MCP (Model Context Protocol) 실전 |
| Claude Code 로 코딩 | Claude Code — 에이전트 코딩 워크플로우 |
| 비용이 너무 나옴 | 프롬프트 캐싱 → 컨텍스트 엔지니어링 |
| 용어가 헷갈림 | LLM 용어사전 |
자주 발 헛디디는 곳
- Claude 패밀리 — 모델별 선택과 API 함정 —
thinking생략의 의미가 모델마다 다르다 (Opus 5 는 ON, 4.8/4.7 은 OFF) - 프롬프트 캐싱 — 캐시 최소 토큰이 모델마다 다르고 단조증가가 아니다
- 툴 콜링 붙이기 — 처음부터 끝까지 — 병렬 툴 결과를 따로 보내면 병렬을 "학습으로 끈다"
- 프롬프팅 안티패턴 카탈로그 —
CRITICAL: 반드시같은 강조가 오버트리거를 만든다
차례
개념
내구성 있는 "왜". 가장 천천히 썩음 (180일 검토).
여기서 시작
- LLM 용어사전 — 모든 핵심 용어 한 화면 정의. 뭔지 모르는 단어가 나오면 여기부터.
토큰과 컨텍스트
- 토큰과 컨텍스트 윈도우 — 토크나이저는 모델마다 다르다 · 토큰 세는 올바른 방법 · 컨텍스트가 크다고 다 쓸 수 있는 게 아니다
- 컨텍스트 엔지니어링 — 컨텍스트 예산을 무엇에 쓸까. 압축 vs 편집 vs 메모리 vs 서브에이전트 격리
모델이 동작하는 방식
- 추론모델 (reasoning models / thinking) — 추론모델은 뭐가 다른가. thinking 토큰 과금·effort·언제 손해인가
- 양자화 (Quantization) — 셀프호스트할 때만 필요한 주제. 포맷·비트수·VRAM 계산
- 멀티모달 입력 실무 — 이미지 토큰 과금과 문서 처리 — 이미지/오디오/비디오 입력. 해상도가 곧 비용
검색과 품질
- 임베딩과 벡터 검색 — 임베딩 모델 고르기 · 벡터DB 선택 · 하이브리드 검색
- 환각(hallucination) — 원인·유형·완화·시스템 설계 — 왜 생기나, 완화 기법을 효과 순으로, 없앨 수 없다는 전제의 설계
- 01컨텍스트 엔지니어링에이전트가 여러 턴을 돌수록 답이 흐트러질 때, "무엇을 컨텍스트에 남기고 무엇을 버릴지"를 설계하려고 여는 문서.7분
- 02임베딩과 벡터 검색RAG 를 붙이기 전에 "임베딩 모델 뭐 쓰고, 벡터DB 를 정말 세워야 하나, 하이브리드/리랭킹이 필요한가" 를 결정할 때 연다.6분
- 03환각(hallucination) — 원인·유형·완화·시스템 설계모델이 그럴듯하지만 틀린 말을 내놓을 때 왜 그런지, 무엇을 하면 실제로 줄고 무엇은 헛수고인지 찾아볼 때.6분
- 04멀티모달 입력 실무 — 이미지 토큰 과금과 문서 처리스크린샷·PDF·차트를 모델에 넣기 전에 연다. "이 이미지가 토큰을 얼마나 먹고, 어떻게 넣어야 안 깨지나"에 답한다.5분
- 05양자화 (Quantization)오픈웨이트 모델을 직접 GPU 에 올려 돌릴 때만 여는 문서. GGUF·AWQ·GPTQ·FP8 중 뭘 고르고, 이 모델이 내 VRAM 에 들어가는지 계산할 때.5분
- 06추론모델 (reasoning models / thinking)"이 요청에 thinking 을 켜야 하나, 켜면 돈·지연이 얼마나 붙나, 프롬프팅은 뭐가 달라지나" 를 판단할 때 연다.7분
- 07토큰과 컨텍스트 윈도우"이 프롬프트/대화가 토큰을 얼마나 먹나", "컨텍스트가 1M 인데 왜 정확도가 떨어지나", "롱컨텍스트 요금이 왜 튀나" 를 실무에서 확인할 때 여는 문서.6분
모델
프로바이더별 엔티티 페이지 + 선택 가이드. 30일 검토 대상 (가격·모델 ID 부패 빠름).
여기서 시작
- 2026 LLM 지형도 — 모델 한눈에 — 전 프로바이더 비교표 · 티어 지도
- 어떤 모델을 써야 하나? — 어떤 모델을 쓸까
프로바이더별 상세
- Claude 패밀리 — 모델별 선택과 API 함정 — Claude. effort·thinking 노브가 모델마다 다르다는 함정 [HIGH]
- OpenAI GPT 모델 패밀리 — GPT 티어 · 롱컨텍스트 서차지
- Google Gemini 패밀리 — Gemini · 구간별 요율 · Developer API vs Vertex
- 오픈웨이트 모델 지도 — DeepSeek·Qwen·Mistral·Llama. 라이선스가 핵심
- 오픈웨이트로 만든 게 "우리 모델"인가 — 가중치, 만들기의 사다리, 한국의 독자 LLM — 남의 가중치로 만든 게 "우리 모델"인가 · 한국 독자 LLM 기준
함께 보기
- 추론모델 (reasoning models / thinking) — 추론모델은 뭐가 다른가
- 양자화 (Quantization) — 오픈웨이트를 셀프호스트할 때
30일 검토 대상. 가격·모델 ID 가 가장 빨리 썩는 층이다. Anthropic 사실은 first-party [HIGH], 나머지는 각 사 공식 가격 페이지로 재확인해야 [official] 이다.
- 08Claude 패밀리 — 모델별 선택과 API 함정Claude 안에서 어떤 모델을 고르고, thinking·effort·캐시 노브를 어떻게 맞출지 판단할 때 연다. 지형도 전체 비교는 models-overvie…6분
- 09Google Gemini 패밀리Gemini 를 실제로 붙이기 직전에 여는 문서 — 어떤 모델 ID 가 진짜 GA 인지, 200K 요율 함정은 어디인지, Claude 대신 언제 Gemini 를…8분
- 10어떤 모델을 써야 하나?models-overview 의 표를 "실제 결정"으로 바꾸는 문서. 작업마다 필요한 판단이다. 원칙 하나: 품질 기준을 넘는 가장 싼 티어를 골라라 — 반사적…3분
- 112026 LLM 지형도 — 모델 한눈에⚠️ 신선도: 이 페이지는 30일마다 재검증 대상. Anthropic 데이터는 first-party 출처 [HIGH]. 나머지 프로바이더는 2026-07 재검증…9분
- 12오픈웨이트 모델 지도데이터 주권·비용·커스터마이징 때문에 Claude 대신(또는 병행) 오픈웨이트를 검토할 때 연다. 핵심 질문은 "라이선스가 상업적 사용을 허락하나"와 "이걸 내…6분
- 13오픈웨이트로 만든 게 "우리 모델"인가 — 가중치, 만들기의 사다리, 한국의 독자 LLM업스테이지·SKT 같은 회사들은 라마·큐원 같은 오픈웨이트를 가져다 쓰는가, 처음부터 만드는가. 남의 가중치로 학습한 걸 "우리 모델"이라 불러도 되는가. 애초…6분
- 14OpenAI GPT 모델 패밀리OpenAI 모델을 티어·가격·컨텍스트로 고를 때, 그리고 Claude 와 대응시켜 볼 때 여는 문서.9분
프롬프팅
여기서 시작
- 프롬프트 패턴 치트시트 — 기법 → 언제 쓸지 표
규칙이 뒤집히는 지점
- 추론모델 vs 일반모델 — 프롬프팅이 뒤집힌다 — 추론모델에선 옛 조언이 역효과다
- 프롬프팅 안티패턴 카탈로그 — 실패 모드 카탈로그. 증상 → 원인 → 대안 3단 표
출력을 통제하기
- 구조화 출력 강제하기 — JSON Schema 강제 vs strict tool use vs XML 태그. 선택표와 실패 대응
비용
- 프롬프트 캐싱 — stable-first/variable-last · 캐시 최소 길이가 모델마다 다르다는 함정
- 15프롬프팅 안티패턴 카탈로그프롬프트가 기대대로 안 될 때 여는 문서. "옛날 조언 그대로 썼는데 왜 이상하지" 를 진단한다. 증상 → 원인 → 대신 이렇게, 3단으로.7분
- 16프롬프트 캐싱프롬프트의 안정적 프리픽스를 캐시해 반복 호출 시 재처리를 건너뛴다. 반복 컨텍스트가 큰 워크로드에서 입력 비용을 크게 줄이는 1순위 레버다.6분
- 17프롬프트 패턴 치트시트프롬프트 쓸 때 가장 자주 여는 문서. 기법 → 언제 쓸지 표 + 2026 의 함정.4분
- 18추론모델 vs 일반모델 — 프롬프팅이 뒤집힌다2026 에서 가장 모델별로 갈리는 영역. 틀리면 더 많은 돈을 내고 더 나쁜 출력을 받는다.3분
- 19구조화 출력 강제하기모델 응답을 파싱 가능한 형태(대개 JSON)로 받아내야 할 때. 어떤 방법을 고를지, 스키마에서 뭐가 막히는지, 파싱이 깨질 때 뭘 하는지.8분
API
30일 검토 대상 (SDK 버전·엔드포인트 드리프트).
여기서 시작
- LLM API 퀵스타트 (Anthropic + AI SDK) — 최소 호출 + SDK 버전 핀. 처음 붙일 때
심화
- Anthropic Messages API 심화 — tool use 루프 · 구조화 출력 · 캐싱 · 스트리밍 · stop_reason · 배치
- Vercel AI SDK 실전 — 프로바이더 중립 TS 레이어. 핵심 함수 · 툴 · 스트리밍 UI
다른 프로바이더로 옮길 때
- OpenAI API Parity — Anthropic 코드를 OpenAI로 옮기기 — Responses vs Chat Completions, Anthropic ↔ OpenAI 필드 대응표와 함정
- 20Anthropic Messages API 심화최소 호출은 api-quickstart. 이 문서는 그다음 — tool use 루프, 구조화 출력, 캐싱 배치, 스트리밍, 배치 API, 에러 처리를 실제로 짤…10분
- 21LLM API 퀵스타트 (Anthropic + AI SDK)동작하는 호출을 빠르게 띄우고, 가장 심하게 드리프트하는 버전 사실을 못박는 문서. TS/웹 스택 복붙용.8분
- 22OpenAI API Parity — Anthropic 코드를 OpenAI로 옮기기Anthropic Messages API로 짠 코드를 OpenAI로 포팅할 때, 필드 이름·구조·기본값이 어떻게 어긋나는지 찾아보는 대응표.9분
- 23Vercel AI SDK 실전Next.js/TS 앱에서 여러 LLM 프로바이더를 한 API 로 붙일 때 연다. 함수 시그니처, 툴 호출, 스트리밍 UI, 프로바이더 교체, 그리고 메이저 버…10분
에이전트
여기서 시작
- 프롬프트에서 루프로, 그래프로 — LLM 엔지니어링의 무게중심 이동 — 프롬프트 → 컨텍스트 → 루프 → 그래프: 판이 어떻게 왔나, 주고받기와 오케스트레이션의 실체
- Claude Code — 에이전트 코딩 워크플로우 — 6개 원시요소 + 매일의 루프
무엇을 어떻게 조립하나
- 에이전트 설계 패턴 — Tool Use / ReAct / Reflection / Plan-Execute / Multi-Agent / Agentic RAG + 선택표
- 에이전트 프레임워크, 어느 걸 쓰나 (대개는 안 쓰는 게 답) — 프레임워크 비교. 대부분은 직접 루프 짜는 게 낫다는 결론 포함
- 툴 콜링 붙이기 — 처음부터 끝까지 — 툴 콜링 처음부터 끝까지 (플레이북)
툴을 표준으로 노출하기
- MCP (Model Context Protocol) 실전 — Model Context Protocol. 아키텍처 · 트랜스포트 선택 · 보안 함정
컨텍스트가 썩지 않게
- 컨텍스트 엔지니어링 — 긴 루프에서 컨텍스트 예산 관리
- 24에이전트 설계 패턴어떤 에이전트 패턴을 쓸까. 벤더 무관 패턴 7종 + 선택표.3분
- 25에이전트 프레임워크, 어느 걸 쓰나 (대개는 안 쓰는 게 답)멀티에이전트 오케스트레이션·상태 영속·human-in-the-loop 가 필요해서 프레임워크를 고를 때 연다. 결론 먼저: 대부분의 실무 작업은 프레임워크 없이…10분
- 26Claude Code — 에이전트 코딩 워크플로우매일 쓰는 툴이니 개인 관련성 최고 페이지. 6개 원시요소(primitive)와 그것들이 사는 plan→implement→verify→review 루프.4분
- 27프롬프트에서 루프로, 그래프로 — LLM 엔지니어링의 무게중심 이동"프롬프트 잘 쓰는 법"에서 시작한 판이 지금은 "루프와 그래프를 설계하는 일"이 됐다. 각 세대가 무엇을 최적화했고 왜 다음 단계가 필요해졌는지, 그리고 실무…6분
- 28MCP (Model Context Protocol) 실전LLM 앱에 외부 툴·데이터를 붙이는 표준 프로토콜. "서버를 직접 만들까, 그냥 API 에 툴을 인라인 정의할까"를 정할 때, 그리고 붙인 서버의 신뢰 경계를…7분
플레이북
엔드투엔드 "이걸 해라" 레시피. 개념이 아니라 순서다. 위에서부터 따라 하면 동작하는 것이 나온다.
작성됨
- 툴 콜링 붙이기 — 처음부터 끝까지 — 툴 콜링 처음부터 끝까지. 툴 정의 → 루프 → 병렬 → 에러 → 승인 게이트 → 관측성 + 체크리스트
- RAG 파이프라인 만들기 — RAG 파이프라인. "안 만들어도 되는 경우"부터 읽어라. 청킹 → 검색 → 리랭킹 → 인용 → 평가
레퍼런스와의 관계
플레이북은 순서를, 레퍼런스는 사전을 맡는다. 필드 하나를 찾는 거라면 이쪽이 아니라 저쪽이다.
| 플레이북 | 대응 레퍼런스 |
|---|---|
| 툴 콜링 붙이기 — 처음부터 끝까지 | Anthropic Messages API 심화 · 에이전트 설계 패턴 |
| RAG 파이프라인 만들기 | 임베딩과 벡터 검색 · 환각(hallucination) — 원인·유형·완화·시스템 설계 |
용어
이 교과서는 브루니 월드에 처음 실렸다. 브루니 월드 ↗