교과서

LLM 위키

LLM 을 실제로 쓸 때 찾아보는 실전 레퍼런스 31쪽이다. 개념·모델·프롬프팅·API·에이전트·플레이북·용어로 나눠 쪽마다 함정과 검증일을 함께 적었다.

31쪽 · 7부 · 다 읽으면 204분

1쪽부터 읽기 →

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 용어사전

자주 발 헛디디는 곳

차례

개념

내구성 있는 "왜". 가장 천천히 썩음 (180일 검토).

여기서 시작

  • LLM 용어사전 — 모든 핵심 용어 한 화면 정의. 뭔지 모르는 단어가 나오면 여기부터.

토큰과 컨텍스트

  • 토큰과 컨텍스트 윈도우 — 토크나이저는 모델마다 다르다 · 토큰 세는 올바른 방법 · 컨텍스트가 크다고 다 쓸 수 있는 게 아니다
  • 컨텍스트 엔지니어링 — 컨텍스트 예산을 무엇에 쓸까. 압축 vs 편집 vs 메모리 vs 서브에이전트 격리

모델이 동작하는 방식

검색과 품질


  1. 01컨텍스트 엔지니어링에이전트가 여러 턴을 돌수록 답이 흐트러질 때, "무엇을 컨텍스트에 남기고 무엇을 버릴지"를 설계하려고 여는 문서.7분
  2. 02임베딩과 벡터 검색RAG 를 붙이기 전에 "임베딩 모델 뭐 쓰고, 벡터DB 를 정말 세워야 하나, 하이브리드/리랭킹이 필요한가" 를 결정할 때 연다.6분
  3. 03환각(hallucination) — 원인·유형·완화·시스템 설계모델이 그럴듯하지만 틀린 말을 내놓을 때 왜 그런지, 무엇을 하면 실제로 줄고 무엇은 헛수고인지 찾아볼 때.6분
  4. 04멀티모달 입력 실무 — 이미지 토큰 과금과 문서 처리스크린샷·PDF·차트를 모델에 넣기 전에 연다. "이 이미지가 토큰을 얼마나 먹고, 어떻게 넣어야 안 깨지나"에 답한다.5분
  5. 05양자화 (Quantization)오픈웨이트 모델을 직접 GPU 에 올려 돌릴 때만 여는 문서. GGUF·AWQ·GPTQ·FP8 중 뭘 고르고, 이 모델이 내 VRAM 에 들어가는지 계산할 때.5분
  6. 06추론모델 (reasoning models / thinking)"이 요청에 thinking 을 켜야 하나, 켜면 돈·지연이 얼마나 붙나, 프롬프팅은 뭐가 달라지나" 를 판단할 때 연다.7분
  7. 07토큰과 컨텍스트 윈도우"이 프롬프트/대화가 토큰을 얼마나 먹나", "컨텍스트가 1M 인데 왜 정확도가 떨어지나", "롱컨텍스트 요금이 왜 튀나" 를 실무에서 확인할 때 여는 문서.6분

모델

프로바이더별 엔티티 페이지 + 선택 가이드. 30일 검토 대상 (가격·모델 ID 부패 빠름).

여기서 시작

프로바이더별 상세

함께 보기


30일 검토 대상. 가격·모델 ID 가 가장 빨리 썩는 층이다. Anthropic 사실은 first-party [HIGH], 나머지는 각 사 공식 가격 페이지로 재확인해야 [official] 이다.

  1. 08Claude 패밀리 — 모델별 선택과 API 함정Claude 안에서 어떤 모델을 고르고, thinking·effort·캐시 노브를 어떻게 맞출지 판단할 때 연다. 지형도 전체 비교는 models-overvie…6분
  2. 09Google Gemini 패밀리Gemini 를 실제로 붙이기 직전에 여는 문서 — 어떤 모델 ID 가 진짜 GA 인지, 200K 요율 함정은 어디인지, Claude 대신 언제 Gemini 를…8분
  3. 10어떤 모델을 써야 하나?models-overview 의 표를 "실제 결정"으로 바꾸는 문서. 작업마다 필요한 판단이다. 원칙 하나: 품질 기준을 넘는 가장 싼 티어를 골라라 — 반사적…3분
  4. 112026 LLM 지형도 — 모델 한눈에⚠️ 신선도: 이 페이지는 30일마다 재검증 대상. Anthropic 데이터는 first-party 출처 [HIGH]. 나머지 프로바이더는 2026-07 재검증…9분
  5. 12오픈웨이트 모델 지도데이터 주권·비용·커스터마이징 때문에 Claude 대신(또는 병행) 오픈웨이트를 검토할 때 연다. 핵심 질문은 "라이선스가 상업적 사용을 허락하나"와 "이걸 내…6분
  6. 13오픈웨이트로 만든 게 "우리 모델"인가 — 가중치, 만들기의 사다리, 한국의 독자 LLM업스테이지·SKT 같은 회사들은 라마·큐원 같은 오픈웨이트를 가져다 쓰는가, 처음부터 만드는가. 남의 가중치로 학습한 걸 "우리 모델"이라 불러도 되는가. 애초…6분
  7. 14OpenAI GPT 모델 패밀리OpenAI 모델을 티어·가격·컨텍스트로 고를 때, 그리고 Claude 와 대응시켜 볼 때 여는 문서.9분

프롬프팅

여기서 시작

규칙이 뒤집히는 지점

출력을 통제하기

