[Claude] official claude on aws workshop

안녕하세요. aws workshop 문서를 통해 claude를 익힌 내용에 대해 간단히 정리했습니다.

 

Claude Code 특징

• 여러분의 워크플로 안에서 동작합니다 브라우저 창에 코드를 복사해 붙여넣을 필요가 없습니다. Claude Code는 터미널에서 실행되면서 파일을 직접 읽고, 여러분의 승인을 받아 변경을 수행합니다. 전화로 집을 설명하는 것과 실제로 집을 함께 둘러보는 것의 차이라고 생각하시면 됩니다.
• 컨텍스트를 이해합니다 CLAUDE.md 파일(곧 자세히 다룹니다)을 통해 Claude는 프로젝트의 컨벤션, 코딩 스타일, 아키텍처를 학습합니다. 문서를 실제로 읽어주는 신규 팀원을 온보딩하는 느낌입니다.
• 행동을 수행합니다 Claude Code는 제안만 하는 것이 아니라 실제로 실행합니다. 의존성을 설치하고, 테스트를 돌리고, 변경 사항을 커밋해야 할 때 그냥 요청하면 됩니다. 물론 항상 먼저 권한을 묻습니다. 여러분이 조종사고, Claude는 매우 유능한 부조종사입니다.

 

프로젝트에서 Claude Code를 시작하면 뒤에서는 이런 일이 벌어집니다.

1. 컨텍스트 로딩 — Claude가 CLAUDE.md 파일을 읽고 프로젝트 구조를 파악합니다
2. 자연어 처리 — 여러분이 원하는 것을 평범한 문장으로 설명합니다
3. 계획 수립 — Claude가 어떤 도구와 파일이 필요한지 판단합니다
4. 실행 — 여러분의 승인을 받아 Claude가 행동을 수행합니다
5. 반복 — 여러분이 리뷰하고 피드백을 주면 Claude가 적응합니다

권한 모델

여기서 핵심 단어는 "승인"입니다. Claude Code는 권한 모델 위에서 동작합니다. 모든 파일 변경, 모든 명령 실행, 모든 도구 설치를 여러분이 승인합니다. 안전을 위한 것이기도 하지만(물론 그렇습니다), 무엇보다 여러분이 계속 흐름을 파악하고 통제권을 유지하기 위한 장치입니다.

 

이 워크숍에서는 오픈소스 화이트보드 도구인 Excalidraw 와 함께 작업합니다. 기술 다이어그램에 널리 쓰이는 도구입니다.

먼저 Excalidraw를 로컬로 클론하고 실행한 뒤, Claude를 이용해 코드베이스로부터 아키텍처 다이어그램을 생성합니다(이 얼마나 메타한가요?). 메인 이벤트는 무지개 툴바 만들기입니다. 반짝이는 도구를 마다할 사람이 있을까요? 이어서 Playwright를 활용한 브라우저 자동화로 테스트하고, 제대로 된 Git 워크플로로 모두 커밋합니다. 실제 기능, 실제 커밋, 실제 스킬입니다.

 

사전준비

 

 

Lab1 : 핵심 워크플로

 

Excalidraw 로컬 실행하기

 

경로 설정

 

 

마법의 프롬프트

Install dependencies and run the development server

 

CLAUDE.md 다루기

 

CLAUDE.md 파일은 compact하게 작성하기

 

프로젝트 메모리 vs 사용자 메모리

Claude Code는 두 가지 메모리 스코프를 지원합니다.

유형	위치	스코프
프로젝트 메모리	./CLAUDE.md	이 저장소에만 적용
사용자 메모리	~/.claude/CLAUDE.md	모든 프로젝트에 적용

 

.claude/rules/ 로 규칙 정리

.claude/
└── rules/
    ├── code-style.md
    ├── testing.md
    └── security.md

 

 

코드베이스 탐색하기

 

아키텍처 다이어그램 생성하기

Using @CLAUDE.md as your guide to the project layout, create a .excalidraw file in the repo root that visualizes this codebase's architecture. Use boxes for components and arrows for dependencies, and add short labels to the arrows.

 

 

Plan Mode 기능 구현하기

 

/rewind : 롤백 가능

