Anthropic API 개요 (Overview)

출처: Anthropic 공식 문서 — Intro to Claude 원문(영문)을 한국어로 번역·재해석한 문서예요. 기술 용어는 원문 표기를 보존했어요.

먼저 채팅을 해보고 싶다면 claude.ai를 방문하면 돼요. 여기서는 개발자가 Claude로 무언가를 만드는 방법을 설명할게요.

Anthropic은 Claude로 무언가를 만들 수 있는 방법을 두 가지로 제공해요. 각각 쓰이는 상황이 달라요.

	Messages API	Claude Managed Agents
그게 뭐예요?	모델에 직접 프롬프트를 보내는 접근 방식	관리형 인프라에서 돌아가는, 미리 만들고 설정할 수 있는 에이전트 하네스
누구에게 좋아요?	직접 커스텀 에이전트 루프를 짜고 세밀한 제어가 필요한 작업	오래 걸리는 작업, 비동기적 작업

각각에 대해 더 자세히 알고 싶으면 'Messages API 사용하기'와 'Claude Managed Agents 개요' 문서를 보면 돼요.

새 개발자에게 추천하는 경로

아래 단계를 따라가면 완전히 처음부터 실제로 동작하는 Claude 연동까지 갈 수 있어요.

첫 API 호출 만들기

환경을 세팅하고 SDK를 설치한 뒤, 첫 메시지를 Claude에 보내는 과정이에요. '퀵스타트' 문서로 가면 돼요.

자격 증명(Credentials) 안전하게 보호하기

API 키를 만들 때 만료 시간(expiration)을 설정하고, 키를 소스 코드·클라이언트 측 코드·프롬프트에 넣지 않도록 주의해야 해요. 그리고 정적 키(static key) 대신 Workload Identity Federation을 쓸 수 있는 작업인지 확인해 보는 것도 좋아요. 자세한 내용은 인증 가이드를 읽어요.

Messages API 이해하기

핵심 요청·응답 구조를 익히는 단계예요. 멀티턴 대화, 시스템 프롬프트, stop reason 등이 여기 포함돼요. 'Messages API 가이드'를 보면 돼요.

알맞은 모델 고르기

용도에 맞는 모델을 고르려면 능력과 비용을 비교해야 해요. '모델 개요' 페이지에서 자세히 볼 수 있어요.

기능과 도구 살펴보기

Claude가 뭘 할 수 있는지 알아보는 단계예요. extended thinking(확장된 사고), 웹 검색, 파일 처리, 구조화된 출력 등을 다룰 수 있어요. '기능 개요'를 둘러보면 돼요.

Claude로 개발하기

Anthropic은 Claude로 앱을 만들고 확장하는 데 쓰는 개발자 도구도 제공해요.

Developer Console — 브라우저에서 playground로 API를 직접 탐색하고 이해할 수 있어요.
API Reference — 전체 Claude API와 클라이언트 SDK 문서를 살펴볼 수 있어요.
Claude Cookbook — PDF, 임베딩 등을 다루는 인터랙티브 Jupyter 노트북으로 배울 수 있어요.

핵심 기능들

Claude는 텍스트, 코드, 이미지가 얽힌 많은 작업을 도와줄 수 있어요.

Anthropic API 개요 (Overview)