Claude Code가 이제 모든 AI 앱을 구동합니다

채널 아이콘
AI LABS 구독자 10,300명

요약

이 영상은 Claude Code SDK를 통해 AI 코딩 도구가 단순한 코드 생성기를 넘어 프로그래머블한 에이전트로 진화하는 과정을 설명합니다. Agentic Coding의 개념과 AI 코딩과의 차이를 비교하고, 명령줄·TypeScript·Python 환경을 지원하는 SDK 사용법을 단계별로 보여줍니다. 실제 예제와 GitHub Actions 연동 사례를 통해 Claude Code SDK로 일상 워크플로우를 자동화하고 확장하는 방법을 제시합니다. MCP 설정과 프로 플랜 가격 경쟁력 등 핵심 기능을 살펴보며 앞으로의 AI 엔지니어링 변화를 예측합니다.

주요 키워드

Agentic Coding Claude Code SDK Subprocess MCP Configuration GitHub Actions Prompt Built-in Tools Max Turns Python SDK

하이라이트

  • 🔑 SDK 도입으로 Claude Code가 단순 코드 생성기를 넘어 프로그래머블한 에이전트로 작동합니다.
  • ⚡️ Agentic Coding은 에이전트가 도구(tool)를 활용해 단계별로 작업을 수행하도록 설계된 차세대 소프트웨어 엔지니어링 방식입니다.
  • 🌟 Claude Code SDK는 명령줄, TypeScript, Python 세 가지 환경에서 서브프로세스로 통합 사용이 가능합니다.
  • 📌 Agentic Coding 앱은 prompt 분석 후 11가지 내장 도구를 조합해 최적의 작업 흐름을 자동으로 선택·수행합니다.
  • 🚀 $20 프로 플랜으로 API 사용량에 대한 부담 없이 최대 문맥 크기의 Claude 모델을 활용할 수 있습니다.
  • 🐍 Python 예제에서는 가상환경 설정, SDK 설치, 간단한 haiku 생성 스크립트를 실행해 보고 오류 해결 과정을 다룹니다.
  • 🛠 MCP 설정을 통해 외부 MCP 서버와 연결하면 Slack·Jira 연동 등 훨씬 더 폭넓은 자동화 워크플로우 구축이 가능합니다.
  • 🔄 GitHub Actions 예제에서는 Claude Code 에이전트가 풀 리퀘스트 리뷰부터 이슈 해결, 다크 모드 기능 구현까지 전 과정을 자동으로 처리합니다.

용어 설명

Agentic Coding

에이전트가 도구(tool)를 활용해 단계별로 작업을 수행하도록 설계된 AI 코딩 방식

SDK (Software Development Kit)

개발자가 Claude Code 기능을 프로그램에 통합할 수 있게 해 주는 개발 도구 모음

Subprocess

메인 애플리케이션 외부에서 독립적으로 실행되는 Claude Code 인스턴스 역할

Prompt

AI 에이전트에 작업 지시문과 컨텍스트를 전달하는 명령문

Built-in Tools

Claude Code가 자동으로 선택·조합해 작업을 수행하는 11가지 내장 기능

Max Turns

에이전트가 스스로 응답을 확장할 수 있는 대화 횟수 제한

MCP Configuration

외부 MCP(Multi-Channel Protocol) 서버와 연결해 다양한 서비스 연동 워크플로우를 구축하는 기능

GitHub Actions

GitHub 저장소 내 이벤트 트리거로 CI/CD 워크플로우를 자동 실행하는 기능

[00:00:00] 프로그래머블 Agentic Coding의 등장

AI 코딩 도구가 단순 업데이트를 넘어 근본적인 변화를 맞이했다는 점을 강조합니다. Claude Code SDK로 이제 개발자가 원하는 대로 AI 에이전트를 프로그래밍할 수 있다는 혁신적 전환을 소개합니다.

