실습 환경 구성 — API 키, SDK, Claude Code

시험은 클로즈드북이지만, 준비 과정에서는 코드를 직접 돌려 보는 것이 개념을 가장 확실하게 익히는 방법입니다. 이 절에서는 본문의 예제를 실행하기 위한 최소 환경을 구성합니다. 이미 Claude로 개발해 온 독자라면 대부분 이미 갖추고 있을 것이므로, 빠진 부분만 점검하면 됩니다.

1. Anthropic API 키 발급

Anthropic Console에서 API 키를 발급받습니다. 발급한 키는 코드에 직접 적지 말고 환경 변수로 관리하세요. 키가 코드에 남으면 유출 위험이 생깁니다.

# 터미널: 환경 변수로 API 키 설정 (셸 세션에만 적용됨)export ANTHROPIC_API_KEY="sk-ant-..."

영구적으로 적용하려면 ~/.zshrc나 ~/.bashrc에 같은 줄을 추가합니다.

2. Python SDK 설치

본문 예제는 Python을 기준으로 합니다. 공식 Anthropic SDK를 설치합니다.

# 터미널: 공식 Python SDK 설치pip install anthropic

설치가 끝나면 아래 검증 스크립트로 키와 SDK가 정상 동작하는지 확인합니다. 코드 블록 전체를 그대로 복사해 파일로 저장한 뒤 실행하세요.

# 새 파일: verify_setup.pyimport anthropic# ANTHROPIC_API_KEY 환경 변수에서 키를 자동으로 읽어온다client = anthropic.Anthropic()response = client.messages.create(    model="claude-opus-4-8",    max_tokens=128,    messages=[        {"role": "user", "content": "한 문장으로 자기소개를 해 주세요."}    ],)# 응답 content는 블록 리스트다. 타입을 확인하고 텍스트를 출력한다for block in response.content:    if block.type == "text":        print(block.text)print("환경 구성 완료:", response.model)

# 터미널: 검증 스크립트 실행python verify_setup.py

응답 텍스트와 "환경 구성 완료: claude-opus-4-8"이 출력되면 API 키와 SDK가 정상입니다. 여기서 사용한 claude-opus-4-8은 집필 시점의 기본 권장 모델입니다. 시험 자체는 특정 모델 버전을 묻기보다 아키텍처 개념을 묻지만, 실습에서는 최신 모델을 쓰는 것이 좋습니다.

3. Claude Code 설치

PART 03(Claude Code 도메인, 출제 비중 20%)의 예제를 실습하려면 Claude Code가 필요합니다. Claude Code는 터미널·데스크톱 앱·IDE 확장 등 여러 형태로 제공됩니다. 설치 방법은 환경에 따라 다르므로 공식 설치 안내를 따르고, 설치 후 다음을 확인하세요.

• 프로젝트 루트에 CLAUDE.md 파일을 만들고 인식되는지
• 슬래시 커맨드가 동작하는지

이 두 가지는 PART 03에서 본격적으로 다룹니다. 지금은 "설치가 되어 있고 실행된다"는 것만 확인하면 충분합니다.

4. (선택) MCP 실습 준비

PART 05(도구·MCP, 출제 비중 18%)에서는 MCP 서버를 다룹니다. MCP는 비교적 새로운 주제라 직접 손으로 만져 보면 이해가 크게 빨라집니다. 다만 MCP 환경 구성은 PART 05에서 단계별로 안내하므로, 지금 미리 준비할 필요는 없습니다.

보안 주의

• API 키를 코드, 깃 저장소, 공유 문서에 절대 적지 마세요. 항상 환경 변수로 관리합니다.
• 키가 유출되었다고 의심되면 Console에서 즉시 폐기하고 재발급하세요.

정리

• API 키는 환경 변수(ANTHROPIC_API_KEY)로 관리하고 코드에 적지 않는다.
• pip install anthropic로 공식 SDK를 설치하고 검증 스크립트로 동작을 확인한다.
• PART 03 실습을 위해 Claude Code를 설치하고 실행을 확인한다.
• MCP 실습 환경은 PART 05에서 단계별로 구성하므로 지금은 불필요하다.