기능 개요
기능 개요 (Features overview)
Claude의 API 표면은 모델 능력, 도구, 도구 인프라, 컨텍스트 관리, 파일과 자산의 다섯 영역으로 구성돼요. 이 페이지는 각 영역의 기능과 이용 가능한 플랫폼, 베타·폐기·퇴역 분류를 한눈에 보여줘요. 새로 시작하는 경우 모델 능력과 도구부터 시작하세요.
출처: 문서
본문
Claude의 API 표면은 다섯 영역으로 구성돼요:
- 모델 능력 (Model capabilities): Claude가 어떻게 추론하고 응답을 형식화하는지 제어해요.
- 도구 (Tools): Claude가 웹이나 당신의 환경에서 행동하게 해요.
- 도구 인프라 (Tool infrastructure): 대규모에서 발견과 오케스트레이션을 처리해요.
- 컨텍스트 관리 (Context management): 오래 실행되는 세션을 효율적으로 유지해요.
- 파일과 자산 (Files and assets): Claude에 제공하는 문서와 데이터를 관리해요.
새로 시작하는 경우 모델 능력과 도구부터 시작하세요. 비용, 지연, 규모를 최적화할 준비가 되면 나머지 섹션으로 돌아오세요.
관리와 거버넌스는 Admin API, 사용량 및 비용 API, 컴플라이언스 API를 참고하세요.
기능 가용성 (Feature availability)
아래 각 표의 Availability(가용성) 열은 기능을 제공하는 플랫폼을 나열해요. 레이블 없이 나열된 플랫폼은 그 기능을 안정적이고 완전히 지원되며 프로덕션 사용에 권장되는 것으로 제공해요. 베타 헤더 없이, 표준 API 버전 관리 보장을 포함해요. 플랫폼 이름 뒤의 레이블은 그 플랫폼에서 다음 분류 중 하나를 표시해요. 모든 기능이 모든 단계를 통과하는 것은 아니며, 기능은 어떤 단계에서든 시작하거나 단계를 건너뛸 수 있어요.
| 분류 | 설명 |
|---|---|
| Beta | 피드백 수집과 덜 성숙한 사용 사례의 반복을 위해 사용되는 미리보기 기능. 가용성이 제한될 수 있으며(가입 요건이나 대기열 포함), 공개적으로 발표되지 않을 수도 있어요. 기능은 피드백에 따라 크게 바뀌거나 중단될 수 있어요. 지속적인 프로덕션 사용이 보장되지 않아요. 공지와 함께 호환성이 깨지는 변경이 가능하며, 일부 플랫폼별 제한이 적용될 수 있어요. Claude API와 Claude Platform on AWS의 대부분 베타 기능에는 베타 헤더가 있어요. |
| Deprecated | 기능이 여전히 작동하지만 더 이상 권장되지 않음. 마이그레이션 경로와 제거 일정이 제공돼요. |
| Retired | 기능을 더 이상 사용할 수 없음. |
플랫폼 레이블: Claude API (Anthropic 퍼스트파티) · Bedrock (AWS 운영) · Claude Platform on AWS (AWS에서 Anthropic 운영) · Google Cloud (Google 운영) · Microsoft Foundry (Azure에서 Anthropic 운영)
모델 능력 (Model capabilities)
Claude와 Claude의 직접 출력을 조정하는 방법들. 응답 형식, 추론 깊이, 입력 모달리티를 포함해요.
팁: 모델이 지원하는 능력을 프로그래매틱하게 발견할 수 있어요. Models API는 사용 가능한 모든 모델에 대해
max_input_tokens,max_tokens,capabilities객체를 반환해요.
ZDR 열은 기능이 제로 데이터 보존(Zero Data Retention) 약정 하에 사용 가능한지 나타내요. 대부분 기능에서 이는 기능 메커니즘이 보존하는 것에만 달려 있어요. 특정 모델에 묶인 기능의 경우 모델 수준 ZDR 가용성도 적용돼요. 모델별 데이터 보존 요구 사항을 참고하세요.
| 기능 | 설명 | ZDR(제로 데이터 보존) | 가용성 |
|---|---|---|---|
| 컨텍스트 창 | 대용량 문서, 방대한 코드 베이스, 긴 대화를 처리하기 위한 최대 1M 토큰. | ZDR 적격 | |
| 적응형 thinking | Claude가 언제 얼마나 생각할지 동적으로 결정하게 해 줌. Claude 4.7 이상 모델의 유일한 thinking 모드. effort 매개변수로 thinking 깊이를 제어. | ZDR 적격 | |
| 배치 처리 | 비용 절감을 위해 대량의 요청을 비동기로 처리. 배치당 많은 수의 질의를 보낼 수 있음. 배치 API 호출은 표준 API 호출보다 50% 저렴. | ZDR 비적격 | |
| 인용 | Claude의 응답을 소스 문서에 근거 지움. 인용을 통해 Claude는 응답 생성에 사용한 정확한 문장과 구절에 대한 상세한 참조를 제공해 더 검증 가능하고 신뢰할 수 있는 출력을 만들 수 있음. | ZDR 적격 | |
| 데이터 레지던시 | 지리적 컨트롤로 모델 추론이 실행되는 위치를 제어. inference_geo 매개변수를 통해 요청별로 "global" 또는 "us" 라우팅 지정. |
ZDR 적격 | |
| Effort | effort 매개변수로 Claude가 응답할 때 사용하는 토큰 수를 제어. 응답의 철저성과 토큰 효율성 사이의 트레이드오프. | ZDR 적격 | |
| 폴백 크레딧 | 거부된 요청을 다른 모델에서 재시도할 때 프롬프트 캐시 비용을 두 번 내지 않게 해 줌. 거부에는 크레딧 토큰이 붙고, 재시도에서 이를 반향하면 새 모델에서 처음부터 대화가 있었다는 것처럼 요금이 매겨짐. Message Batches 결과에는 폴백 크레딧 토큰이 포함되지 않음. | ZDR 비적격* | |
| PDF 지원 | PDF 문서에서 텍스트와 시각 콘텐츠를 처리하고 분석. | ZDR 적격 | |
| 검색 결과 | 적절한 소스 속성을 가진 검색 결과를 제공해 RAG 애플리케이션에 자연스러운 인용을 지원. 맞춤 지식 베이스와 도구에 대해 웹 검색 수준의 인용 달성. | ZDR 적격 | |
| 서버 측 폴백 | 단일 API 호출 안에서 거부된 요청을 재시도. "default" 모드로 Anthropic 권장 폴백 모델을 적용하거나 당신만의 모델을 최대 3개 지정. 요청된 모델이 거절하면 API는 같은 요청에서 체인의 다음 모델을 실행. fallbacks 매개변수는 Message Batches API에서 사용 불가. |
ZDR 비적격* | |
| 구조화된 출력 | 두 가지 접근으로 스키마 준수를 보장: 구조화된 데이터 응답을 위한 JSON 출력, 검증된 도구 입력을 위한 엄격한 도구 사용. | ZDR 적격(한정)* | |
| Thinking | 복잡한 작업을 위한 강화된 추론 능력. 최종 답변을 내기 전에 Claude의 단계별 사고 과정을 투명하게 보여줌. | ZDR 적격 |
도구 (Tools)
Claude가 tool_use를 통해 호출하는 내장 도구. 서버 측 도구는 플랫폼이 실행하고, 클라이언트 측 도구는 당신이 구현·실행해요.
서버 측 도구 (Server-side tools)
| 기능 | 설명 | ZDR | 가용성 |
|---|---|---|---|
| Advisor 도구 | 더 빠른 실행자 모델을 더 높은 지능의 advisor 모델과 짝지어, 장기 에이전트 워크로드에서 생성 도중 전략적 안내를 제공. | ZDR 적격 | |
| 코드 실행 | 샌드박스 환경에서 코드를 실행해 고급 데이터 분석, 계산, 파일 처리. 웹 검색이나 웹 패치와 함께 쓰면 무료. | ZDR 비적격 | |
| 웹 패치 | 심층 분석을 위해 지정된 웹 페이지와 PDF 문서 전체 콘텐츠를 검색. | ZDR 적격* | |
| 웹 검색 | 웹 전반의 현재·실세계 데이터로 Claude의 포괄적인 지식을 보강. | ZDR 적격* |
클라이언트 측 도구 (Client-side tools)
| 기능 | 설명 | ZDR | 가용성 |
|---|---|---|---|
| Bash | bash 명령과 스크립트를 실행해 시스템 셸과 상호작용하고 명령줄 작업 수행. | ZDR 적격 | |
| Browser use | 당신의 브라우저 환경에서 웹 페이지를 탐색, 읽고, 상호작용. | ZDR 적격 | |
| 컴퓨터 사용 | 스크린샷을 찍고 마우스·키보드 명령을 내려 컴퓨터 인터페이스를 제어. | ZDR 적격 | |
| 메모리 | Claude가 대화에 걸쳐 정보를 저장하고 검색하게 함. 시간이 지나 지식 베이스를 구축하고, 프로젝트 컨텍스트를 유지하며, 과거 상호작용에서 학습. | ZDR 적격 | |
| 텍스트 편집기 | 파일 조작 작업을 위한 내장 텍스트 편집기 인터페이스로 텍스트 파일 생성·편집. | ZDR 적격 |
도구 인프라 (Tool infrastructure)
도구 사용의 발견, 오케스트레이션, 확장을 지원하는 인프라.
| 기능 | 설명 | ZDR | 가용성 |
|---|---|---|---|
| Agent Skills | Skills로 Claude의 능력을 확장. 사전 구축된 Skills(PowerPoint, Excel, Word, PDF) 또는 지침과 스크립트가 있는 맞춤 Skills 생성. Skills는 점진적 공개(progressive disclosure)로 컨텍스트를 효율적으로 관리. | ZDR 비적격 | |
| 세분화된 도구 스트리밍 | 버퍼링/JSON 검증 없이 도구 사용 매개변수를 스트리밍. 큰 매개변수 수신의 지연 시간 감소. | ZDR 적격 | |
| MCP 커넥터 | 별도의 MCP 클라이언트 없이 Messages API에서 원격 MCP 서버에 직접 연결. | ZDR 비적격 | |
| 프로그래매틱 도구 호출 | Claude가 코드 실행 컨테이너 안에서 도구를 프로그래매틱하게 호출하게 해, 다중 도구 워크플로의 지연 시간과 토큰 소비를 줄임. | ZDR 비적격 | |
| 도구 검색 | regex·BM25 기반 검색으로 도구를 동적으로 발견·온디맨드 로드해 수천 개 도구로 확장. 컨텍스트 사용 최적화와 도구 선택 정확도 향상. | ZDR 적격 |
컨텍스트 관리 (Context management)
Claude의 컨텍스트 창을 제어하고 최적화하는 인프라.
| 기능 | 설명 | ZDR | 가용성 |
|---|---|---|---|
| 토큰 임계값 컴팩션 | 긴 대화를 위한 서버 측 컨텍스트 요약. 입력 토큰이 트리거 임계값에 도달하면 API가 대화의 앞부분을 자동으로 요약. | ZDR 적격 | |
| 컨텍스트 편집 | 구성 가능한 전략으로 대화 컨텍스트를 자동 관리. 토큰 한도에 가까워질 때 도구 결과 지우기와 확장 thinking 대화의 thinking 블록 관리 지원. | ZDR 적격 | |
| 자동 프롬프트 캐싱 | 프롬프트 캐싱을 단일 API 매개변수로 단순화. 시스템이 요청의 마지막 캐시 가능한 블록을 자동으로 캐시하고, 대화가 커질수록 캐시 포인트를 앞으로 이동. | ZDR 적격 | |
| 프롬프트 캐싱 (5m) | 비용과 지연을 줄이기 위해 Claude에 더 많은 배경 지식과 예제 출력 제공. | ZDR 적격 | |
| 프롬프트 캐싱 (1hr) | 자주 접근하지 않지만 중요한 컨텍스트를 위한 1시간 캐시 기간. 표준 5분 캐시를 보완. | ZDR 적격 | |
| 토큰 계산 | 메시지를 Claude에 보내기 전에 토큰 수를 결정하게 해, 프롬프트와 사용량에 대한 정보에 입각한 결정 지원. | ZDR 적격 |
파일과 자산 (Files and assets)
Claude와 함께 사용할 파일과 자산을 관리해요.
| 기능 | 설명 | ZDR | 가용성 |
|---|---|---|---|
| Files API | 매 요청마다 콘텐츠를 재업로드하지 않고 Claude와 함께 사용할 파일을 업로드·관리. PDF, 이미지, 텍스트 파일 지원. | ZDR 비적격 |
* 구조화된 출력: 당신의 프롬프트와 Claude의 출력은 저장되지 않아요. JSON 스키마만 마지막 사용 후 최대 24시간 동안 캐시돼요. 웹 검색과 웹 패치: 동적 필터링이 활성화된 경우를 제외하고 ZDR 적격. 폴백 크레딧과 서버 측 폴백: 이 기능은 메시지 콘텐츠를 보존하지 않지만, ZDR 하에서는 사용할 수 없는 Claude Fable 모델의 거부를 처리해요. ZDR 상세 참고.
† Microsoft Foundry에서 기능 가용성은 호스팅 옵션에 따라 달라져요. 이 기능들은 Hosted on Anthropic 배포에서 사용 가능하고, Hosted on Azure 배포에서는 사용할 수 없어요.
‡ Claude Platform on AWS에서 Agent Skills는 베타 헤더가 필요 없고 Claude API와 동일하게 동작해요.