/rename : 본인이 무슨 작업을 했는지 기억하기 위해 ..

 

 

Lab2 : 고급 기능

• 컨텍스트 관리 - 긴 세션 동안 Claude가 예리함을 유지하게 만들기
• Playwright MCP - Claude에게 브라우저의 눈과 손을 부여하기
• Git 워크플로 - 자신 있게 작업을 커밋하기

 

컨텍스트 관리

- Claude의 컨텍스트 창을 RAM이라고 생각하면 됩니다. Claude가 능동적으로 "생각하고 있는" 모든 것 — 대화, 읽은 파일, 명령어 출력, 도구 결과 — 을 담고 있습니다. 인상적으로 크지만, 무한하지는 않습니다.

 

 

Playwright MCP 통합

- github mcp 붙이면 context 늘어나니 주의

 

 

Playwright MCP는 다음을 열어주는 플러그인 중 하나입니다.

• 브라우저 제어
• 페이지 탐색
• 스크린샷 캡처
• UI 상호작용

 

알아둘 만한 다른 MCP들

Playwright는 훌륭하지만, 수많은 MCP 중 하나일 뿐입니다.

• Filesystem MCP - Claude의 기본 파일 조작을 넘어선 확장 기능
• GitHub MCP - 저장소 직접 조작, PR 관리
• Database MCP - Postgres, MySQL, SQLite를 직접 쿼리
• Custom MCP - 내부 도구를 위한 자체 MCP 구축 가능

MCP 생태계는 빠르게 성장하고 있습니다. 주기적으로 살펴보세요. 

Connect Claude Code to tools via MCP - Claude Code Docs

 

 

Git 워크플로

 

 

Lab3 : 확장 기능

• 서브에이전트와 플러그인 — 전문화된 AI 어시스턴트를 만들고 워크플로 모음을 설치합니다
• 커스텀 스킬 — 관련 상황에서 Claude가 자동으로 로드하는 재사용 가능한 워크플로를 패키징합니다
• 후크 — 도구 사용, 세션 시작 등 이벤트에 반응해 실행되는 스크립트를 자동화합니다
• 고급 커스터마이징 — MCP 서버, 확장 사고, 디버그 트랜스크립트

 

EPCC 워크플로 플러그인

EPCC는 Explore-Plan-Code-Commit의 약자이며, 문제를 이해하기도 전에 코드로 뛰어드는 것을 막아주는 구조화된 개발 워크플로입니다.

1. Explore - 코드베이스를 조사하고 문제 영역을 이해합니다
2. Plan - 코드를 쓰기 전에 접근 방식을 설계합니다
3. Code - 각 단계마다 품질 점검을 병행하며 구현합니다
4. Commit - 적절한 문서화와 함께 마무리합니다

 

MCP와 스킬의 차이?

 

- 스킬 : 반복된 작업을 로컬베이스로 진행할 때 사용. 워크플로우.(예: explore -> plan -> 구현 -> 커밋)...

- MCP : MCP는 표준화된 인터페이스를 통해 Claude가 외부 도구와 통신할 수 있게 해줌

 

좋은 스킬의 구성 요소

요소	목적
name	소문자와 하이픈, 동명사(verb-ing) 형태
description	무엇을 하는지 AND 언제 사용하는지(최대 1024자)
Workflow	Claude가 추적할 수 있는 체크박스 단계
Example	기대치를 알려주는 구체적인 입력/출력
Constraints	원치 않는 동작을 방지하는 경계

 

• 간결하게 유지하세요. 컨텍스트 창은 공유 공간입니다. 모든 단락은 토큰 비용을 정당화해야 합니다. 예시 스킬은 약 30줄로 — 유용할 만큼 충분하고, 효율적일 만큼 짧습니다.
• 3인칭 설명을 사용하세요. "I can help you improve diagrams"가 아니라 "Improves diagrams"라고 쓰세요. Claude가 이 형식을 더 잘 이해합니다.
• 구체적인 예시를 포함하세요. 어떤 입력이 스킬을 트리거하고 어떤 출력이 나올지 보여주세요. 추상적인 설명은 추상적인 결과로 이어집니다.
• 워크플로 체크박스를 추가하세요. Claude가 단계별 진행 상황을 추적할 수 있어 다중 단계 작업의 안정성이 향상됩니다.

 

