반응형 전체 글483 Claude로 RAG 제대로 만들기 — 청크가 맥락을 잃는 문제와 Contextual Retrieval Claude로 RAG 제대로 만들기 — 청크가 맥락을 잃는 문제와 Contextual RetrievalRAG를 처음 만들면 대개 잘 된다. 문서를 잘게 잘라 임베딩하고, 질문과 비슷한 조각을 찾아 모델에게 붙여 주면 그럴듯한 답이 나온다. 그런데 조금만 실제 문서를 물리면 이상한 일이 생긴다. 분명 답이 문서 안에 있는데 엉뚱한 조각을 물어 오거나, 아예 못 찾는다. 대부분의 RAG가 여기서 무너진다. 그리고 그 원인은 모델이 아니라 검색 앞단, 정확히는 "문서를 자르는 순간"에 있다. 이 글은 그 실패의 정체를 짚고, 앤트로픽이 공개한 Contextual Retrieval이라는 처방을 정리한다. 거창한 새 프레임워크가 아니라, 청크를 자르기 전에 클로드로 맥락 한 줄을 붙여 두는 단순한 아이디어인데, .. 2026. 8. 30. 클로드 확장 사고(Extended Thinking) 완전 정리 클로드 확장 사고(Extended Thinking) 완전 정리 — '생각 예산'은 잊어라, 이제 adaptive와 effort로 조절한다클로드에게 어려운 문제를 던지면, 답을 곧장 뱉지 않고 잠깐 뜸을 들이는 때가 있다. 그 사이에 모델은 머릿속으로 문제를 쪼개고, 경우를 따져 보고, 계획을 세운다. 이 "답하기 전에 스스로 생각하는" 과정이 확장 사고(extended thinking)다. 복잡한 코딩, 수학, 다단계 추론에서 정답률을 크게 끌어올리는 기능이다. 그런데 이 기능을 다루는 방식이 2025년과 2026년 사이에 조용히, 그러나 근본적으로 바뀌었다. 예전에는 "생각에 토큰 몇 개까지 써라"라고 예산을 손수 정해 줬는데, 이제 그 방식은 사실상 사라지고 모델이 알아서 정하는 방식으로 넘어갔다. .. 2026. 8. 30. Claude Agent SDK 완전 정리 — 클로드 코드를 라이브러리로, 나만의 AI 에이전트를 만드는 법 Claude Agent SDK 완전 정리 — 클로드 코드를 라이브러리로, 나만의 AI 에이전트를 만드는 법2025년 9월, 앤트로픽이 조용히 이름을 하나 바꿨다. "Claude Code SDK"가 "Claude Agent SDK"가 됐다. 단순한 리브랜딩처럼 보이지만, 이 개명 안에는 한 가지 선언이 담겨 있다. 코딩 도구를 만들려고 내놨던 물건이, 알고 보니 온갖 종류의 AI 에이전트를 만드는 범용 뼈대였다는 것이다. 이름이 그 사실을 뒤늦게 따라잡은 셈이다. 그래서 이 글은 코드 튜토리얼이 아니라 지도에 가깝다. Agent SDK가 정확히 무엇이고, 왜 이름이 바뀌었으며, 그 안에 뭐가 들어 있는지, 그리고 클로드로 에이전트를 만드는 여러 갈래 가운데 이게 어디에 놓이는지를 정리한다. "에이전트를 만.. 2026. 8. 29. MCP 서버 직접 만들기 실전 — 파이썬 FastMCP로 30분 만에 나만의 도구를 클로드에 붙이기 MCP 서버 직접 만들기 실전 — 파이썬 FastMCP로 30분 만에 나만의 도구를 클로드에 붙이기MCP가 "AI와 도구를 잇는 표준 규격"이라는 건 이제 여기저기서 들린다. 그런데 남이 만든 서버를 설치해 쓰는 글은 많아도, 정작 "내 손으로 하나 만들어 클로드에 물려 보는" 과정을 끝까지 따라가는 글은 드물다. 개념만 읽고 덮으면 남는 게 없다. 이 글은 빈 폴더에서 시작해 실제로 동작하는 MCP 서버를 만들고, Claude Desktop과 Claude Code에 연결해 대화창에서 내 도구가 호출되는 것까지 직접 확인한다. 준비물은 파이썬 하나뿐이다. 프레임워크는 FastMCP를 쓴다. 함수 하나에 데코레이터 한 줄만 붙이면 그게 곧 AI가 부를 수 있는 도구가 되는, 지금 파이썬 생태계의 사실상 표.. 2026. 8. 29. Claude Skills(에이전트 스킬) 완전 정리 — SKILL.md로 AI 역량을 패키징하고 재사용하는 법 Claude Skills(에이전트 스킬) 완전 정리 — SKILL.md로 AI 역량을 패키징하고 재사용하는 법AI에게 같은 작업 방식을 매번 처음부터 설명하는 것만큼 비효율적인 일도 없다. "우리 회사 보고서는 이런 양식으로, 이 순서로 만들어줘"를 대화마다 다시 붙여넣는 식이다. Claude Skills(에이전트 스킬)는 이 반복을 끝내기 위한 기능이다. 특정 작업을 해내는 방법을 파일 묶음으로 만들어 두면, 클로드가 필요할 때 알아서 그 역량을 꺼내 쓴다. 이 글은 스킬을 개념부터 실전 감각까지 정리한다. 무엇이고 왜 나왔는지, SKILL.md라는 파일 구조와 "단계별 로딩"이라는 핵심 작동 원리, 어디서 쓰이고 어떻게 문서까지 만들어 내는지, 그리고 앞서 다룬 MCP나 그냥 긴 프롬프트와 무엇이 다.. 2026. 8. 27. MCP(Model Context Protocol) 완전 정리 — AI 도구 연결 표준의 구조·주요 서버·직접 만들기 개념 MCP(Model Context Protocol) 완전 정리 — AI 도구 연결 표준의 구조·주요 서버·직접 만들기 개념AI 모델이 아무리 똑똑해도, 내 파일이나 회사 데이터베이스·사내 도구에 직접 손을 뻗지 못하면 반쪽짜리다. 이 "AI와 바깥 세상을 잇는 배선"을 표준화한 것이 MCP(Model Context Protocol)다. 앤트로픽이 오픈소스로 공개한 지 얼마 되지 않아 오픈AI·구글·마이크로소프트까지 채택하며 사실상 업계 표준으로 굳어졌고, 지금은 벤더 중립 재단이 관리한다.이 글은 MCP를 개념부터 실전 감각까지 한 번에 정리한다. 왜 필요한지(통합 문제), 어떤 구조인지(호스트·클라이언트·서버와 세 가지 핵심 요소), 누가 쓰는지(채택 현황), 무엇을 조심해야 하는지(보안), 그리고 함수.. 2026. 8. 27. 최신 클로드(Claude) 트렌드 총정리 — Opus 5·Fable 5·에이전틱·MCP·Skills 한눈에 최신 클로드(Claude) 트렌드 총정리 — Opus 5·Fable 5·에이전틱·MCP·Skills 한눈에클로드는 더 이상 "대화 잘하는 챗봇"이 아니다. 2026년의 클로드는 스스로 코드를 짜고, 몇 시간짜리 작업을 혼자 굴리며, 외부 도구를 표준 규격으로 연결해 쓰는 하나의 작업 플랫폼으로 진화했다. 모델 이름도 Opus 5·Fable 5·Sonnet 5로 세대가 통째로 바뀌었고, 경쟁의 축은 "누가 더 똑똑한 모델인가"에서 "누가 더 잘 일하는 에이전트인가"로 옮겨갔다.이 글은 지금 클로드에서 실제로 벌어지고 있는 흐름을 다섯 갈래로 정리한다. 새 모델 라인업, 사고 방식의 변화(Adaptive Thinking), 에이전틱 붐과 Claude Code, 업계 표준이 된 MCP, 그리고 재사용 역량 패.. 2026. 8. 27. 파이썬 키 에러 (KeyError) 원인과 딕셔너리 안전하게 다루는 법 파이썬 키 에러 (KeyError) 원인과 딕셔너리 안전하게 다루는 법딕셔너리에서 값 하나 꺼내려다 "KeyError: 'email'"을 만나면 당황스럽다. user["name"]은 잘 되는데 user["email"]은 왜 터질까. 답은 단순하다. 그 딕셔너리에 'email'이라는 키가 아예 없기 때문이다. 파이썬 딕셔너리는 대괄호로 값을 꺼낼 때 "정확히 그 키가 있는가"만 본다. 없으면 대충 넘어가는 법 없이 곧바로 KeyError를 던진다. 그래서 이 에러의 진짜 해법은 "왜 없는지"를 파악하고, 없을 수도 있는 키를 애초에 안전하게 꺼내는 습관을 들이는 것이다. 이 글은 KeyError가 나는 이유와 단골 원인, 그리고 get·in·try·setdefault·defaultdict로 이어지는 딕셔너.. 2026. 7. 7. 이전 1 2 3 4 ··· 61 다음 반응형
