Blog 6

대화 히스토리가 넘치기 전에: 슬라이딩 윈도우와 요약 레이어로 토큰 한도 안에서 컨텍스트 유지하기

한눈에 보는 답대화 히스토리가 길어지면 두 가지 문제가 동시에 생깁니다. 토큰 한도를 넘어서 오류가 발생하거나, 앞부분을 통째로 잘라내 중요한 맥락이 사라집니다. 슬라이딩 윈도우는 '최근 N개 메시지만 유지'하는 단순한 방법이고, 요약 레이어는 잘려나간 메시지를 한 줄짜리 핵심으로 압축해 보존하는 방법입니다. 두 방식을 계층으로 쌓으면 최신 맥락은 그대로 두면서 오래된 맥락은 압축해 함께 전달할 수 있습니다.왜 지금 중요한가Claude의 컨텍스트 윈도우는 늘어났지만 그만큼 프롬프트도 길어졌습니다. 시스템 프롬프트, 툴 스키마, 이전 응답까지 누적되면 실제 대화에 쓸 수 있는 공간은 생각보다 빠르게 줄어듭니다. 실무에서는 긴 코드 리뷰, 멀티스텝 분석, 반복 피드백 루프처럼 수십 턴이 넘어가는 세션이 흔합..

Code 실전 13:00:40

Claude Code로 API 문서 초안 쓰기: 엔드포인트 목록을 주면 요청·응답 예시가 완성되는 법

한눈에 보는 답엔드포인트 목록과 간단한 설명을 Claude Code에 붙여 넣으면, 각 엔드포인트별로 HTTP 메서드, 요청 파라미터, 성공·에러 응답 예시가 포함된 API 문서 초안이 한 번에 생성됩니다. 별도 템플릿 없이도 OpenAPI 스타일의 구조를 따르도록 지시할 수 있고, 생성된 초안을 바탕으로 실제 코드와 맞춰 수정하면 문서 작성 시간을 크게 줄일 수 있습니다.왜 지금 중요한가API를 새로 만들거나 팀 간 협업을 시작할 때, 문서가 없으면 개발자마다 엔드포인트를 다르게 해석합니다. 특히 프론트엔드와 백엔드가 분리된 팀에서는 '어떤 필드가 필수인지', '에러 코드가 무엇인지' 같은 기초 질문이 슬랙 메시지로 쌓입니다. 그렇다고 모든 엔드포인트를 직접 타이핑하기엔 시간이 부족합니다. Claude..

Code 입문 10:00:41

Claude Code Slash Commands 체인 설계: 복합 워크플로를 단일 호출로 끝내는 법

코드 리뷰를 요청할 때마다 /lint, /test, /summarize를 세 번씩 따로 치고 있다면, 그 반복은 설계의 문제입니다. Claude Code의 커스텀 Slash Commands는 단순 단축키가 아닙니다. 명령어끼리 순서를 가지고 연결되는 컴포저 구조로 만들면, 복합 워크플로 전체를 단일 호출 한 번으로 끝낼 수 있습니다.한눈에 보는 답Slash Commands 체인 설계의 핵심은 세 가지입니다.첫째, 각 명령어는 앞 단계의 출력을 입력으로 받을 수 있도록 인자 구조를 통일합니다.둘째, 최상위 컴포저 명령어 하나가 하위 명령어들을 순서대로 호출하며 결과를 누적합니다.셋째, 어느 단계에서든 실패하면 컴포저가 멈추고 어느 단계에서 멈췄는지 알려줍니다.이 구조를 갖추면 /review 한 번으로 정적..

Code 실전 2026.06.04

Claude Code로 회의록 구조화하기: 메모를 붙이면 안건·결정·액션아이템이 정리되는 법

한눈에 보는 답회의 메모를 Claude Code 터미널에 붙여넣고 '이 메모에서 안건, 결정, 액션아이템을 각각 표로 뽑아줘'라고 지시하면 됩니다. 파일로 저장된 메모라면 @회의메모.txt처럼 파일을 직접 지정해서 넘길 수 있습니다. Claude Code는 텍스트를 읽고 세 가지 범주로 분류한 뒤 담당자와 마감일 항목까지 포함한 표를 돌려줍니다.왜 지금 중요한가회의가 끝나고 나면 가장 먼저 사라지는 것이 '누가 뭘 하기로 했더라'는 맥락입니다. 슬랙 메모, 노트 앱, 손으로 적은 종이까지 여러 곳에 흩어진 내용을 사람이 직접 분류하면 20분이 훌쩍 지나갑니다. Claude Code는 구조화되지 않은 텍스트를 읽고 논리적 범주를 스스로 판단하기 때문에, 같은 작업을 2분 이내로 줄여줍니다. 특히 반복 회의..

Code 입문 2026.06.04

Claude Code 컨텍스트 윈도우 포화 진단과 분할 요청 설계

복잡한 리팩터링을 맡겼는데 중반부부터 Claude Code의 답변이 갑자기 짧아지고, 앞에서 합의한 변수명이나 인터페이스를 무시하기 시작한다면 컨텍스트 윈도우 포화 문제일 가능성이 높습니다. 오류 메시지도 없고, Claude 자신도 눈치채지 못하는 경우가 많아서 원인을 특정하기까지 시간을 낭비하게 됩니다.한눈에 보는 답Claude Code의 컨텍스트 윈도우는 모델마다 다르지만 Claude Sonnet 4 기준 약 200,000 토큰입니다. 이 한도에 가까워지면 두 가지 문제가 생깁니다. 첫째, 초반에 교환한 지시·파일 내용을 사실상 '잊어버립니다'. 둘째, API 레이어에서 응답 자체가 잘려나갑니다. 두 현상 모두 명시적 오류 없이 발생하므로 사용자가 눈치채기 어렵습니다.핵심 대응 원칙: 하나의 긴 대화..

Code 실전 2026.06.03

Claude Code로 PR 설명 쓰기: 변경 내용을 주면 리뷰어가 바로 이해하는 본문이 나오는 법

한눈에 보는 답Claude Code에게 git diff나 변경 파일 목록을 붙여 넣고 "PR 본문을 작성해줘"라고 하면, 배경·변경 요약·테스트 방법이 구조화된 Pull Request 설명이 나옵니다. 추가로 PR 형식 템플릿을 함께 넣으면 팀 규칙에 맞는 완성본이 나옵니다.왜 지금 중요한가PR 본문을 대충 쓰면 리뷰어가 맥락을 파악하느라 시간을 씁니다. "로직 수정"한 줄짜리 설명은 리뷰어가 코드 전체를 처음부터 읽어야 한다는 의미입니다.반대로 잘 쓴 PR 본문은 다음 세 가지를 담습니다.왜 바꿨는가 — 문제 상황 또는 요구사항무엇을 바꿨는가 — 핵심 변경 사항 목록어떻게 확인하는가 — 테스트 방법 또는 스크린샷이 세 가지를 매번 직접 쓰는 건 반복 작업입니다. Claude Code는 이 반복을 대신할..

Code 입문 2026.06.03