목차
Toggle1Claude API란 무엇인가?
Claude API는 Anthropic이 제공하는 AI 언어 모델 인터페이스로, 개발자가 자신의 애플리케이션에 Claude의 고급 언어 이해·생성 능력을 통합할 수 있게 해줍니다. API 표면은 크게 5가지 영역으로 나뉩니다.
| 영역 | 역할 요약 |
|---|---|
| 모델 기능 | 응답 방식·형식·추론 깊이 제어 |
| 도구 | 웹 검색, 코드 실행 등 외부 작업 수행 |
| 도구 인프라 | 대규모 검색 및 오케스트레이션 |
| 컨텍스트 관리 | 장기 실행 세션의 효율적 유지 |
| 파일 및 자산 | 문서·데이터 업로드 및 재사용 관리 |
2모델 기능 — 응답 품질과 형식 제어
모델 기능은 Claude가 어떻게 생각하고, 어떤 형식으로 응답할지 제어하는 핵심 도구입니다.
컨텍스트 윈도우
최대 1M 토큰. 대용량 문서·코드베이스·긴 대화 처리에 최적.
확장 사고
복잡한 작업을 위한 단계별 추론. 사고 과정을 투명하게 확인.
적응형 사고
Claude가 언제 얼마나 생각할지 동적 결정. Opus 4.6 권장 모드.
배치 처리
대량 요청 비동기 처리. 표준 API 대비 50% 비용 절감.
인용 (Citations)
응답을 소스 문서에 근거. 정확한 문장·구절 참조 제공.
구조화된 출력
JSON 출력 + 엄격한 도구 사용으로 스키마 준수 보장.
PDF 지원
PDF 문서의 텍스트 및 시각적 콘텐츠 처리·분석.
검색 결과
RAG 애플리케이션용 자연스러운 인용 활성화.
3도구 — 서버 측 & 클라이언트 측
도구는 Claude가 웹이나 사용자 환경에서 실제 작업을 수행할 수 있도록 합니다. tool_use를 통해 호출하며 실행 위치에 따라 두 종류로 나뉩니다.
🌐 서버 측 도구 (플랫폼에서 실행)
| 도구 | 설명 | ZDR |
|---|---|---|
| 웹 검색 | 웹 전반의 최신 실시간 데이터로 Claude 지식 보강 | 적격 |
| 웹 가져오기 | 지정된 웹 페이지·PDF에서 전체 콘텐츠 검색 | 적격 |
| 코드 실행 웹 검색과 함께 시 무료 | 샌드박스 환경에서 데이터 분석·계산·파일 처리 | 비적격 |
💻 클라이언트 측 도구 (사용자가 구현·실행)
| 도구 | 설명 | 상태 |
|---|---|---|
| Bash | bash 명령·스크립트 실행, 명령줄 작업 수행 | GA |
| 텍스트 편집기 | 텍스트 파일 생성 및 편집 | GA |
| 메모리 | 대화 전반에 걸친 정보 저장·검색, 지식 베이스 구축 | GA |
| 컴퓨터 사용 | 스크린샷, 마우스·키보드로 컴퓨터 인터페이스 제어 | Beta |
4도구 인프라 — 대규모 확장을 위한 기반
도구 사용의 검색, 오케스트레이션, 확장을 지원하는 인프라 레이어입니다.
| 기능 | 설명 | 상태 |
|---|---|---|
| 도구 검색 | 정규식 기반으로 수천 개 도구를 온디맨드 동적 로드. 컨텍스트 최적화 및 도구 선택 정확도 향상. | GA |
| Agent Skills | 사전 구축 Skills(PowerPoint, Excel, Word, PDF) 또는 커스텀 Skills 생성. 점진적 공개로 컨텍스트 효율화. | Beta |
| MCP 커넥터 | 별도 클라이언트 없이 Messages API에서 직접 원격 MCP 서버 연결. | Beta |
| 프로그래밍 방식 도구 호출 | 코드 실행 컨테이너 내에서 도구를 프로그래밍 방식으로 호출. 지연 시간 및 토큰 소비 감소. | GA |
| 세밀한 도구 스트리밍 | 버퍼링·JSON 유효성 검사 없이 파라미터 스트리밍. 대용량 파라미터 수신 시 지연 시간 최소화. | GA |
5컨텍스트 관리 — 장기 세션 최적화
Claude의 컨텍스트 윈도우를 제어하고 비용 효율적으로 운영하기 위한 도구 모음입니다.
프롬프트 캐싱
| 캐시 유형 | 유지 시간 | 지원 플랫폼 |
|---|---|---|
| 표준 캐시 | 5분 | Claude API, Bedrock, Vertex AI, Foundry |
| 장기 캐시 | 1시간 | Claude API, Vertex AI, Foundry |
| 자동 캐싱 | 자동 관리 | Claude API, Foundry |
압축 (Compaction)
장기 실행 대화를 위한 서버 측 자동 컨텍스트 요약입니다. 컨텍스트가 윈도우 한계에 근접하면 API가 이전 대화를 자동 요약합니다. Opus 4.6, Sonnet 4.6 지원.
컨텍스트 편집 (Context Editing)
구성 가능한 전략으로 대화 컨텍스트를 자동 관리합니다. 토큰 한계 근접 시 도구 결과 자동 정리, 확장 사고 대화에서 사고 블록 관리를 지원합니다.
토큰 카운팅
메시지 전송 전 토큰 수를 미리 확인하여 비용과 사용량을 사전에 최적화할 수 있습니다.
6파일 및 자산 관리
지원 형식: PDF, 이미지, 텍스트 파일 | 상태: Beta (Claude API, Microsoft Foundry)
ZDR 비적격
7처음 시작하는 개발자를 위한 추천 순서
기본 기능 이해
- 모델 기능 — 확장 사고, 구조화된 출력
- 기본 도구 — 웹 검색, 코드 실행
실전 통합
- 클라이언트 측 도구 — Bash, 텍스트 편집기
- 컨텍스트 윈도우 활용 및 인용 기능
비용·성능 최적화
- 프롬프트 캐싱 (5분 / 1시간)
- 배치 처리로 50% 비용 절감
- 압축 및 컨텍스트 편집
대규모 확장
- 도구 검색으로 수천 개 도구 관리
- Agent Skills 활용
- MCP 커넥터로 원격 서버 연결