byteforce

CPN 한국어 자습서 · 러닝패스 2 / 4 — Building with the Claude API

도구 사용

프로젝트 개요

Project overview

도구를 제대로 익히기 위해 작은 목표를 세웁니다. Jupyter 노트북 안에서, Claude에게 미래의 특정 시점에 알림(reminder)을 설정하는 법을 가르치는 프로젝트입니다. 이를 위해 여러 도구가 필요한데, 지금은 한 번에 하나씩 다룹니다.

전체 내레이션영상 나레이션 한국어 번역 (전체)›

Stephen Grider · Anthropic 기술 스태프

도구를 더 깊이 배우기 위해 작은 목표를 세웁니다. Jupyter 노트북 안에서 구현할 작은 프로젝트인데, Claude에게 미래의 어느 시점에 발생하는 알림을 설정하는 법을 가르쳐 봅니다. 이를 위해 여러 도구를 구현해야 합니다. 지금은 한 번에 하나의 도구에만 집중하지만, 결국 여러 도구를 다루게 된다는 점만 알아 두세요.

최종적으로는 Claude에게 “다음 주 목요일에 병원 예약 알림 좀 설정해 줘” 같은 메시지를 보내고, Claude가 “알겠습니다, 그 시점에 알려 드릴게요” 같은 응답을 하게 만들고 싶습니다.

처음엔 이 작업이 아주 쉬워 보일 수 있습니다. 하지만 실제로는 우리가 해결해야 할 서로 다른 과제가 몇 가지 있고, 그걸 전부 도구로 풀어 갈 것입니다.

구체적으로, Claude는 현재 날짜는 압니다. 지금 프롬프트를 열어 오늘 날짜를 물으면 정확히 답해 줍니다. 그러나 Claude는 현재 시각(time of day)은 항상 알지는 못합니다. 그래서 “지금부터 정확히 24시간 뒤로 알림을 설정해 줘”라고 하면, 현재 시각을 모르기 때문에 ‘24시간 뒤’가 실제로 언제인지 정확히 알지 못합니다.

둘째, Claude는 시간 기반 덧셈을 항상 완벽하게 하지는 못합니다. “1973년 1월 13일에서 379일 뒤는?” 같은 질문에 대개 정답을 주지만, 가끔 그 덧셈을 틀립니다.

마지막으로, Claude는 알림을 설정한다는 것이 무엇인지에 대한 실제 메커니즘이 없습니다. 개념적으로 ‘알림 설정’이 무엇인지는 알지만, Claude 내부에는 미래에 알림을 거는 어떠한 장치도 없습니다.

이 문제들을 풀기 위해 각각에 전용 도구를 만듭니다. 여기 세 가지 문제가 있으니, 한 번에 하나씩 세 개의 도구를 만듭니다.

각 도구가 할 일은 이렇습니다. 가장 먼저 만들 아주 단순한 도구는 현재 날짜·시각을 가져오는 것입니다(현재 날짜 + 시각). 이걸로 도구 호출이 무엇인지 감을 잡습니다. 두 번째 도구는 날짜·시각에 기간을 더하는 것 — 예: 현재 날짜에 20일을 더하면 며칠이 되는지. 그리고 마지막으로 알림을 설정하는 도구를 만듭니다.

이 장에서 배우는 것What you'll learn

약 2분

목표 — Jupyter 노트북에서 Claude에게 알림 설정을 가르친다

“다음 주 목요일 병원 예약 알림” → “그때 알려 드릴게요”가 되는 것

문제 1 — Claude는 현재 시각을 항상 알지는 못한다(날짜는 안다)

문제 2 — Claude는 시간 덧셈을 가끔 틀린다(379일 뒤 등)

문제 3 — Claude에는 알림을 거는 메커니즘 자체가 없다

해법 — 세 문제에 전용 도구 3개를 한 번에 하나씩 만든다

먼저 짚고 갈 용어

알림(reminder): 미래의 특정 시각에 사용자에게 알려 주는 것. 이 프로젝트가 Claude에게 가르치려는 최종 기능.
현재 날짜 vs 현재 시각: Claude는 오늘 날짜는 알지만, 하루 중 ‘지금 몇 시’인지는 항상 알지 못한다 — 그래서 ‘24시간 뒤’ 계산이 어긋난다.
시간 기반 덧셈: 날짜에 기간을 더하는 계산. Claude가 대개 맞히지만 가끔 틀려, 도구로 정확히 처리한다.
전용 도구: 각 문제(시각·덧셈·알림)를 정확히 해결하기 위해 하나씩 만드는 함수 기반 도구.

