본문 바로가기

전체 글143

Claude API 메시지 배치로 대량 요청을 비동기 처리한 방법 - 공식 문서 기준으로 정리한 기록 Claude API 메시지 배치로 대량 요청을 비동기 처리한 방법 - 공식 문서 기준으로 정리한 기록AI API 활용공식 문서와 실제 사용 경험을 기준으로 정리했습니다.수백~수천 건의 요청을 한 건씩 실시간으로 보내다 보면, 응답을 기다리는 시간도 길고 비용도 부담스럽습니다. 메시지 배치(Message Batches)는 여러 요청을 한꺼번에 제출해 두고 비동기로 처리한 뒤 나중에 결과를 수거하는 방식입니다. 실시간 응답이 필요하지 않은 대량 작업에 적합하고, 표준 가격보다 저렴하게 처리할 수 있습니다. 이 글은 메시지 배치가 어떤 흐름으로 동작하고, 어떻게 만들고 결과를 받는지, 언제 쓰면 좋은지를 공식 문서를 기준으로 정리한 기록입니다. 수치와 세부 동작은 모델·버전에 따라 달라질 수 있으니 본문 끝의.. 2026. 7. 15.
Claude API 프롬프트 캐싱으로 반복 요청 비용을 줄인 방법 - 공식 문서 기준으로 정리한 기록 Claude API 프롬프트 캐싱으로 반복 요청 비용을 줄인 방법 - 공식 문서 기준으로 정리한 기록AI API 활용공식 문서와 실제 사용 경험을 기준으로 정리했습니다.Claude API로 같은 안내문이나 긴 문서를 매 요청마다 다시 보내다 보면, 똑같은 앞부분을 반복해서 처리하느라 토큰이 쌓입니다. 프롬프트 캐싱(Prompt Caching)은 이렇게 반복되는 앞부분을 캐시에 담아 두고, 다음 요청에서 다시 계산하지 않고 재사용하게 해 주는 기능입니다. 이 글은 프롬프트 캐싱이 어떤 원리로 동작하고, 어떻게 켜며, 언제 효과가 있는지를 공식 문서를 기준으로 정리한 기록입니다. 수치와 세부 동작은 모델·버전에 따라 달라질 수 있으니 본문 끝의 공식 문서를 함께 확인하시길 권합니다.핵심 원리 — 앞부분이 같.. 2026. 7. 12.
Claude Code 플랜 모드와 권한 설정으로 안전하게 작업하기 - 실수로 파일을 건드리지 않으려고 정리한 기록 Claude Code 플랜 모드와 권한 설정으로 안전하게 작업하기 - 실수로 파일을 건드리지 않으려고 정리한 기록개발 도구 사용기공식 문서와 실제 사용 경험을 기준으로 정리했습니다.AI 도구에게 코드 작업을 맡길 때 가장 신경 쓰이는 건 "시키지도 않은 파일을 고치면 어쩌지" 하는 부분입니다. Claude Code에는 이런 걱정을 덜어 주는 두 가지 장치가 있습니다. 먼저 계획만 세우고 실제 수정은 하지 않는 플랜 모드(Plan Mode), 그리고 어떤 작업을 자동 허용·확인·차단할지 미리 정해 두는 권한 설정(Permissions)입니다. 이 글은 플랜 모드와 권한 설정을 어떻게 쓰면 실수로 파일을 건드리는 일을 줄일 수 있는지 공식 문서를 기준으로 정리한 기록입니다. 명령과 동작은 버전에 따라 달라질.. 2026. 7. 5.
Claude Code에서 CLAUDE.md와 메모리로 프로젝트 맥락 유지하기 - 매번 설명하지 않으려고 정리한 기록 Claude Code에서 CLAUDE.md와 메모리로 프로젝트 맥락 유지하기 - 매번 설명하지 않으려고 정리한 기록개발 도구 사용기공식 문서와 실제 사용 경험을 기준으로 정리했습니다.새 세션을 열 때마다 "이 프로젝트는 들여쓰기 두 칸을 쓰고, 테스트는 이 명령으로 돌리고…" 같은 설명을 다시 적고 있다면, 그 반복을 한 번만 적어 두는 방법이 있습니다. Claude Code의 CLAUDE.md와 메모리(memory) 기능입니다. 이 글은 프로젝트 규칙과 자주 쓰는 정보를 어디에, 어떻게 적어 두면 매번 설명하지 않아도 되는지를 공식 문서를 기준으로 정리한 기록입니다. 명령과 동작은 버전에 따라 달라질 수 있으니 본문에 적은 공식 문서를 함께 확인하시길 권합니다.매번 같은 설명을 반복하게 되는 이유Cla.. 2026. 6. 27.
Claude Code 병렬 서브에이전트로 대규모 작업 처리하기 - fan-out·파이프라인을 직접 써본 기록 Claude Code 병렬 서브에이전트로 대규모 작업 처리하기 - fan-out·파이프라인을 직접 써본 기록개발 도구 사용기공식 문서와 실제 사용 경험을 기준으로 정리했습니다.한 번에 다루기엔 너무 큰 작업이 있습니다. 파일 수백 개를 훑어야 하거나, 여러 갈래를 동시에 조사해야 하거나, 같은 내용을 여러 관점에서 교차 확인해야 할 때입니다. 이런 일을 하나의 대화창에서 순서대로 처리하면 금세 한계에 부딪힙니다. 이 글은 Claude Code의 서브에이전트(subagent)를 병렬로 나눠 큰 작업을 처리한 기록입니다. fan-out(갈래로 펼치기)과 파이프라인(단계로 잇기)이라는 두 가지 흐름을 중심으로 정리했고, 기능 설명은 공식 문서를 기준으로 했습니다. 명령과 화면은 버전에 따라 달라질 수 있으니 .. 2026. 6. 26.
Claude Code에 MCP 서버 연동하기 - 외부 도구를 붙여 쓴 기록 Claude Code에 MCP 서버 연동하기 - 외부 도구를 붙여 쓴 기록개발 도구 사용기공식 문서와 실제 연동 경험을 기준으로 정리했습니다.Claude Code를 쓰다 보면 "이 작업까지 도구가 직접 해 주면 좋겠다" 싶은 순간이 옵니다. 브라우저를 열어 확인한다거나, 외부 서비스의 데이터를 가져온다거나 하는 일들입니다. 이때 쓰는 것이 MCP(Model Context Protocol) 서버 연동입니다. 이 글은 MCP가 무엇이고, 서버를 어떻게 추가·관리하는지를 공식 문서 기준으로 정리하고, 직접 붙여 쓰며 느낀 점을 덧붙인 기록입니다. 명령과 화면은 도구 버전에 따라 달라질 수 있으니, 정확한 내용은 본문에 적은 공식 문서를 함께 확인하시길 권합니다.MCP가 무엇인가MCP(Model Context .. 2026. 6. 22.

티스토리툴바