Anthropic Academy의 「Claude Platform 101」 학습 메모입니다.

이 코스의 학습 목적은 「브라우저에서 Claude와 채팅하는 것」과 「Claude를 프로덕트(Product)에組み込んで 출하하는 것」 사이의 간극을 메우기 위한 것이며, API 요청의 내용, 에이전트 루프(Agent Loop), 컨텍스트 윈도우(Context Window), 도구(Tool)와 권한의 메커니즘을 다시 학습하여 지식을 체계화하고자 함입니다.

What is the Claude Platform?— API의 기본, 모델 선택 -
Teaching your Agent— 에이전트 루프(Agent Loop), Tool Use, Thinking -
Extending your Agent— Built-in Tools, Skills, MCP, Context Management -
Managed Agents— Anthropic이 루프를 돌리는 호스티드(Hosted)형 에이전트 -
Building with Claude Code— Claude Code 자체를 사용한 개발

채팅 UI에서의 Claude 이용은 「질문하고, 답을 받고, 스레드가 종료되는」 1회 완결형 경험입니다.

반면, Platform으로서 Claude를 사용한다는 것은, 구조화된 요청을 보내고, 도구를 전달하며, 실제 시스템상에서 액션을 일으키게 하고, 그 루프를 1명의 사용자에게도 100만 명의 사용자에게도 돌릴 수 있도록 하는 것입니다. 프롬프팅(Prompting)과는 다른 스킬셋이 필요합니다.

코스에서는 Opus / Sonnet / Haiku의 3개 티어(Tier)가 소개되고 있으나, 2026년 중반 시점에는 모델 패밀리가 더욱 확충되어 있습니다.

기본 방침은 변함없이 「고민된다면 Sonnet, 복잡하다면 Opus, 대량 처리라면 Haiku」입니다. Fable은 「며칠이 걸리는 코드베이스 전체 마이그레이션」과 같은 장기 자율 태스크에서 비로소 가격에 부합합니다. 대부분의 유스케이스(Use case)에서는 Opus 이하로 충분합니다.

Claude가 자율적으로 움직이는 메커니즘의 핵심. 직접 작성하면 다음과 같은 사이클이 됩니다.

사용자의 지시
↓
Claude가 생각함 (Thinking)
...

이 루프를 직접 작성함으로써 메커니즘을 이해한 후, SDK의 Tool Runner로 교체하면 개발이 쉬워집니다.

「실행(Doing)」의 단위. 인수를 넣어 호출하면 반드시 1개의 결과를 반환하는 단일 함수입니다. 도구 자체에는 「업무 진행 방식」에 대한 지식은 없습니다.

중요한 것은, 모델은 「도구를 사용하고 싶다」는 의사 표시(tool_use 블록)를 낼 뿐이며, 실제 실행은 Harness(런타임 외각)가 수행한다는 분리입니다.

「추론(Reasoning)」의 기반 계층. 답변을 출력하기 전에 계산, 버그 체크, 접근 방식 검토를 Claude가 내부적으로 수행하기 위한 리소스입니다.

Skills를 읽은 결과를 소화하는 것도 Thinking, Tool의 호출 순서를 결정하는 것도 Thinking입니다. 다른 모든 요소에 앞서는 기반이며, 특정 레이어가 아니라 모든 레이어를 관통하는 추론 프로세스 그 자체입니다.

Agent의 능력을 확장하는 4가지 메커니즘에 대하여.

Harness에 프리셋(Preset)되어 있는 표준 도구군. Anthropic의 인프라 위에서 동작합니다.

Web Search— 웹 검색 -
Code Execution— 샌드박스(Sandbox) 내에서의 코드 실행 -
Web Fetch— URL 콘텐츠 취득

Claude Code의 문맥에서는 파일 조작(Read, Write, Edit), 검색(Glob, Grep), 실행(Bash), 에이전트 위임(Task) 등이 추가됩니다.

「전문 지식·워크플로우(SOP: Standard Operating Procedures)」의 선언적 절차서.

Skills는 「실행 가능한 패키지」가 아니라, Claude가 참조하는 SOP 매뉴얼입니다. 실행 주체는 항상 Agent(Claude)이며, Skills는 그 Agent에게 전문 지식을 주입하는 인터페이스입니다.

「어떤 도구를, 어떤 순서로, 어떤 제약 조건 아래에서 사용하여 결과물을 낼 것인가」가 적힌 지식 자산이며, Skills가 도구를 호출하는 것이 아니라, Claude가 Skills를 읽은 뒤에 도구를 호출한다.

이 세 가지 차이점은 오너십 (Ownership) 관점에서 나누면 명확해진다.

