MessagesClaude로 구축하기
기능 개요
Claude의 고급 기능과 역량을 살펴보세요.
각 기능의 “zero data retention”(제로 데이터 보존), 즉 ZDR 및 HIPAA 대응 적격성에 대해서는 API 및 데이터 보존을 참조하세요.
관리 및 거버넌스에 대해서는 Admin API, Usage and Cost Analytics API, Compliance API를 참조하세요.
플랫폼 기능
Claude Platform의 API 전반에서 작동하는 기능입니다. 각 기능의 페이지에서 해당 기능을 사용할 수 있는 곳을 안내합니다.
| 기능 | 설명 |
|---|---|
| 어드바이저 도구 | 더 빠른 실행자 모델이 생성 도중 계획이나 방향 수정을 위해 더 유능한 어드바이저 모델에 자문을 구할 수 있게 합니다. |
| Agent Skills | 작업과 관련이 있을 때 Claude가 자동으로 사용하는, 지침, 메타데이터, 선택적 스크립트로 구성된 재사용 가능한 패키지입니다. |
| Agent Skills의 일부: 사용자 정의 스킬 | 직접 작성하여 워크스페이스에 업로드하는 스킬입니다. |
| Agent Skills의 일부: 사전 구축된 Agent Skills | PowerPoint, Excel, Word, PDF 파일용으로 Anthropic이 사전 구축한 스킬입니다. |
| 배치 처리 | 여러 Messages API 요청을 하나의 배치로 표준 가격의 절반에 비동기 처리합니다. |
| 브라우저 및 컴퓨터 사용 SDK 도구 세트 | 브라우저 사용 또는 컴퓨터 사용 도구를 사용자가 제공하는 브라우저나 데스크톱에 연결하는 Python 및 TypeScript SDK의 클래스입니다. |
| 브라우저 사용 도구 | Claude가 사용자 자체 브라우저 환경에서 웹 페이지를 탐색하고, 읽고, 상호작용할 수 있게 합니다. |
| 인용 | 문서에 대한 Claude의 답변은 각 주장을 뒷받침하는 정확한 구절을 인용합니다. |
| 분류기 거부 | 일부 모델의 안전 분류기는 요청을 거절할 수 있으며, 거절은 오류가 아닌 일반 응답으로 반환됩니다. |
| 분류기 거부의 일부: 클라이언트 측 폴백 | 지정한 폴백 모델로 거부된 요청을 재시도하는 Claude SDK의 미들웨어입니다. |
| 분류기 거부의 일부: 폴백 크레딧 | 거부된 요청을 다른 모델에서 재시도할 때 대화가 처음부터 해당 모델에서 진행된 것처럼 청구하므로, 프롬프트 캐시 쓰기 비용을 두 번 지불하지 않습니다. |
| 분류기 거부의 일부: 서버 측 폴백 | API가 동일한 호출 내에서 거부된 요청을 폴백 모델로 재시도하고 하나의 응답을 반환합니다. |
| 컴퓨터 사용 도구 | Claude에 데스크톱 환경의 스크린샷, 마우스, 키보드 제어 기능을 제공합니다. |
| 사용자 정의 도구 | 이름, 설명, 입력 스키마로 정의하는 도구입니다. Claude가 호출을 요청하면 코드에서 도구를 실행하고 결과를 반환합니다. |
| 데이터 레지던시 | 모델 추론이 실행되는 위치(추론 지역)와 저장 데이터가 보관되는 위치(워크스페이스 지역)를 제어합니다. |
| 노력 수준(Effort) | Claude가 응답에 사용하는 토큰 수를 제어하여 철저함과 토큰 효율성 사이의 균형을 조절하는 설정입니다. |
| 노력 수준(Effort)의 일부: 메시지별 노력 수준 | 메시지별 output_config로 대화의 이후 턴에 대한 노력 수준을 변경하며, 프롬프트 캐시는 유지됩니다. |
| Fast mode | 지원되는 모델에서 초당 최대 2.5배 많은 출력 토큰을 생성하며, 프리미엄 가격이 적용됩니다. |
| Files API | 파일을 한 번 업로드한 후 이후 요청에서 file_id로 참조하고, 스킬이나 코드 실행 도구가 생성한 파일을 다운로드합니다. |
| MCP 커넥터 | 자체 MCP 클라이언트를 실행하지 않고도 Claude를 원격 MCP 서버에 연결하여 해당 도구를 호출할 수 있게 합니다. |
| MCP 커넥터의 일부: 클라이언트 측 MCP 헬퍼 | 로컬 서버, 프롬프트, 리소스 등을 위해 자체 MCP 클라이언트를 실행할 때 MCP 타입과 Claude API 타입 간 변환을 수행하는 SDK 헬퍼입니다. |
| MCP 터널 | 인바운드 포트를 열지 않고 아웃바운드 전용 연결을 통해 Claude를 사설 네트워크 내부의 MCP 서버에 연결합니다. |
| 대화 중 시스템 메시지 | 최상위 시스템 프롬프트나 그 앞의 캐시된 접두사를 변경하지 않고 대화 도중에 추가하는 시스템 지시입니다. |
| 대화 중 시스템 메시지의 일부: 대화 중 도구 변경 | 도구 배열을 변경하지 않고 대화 도중에 도구를 제공하거나 철회하여 캐시된 접두사가 유효하게 유지되도록 합니다. |
| 대화 중 시스템 메시지의 일부: 턴 범위 시스템 메시지 | 다음 사용자 메시지 전까지만 적용되는 대화 중 시스템 메시지로, 이후에는 기록에 남지만 아무것도 렌더링하지 않으며 입력 토큰 비용이 들지 않습니다. |
| 다국어 지원 | Claude는 여러 언어로 작동하며, 영어 대비 우수한 성능을 보입니다. |
| OpenTelemetry | Claude SDK와 Claude API의 OpenTelemetry 스팬으로 Messages API 요청, 도구 사용, Managed Agents 세션을 추적합니다. |
| OpenTelemetry의 일부: API 트레이싱 | Claude API가 실행하는 각 모델 요청과 도구 사용에 대해 관측성 플랫폼으로 보내는 OpenTelemetry 스팬입니다. |
| OpenTelemetry의 일부: SDK 트레이싱 | Claude SDK가 보내는 각 요청과 도구 러너가 실행하는 각 도구에 대해 애플리케이션에서 내보내는 OpenTelemetry 스팬입니다. |
| 병렬 도구 사용 | Claude는 하나의 응답에서 여러 도구를 호출할 수 있습니다. |
| PDF 지원 | PDF를 Claude에 보내 그 안의 텍스트, 그림, 차트, 표를 읽게 합니다. |
| 프로그래매틱 도구 호출 | 호출마다 모델 왕복을 한 번씩 거치는 대신, Claude가 코드 실행 컨테이너의 코드에서 도구를 호출할 수 있게 합니다. |
| 프롬프트 캐싱 | 최근 요청에서 캐시된 프롬프트 접두사를 재사용하여 처리 시간과 비용을 줄입니다. |
| 프롬프트 캐싱의 일부: 1시간 지속 시간 | 1시간 프롬프트 캐시 수명으로, 5분 기본값보다 캐시 쓰기 가격이 높습니다. |
| 프롬프트 캐싱의 일부: 5분 지속 시간(기본값) | 기본 프롬프트 캐시 수명입니다. 캐시된 콘텐츠를 사용할 때마다 추가 비용 없이 갱신됩니다. |
| 프롬프트 캐싱의 일부: 자동 캐싱 | 최상위 cache_control 필드 하나를 사용하는 프롬프트 캐싱입니다. 캐시 중단점은 마지막 캐시 가능 블록에 배치되며 대화가 길어짐에 따라 앞으로 이동합니다. |
| 프롬프트 캐싱의 일부: 캐시 진단 | 요청을 이전 요청과 비교하여 프롬프트 접두사가 변경된 위치를 보고함으로써 캐시 미스의 원인을 설명합니다. |
| 프롬프트 캐싱의 일부: 명시적 캐시 중단점 | 개별 콘텐츠 블록에 cache_control을 지정하여 캐시할 내용을 정확히 선택하는 프롬프트 캐싱입니다. |
| SDK 미들웨어 | 각 요청이 전송되기 전과 응답을 받은 후에 사용자의 코드를 실행하는 Claude SDK의 훅입니다. |
| 검색 결과 | 출처와 제목이 포함된 자체 검색 결과를 담는 콘텐츠 블록으로, Claude가 웹 검색 결과를 인용하는 것과 같은 방식으로 인용할 수 있게 합니다. |
| 서비스 티어 | 요청이 조직의 Priority Tier 용량을 사용할 수 있게 합니다. |
| 세션 예산 | 하나의 세션에 대한 미국 달러 단위의 엄격한 지출 한도로, 공개 정가 기준으로 측정됩니다. |
| 스트리밍 거부 | 스트리밍 분류기가 정책 위반 가능성으로 응답을 중단하면 스트리밍된 응답은 stop_reason "refusal"로 끝납니다. |
| 구조화된 출력 | Claude의 응답을 사용자가 제공한 JSON 스키마로 제한하여 출력이 유효하고 파싱 가능하도록 합니다. |
| 작업 예산 | 전체 에이전트 루프에 사용할 수 있는 토큰 수를 Claude에 알려, Claude가 작업을 계획하고 예산이 소진되기 전에 완료할 수 있게 합니다. |
| 사고 | Claude는 답변을 작성하기 전에 사고 블록에서 문제를 단계적으로 풀어 갑니다. |
| 사고의 일부: 적응형 사고 | Claude가 요청마다 사고할지 여부와 사고량을 결정하는 사고 모드입니다. |
| 사고의 일부: 확장 사고 | 각 요청에 고정된 사고 토큰 예산(budget_tokens)을 설정하는 수동 사고 모드입니다. |
| 사고의 일부: 보존된 사고 | Claude는 현재 모델이 읽을 수 있고 그 앞의 내용(시스템 프롬프트, 도구, 이전 메시지)이 변경되지 않은 경우에만 이전 턴의 사고 블록을 사용합니다. |
| 임계값 압축 | 자동 압축: 대화가 토큰 임계값에 도달하면 API가 요청 내에서 이전 컨텍스트를 요약합니다. |
| 토큰 카운팅 | 메시지를 Claude에 보내기 전에 메시지의 토큰 수를 계산합니다. |
| 도구 러너 | 도구 사용 루프를 대신 실행하는 SDK 헬퍼로, Claude가 도구를 호출하면 해당 도구를 실행하고 결과를 다시 보냅니다. |
| 도구 검색 도구 | Claude가 도구 카탈로그를 검색하여 필요한 도구 정의만 로드할 수 있게 합니다. |
| 비전(이미지) | Claude는 사용자가 보낸 이미지를 읽고 분석할 수 있습니다. |
| 웹 도메인 제한 | 웹 검색 도구와 웹 가져오기 도구가 접근할 수 있는 사이트를 제어하는 허용 또는 차단 도메인 목록입니다. |
| 웹 가져오기 도구 | Claude가 지정된 URL의 웹 페이지와 PDF 문서의 전체 콘텐츠를 가져올 수 있게 하는 서버 도구입니다. |
| 웹 검색 도구 | Claude가 웹에서 최신 정보를 검색할 수 있게 하는 서버 도구입니다. |
Messages API 기능
| 기능 | 설명 |
|---|---|
| Apple Foundation Models | Apple의 Foundation Models 프레임워크에서 Claude를 언어 모델로 사용할 수 있게 하는 Swift 패키지입니다. |
| Bash 도구 | Claude가 셸 명령을 요청할 수 있게 하며, 명령은 명령 간 상태를 유지하는 bash 세션에서 실행됩니다. |
| 코드 실행 도구 | Claude가 샌드박스 컨테이너에서 Python 및 Bash 코드를 실행할 수 있게 합니다. |
| 컨텍스트 편집 | 대화 기록이 길어짐에 따라 오래된 도구 결과나 오래된 사고 블록과 같은 선택된 콘텐츠를 대화 기록에서 지웁니다. |
| 강제 도구 사용 | Claude가 직접 답변하는 대신 도구 또는 특정 도구 하나를 호출하도록 합니다. |
| 메모리 도구 | Claude가 메모리 파일 디렉터리에 대화 간 정보를 저장하고 읽을 수 있게 합니다. |
| 메모리 도구의 일부: 메모리 도구 헬퍼 | 메모리 도구의 인터페이스와 도구 사용 루프를 처리하는 SDK 헬퍼로, 코드에서는 저장소만 제공하면 됩니다. |
| 메시지 스트리밍 | Messages API 응답을 생성되는 동안 서버 전송 이벤트로 점진적으로 수신하는 기능입니다. |
| 메시지 스트리밍의 일부: 세분화된 도구 스트리밍 | 서버가 먼저 JSON을 버퍼링하고 검사하지 않고, Claude가 작성하는 대로 도구 입력을 클라이언트로 스트리밍합니다. |
| 메시지 스레드 | 각 요청에서 새 메시지만 보내, 특히 긴 대화에서 장기 실행 에이전트의 첫 토큰까지의 시간을 단축합니다. |
| 온디맨드 압축 | 애플리케이션이 요청할 때 대화의 이전 메시지를 Claude가 작성한 요약으로 대체합니다. |
| 온디맨드 압축의 일부: 백그라운드 압축 | 대화가 전체 기록으로 계속되는 동안 온디맨드 압축 요청을 실행하고, 요약이 도착하면 이를 교체해 넣습니다. |
| 온디맨드 압축의 일부: 압축과 보존된 사고 | 온디맨드 압축 후 유지하는 턴의 사고 블록은 보존된 사고를 지원하는 모델에서 명시된 조건하에 유효하게 유지될 수 있습니다. |
| 온디맨드 압축의 일부: 최근 턴 유지 압축 | 이전 턴을 요약하고 마지막 몇 턴은 요약 뒤에 원문 그대로 유지하는 온디맨드 압축입니다. |
| 온디맨드 압축의 일부: 도구 러너 압축 헬퍼 | 현재 턴과 해당 도구 호출이 완료되면 압축 요청을 대신 보내는 SDK 도구 러너의 메서드입니다. |
| OpenAI SDK 호환성 | OpenAI SDK로 Claude API를 호출할 수 있게 해주는 호환성 계층으로, 모델 테스트와 비교를 위한 것입니다. |
| 엄격한 도구 사용 | Claude의 도구 입력이 항상 도구의 JSON Schema와 일치하도록 합니다. |
| 텍스트 편집기 도구 | Claude가 Anthropic이 정의한 도구로 텍스트 파일을 보고, 생성하고, 편집할 수 있게 합니다. |
| 타입 기반 구조화된 출력 헬퍼 | 코드의 타입으로부터 JSON 스키마를 생성하고 Claude의 응답을 해당 타입으로 파싱하는 SDK 헬퍼입니다. |
Managed Agents 기능
| 기능 | 설명 |
|---|---|
| 에이전트 구성 | 세션이 실행하는 모델, 시스템 프롬프트, 도구, MCP 서버, 스킬로 이루어진 재사용 가능하고 버전이 관리되는 구성입니다. |
| 에이전트 도구 세트 | 에이전트가 샌드박스에서 사용하는 기본 제공 도구 세트(bash, read, write, edit, glob, grep, 웹 가져오기, 웹 검색)입니다. |
| 클라우드 샌드박스 | 세션의 도구와 코드가 실행되는, Anthropic이 관리하는 인프라의 격리된 Linux 컨테이너입니다. |
| Console 에이전트 빌더 | 에이전트를 생성, 구성, 테스트하기 위한 Claude Console의 시각적 인터페이스입니다. |
| 드림 | 메모리 저장소와 과거 세션 트랜스크립트를 읽고, 재구성된 새 메모리 저장소를 작성하는 작업입니다. |
| 이벤트 델타 | 모델이 아직 생성하는 동안 세션 이벤트 스트림에 표시되는 에이전트 응답 텍스트의 실시간 미리보기입니다. |
| GitHub 액세스 | 세션에서의 GitHub 액세스로, 샌드박스에 마운트된 저장소와 pull request용 GitHub MCP 서버를 제공합니다. |
| 메모리 저장소 | 에이전트가 읽고 쓰는 텍스트 문서 모음으로, 정보가 세션 간에 유지되도록 합니다. |
| 멀티에이전트 오케스트레이션 | 세션의 에이전트가 서브에이전트로 또는 워크플로에서 다른 에이전트에게 작업을 넘기고, 어드바이저 모델에 자문을 구할 수 있게 합니다. |
| 멀티에이전트 오케스트레이션의 일부: 동적 워크플로 | 에이전트가 작성하는 프로그램으로, 백그라운드에서 여러 에이전트를 실행하고 그 결과를 결합합니다. |
| 멀티에이전트 오케스트레이션의 일부: 세션 스레드 | 멀티에이전트 세션의 각 에이전트가 작업하는 스레드로, 목록 조회, 스트리밍, 중단, 보관을 할 수 있습니다. |
| 결과 | 세션의 목표 결과로, 목표가 달성될 때까지 별도의 채점기가 에이전트의 작업을 확인하는 데 사용하는 루브릭을 포함합니다. |
| 권한 정책 | 에이전트의 기본 제공 도구와 MCP 도구를 자동으로 실행할지, 사용자의 승인을 기다릴지, 호출할 때마다 서버에서 검사할지를 제어하는 설정입니다. |
| 예약된 배포 | cron 일정에 따라 에이전트를 실행하여, 에이전트가 스스로 세션을 시작하도록 합니다. |
| 자체 호스팅 샌드박스 | 에이전트의 도구 호출을 자체 인프라에서 실행하는 샌드박스이며, Claude 자체는 계속 Anthropic 측에서 실행됩니다. |
| 자체 호스팅 샌드박스의 일부: 자체 호스팅 워커 | 자체 호스팅 환경의 대기열에서 세션을 가져와 해당 도구 호출을 실행하기 위해 자체 인프라에서 실행하는 프로세스입니다. |
| 세션 뷰어 | 에이전트가 무엇을 했고 무엇을 사용했는지 확인할 수 있는 Claude Console의 세션 뷰어와 세션별 사용량 합계입니다. |
| 볼트 | 한 번 등록한 후 세션을 생성할 때 ID로 참조하는, 서드파티 서비스용 사용자별 자격 증명 저장소입니다. |
| 웹훅 | 세션 상태 변경과 같이 Managed Agents 리소스에서 이벤트가 발생할 때 HTTPS 엔드포인트로 전송되는 알림입니다. |
이 페이지가 도움이 되었나요?