Claude Academy
로드 중

Claude Platform 101

이 과정에서는 API를 몇 번 호출해봤든 채팅 창을 통해서만 Claude를 사용해봤든, 개발자가 처음부터 Claude Platform을 기반으로 구축하는 방법을 가르칩니다.

1.5시간1 퀴즈
강좌 시작진행 상황을 저장하려면 로그인하세요
학습 내용이 강좌를 마치면
  • messages.create로 첫 API 요청을 보내고 구조화된 응답을 읽어봅니다
  • 간단한 평가를 실행하고 비용과 지연 시간을 고려하여 작업에 적합한 모델(Fable, Opus, Sonnet, Haiku)을 선택합니다
  • 에이전트 루프를 직접 만들어본 다음, SDK의 Tool Runner가 무엇을 대신해주는지 이해하고 나서 이를 Tool Runner로 축약합니다
  • 도구 사용을 통해 Claude의 범위를 확장하고 확장 사고로 어려운 문제를 추론하게 합니다
  • Anthropic의 내장 도구(웹 검색, 코드 실행, 웹 페치), Skills, MCP 서버로 에이전트를 확장합니다
  • 네 가지 컨텍스트 관리 패턴으로 장시간 실행되는 에이전트를 컨텍스트 창 내에 유지하면서 비용 효율적으로 운영합니다
  • Anthropic가 루프를 실행하고 결과를 보고하는 동안 이벤트 스트림을 소비하면서 관리형 에이전트를 처음부터 끝까지 구축합니다
  • Claude Code 자체를 사용하여 API로 구축하고, 에이전트가 작성한 코드를 검토합니다

브라우저 탭에서 Claude와 채팅하는 것과 Claude를 실제로 출시하는 제품에 구축해 넣는 것 사이에는 큰 간극이 있습니다. 채팅은 질문에 답하면 그걸로 스레드가 끝납니다. 애플리케이션은 Claude에 구조화된 요청을 보내고, 도구를 제공하고, 실제 시스템에서 동작하게 하며, 사용자 한 명을 위해서든 백만 명을 위해서든 그 루프를 실행합니다. Claude Platform은 이러한 간극을 좁히기 위해 존재하며, 이는 프롬프트 작성과는 다른 기술입니다. 여기서 가치를 얻으려면 요청에 무엇이 담겨 있는지, 에이전트가 어떻게 행동을 결정하는지, 그리고 비용과 한계가 어디에 있는지를 이해해야 합니다.

이 과정에서는 API를 몇 번 호출해봤든 채팅 창을 통해서만 Claude를 사용해봤든, 개발자가 처음부터 Claude Platform을 기반으로 구축하는 방법을 가르칩니다. API 요청에 무엇이 담기는지, 에이전트 루프란 무엇인지, 컨텍스트 창이 Claude가 볼 수 있는 것을 어떻게 제한하는지, 도구와 권한이 Claude가 할 수 있는 일을 어떻게 결정하는지와 같은 기본 원칙부터 시작합니다. 그러면 과정 후반부의 기법들이 단순히 따라 할 호출 목록이 아니라 제대로 이해한 내용으로 자리 잡게 됩니다.

첫 요청을 보내고 응답을 읽어본 다음, 작업에 적합한 모델(Fable, Opus, Sonnet, Haiku)을 선택하고, 추측이 아니라 직접 만든 예시를 바탕으로 비용과 지연 시간의 트레이드오프를 따져봅니다. 이어서 Claude가 어떻게 행동하고, 관찰하고, 결정하는지 보기 위해 에이전트 루프를 직접 손으로 만들어본 다음, SDK의 Tool Runner가 무엇을 대신해주는지 이해하고 나면 직접 작성한 루프를 Tool Runner로 축약합니다. 도구 사용을 통해 Claude의 범위를 확장하고, 확장 사고로 어려운 문제를 추론하게 합니다.

과정 중반부에서는 에이전트를 여러분 자신의 코드 너머로 확장합니다: Anthropic의 인프라에서 실행되는 Anthropic의 내장 도구(웹 검색, 코드 실행, 웹 페치), 절차를 한 번 패키징해서 여러 호출에 걸쳐 재사용할 수 있는 Skills, 스키마를 작성하지 않고도 Claude를 타사 도구에 연결하는 MCP 서버, 그리고 10턴이 넘어가도 장시간 실행되는 에이전트를 컨텍스트 창 안에 유지하면서 비용 효율적으로 운영하는 컨텍스트 관리 패턴입니다.

마지막 섹션에서는 작업을 넘겨줍니다. 언제 직접 루프를 실행해야 하고 언제 Anthropic이 샌드박스화된 관리형 에이전트를 대신 실행하도록 맡겨야 하는지 배운 다음, Anthropic이 루프를 실행하고 결과를 보고하는 동안 이벤트 스트림을 소비하면서 그러한 에이전트를 처음부터 끝까지 구축해봅니다. 독립된 레슨 하나에서는 Claude Code 자체를 사용하여 API로 구축하는 방법을 보여주는데, 이는 이 과정의 나머지 부분이 중요한 이유이기도 합니다: 에이전트가 작성한 코드를 검토하려면 좋은 코드가 어떤 모습인지 알아야 하기 때문입니다. 대부분의 레슨에는 여러분 자신의 프로젝트에 맞게 활용할 수 있는 코드 데모가 포함되어 있습니다.

권장 사전 지식

최소 한 가지 언어로 코드를 읽고 쓰는 데 익숙해야 하며, 기본적인 명령줄 사용법도 알아야 합니다. 대부분의 데모는 Python SDK(anthropic, pip로 설치)를 사용합니다. "첫 API 호출", "도구 사용이란 무엇인가?", "Claude Code로 구축하기" 레슨은 Node와 npm을 사용하는 TypeScript SDK(@anthropic-ai/sdk)를 사용합니다. 두 언어 중 어느 쪽이든 전문가일 필요는 없지만, 내용을 따라가며 스크립트를 실행할 수 있어야 합니다. Claude Console 계정과 platform.claude.com에서 발급받은 API 키가 필요합니다. 첫 API 호출 전에 Claude Console의 결제 페이지에서 크레딧이 있는지 확인하세요. 크레딧이 없다면 그곳에서 추가하세요. LLM으로 구축해본 사전 경험은 필요하지 않습니다.

이 과정의 대상

채팅 창에서 Claude를 사용해봤고 이를 자신의 애플리케이션에 구축하고자 하는 개발자를 위한 과정입니다. 기존 제품에 AI 기능을 추가하든 처음부터 에이전트를 프로토타이핑하든 상관없습니다. API 호출을 몇 번 보내봤지만 "이걸 어떻게 스스로 행동하게 만들까" 또는 "내 실제 시스템에 어떻게 연결할까"라는 지점에서 막혔다면, 이 과정은 단일 요청에서 프로덕션 에이전트로 이어지는 다리가 되어줄 것입니다. 에이전트 관련 사전 경험은 필요하지 않습니다. 각 레슨은 이전 레슨을 바탕으로 구성되어 있습니다.