AI 에이전트 코딩이 근본적으로 변화했으며, 이는 일반적인 업데이트가 아닌 AI 코딩 도구와의 상호작용 방식 자체가 바뀐 것이라고 설명합니다.
클로드 코드 SDK가 이러한 변화의 핵심이며, 프로그래밍 가능한 에이전트 코딩이 소프트웨어 엔지니어링의 미래라고 강조합니다.
[00:00:22] Claude Code SDK 개요

SDK를 통해 Claude Code를 스크립트나 애플리케이션에 서브프로세스로 통합하는 방법을 설명합니다. 명령줄·TypeScript·Python 환경에서 호출 가능한 구조를 개괄합니다.

이제 AI 도구를 단순히 사용하는 것이 아니라 시스템에 구축하여 원하는 방식으로 작동하게 만들 수 있으며, 백그라운드에서 서브프로세스로 실행되는 지능적인 코딩 에이전트를 보유할 수 있게 되었다고 설명합니다.
클로드 코드 SDK의 공식 문서를 소개하며, 이것이 클로드 코드를 프로그래밍 방식으로 스크립트나 애플리케이션에 통합할 수 있게 해주는 도구라고 설명합니다.
[00:00:57] AI 코딩 vs Agentic Coding

기존 AI 코딩은 단순 prompt-응답 구조였으나, Agentic Coding은 내장 도구를 자동 선택해 복합 작업을 수행하는 차별점을 상세히 비교합니다.

이제 최고의 코딩 에이전트 중 하나를 원하는 방식으로 프로그래밍할 수 있게 되었으며, 실제 예제를 통해 그 강력함을 보여주겠다고 말합니다.
AI 코딩과 에이전트 코딩의 차이점을 설명합니다. AI 코딩은 프롬프트와 맥락을 입력하면 코드를 출력하는 반면, 에이전트 코딩은 도구를 사용한다고 구분합니다.
클로드 코드가 11개의 내장 도구를 가지고 있으며, 프롬프트를 분석해서 적절한 도구를 선택하고 조합하여 작업을 완료하는 방식으로 작동한다고 설명합니다.
[00:02:02] 가격 및 문맥 지원 비교

$20 프로 플랜으로 Claude 모델의 전체 문맥 크기를 고정 월 구독 방식으로 무제한 활용할 수 있는 가격 경쟁력을 설명합니다. Cursor의 API 과금 모델과 차이를 짚어 봅니다.

클로드 코드가 커서보다 우수한 이유로 $20 프로 플랜에서 사용 가능하다는 점을 들며, 월 정액제로 최고 품질의 코딩 모델을 사용할 수 있다고 강조합니다.
[00:02:29] Python 환경 설정 및 SDK 설치

가상환경 초기화·활성화 과정을 통해 Python 개발 환경을 준비하는 방법과 pip 명령으로 SDK를 설치하는 과정을 단계별로 안내합니다.

Claude Code SDK의 작동 방식을 Python 가상 환경 설정부터 시작해서 단계별로 설명합니다. 사전 요구사항 확인과 pip를 통한 SDK 설치 과정을 안내합니다.
제공된 기본 예제 스크립트를 사용해서 fu.py 파일 내용에 대한 하이쿠 작성을 Claude에게 요청하는 실습을 진행합니다. main.py 파일 생성과 코드 구조를 설명합니다.
[00:03:12] 기본 예제 스크립트 실행

제공된 haiku 생성 예제(main.py, fu.py)를 복사해 실행해 보고, 업데이트 후 발생한 오류를 해결하기 위한 임시 방안을 제시합니다.

Claude Code SDK의 핵심 구성 요소들을 설명합니다. query, options, message 객체와 max_turns 설정을 통한 에이전트 응답 제어 방법을 다룹니다.
실제 실행 과정에서 발생한 오류와 Python SDK 업데이트로 인한 예제 스크립트 문제를 언급하며, 우회 방법을 찾았지만 여전히 완전하지 않은 상태임을 설명합니다.
[00:04:18] MCP 설정으로 기능 확장