Tools는 당신의 것(your stuff)을 위한 것이고, Skills는 당신의 프로세스(your processes)를 위한 것이며, MCP는 그 외 다른 모든 것(everyone else's stuff)을 위한 것이다.

예를 들어 자사 DB로의 접속 코드 → Tool. "PR 리뷰는 3가지 관점에서 수행한다" → Skill. Cloudflare Workers로의 배포 → MCP (Cloudflare 공식 제공).

컨텍스트 윈도우 (Context Window)라는 유한한 리소스 안에서 "무엇을 기억하고 무엇을 잊을 것인가"를 제어하는 메커니즘 전체.

• System prompt
• Message history (대화 이력)
• Tool definitions and tool results (도구 정의 및 실행 결과)
• Attached files and skills (첨부 파일 및 스킬)
• Thinking blocks (사고 블록)

Just-in-time context

점진적 공개 (Progressive Disclosure) 패턴. 필요할 때까지 컨텍스트에 넣지 않는다.

• CLAUDE.md → 세션 시작 시 항상 로드
• Rules (경로 범위 지정 포함) → 해당 파일 조작 시에만
• Skills → 이름과 description만 먼저 로드, 본문은 호출 시점에 로드
• Subagents → 이름과 도구 목록만, 본문은 부모의 컨텍스트에 들어가지 않음

Compaction

컨텍스트가 임계치에 도달하면 자동으로 오래된 대화를 요약 압축한다. 요소별로 생존율이 다르다.

• CLAUDE.md → Compaction 후 재로드 (생존함)
• Rules (경로 범위 지정 없음) → 재주입됨
• Skills (호출됨) → 공유 버짓(Budget) 내에서 재주입되나, 오래된 것부터 탈락
• 하위 디렉토리 CLAUDE.md → 다시 다루기 전까지 삭제됨

Prompt caching

비용 최적화 메커니즘. 동일한 접두사(Prefix) 부분의 API 과금을 억제하는 기술로, 컨텍스트의 내용 자체를 바꾸지는 않는다.

Memory

컨텍스트 윈도우는 세션 종료 시 사라지지만, Memory tool이나 외부 파일로의 쓰기를 통해 세션 간의 상태를 유지한다.

직접 에이전트 루프 (Agent Loop)를 돌리는 대신, Anthropic의 인프라 위에서 샌드박스화된 에이전트를 실행시키는 모델.

"언제 직접 루프를 돌리고, 언제 Anthropic에 맡길 것인가"에 대한 판단이 필요하다. 이벤트 스트림 (Event Stream)을 consume(소비)하면서, Anthropic이 루프를 돌려 결과를 반환해 준다.

이미 감각적으로 알고 있는 내용이지만, 본 코스를 훑어보며 Claude Code 자체가 에이전트이며, 그것이 작성하는 코드를 리뷰하려면 "좋은 코드란 무엇인가"를 알아야 한다는 점을 다시 한번 이해했다.

코스의 내용을 Claude Code의 실무에 대응시키면 다음과 같은 레이어 모델이 된다.

• 기존 Commands는 v2.1.3부터 Skills로 통합된 것으로 보임 (소스 기사: https://www.buildthisnow.com/blog/tools/hooks/claude-code-commands-to-skills)

• CLAUDE.md에 "매번 반드시 ~한다"라고 적는 것 → Hook으로 만들어야 함. 모델의 판단에 의존하면 긴 세션에서 누락될 수 있음.
• CLAUDE.md에 30줄의 절차를 적는 것 → Skill로 만들어야 함. 매 턴마다 토큰 비용이 낭비됨.
• 경로(paths)가 없는 API 전용 규칙 → 경로 스코프(path scope)가 포함된 Rule로 만들어야 함. 무관한 세션에서도 로드됨.
• 개인적인 취향을 프로젝트 CLAUDE.md에 적는 것 → CLAUDE.local.md에 적어야 함. 팀원 전체에게 영향을 미침.

종합해 보면 "Claude Platform을 구축하는" 목적은 크게 다음 세 가지임.

1. 베테랑의 머릿속에만 있는 방식을 Skills나 CLAUDE.md에 녹여내어, Claude가 그 지혜를 참조하며 움직이도록 한다. 이는 단순히 개인 의존성을 배제하는 것이 아니라, 개인의 지혜를 조직의 자산으로서 계속 가동시키는 메커니즘을 구축하는 것이다.

2. 인간이 해야 할 일은 "무엇을 할 것인가·왜 할 것인가"에 대한 판단이다. "어떻게 할 것인가"의 실행은 Claude에게 위임할 수 있는 부분이 늘어난다. 인간은 리뷰와 의사결정에 집중한다.

3. Hooks나 Permissions를 통해 "해서는 안 되는 일"을 코드로 정의하여, 휴먼 에러나 정책 위반을 구조적으로 방지한다. 개인의 주의력에 의존하지 않는 거버넌스.

Claude Platform 101은 "채팅 UI의 연장선에서 Claude를 사용하는 사람"이 "Claude를 런타임 (Runtime)으로서 자신의 업무 시스템을 구축하는" 관점으로 전환하기 위한 코스이다.

특히 개인적으로 잘 이해하지 못한 채 사용하고 있었던 다음 내용들을 지식으로서 정리할 수 있었던 점이 좋았다.

• Tools / Skills / MCP의 오너십(Ownership)에 따른 구분 — "누가 만들고, 누가 유지보수하는가"에 따라 위치가 결정됨.
• 컨텍스트 관리 (Context Management)는 설계 판단의 근거 — "무엇을 어디에 적을 것인가"의 배후에는 모두 컨텍스트 윈도우 (Context Window)의 유한성이 있음.
• Harness라는 개념 — Claude는 모델뿐만 아니라, 그 주변의 하네스 (Harness) 설계가 결정적으로 중요함.