목표 — 알림 설정 가르치기

A small goal

도구를 제대로 익히기 위해 Jupyter 노트북 안에서 작은 프로젝트를 만듭니다. 목표는 Claude에게 미래의 특정 시점에 알림을 거는 법을 가르치는 것입니다. 최종적으로는 이런 대화가 자연스럽게 되길 원합니다.

만들 프로젝트 미리보기 · 카드를 눌러 펼치기

사용자 → Claude“내 병원 예약 알림 좀 설정해 줘. 다음 주 목요일이야.”

Claude (목표)“알겠습니다 — 그 시점에 알려 드릴게요.”

쉬워 보이지만, 이 한 문장 뒤에는 세 가지 숨은 문제가 있습니다. 각 문제를 전용 도구 하나로 풉니다 — 한 번에 하나씩.

1현재 시각을 모른다눌러서 도구 보기

문제Claude는 오늘 날짜는 알지만 하루 중 ‘지금 몇 시’인지는 항상 알지 못한다. 그래서 “24시간 뒤” 같은 계산이 어긋난다.

전용 도구get_current_datetime() — 현재 날짜 + 시각을 가져온다. (가장 단순 — 도구 호출 입문용)

2시간 덧셈을 틀린다눌러서 도구 보기

문제“1973년 1월 13일 + 379일” 같은 날짜 덧셈을 대개 맞히지만 가끔 틀린다.

전용 도구add_duration_to_datetime() — 날짜·시각에 기간(일·주·월…)을 정확히 더한다.

3알림을 걸 수단이 없다눌러서 도구 보기

문제‘알림 설정’이 무엇인지 개념은 알지만, Claude 내부에 미래 알림을 실제로 거는 장치가 없다.

전용 도구set_reminder() — 내용 + 시각을 받아 알림을 실제로 등록한다.

숨은 세 가지 문제

Three hidden challenges

“알림 설정”은 쉬워 보이지만 실제로는 세 가지 과제가 숨어 있습니다. 셋 다 도구로 풉니다.

세 가지 문제

현재 시각을 모른다 — Claude는 오늘 날짜는 알지만 ‘지금 몇 시’는 항상 알지 못해, “24시간 뒤”가 어긋난다.
시간 덧셈을 가끔 틀린다 — “1973-01-13 + 379일” 같은 계산을 대개 맞히지만 가끔 틀린다.
알림을 걸 수단이 없다 — 개념은 알지만 미래 알림을 실제로 거는 메커니즘이 Claude 내부에 없다.

접근

한 번에 하나씩. 위 세 문제 각각에 전용 도구를 만들어, 도구 사용의 패턴을 단계적으로 익힙니다.

만들 도구 세 가지

Tools we need

세 문제에 대응해 세 개의 도구를 차례로 만듭니다. 첫 도구는 가장 단순해, 도구 호출이 무엇인지 감을 잡는 입문용입니다.

도구 로드맵

① 현재 날짜·시각 가져오기 — get_current_datetime(). 가장 단순한 도구로 시작해 호출 흐름을 배운다.
② 날짜·시각에 기간 더하기 — add_duration_to_datetime(). “현재 날짜 + 20일” 같은 계산을 정확히.
③ 알림 설정하기 — set_reminder(). 내용과 시각을 받아 알림을 실제로 등록한다.

다음 레슨부터

바로 다음 레슨에서 ① 현재 날짜·시각 도구의 함수를 직접 작성하며 도구 사용의 첫걸음을 뗍니다.

정리 & 점검

Recap & check

핵심 정리

프로젝트 목표 — Jupyter 노트북에서 Claude에게 알림 설정을 가르친다.
숨은 문제 3개 — 현재 시각 모름 · 시간 덧셈 오류 · 알림 메커니즘 부재.
각 문제에 전용 도구 — get_current_datetime · add_duration_to_datetime · set_reminder.
한 번에 하나씩, 가장 단순한 현재 날짜·시각 도구부터 시작한다.

Q1이 프로젝트의 최종 목표는?

Q2“24시간 뒤로 알림” 요청이 어긋나는 이유는?

Q3세 문제를 어떻게 해결하나요?

다음 장

이제 첫 번째 도구의 함수를 직접 작성합니다. → 도구 함수