CPN 한국어 자습서 · Claude Certified Developer — Foundations Prep
2-1 · 오리엔테이션
Module 2 · Orientation — What you'll be able to do by the end
지금까지 Claude는 주로 대화 창에서, 코드를 짤 때 옆에서 도와주는 도구로 써 왔을 겁니다. 이 모듈은 방향이 반대입니다 — Claude를 프로그램 안에서 호출해 쓰는 코드를 직접 만들고, 그 결과를 안정적으로 처리해 실제 서비스에 올리는 일을 다룹니다. 이번 오리엔테이션에서는 모듈 전체가 어떤 문제를 겨냥하는지, 다 마치면 무엇을 할 수 있게 되는지 먼저 살펴봅니다.
이 장에서 배우는 것What you'll learn
약 2분대화식으로 쓰는 것과 코드에 통합하는 것이 어떻게 다른지
이 모듈을 마치면 할 수 있게 되는 여덟 가지
이 모듈 전체가 다루는 하나의 문제 — 개발에선 되던 통합이 프로덕션에서 버티는 일
이 모듈이 누구를 위한 것이고, 무엇은 다루지 않는지
지금까지 Claude를 써 봤다면, 아마 대화 창에서 프롬프트를 입력하고 응답을 읽은 뒤 필요에 따라 다시 다듬는 방식이었을 겁니다. 이 모듈은 그 기본 단계 이후에 오는 것들을 다룹니다 — 도구 스키마, 컨텍스트 관리, 에이전트 루프 같은 것들입니다. 앞에서 익힌 '출력을 원하는 형태로 다듬는 능력' 위에 쌓아 올린다고 보면 됩니다.
엔지니어로서 여러분이 맡는 일은 조금 다릅니다. Claude를 프로그램 안에 통합하고, 응답을 안정적으로 처리하고, 실제로 잘 돌아가는 프로덕션 시스템까지 올리는 것 — 이 전체가 여러분의 몫이 됩니다.
이 모듈의 각 주제는 저마다 하나의 실패 유형을 겨냥합니다. 개발 중에는 눈에 잘 안 띄다가, 막상 개발이 어느 정도 진행된 뒤에 발견하면 찾아 고치는 데 시간과 품이 많이 드는 종류의 실패들입니다. 이런 실패를 미리 알아보고 피할 수 있으면, Claude를 개발 과정에 효율적으로 통합하기가 한결 수월해집니다.
대화 창에서 Claude에게 코드를 부탁하는 것과, Claude를 부품처럼 프로그램 안에 끼워 넣는 것은 다른 일입니다. 이 모듈은 뒤쪽, 그러니까 프로그램에 넣고 실제 서비스에서 돌아가게 만드는 쪽을 다룹니다.
이 모듈을 끝까지 마치면 다음 여덟 가지를 할 수 있게 됩니다. 각 항목은 뒤에 이어지는 주제 하나에 대응합니다.
EIGHT OUTCOMES — 모듈을 마치면 도달하는 지점
| 1 | 시스템 프롬프트·XML 태그·퓨샷 예시·출력 제약을 써서 프로덕션에 쓸 수 있는 프롬프트를 작성하고, 첫 응답이 기대에 못 미칠 때 왜 그런지 진단할 수 있습니다. |
|---|---|
| 2 | 확장 사고(extended thinking)를 언제 켤지 판단하고, 그 강도(effort) 설정을 조절하며, 도구를 쓰는 턴 사이에서 사고 블록(thinking block)을 올바르게 다룰 수 있습니다. |
| 3 | Claude가 정확히 골라 쓰는 도구 스키마를 정의·구현하고, 도구 사용 루프를 짜고, 여러 턴에 걸친 메시지 블록을 처리하며, 도구를 한 번만 호출할 때와 여러 개를 동시에 부를 때를 구분할 수 있습니다. |
| 4 | 스트리밍으로 오는 응답을 받아 처리하고, 조각조각 오는 이벤트를 온전한 콘텐츠 블록으로 조립하며, 스트림이 중간에 끊겨도 깔끔하게 복구할 수 있습니다. |
| 5 | 컨텍스트 윈도 관리, 압축(compacting), 작업 사이 기록 비우기, 서브에이전트 인계 같은 컨텍스트 엔지니어링 기법을 적용해, 여러 턴이 이어지는 에이전트 세션을 예산 안에서 유지하면서도 작업의 맥락을 잃지 않을 수 있습니다. |
| 6 | 워크플로 패턴과 에이전트 패턴 중에서 고르고, 도구와 컨텍스트를 하나의 루프로 엮고, 배포 제약에 맞는 연결 방식을 선택하며, 되돌릴 수 없는 동작이 있는 지점에 사람이 개입하는 확인 단계(HITL)를 넣어 프로덕션 에이전트를 만들 수 있습니다. |
| 7 | 지속 저장 패턴으로 세션을 넘나드는 에이전트의 기억을 관리하고, 알맞은 기억 범위(memory scope)를 골라, 컨텍스트 비용을 부풀리지 않으면서도 에이전트 상태가 턴을 넘어 이어지게 할 수 있습니다. |
| 8 | 올바른 메시지 블록 구조로 이미지와 PDF를 Claude에 보내고, 재사용할 자산에는 Files API를 쓰며, 대량 작업은 Message Batches API로 보내 비동기로 처리되게 할 수 있습니다. |
지금 이 용어들을 다 알아야 하는 것은 아닙니다. 각 항목은 뒤따르는 주제에서 하나씩 자세히 다룹니다. 여기서는 이 모듈이 어디로 향하는지 큰 그림만 잡아 두면 됩니다.
이 모듈의 모든 내용은 하나의 엔지니어링 문제를 중심으로 짜여 있습니다. 개발할 때는 잘 돌아가던 Claude 통합이, 이제 프로덕션에서도 버텨야 하는 상황입니다.
개발 중에는 대체로 순조롭습니다. 프롬프트는 견고해 보이고, 도구 호출도 잘 되고, 세션은 짧고, 시험에 쓰는 입력도 감당할 만합니다. 그런데 같은 시스템이 프로덕션에 올라가면 사정이 달라집니다.
DEV → PROD — 같은 시스템, 달라지는 조건
| 개발 중에는 | 프롬프트가 견고해 보이고, 도구 호출이 동작하고, 세션이 짧고, 시험 입력이 감당할 만합니다. |
|---|---|
| 프로덕션에서는 | 같은 시스템이 더 긴 세션, 더 큰 도구 출력, 중간에 끊기는 스트림, 더 빠듯해진 비용·지연 제약, 턴을 넘나드는 기억, 그리고 되돌릴 수 없는 동작까지 견뎌야 합니다. |
그래서 이 모듈은 어떤 구현 선택이 어떤 프로덕션 실패를 막아 주는지를 하나씩 짚어 갑니다. 프롬프트를 어떻게 구성할지, 도구를 어떻게 정의할지, 스트리밍을 어떻게 안전하게 다룰지, 컨텍스트와 기억을 어떻게 관리할지, 에이전트를 어떻게 안전하게 엮을지 — 그 실패들이 겉으로 드러나기 전에 미리 결정해 두는 것입니다.
이 모듈은 프로토타입을 실제 사용 환경에서 버티는 프로덕션 시스템으로 만들 준비가 된 개발자를 위한 것입니다. 실용적이고, 코드를 앞세우며, 패턴으로 생각하는 분에게 맞습니다.
전제도 분명합니다. 이 모듈은 여러분이 이미 코드를 편하게 짤 수 있다고 가정합니다. 그래서 프로그래밍 기초는 가르치지 않고, Claude를 대화 창에서 가볍게 쓰는 방법을 다루지도 않습니다.
대신 다루는 것은 모델을 둘러싼 엔지니어링 판단입니다.
오리엔테이션 내용을 잘 잡았는지 가볍게 확인해 봅니다. 정답을 먼저 떠올려 본 뒤 골라 보세요. 맞히면 설명이 나옵니다.
Q1이 모듈이 중점적으로 다루는 것은 무엇일까요?
이 모듈은 프로그래밍 기초를 가르치지 않고, Claude를 대화 창에서 가볍게 쓰는 방법도 다루지 않습니다. 다루는 것은 모델을 둘러싼 엔지니어링 판단 — 프롬프트 구성, 도구 정의, 스트리밍 처리, 컨텍스트·기억 관리, 에이전트 구성입니다.
Q2이 모듈의 모든 주제를 하나로 잇는 문제는 무엇일까요?
모든 내용은 개발에선 순조롭던 통합 — 견고해 보이던 프롬프트, 잘 되던 도구 호출, 짧은 세션 — 이 프로덕션의 긴 세션·큰 출력·끊기는 스트림·빠듯한 제약·되돌릴 수 없는 동작을 견뎌야 하는 상황으로 이어집니다. 이 모듈은 어떤 구현 선택이 어떤 실패를 막아 주는지를 다룹니다.
Q3이 모듈의 각 주제는 무엇을 중심으로 구성되어 있을까요?
각 주제는 저마다 하나의 실패 유형을 겨냥합니다. 개발 중에는 눈에 잘 안 띄다가 나중에 발견하면 고치는 데 큰 비용이 드는 종류입니다. 이런 실패를 미리 알아보고 피하는 법을 익히는 것이 이 모듈의 목적입니다.
모듈 2의 첫 실전 주제는 프롬프팅 기법입니다. 실패한 출력을 읽는 법부터 시작해, 프롬프트를 고치는 네 가지 기법을 차례로 살펴봅니다. → 시스템 프롬프트, XML, 퓨샷, 출력 제약
전 코스는 계속 무료입니다. 등록하면 이 코스의 남은 38개 레슨을 끝까지 읽을 수 있습니다.
이미 등록하셨다면 그때 쓰신 이메일을 넣어 주세요.