CPN 한국어 자습서 · Claude Certified Developer — Foundations Prep
1-5 · 기술 기반
How a developer reaches Claude: SDK versus raw REST
코드에서 Claude를 부르는 방법에는 크게 두 가지가 있습니다. HTTP REST API를 직접 호출하는 방법과, 그 위에 얹힌 공식 SDK를 쓰는 방법입니다. 이 둘이 실제로 어떻게 다르고, 왜 대부분 SDK를 고르는지 이 레슨에서 살펴봅니다.
이 장에서 배우는 것What you'll learn
Claude는 가장 아래에서 HTTP REST API로 닿는다 — 요청과 응답의 구조
공식 SDK는 같은 REST API 위에 얹힌 얇은 편의 계층
SDK가 대신 처리하는 일 — 인증 · 요청 구성 · 재시도 · 응답 파싱
SDK와 직접 호출은 같은 API · 같은 모델에 닿는다
모듈 2가 SDK와 Messages API 위에서 이어진다
코드에서 Claude를 부르는 방식은 여러 가지처럼 보이지만, 가장 아래에서 보면 결국 하나입니다. HTTP REST APIHTTP로 요청을 보내고 JSON 응답을 받는 방식의 API.로 닿는 것입니다. 코드가 엔드포인트요청을 보내는 주소.로 요청을 하나 보내는데, 이때 API 키와 JSON 본문을 함께 실어 보내고, 돌아온 JSON 응답을 읽습니다.
이 엔드포인트는 어떤 HTTP 클라이언트로도 직접 호출할 수 있습니다. 특별한 도구 없이 요청을 직접 만들어 보내고, 응답을 직접 받아 해석하는 방식입니다.
가장 아래에서 Claude와 주고받는 것은 결국 요청 하나와 응답 하나입니다. 요청에는 API 키와 JSON을 담아 보내고, 응답도 JSON으로 돌아옵니다.
직접 호출도 물론 되지만, 실제로는 공식 SDKREST API 위에 얹은 얇은 편의 계층. 인증·요청 구성·재시도·응답 파싱을 대신 처리한다.를 쓰는 경우가 더 많습니다. SDK는 같은 REST API 위에 얹힌 얇은 편의 계층이고, Python과 TypeScript를 비롯한 여러 언어로 제공됩니다.
SDK를 쓰면 매번 손으로 하던 몇 가지 일을 대신 처리해 줍니다. 인증, 요청 구성, 재시도, 응답 파싱이 여기에 해당합니다. 그만큼 보일러플레이트기능과 상관없이 매번 반복해서 써야 하는 준비용 코드.를 덜 쓰게 됩니다.
RAW REST vs SDK — 같은 API에 닿는 두 경로
| 구분 | 직접 REST 호출 | 공식 SDK |
|---|---|---|
| 닿는 대상 | 같은 API · 같은 모델 | 같은 API · 같은 모델 |
| 요청 만들기 | 손으로 직접 조립한다. | SDK가 대신 구성해 준다. |
| 대신 처리해 주는 일 | 인증·재시도·파싱을 직접 챙겨야 한다. | 인증·요청 구성·재시도·응답 파싱을 맡아 준다. |
| 코드 양 | 보일러플레이트가 많다. | 준비용 코드가 줄어든다. |
| 쓰는 방법 | 어떤 HTTP 클라이언트로도 호출. | Python·TypeScript 등 공식 SDK. |
두 방식의 도착지는 같습니다. SDK든 직접 호출이든 같은 API, 같은 모델에 닿습니다. SDK를 쓰면 요청을 손으로 조립하는 반복 작업이 줄어듭니다. 앞으로 배울 모듈 2는 이 SDK와 Messages APIClaude와 메시지를 주고받는 API. 지금 보는 REST 기반 위에 있다.를 기반으로 진행되는데, Messages API도 지금 본 REST 기반 위에 놓여 있습니다.
여기서 정하는 건 모델 선택보다, 요청을 직접 만들지 SDK에 맡길지 고민해보는 겁니다. 연결되는 API는 동일합니다. SDK에 맡기면 반복되는 작업이 줄어듭니다.
배운 내용을 객관식으로 점검해 봅니다. 정답을 먼저 떠올려 본 뒤 골라 보세요. 맞히면 설명이 나옵니다.
Q1SDK와 직접 REST 호출의 관계로 맞는 것은 무엇일까요?
SDK는 같은 REST API 위에 얹은 얇은 편의 계층입니다. 두 방식 모두 같은 API, 같은 모델에 닿습니다. 또 엔드포인트는 어떤 HTTP 클라이언트로도 직접 호출할 수 있으니, "직접 호출은 불가능하다"도 사실과 다릅니다.
Q2공식 SDK가 대신 처리해 주는 일은 무엇일까요?
SDK가 대신 처리해 주는 일은 인증, 요청 구성, 재시도, 응답 파싱입니다. 덕분에 매번 같은 준비용 코드를 손으로 쓰지 않아도 됩니다. 나머지 보기는 원문이 다루지 않은 내용입니다.
Q3원문에 따르면 다음 모듈(모듈 2)은 무엇을 기반으로 진행되나요?
모듈 2는 SDK와 Messages API를 기반으로 진행됩니다. 이 Messages API 역시 지금 살펴본 REST 기반 위에 놓여 있습니다.
기술 기반에는 이 밖에도 동기·스트리밍 방식과, 대량 처리를 위한 비동기 방식이 있습니다. 학습은 다음 장으로 이어집니다. → 다음 장으로
전 코스는 계속 무료입니다. 등록하면 이 코스의 남은 38개 레슨을 끝까지 읽을 수 있습니다.
이미 등록하셨다면 그때 쓰신 이메일을 넣어 주세요.