비용

  • 프롬프트 캐싱 — stable-first/variable-last · 캐시 최소 길이가 모델마다 다르다는 함정
  1. 15프롬프팅 안티패턴 카탈로그프롬프트가 기대대로 안 될 때 여는 문서. "옛날 조언 그대로 썼는데 왜 이상하지" 를 진단한다. 증상 → 원인 → 대신 이렇게, 3단으로.7분
  2. 16프롬프트 캐싱프롬프트의 안정적 프리픽스를 캐시해 반복 호출 시 재처리를 건너뛴다. 반복 컨텍스트가 큰 워크로드에서 입력 비용을 크게 줄이는 1순위 레버다.6분
  3. 17프롬프트 패턴 치트시트프롬프트 쓸 때 가장 자주 여는 문서. 기법 → 언제 쓸지 표 + 2026 의 함정.4분
  4. 18추론모델 vs 일반모델 — 프롬프팅이 뒤집힌다2026 에서 가장 모델별로 갈리는 영역. 틀리면 더 많은 돈을 내고 더 나쁜 출력을 받는다.3분
  5. 19구조화 출력 강제하기모델 응답을 파싱 가능한 형태(대개 JSON)로 받아내야 할 때. 어떤 방법을 고를지, 스키마에서 뭐가 막히는지, 파싱이 깨질 때 뭘 하는지.8분

API

30일 검토 대상 (SDK 버전·엔드포인트 드리프트).

여기서 시작

심화

다른 프로바이더로 옮길 때

  1. 20Anthropic Messages API 심화최소 호출은 api-quickstart. 이 문서는 그다음 — tool use 루프, 구조화 출력, 캐싱 배치, 스트리밍, 배치 API, 에러 처리를 실제로 짤…10분
  2. 21LLM API 퀵스타트 (Anthropic + AI SDK)동작하는 호출을 빠르게 띄우고, 가장 심하게 드리프트하는 버전 사실을 못박는 문서. TS/웹 스택 복붙용.8분
  3. 22OpenAI API Parity — Anthropic 코드를 OpenAI로 옮기기Anthropic Messages API로 짠 코드를 OpenAI로 포팅할 때, 필드 이름·구조·기본값이 어떻게 어긋나는지 찾아보는 대응표.9분
  4. 23Vercel AI SDK 실전Next.js/TS 앱에서 여러 LLM 프로바이더를 한 API 로 붙일 때 연다. 함수 시그니처, 툴 호출, 스트리밍 UI, 프로바이더 교체, 그리고 메이저 버…10분

에이전트

여기서 시작

무엇을 어떻게 조립하나

툴을 표준으로 노출하기

컨텍스트가 썩지 않게

  1. 24에이전트 설계 패턴어떤 에이전트 패턴을 쓸까. 벤더 무관 패턴 7종 + 선택표.3분
  2. 25에이전트 프레임워크, 어느 걸 쓰나 (대개는 안 쓰는 게 답)멀티에이전트 오케스트레이션·상태 영속·human-in-the-loop 가 필요해서 프레임워크를 고를 때 연다. 결론 먼저: 대부분의 실무 작업은 프레임워크 없이…10분
  3. 26Claude Code — 에이전트 코딩 워크플로우매일 쓰는 툴이니 개인 관련성 최고 페이지. 6개 원시요소(primitive)와 그것들이 사는 plan→implement→verify→review 루프.4분
  4. 27프롬프트에서 루프로, 그래프로 — LLM 엔지니어링의 무게중심 이동"프롬프트 잘 쓰는 법"에서 시작한 판이 지금은 "루프와 그래프를 설계하는 일"이 됐다. 각 세대가 무엇을 최적화했고 왜 다음 단계가 필요해졌는지, 그리고 실무…6분
  5. 28MCP (Model Context Protocol) 실전LLM 앱에 외부 툴·데이터를 붙이는 표준 프로토콜. "서버를 직접 만들까, 그냥 API 에 툴을 인라인 정의할까"를 정할 때, 그리고 붙인 서버의 신뢰 경계를…7분

플레이북

엔드투엔드 "이걸 해라" 레시피. 개념이 아니라 순서다. 위에서부터 따라 하면 동작하는 것이 나온다.

작성됨

레퍼런스와의 관계

플레이북은 순서를, 레퍼런스는 사전을 맡는다. 필드 하나를 찾는 거라면 이쪽이 아니라 저쪽이다.

플레이북 대응 레퍼런스
툴 콜링 붙이기 — 처음부터 끝까지 Anthropic Messages API 심화 · 에이전트 설계 패턴
RAG 파이프라인 만들기 임베딩과 벡터 검색 · 환각(hallucination) — 원인·유형·완화·시스템 설계

  1. 29RAG 파이프라인 만들기문서를 잘라 넣고 검색해서 답하게 하는 것까지. 단계마다 기본값으로 뭘 고르고 언제 바꾸는지만 적었다. 개념은 embeddings-and-vector-searc…6분
  2. 30툴 콜링 붙이기 — 처음부터 끝까지모델에 함수를 쥐여주고 루프를 도는 것까지. 순서대로 따라 하는 레시피다. API 필드 레퍼런스는 anthropic-messages-api 를 보라.8분

용어

  1. 31LLM 용어사전다른 페이지들이 링크로 물어오는 정의 백스톱. 각 항목: 2~4문장 정의 + "실무에서 왜 중요한가" 한 줄. 실무자(연구자 아님) 관점.6분

이 교과서는 브루니 월드에 처음 실렸다. 브루니 월드 ↗