MCP 서버를 외부에 연결해 Claude Code 인스턴스가 Jira·Slack 등 다양한 API와 연동되도록 설정하는 방법과 활용 가능성을 설명합니다.

MCP 구성 기능을 소개하며, 외부 MCP 서버와의 연동을 통해 Claude Code의 기능을 10배 더 강력하게 만드는 방법을 설명합니다.
구독과 채널 멤버십에 대한 안내를 하며, 우선 답변 서비스를 제공하는 첫 번째 티어가 출시되었음을 알립니다.
[00:04:42] 채널 지원 및 멤버십 안내

구독·채널멤버십을 통해 우선 댓글 응답, 슈퍼 땡스 기능으로 제작 지원 방법을 안내하며 시청자 참여를 독려합니다.

일상생활에서의 활용 방안을 묻고, 문서의 실제 응용 프로그램 예제로 Claude Code GitHub을 소개합니다.
Claude Code GitHub Actions 워크플로우를 소개하며, 풀 리퀘스트 검토와 이슈 해결 기능을 설명합니다. 사용자는 간단히 Claude를 언급하기만 하면 코드 분석과 문제 해결이 가능합니다.
[00:05:18] GitHub Actions 실제 연동 사례

Claude Code GitHub Actions 워크플로우를 활용해 풀 리퀘스트 리뷰, 이슈 생성·해결, 다크 모드 기능 구현 과정을 데모 형태로 보여줍니다.

실제 사용 예시로 간단한 노트 애플리케이션을 보여줍니다. Apple Notes와 유사한 구조로 폴더와 노트 미리보기 기능을 가지고 있으며, GitHub 저장소에 업로드된 상태입니다.
다크 모드가 누락된 이슈를 GitHub에 등록하고, Claude를 호출하여 자동으로 기능을 구현하도록 합니다. Claude는 자체 할 일 목록을 통해 체계적으로 작업을 진행합니다.
Claude Code SDK의 강력한 기능을 설명합니다. 단계별 할 일 목록으로 컨텍스트를 유지하며, 생성하거나 수정한 파일들을 명확히 보여주고 변경사항을 간결하게 요약합니다.
구현된 브랜치로 전환하여 다크 모드 기능이 성공적으로 작동하는 것을 확인합니다. 토글 기능이 정상적으로 동작하며, Claude Code SDK로 실용적인 애플리케이션 구축이 가능함을 입증합니다.
[00:07:03] 추가 활용 및 문서 관리

Jira·Slack MCP를 결합한 전체 자동화 워크플로우 사례를 소개하고, Cursor를 활용해 SDK 문서를 참조하는 실무 팁을 제안합니다.

MCP 접근 능력을 활용한 고급 워크플로우 예시를 제시합니다. Jira와 Slack MCP를 연결하여 풀 리퀘스트 검토, 자동 티켓 배정, Slack을 통한 작업 할당까지 자동화할 수 있는 가능성을 보여줍니다.
코딩을 원하지 않는 사용자를 위한 대안을 제시합니다. Claude Code는 현재 링크에서 문서를 직접 저장하는 기능이 없어 Cursor 사용을 권장하며, 마크다운 파일로 문서를 변환하는 방법도 언급합니다.
[00:08:08] 마무리 및 향후 전망

이번 영상의 핵심 요약과 응용 가능성을 되짚으며, 시청자들에게 더 나은 AI 워크플로우 구축을 위한 의견 공유를 요청하면서 영상을 마무리합니다.

타임라인 정보가 없습니다.

