Claude Code 2.0(클로드 코드 2.0) 설치 - (Claude Code 1.0에서 2.0 업그레이드 하기)
-
728x90
안녕하세요! 갓대희입니다.
오늘은 클로드 코드 2.0 설치 방법에 대해 간단히 알아 보려고 한다.
Claude Code 2.0 출시 - VS Code 통합부터 서브에이전트까지 2025년 9월 말 출시된 Claude Code 2.0의 핵심 변경사항과 VS Code 네이티브 확장, 자동 체크포인트, 서브에이전트 등 기능들을 간단히 알아보려고 한다.
Claude Code가 드디어 2.0으로 메이저 업데이트되었다. 터미널 전용 도구에서 VS Code까지 확장되고, 체크포인트와 서브에이전트 같은 기능들이 추가되면서 완전히 새로운 개발 경험을 제공하게 되었다고 하는데, 설치 방법, 어떤점 들이 변경되었는지 간단하게 알아보도록 하자.
# Windows PowerShell은 이렇게: PS> irm https://claude.ai/install.ps1 | iex
# 3. 확인 $ which claude /usr/local/bin/claude # 경로가 바뀜 $ claude --version 2.0.9
Native Installer의 장점
자동 업데이트 - 더 이상 수동으로 안 해도 됨
빠른 시작 - bun/npm보다 확실히 빠르다
오류 없음 - 캐시 문제 안 생김
패키지 매니저 불필요 - bun이나 npm 없어도 됨
설치 후 첫 실행
나의 경우는 이미 사용중인 환경이 있었기 때문에 다음과 같은 내용에 대해 물어본다. 1번. yes 를 입력 하자.
Claude Code가 /Users/lf/.claude/commands 폴더의 파일을 읽고, 수정하고, 실행할 수 있는지
악의적인 코드가 실행되는 걸 방지하기 위한 안전장치
# Claude Code 실행 $claude
# 권한 확인 Do you trust the files in this folder? /Users/lf/.claude/commands Claude Code may read, write, or execute files contained in this directory. This can pose security risks, so only use files from trusted sources. Learn more ( https://docs.claude.com/s/claude-code-security ) ❯1.Yes, proceed 2. No, exit
결론:특별한 이유가 없다면Native Installer로 설치
공식 가이드: Claude Code 2.0 주요 변경사항
공식 문서 출처 2025년 9월 말 Anthropic 공식 발표 기준으로, Claude Code 2.0은 Sonnet 4.5 엔진을 기반으로 대폭 개선되었습니다. [Anthropic 공식 발표 참조]
구분
Claude Code 1.0
Claude Code 2.0
기본 모델
Claude Sonnet 4
Claude Sonnet 4.5
인터페이스
터미널 TUI만 지원
터미널 + Native VS Code Extension
코드 되돌리기
없음
✅ Checkpoints (Esc+Esc 또는 /rewind)
병렬 작업
단일 작업만 가능
✅ Subagents (병렬 개발 가능)
자동화
기본적인 명령 실행
✅ Hooks + Background Tasks
프롬프트 히스토리
없음
✅ 검색 가능 (Ctrl+R)
SDK
Claude Code SDK
Claude Agent SDK
① Checkpoints
Claude가 코드를 수정하기 전마다 자동으로 체크포인트를 생성한다. 마음에 들지 않으면Esc 키를 두 번누르거나/rewind명령으로 즉시 이전 상태로 되돌릴 수 있다.
코드만 되돌리기
대화만 되돌리기
코드 + 대화 모두 되돌리기
체크포인트 워크플로우
모든 명령 실행 시 자동으로 체크포인트 생성
30일간 체크포인트 보관 (로컬 스토리지)
ESC 두 번 또는 /rewind 명령으로 즉시 복구
코드와 대화 컨텍스트 동시 복원
💡 대규모 리팩토링이나 탐험적 개발에 특히 유용하다!
② Native VS Code Extension
VS Code 확장 주요 기능
실시간 코드 변경 사항 미리보기
인라인 diff로 변경 내용 확인
변경 제안 수락/거절 버튼 UI
사이드바에서 대화 이력 관리
# VS Code Marketplace에서 설치 "Claude Code" 검색 → 설치 → 사이드바에서 Claude 아이콘 클릭
우산단 클로드 코드 아이콘이 보이고 클릭하면 커서를 사용하는것 처럼 클로드 코드 채팅 패널이 열리게 된다.
다양한 슬래시 명령어, 그리고 Login 기능 등 CLI보다 GUI를 선호하시는 분들에게는 좋은 공식 확장 프로그램으로 보인다.
③ Subagents: 팀처럼 일하는 AI
메인 에이전트가 프론트엔드를 만드는 동안, 서브에이전트는 백엔드 API를 구축한다.진짜 시니어 개발자들이 역할 분담하듯병렬로 작업한다.
💡 대형 기능 개발이나 풀스택 프로젝트에 이상적일 것 같다
④ Hooks & Background Tasks: 자동화의 완성
Hooks는 특정 시점에 자동으로 액션을 실행한다:
코드 변경 후 → 자동으로 테스트 실행
커밋 전 → 자동으로 린팅
Background Tasks는 장시간 프로세스를 백그라운드로 돌린다:
Dev 서버 실행 중에도 Claude는 다른 작업 계속 가능
로그 모니터링하면서 동시에 코드 수정
Sonnet 4.5 이후의 변화
Claude Code 2.0의 핵심은 새로운 Sonnet 4.5 엔진이다. 근본적인 아키텍처 개선이 이루어졌다고 하는데, 이것이 실제 개발 경험에 미치는 영향을 살펴보자.
Sonnet 4.5 엔진의 핵심 특징
향상된 코드 이해력: 복잡한 코드베이스의 의존성과 아키텍처를 더 정확히 파악
멀티모달 지원: 코드, 문서, 다이어그램을 동시에 처리하고 이해
장기 기억 능력: 프로젝트 컨텍스트를 세션 간 유지하여 일관성 있는 개발 지원
실시간 학습: 사용자 패턴을 학습하여 개인화된 제안 제공
에러 예측: 코드 작성 중 잠재적 버그나 성능 이슈를 사전에 감지
실무 활용 팁 Sonnet 4.5 엔진은 특히 대규모 리팩토링이나 마이크로서비스 아키텍처 설계에서 더 강력해 진 것 같다. 전체 시스템의 의존성 그래프를 이해하고 영향도 분석을 자동으로 수행하므로, "이 함수를 변경하면 어디에 영향을 미칠까?"같은 질문에 즉시 답변을 받을 수 있다.
실제 프로젝트 적용 시나리오
시나리오 1: 대규모 리팩토링
UUID를 모든 API 엔드포인트에서 타입 안전한 ID로 변경하는 작업이 있다고 하자. 수십 개의 파일을 수정해야 하고, 놓치기 쉬운 작업이다.
$claude
사용자:모든 API 엔드포인트에서 UUID를 StronglyTypedId로 변경해줘. 타입 안전성을 보장하고, 관련된 모든 파일을 찾아서 수정해줘.
# Claude가 작업 시작 Claude:52개 파일에서 127개의 변경 사항을 발견했습니다...
# 중간에 실수 발견 시 사용자:Esc+Esc(체크포인트로 되돌리기)
Claude:이전 상태로 복원했습니다. 다시 시도할까요?
시나리오 2: 신규 기능 풀스택 개발
사용자 인증 기능을 처음부터 만들어야 한다. 프론트엔드, 백엔드, 데이터베이스를 모두 건드려야 한다.
$claude
사용자:JWT 기반 사용자 인증 시스템을 만들어줘: - React 프론트엔드 (로그인/회원가입 UI) - Express 백엔드 (API) - PostgreSQL 데이터베이스 스키마 서브에이전트를 사용해서 병렬로 작업해줘.
Claude:3개의 서브에이전트를 생성했습니다: └─ Agent 1: React UI 컴포넌트 생성 중... └─ Agent 2: Express API 엔드포인트 구현 중... └─ Agent 3: DB 마이그레이션 파일 작성 중...
# 테스트 자동화 Hook 설정 사용자:/permissions Bash(npm test) 허용 사용자:코드 변경할 때마다 테스트를 자동으로 실행해줘
Claude:Hook을 설정했습니다. 이제 변경 후 자동으로 npm test를 실행합니다.
시나리오 3: 레거시 코드 마이그레이션
오래된 JavaScript 프로젝트를 TypeScript로 변환해야 한다. 타입 정의를 하나하나 추가하는 건 지루한 작업이다.
$claude
사용자:이 프로젝트를 TypeScript로 마이그레이션해줘: 1. .js 파일을 .ts로 변환 2. 모든 함수에 타입 추가 3. 인터페이스와 타입 정의 생성 4. tsconfig.json 설정
Claude:마이그레이션 계획을 수립했습니다... 38개 파일을 분석하고 있습니다...
# Dev 서버를 백그라운드로 실행 사용자:Ctrl+Bnpm run dev
Claude:Dev 서버를 백그라운드로 시작했습니다. 마이그레이션을 계속 진행하겠습니다...
고급 기능 활용법
1. 컨텍스트 체이닝 (Context Chaining)
여러 서브에이전트 간 컨텍스트를 공유하고 체이닝하여 복잡한 작업을 수행할 수 있다.
// 컨텍스트 체이닝 예시
const pipeline = await claudeCode.createPipeline([
{ task: 'analyze-dependencies', agent: 'analyzer' },
{ task: 'optimize-imports', agent: 'optimizer' },
{ task: 'generate-tests', agent: 'tester' }
]);
// 각 단계의 결과가 다음 단계의 입력으로 자동 전달
const results = await pipeline.execute();
2. 지능형 캐싱 시스템
성능 최적화 Claude Code 2.0은 분석 결과를 지능적으로 캐싱합니다. 동일한 파일에 대한 반복 분석 요청 시 빠른 응답을 제공하며, 파일이 변경되면 자동으로 캐시를 무효화한다.
3. 커스텀 에이전트 생성
프로젝트별 맞춤 설정 프로젝트의 특성에 맞는 커스텀 에이전트를 생성할 수 있다.
아주 간단한 생성 예시를 살펴보자.
역할별 커스텀 에이전트 설정하기
프로젝트의 특성에 맞는 커스텀 에이전트를 생성할 수 있다. .claude/agents/ 디렉토리에 각 에이전트를 개별 Markdown 파일로 저장한다.
--- name:"backend-specialist" description:"Node.js/Express API 개발 전문가. 보안과 성능을 중시합니다." tools:"Read, Edit, Bash, Glob" model:"sonnet" ---
당신은 백엔드 API 개발 전문가입니다.
## 핵심 역량 - Node.js/Express 서버 구축 - RESTful API 설계 - GraphQL 스키마 설계 - 데이터베이스 설계 및 최적화 - 인증/인가 (JWT, OAuth)
## 필수 규칙 1. 모든 입력값 validation 필수 2. 철저한 error handling 3. database query 최적화 4. 환경변수로 민감정보 관리 5. API 문서화 (Swagger/OpenAPI)
ex) 파이썬 개발자
.claude/agents/python-specialist.md 파일 생성:
--- name:"python-specialist" description:"FastAPI/Django 전문 파이썬 개발자. PEP 8 준수와 타입 안정성을 중시합니다." tools:"Read, Edit, Bash" model:"sonnet" ---
당신은 파이썬 개발 전문가입니다.
## 핵심 역량 - FastAPI/Django 웹 프레임워크 - 비동기 프로그래밍 (async/await) - Type hints 활용 - 데이터 처리 및 분석
## 코딩 스타일 - PEP 8 스타일 가이드 준수 - 모든 함수/클래스에 docstring 작성 - virtual environment 사용 - poetry로 의존성 관리
ex) 데브옵스 엔지니어
.claude/agents/devops-specialist.md 파일 생성:
--- name:"devops-specialist" description:"인프라 자동화 및 CI/CD 전문가. Infrastructure as Code를 실천합니다." tools:"Read, Edit, Bash" model:"sonnet" ---
당신은 데브옵스 엔지니어입니다.
## 핵심 역량 - Docker/Kubernetes 컨테이너 오케스트레이션 - CI/CD 파이프라인 구축 - Infrastructure as Code (Terraform/Pulumi) - 모니터링/로깅 (Prometheus/Grafana)
## 운영 원칙 1. 모든 설정을 코드로 관리 2. 자동화 우선 (Manual은 최소화) 3. 롤백 전략 필수 4. 보안 스캔 자동화
ex) 에이전트 생성 팁
쉽게 만드는 방법
/agents 명령어를 사용하면 Claude가 대화형으로 에이전트를 만들어준다
$ claude
> /agents 📋 Create new agent or manage existing ones
> Generate with Claude What kind of agent do you want to create?
> 프론트엔드 개발 전문가가 필요해. React와 TypeScript에 집중하고, 접근성과 성능을 중시하는 에이전트를 만들어줘
# Claude가 자동으로 에이전트 파일을 생성해줍니다!
사용 예시
에이전트를 만들어두면 Claude가 자동으로 적절한 전문가를 선택하거나, 명시적으로 호출할 수 있다.
# 자동 선택 (Claude가 알아서 판단) $ claude >반응형 네비게이션 바를 만들어줘 # Claude가 frontend-specialist를 자동 선택
# 명시적 호출 >Use the frontend-specialist agent to create a navbar
# 백엔드 작업 >Use the backend-specialist agent to create a user authentication API
# 데브옵스 작업 >Have the devops-specialist agent set up a CI/CD pipeline
실전 팁
하나의 프로젝트에 여러 에이전트를 만들어두면 Claude가 상황에 맞게 선택
프로젝트 폴더의 에이전트는 Git으로 팀과 공유 가능
description을 명확하게 작성하면 자동 선택 정확도 향상
처음엔 간단하게 시작하고 점점 정교하게 발전시키기
고급 워크플로우 활용
서브에이전트 체이닝
여러 서브에이전트를 연결해서 복잡한 작업을 단계별로 처리할 수 있다. 각 에이전트가 독립적인 컨텍스트를 가지면서도 결과를 다음 단계로 전달한다.
$ claude
>다음 순서대로 작업해줘: 1. 의존성 분석 (analyzer agent) 2. import 최적화 (optimizer agent) 3. 테스트 생성 (tester agent)
# Claude가 자동으로 각 에이전트를 순차적으로 호출하고 # 각 단계의 결과를 다음 단계로 전달한다.
성능 최적화
Claude Code 2.0은 분석 결과를 지능적으로 캐싱한다. 동일한 파일에 대한 반복 분석 요청 시 훨씬 빠른 응답을 제공하며, 파일이 변경되면 자동으로 캐시를 갱신한다.
자동 캐싱의 장점
이미 분석한 파일은 즉시 재사용
대규모 코드베이스에서 체감 속도 향상
파일 변경 감지 자동화
별도 설정 불필요
팁
하나의 프로젝트에여러 에이전트를 함께 정의해서 상황별로 전환할 수 있음
팀 단위로공통 설정을 공유하면 코드 품질 일관성 유지 가능
focus는 AI가 집중할 기술/영역,rules는 반드시 지킬 원칙
처음엔 간단하게 시작하고 프로젝트 진행하면서 점점 정교하게 만들기
주의할 점들
토큰 소비가 많아졌다
Claude Code 2.0은 매우 강력하지만, 그만큼토큰 소비도 많다. 특히 Sonnet 4.5는 고성능 모델이라 비용이 발생할 수 있다./usage명령으로 사용량을 체크하자.
체크포인트는 Claude가 한 것만
사용자가 직접 수정한 코드나 bash 명령어는 체크포인트에 포함되지 않는다.Git과 함께 사용하는 것을 권장한다.
자주 묻는 질문 ❓
Q: 기존 1.x 프로젝트가 2.0으로 업그레이드 후 동작하지 않는다면?
A: 대부분의 경우 import 경로와 타입명 변경만으로 해결됩니다. ClaudeCodeOptions를 ClaudeAgentOptions로 변경하고, 메소드 시그니처가 변경된 부분이 있는지 확인하세요. Breaking changes는 공식 마이그레이션 가이드를 참조하시기 바랍니다.
Q: VS Code 확장과 터미널 버전을 동시에 사용할 수 있나요?
A: 네, 가능합니다. 두 인터페이스는 동일한 백엔드를 공유하므로 작업 내용이 실시간으로 동기화됩니다. VS Code에서 작업한 내용을 터미널에서 이어서 작업할 수 있습니다.
Q: 체크포인트는 얼마나 많은 스토리지를 사용하나요?
A: 프로젝트 크기와 변경 빈도에 따라 다르지만, 일반적으로 체크포인트당 수 MB 정도입니다. 30일 후 자동 삭제되므로 스토리지 관리는 자동으로 이루어집니다.