후크

- 후크는 특정 이벤트 — Claude가 도구를 사용하기 전, 완료 후, 세션 시작 시 — 에 자동으로 실행되는 스크립트입니다. 한 번 설정해 두면 여러분이 손가락 하나 까딱하지 않아도 표준을 유지해 줍니다.

- 후크는 자동적이고 일관성 있는 작업에 가장 잘 어울립니다. 포맷팅, 린트, 로깅처럼 항상 같은 방식으로 실행되기를 원하는 작업입니다

 

고급 커스터마이징

사고가 활성화되면, 키워드로 더 많은 사고를 요청할 수 있습니다.

키워드사고	예산
"think"	약 8,000토큰
"think hard"	약 15,000토큰
"think harder"	약 16,000-62,000토큰
"ultrathink"	약 64,000-190,000토큰

 

웹 검색 추가

이 아키텍처는 AgentCore Gateway를 관리형 MCP 엔드포인트로 사용합니다:

• Claude Code(MCP 클라이언트)가 SigV4로 서명된 요청을 HTTPS를 통해 게이트웨이로 전송합니다
• AgentCore Gateway는 AWS IAM으로 인증하고 Web Search 커넥터로 라우팅합니다
• Web Search 커넥터는 AWS의 관리형 웹 인덱스를 조회하고 인용 정보와 함께 결과를 반환합니다
• API 키도, bearer 토큰도 필요 없습니다 — 기존 AWS 자격 증명이 인증을 처리합니다

쿼리가 외부 환경으로 나가는 타사 검색 API와 달리, Web Search Tool은 설계부터 프라이빗합니다. 에이전트가 검색을 실행하면 쿼리는 전적으로 AWS 인프라 내에서 처리됩니다 — 고객 쿼리는 타사 검색 엔진으로 전송되거나 AWS 외부로 라우팅되지 않습니다. 게이트웨이는 AWS 소유 커넥터에 인증하고 요청을 내부적으로 라우팅하므로 데이터 경로가 처음부터 끝까지 AWS 내에 유지됩니다. 데이터 유출에 대한 우려가 있는 팀에게 이는 전체 검토 카테고리를 제거해 줍니다.

 

Lab 5 : Bedrock 구성과 비용 거버넌스

• claude code : client
• antrophic, aws bedrock : server
• 어떻게 서버 판단? 환경 변수로 설정

1) Bedrock 연결

 

 

 

 

2) 모델 선택과 버전 고정

 

Model ID의 global 의미 : cross region inference

 

 

 

3) 비용 관리와 토큰 예산

 

claude code는 coding을 위한 전문 ai agent 이므로 질문에 추가적인 context가 붙게됨. mcp 서버를 사용하게 된다면 추가로 더 비용이 발생됨

 

 

• /context — 창이 무엇으로 채워져 있는지, 비용이 발생하기 전에 확인합니다.

• /clear — 관련 없는 작업으로 전환할 때 새로 시작하세요. 오래된 컨텍스트는 이후 모든 메시지에서 토큰을 낭비합니다. 나중에 /resume으로 이어 갈 계획이라면 먼저 /rename을 실행하세요.

• /compact — 긴 세션을 요약해 훨씬 적은 토큰으로 계속 이어 갑니다. 어떤 내용을 유지할지 지시할 수 있습니다: /compact Focus on code samples and API usage.

 

좋은 모델을 쓰는 것이 정답은 아님

- 복잡하고 어려운 문제를 풀 경우는 좋은 모델 사용해서 한번에 끝내는게 효율적 : opus 모델 사용해서 한번에 끝내기

- 간단한 커밋 메시지 만들때는 저사양 모델 사용해서 context 절감 : hiku 모델로 빠르고 비용 효율적으로

 

 

 

 

Extended thinking 조정하기

/effort

 

프롬프트 캐싱

- Bedrock 에서 가능

 

4) 긴 세션을 위한 자격 증명 갱신

 

 

 

오픈 소스 기여 시 claude code 활용하여 쉽게~!

- plan mode로 계획 세워서 오픈소스 기여/PR/커밋 방법 참고해서