AI 에이전트 코딩이 완전히
바뀌었습니다. 일반적인
업데이트나 새로운 기능에 대한
이야기가 아닙니다. 저는
AI 코딩 도구와 상호작용하는 방식의
근본적인 변화에 대해 이야기하고 있습니다.
이 변화는 현실이며, 모든 것이
클로드 코드 SDK 때문입니다. 에이전트 코딩 도구보다
더 좋은 것은 무엇일까요? 프로그래밍 가능한
에이전트 코딩 도구입니다. 프로그래밍 가능한
에이전트 코딩은 소프트웨어
엔지니어링의 미래입니다. 더 이상
AI 도구를 그냥 사용하는 것이 아니라
시스템에 구축하여 우리가 원하는
방식으로 정확히 작동하게 만들고 있기 때문입니다.
클로드 코드 SDK가 완전히
환경을 바꿔놓았습니다. 이제 백그라운드에서
서브프로세스로 실행되는 지능적인 코딩 에이전트를
가질 수 있으며, 이들이 프로그래밍한 대로 무엇이든
수행합니다. 클로드 SDK가
실제로 어떻게 작동하는지, 그리고 왜 이것이
AI 코딩에 대한 당신의 관점을 바꿀 것인지
보여드리겠습니다. 시작해봅시다.
이것이 클로드 코드 SDK의 공식
문서입니다. 본질적으로 클로드 코드를
프로그래밍 방식으로 자신의 스크립트나
심지어 본격적인 애플리케이션에
통합할 수 있게 해줍니다. 기본적으로
클로드 코드를 어디서든 호출할 수 있는
서브프로세스로 만들어주며
프롬프트 내의 지시사항은
원하는 무엇이든 하도록 설계할 수 있습니다.
이것은 매우 중요한 변화입니다. 이제
최고의 코딩 에이전트 중 하나를
원하는 방식으로 프로그래밍할 수 있기 때문입니다.
클로드 코드가 직접 구축한
실제 예제로 이것이 얼마나 강력한지
보여드리겠습니다. 이 문서들은
SDK에 대해 알아야 할 모든 것을
제공합니다. 현재로서는 명령줄,
TypeScript, 그리고
Python과 함께 사용할 수 있습니다. 하지만 본격적으로 들어가기 전에
클로드 코드가 왜 그렇게 강력한지
이해해야 합니다. AI 코딩과
에이전트 코딩의 차이를
이해해야 합니다. AI 코딩에서는
프롬프트, 모델, 그리고 일부 맥락을 입력하면
도구가 코드를 출력합니다.
에이전트 코딩에서는 클로드 코드와 커서 같은 앱들이
단순히 코드를 작성하지 않습니다.
도구를 사용합니다. 클로드 코드에는 11개의
내장 도구가 있습니다. 화면에서 모두
확인할 수 있습니다. 프롬프트를 분석하고
그에 따라 실제로 사용할 도구를
결정합니다. 그 다음 작업에 가장
적합한 여러 도구의 조합을 사용하여
작업을 완료합니다. 예를 들어,
파일에서 무언가를 변경하라고 요청하면
먼저 ls 도구를 사용해 파일을 나열하고
내용을 가져옵니다.
그 다음 read 도구를 사용해
파일의 내용을 읽습니다. 그리고 마지막으로
파일 내용을 변경할 올바른 도구로
진행합니다. 하지만 왜 이것이 갑자기
커서보다 더 나은 걸까요?
주된 이유는 클로드 코드가 이제
$20 프로 플랜에서 사용 가능하다는 것입니다.
이를 통해 코딩에서 최고로 여겨지는
클로드 모델의 전체 맥락을
월 정액제로 사용할 수 있습니다.
이전에는 API 사용량에 따라 비용을 지불해야 했고
매우 비쌌습니다. 커서에서 같은 일을
하려고 하면 맥스 모드를
활성화해야 하는데, 이것 역시
API 기반 구독입니다. 이제
SDK가 어떻게 작동하는지 궁금하시다면
직접 보여드리겠습니다. Python을 사용할 예정이므로
가상 환경을 먼저 초기화하겠습니다.
그 다음 활성화하고
커서에서 디렉토리를 열겠습니다.
또한 여기서 볼 수 있듯이
사전 요구사항들이 나열되어 있습니다.
따라서 이것들이 설치되어 있는지
확인해 주세요. 이런 사전 요구사항들이 갖춰지면
pip 명령어를 사용해서 SDK를 설치할 수 있습니다.
설치가 완료되면 커서로 이동해서
실제로 새로운 스크립트를 만들어
SDK를 테스트해보겠습니다.
심지어 우리만의 스크립트를 작성할 필요도 없습니다.
그들이 제공한 기본 예제 스크립트를
그냥 사용하면 됩니다. 여기서는 Claude에게
fu.py라는 파일의 내용에 대한
하이쿠를 작성하라고 프롬프트를 줬습니다.
그러려면 먼저 main.py라는
새 파일을 만들어야 합니다.
그리고 복사한 코드를 붙여넣겠습니다.
이 스크립트에서는 claude code SDK에서
query, cla code options, message를 가져옵니다.
프롬프트는 query에 전달되고
기본적으로 claude code의 인스턴스를 실행합니다.
그리고 claude code options가 있는데
이는 해당 인스턴스를 구성하는 방법입니다.
여기서는 max turns를 설정하는데
이는 에이전트가 자체 응답을
몇 번까지 빌드할 수 있는지를 의미합니다.
응답은 일반 텍스트로 오지 않습니다.
구조화된 메시지 객체로 옵니다.
따라서 실제 콘텐츠를
별도로 추출해야 합니다.
그리고 코드를 이해하지 못하거나 하고 싶지 않다면
그것도 괜찮습니다. 저도 그에 대한
해결책을 가지고 있습니다.
그 다음 fu.py라는 또 다른 파일을 만들고
피보나치 수열을 출력하는
스크립트를 작성하겠습니다.
이제 터미널을 열고
main Python 파일을 실행해보겠습니다.
여기서 실제로 오류가 발생한 것 같습니다.
어떤 이유로 Python SDK를 업데이트한 후
그들이 제공한 예제 스크립트가
작동하지 않게 되었습니다.
우회 방법을 찾아서
출력을 얻을 수는 있지만 여전히 작동하지 않습니다.
곧 이에 대한 업데이트가 있기를
바라고 있습니다. 그리고 최고의 기능이 있습니다.
MCP 구성입니다. 이는 기본적으로
프로그래밍 가능한 claude code 인스턴스가
외부 MCP 서버와 함께 실행될 수 있게 해주는데
이는 그들이 거의 모든 것을
할 수 있게 해줍니다. 왜냐하면 MCP가
구현된 사용 사례들의 종류로
얼마나 놀라운지 봤기 때문입니다.
그리고 이것이 SDK를 10배 더 강력하게 만듭니다.
아, 그리고 우리가 만드는 콘텐츠를
즐기고 계신다면 구독 버튼을
눌러주시면 정말 감사하겠습니다.
또한 우희가 여기서 구축하고 있는 것을
지원하기 위해 채널 멤버십을
테스트하기 시작했습니다.
현재 첫 번째 티어만 출시했는데
댓글에 대한 우선 답변을 제공합니다.
따라서 질문이 있거나
피드백을 원한다면 맨 앞으로
올려드립니다. 이제 이것이 사람들의
일상 생활에서 어떻게 사용될 수 있는지
궁금하실 수 있습니다. 다시 문서로 돌아가면
이러한 실제 응용 프로그램들을 볼 수 있습니다.
그들은 놀라운 예제를 제공했는데
Claude Code GitHub입니다.
GitHub Actions용 워크플로우로,
Claude Code가 풀 리퀘스트를 검토하고
여러분이 제기한 이슈까지 해결해줍니다.
풀 리퀘스트나 이슈에서
Claude만 언급하면 됩니다.
그러면 코드를 분석하거나
발생한 문제를 해결해줍니다.
제가 실제로 어떻게 사용하는지
예시를 보여드리겠습니다.
이것은 제가 만든 간단한 노트 앱입니다.
GitHub 저장소에 업로드되어 있고
정말 간단한 구조를 가지고 있습니다.
Apple Notes처럼 폴더가 있고
폴더 안에 다양한 노트들이 있어서
여기서 미리보기할 수 있습니다.
그런데 여기서 또 다른 버그를
발견할 수 있습니다.
나중에 수정하겠습니다.
이제 GitHub 저장소로 돌아가서
이슈 탭으로 가보면
다크 모드가 현재 앱에서
누락되어 있다는 이슈를 제기했습니다.
앱을 다시 보시면
현재 다크 모드 옵션이
없다는 것을 확인할 수 있습니다.
이슈를 열어보면
이슈 설명과 어떻게 작동해야 하는지
볼 수 있습니다.
이슈에 나열된 세부사항입니다.
제가 직접 댓글을 달고 Claude를 호출했습니다.
이것이 워크플로우를 트리거하는 방법이고
이슈에서 설명한 기능을 구현하라고 했습니다.
Claude가 워크플로우를 실행하고
작업을 완료해서 다크 모드를 구현했습니다.
여기 자체적인 할 일 목록이 있는 것을 볼 수 있습니다.
Claude Code SDK 위에 구축되었기 때문에
실제로 Claude Code의 인스턴스가 실행되어
설명을 검토하고 코드베이스를 분석하며
이슈를 해결합니다.
아시다시피 Claude Code는
자체적인 단계별 할 일 목록을 사용해서 작동하므로
컨텍스트를 잃거나 해야 할 일을
놓치지 않습니다.
Claude Code가 가진 또 다른 강력한 기능입니다.
이것이 제공한 할 일 목록이고
어떤 파일을 생성하거나 수정했는지도 보여줍니다.
어떤 변경사항이 있었는지 전체적으로 간결하게 요약해줍니다.
이제 변경사항이 구현된 브랜치로
전환해보겠습니다.
방금 전환했습니다.
앱으로 돌아가보면
다크 모드가 이제 구현된 것을 볼 수 있습니다.
여기 토글을 볼 수 있습니다.
전환해보면 올바르게 작동합니다.
이것이 Claude Code SDK가
실제로 유용한 애플리케이션을 구축할 수 있게 해주는
방법을 보여준 것입니다.
사람들이 일상적인 워크플로우에서 사용할 수 있는 애플리케이션을요.
또 다른 정말 놀라운 예시는
Claude Code가 MCP에 접근할 수 있기 때문에
실제로 구축될 수 있는데,
Jira와 Slack MCP를 사용해서
전체 워크플로우를 만들 수 있다는 것입니다.
기본적으로 풀 리퀘스트가 만들어지면
여러분이 구축한 Claude Code 에이전트가
검토할 수 있습니다.
검토를 기반으로 Jira에서
티켓이 자동으로 배정될 수 있어서
수동으로 만들 필요가 없습니다.
그다음 Slack용 MCP를 사용해서
Slack에서 간단히 언급하고
Claude를 다양한 티켓이나 이슈에 배정할 수 있습니다.
이렇게 하면 필요한 인간의 입력을
줄일 수 있습니다.
그런데 코딩을 다루고 싶지 않다면 어떨까요?
현재 Claude Code는
Cursor처럼 링크에서 문서를
저장하는 방법이 없습니다.
그래서 이것 위에 커스텀 스크립트나
완전한 제품을 구축하고 싶다면
Cursor로 가서 문서로 추가할 수 있습니다.
하지만 전체 문서를 다운로드해서
마크다운 파일에 넣는 것 같은
다른 방법들도 있습니다.
Claude가 참조할 수 있도록 말이죠.
하지만 그렇게 하면 여전히 너무 많은 컨텍스트를 차지하고
이 경우에는 여기서 Cursor를 사용하는 것이 더 좋습니다.
다른 대안이 있을 것 같다면
댓글로 알려주세요.
이것으로 이 영상을 마무리하겠습니다.
채널을 지원하시고
이런 튜토리얼을 계속 만들 수 있도록
도움을 주고 싶으시다면
아래 Super Thanks 버튼을 사용해주세요.
언제나처럼 시청해주셔서 감사하고
다음 영상에서 만나겠습니다.