[ Claude Code #1 ] 소개 및 설치하기 (Overview & Installation)

by

개발 환경에서의 AI 활용은 단순한 코드 완성을 넘어, 이제 스스로 추론하고 실행하는 ‘에이전틱(Agentic)’ 단계로 진화하고 있습니다.

Anthropic이 공개한 Claude Code는 터미널 내에서 개발자의 의도를 이해하고 직접 파일 수정, 테스트 실행, git 커밋까지 수행하는 혁신적인 CLI 도구입니다.

이번 포스팅에서는 Claude Code의 핵심 개념을 파악하고, 로컬 환경에 VS code와 함께 완벽하게 설치하는 과정을 살펴보겠습니다.

1. Claude Code란 무엇인가?

Claude Code는 Anthropic의 최신 모델인 Claude 3.5 Sonnet을 기반으로 작동하는 에이전틱 CLI(Command Line Interface) 코딩 도구입니다.

기존의 AI 어시스턴트(GitHub Copilot, Cursor 등)가 주로 편집기 내부의 코드 제안에 집중했다면, Claude Code는 터미널을 통해 운영체제와 직접 상호작용하며 더 넓은 권한을 가집니다.

핵심 차별점: ‘에이전틱’ 워크플로우

  • 자율성: “이 프로젝트의 모든 테스트를 실행하고 실패하는 부분을 수정해줘”라고 명령하면,
    Claude는 스스로 파일을 읽고, 테스트 명령을 실행하고, 로그를 분석하여 코드를 수정하는 ‘루프’를 수행합니다.
  • 도구 활용 능력: ls, grep, npm test, git 등의 쉘 명령어를 직접 실행하여 실시간 피드백을 확인합니다.
  • 코드베이스 전체 이해: 특정 파일이 아닌 프로젝트 전체 구조를 인덱싱하여 복잡한 의존성 관계를 파악합니다.
Claude code (Vibe coding)

2. 요금 체계 및 서비스 플랜 비교 (Pricing)

Claude Code는 사용자의 니즈에 따라 **구독형(Subscription)**과 종량제(Pay-as-you-go) 방식을 모두 지원합니다. CLI 도구의 강력한 기능을 제대로 활용하려면 본인의 사용 패턴에 맞는 플랜을 선택하는 것이 중요합니다.

[표] Anthropic Claude 서비스 플랜 비교

요금제 (Plan)가격 (월 기준)대상 (Target)Claude Code 활용 및 특징
Free$0입문자일일 제한적 사용량, 기본적인 에이전트 경험 가능
Pro$20개인 개발자표준 사용량 제공, 최신 모델(Sonnet) 우선 접근
Max$100 ~ $200전문 개발자Pro 대비 5x ~ 20x 높은 사용량, 대규모 프로젝트 최적화
Team인당 $25 ~ $125소규모 팀팀 단위 협업, 보안 강화(데이터 학습 제외), 중앙 결제
API (종량제)사용량 기반CLI/에이전트 헤비 유저CLI 도구 필수 연동, 실제 사용한 토큰만큼 결제 (Sonnet 기준 $3/$15 per MTok)

에디터 권장: 개인 개발자라면 Pro 구독과 함께 $5 정도의 API Credit을 충전해두는 것이 가장 경제적이고 안정적입니다.

3. 설치 전 준비 사항 (Prerequisites)

설치를 진행하기 전에 시스템이 아래 요구 사항을 충족하는지 확인하십시오.

  • Node.js: v18.19.0 이상이 필요합니다 (node -v로 확인).
  • VS Code: 최신 기능을 위해 v1.98.0 이상 설치를 권장합니다.
  • Anthropic API Key:Anthropic Console에서 발급받은 키가 필요합니다.
    • 중요: Claude Pro/Max 구독자이더라도 API 사용을 위한 별도의 Credit(최소 $5 권장)이 충전되어 있어야 정상 작동합니다.
  • 운영체제: macOS, Linux, Windows(WSL2 환경 강력 권장)를 지원합니다.

Anthropic API 설정

Claude Code는 Anthropic의 API를 직접 소모합니다.

  1. Anthropic Console에 접속하여 계정을 생성합니다.
  2. API Keys 메뉴에서 새로운 키를 발급받습니다.
  3. 충분한 Credit이 충전되어 있는지 확인하십시오. (Claude Code는 에이전틱 동작 특성상 토큰 소모량이 일반 채팅보다 많을 수 있습니다.)

4. 설치 및 환경 설정 가이드 (with VS code)

Step 1: Claude Code CLI 설치

터미널(Ctrl + `)에서 아래 명령어를 입력하여 엔진을 설치합니다.

Bash

# npm을 통한 전역 설치
npm install -g @anthropic-ai/claude-code

# 설치 후 계정 인증 (브라우저 연동)
claude auth

Step 2: VS Code 전역 확장 프로그램 설치

터미널을 오가지 않고 사이드바에서 즉시 대화하려면 공식 확장을 반드시 설치하세요.

  1. Extensions(Ctrl+Shift+X)에서 “Claude Code for VS Code” 검색 후 설치.
  2. 사이드바의 Spark(별 모양) 아이콘을 클릭해 활성화합니다.
Claude code installtion (with VS code)

Step 3: 시너지를 높여주는 추천 익스텐션 (Best Match)

Claude Code가 수정한 코드를 더 완벽하게 관리하기 위해 아래 익스텐션들을 함께 설치하는 것을 추천합니다.

  1. GitLens: Claude가 수행한 자동 커밋과 변경 이력을 시각적으로 추적하기에 최적입니다.
  2. Prettier / ESLint: Claude가 작성한 코드의 스타일을 프로젝트 컨벤션에 맞춰 자동으로 교정해 줍니다.
  3. Error Lens: Claude에게 수정 요청을 하기 전, 터미널을 보지 않고도 에러 라인을 즉시 파악할 수 있게 해 줍니다.

5. VS Code 활용 극대화: Side-by-Side 워크플로우

Claude Code를 VS Code에서 사용할 때의 핵심은 ‘편집기’와 ‘에이전트 터미널’의 병렬 배치입니다.

추천 화면 레이아웃

  • 좌측: 소스 코드 편집기 (VS Code Editor)
  • 우측/하단: Claude Code 실행 터미널

실시간 동기화 확인

Claude Code에게 “index.ts 파일의 에러를 수정해줘”라고 명령하면, VS Code 편집기 상에서 해당 파일의 내용이 실시간으로 변경되는 것을 확인할 수 있습니다.

Tip: 파일 변경 감지 VS Code는 외부 명령(Claude Code)에 의한 파일 변경을 즉시 감지하여 UI에 반영합니다. 따라서 별도의 저장 과정 없이도 Claude가 수정한 코드를 즉시 검토하고 테스트할 수 있습니다.

6. 설치 중 발생할 수 있는 이슈 해결 (Troubleshooting)

1. 권한 오류 (EACCES)

터미널에서 설치 중 permission denied 오류가 발생한다면 sudo를 사용하거나(macOS/Linux), VS Code를 관리자 권한으로 실행해 보세요.

Bash

sudo npm install -g @anthropic-ai/claude-code

2. 명령어를 찾을 수 없음 (Command Not Found)

설치 후 claude 명령어가 인식되지 않는다면, npm의 전역 바이너리 경로가 시스템 PATH에 등록되어 있는지 확인해야 합니다.

Bash

# npm 전역 경로 확인
npm config get prefix

마치며: AI와 함께하는 ‘바이브 코딩(Vibe Coding)’

Claude Code의 설치를 마쳤다면, 이제 터미널에서 자연어로 대화하며 코드를 짜는 새로운 개발 방식인 ‘바이브 코딩(Vibe Coding)’을 시작할 준비가 되었습니다.

VS Code 편집기에서 코드를 보고, 터미널의 Claude code가 실시간으로 코드를 수정하는 광경은 개발 경험을 근본적으로 바꿔놓을 것입니다.

참고링크

1. 공식 리소스 (Official)

2. 커뮤니티 및 오픈소스 가이드 (Community)

3. 심화 학습 (Korean Blog)

[실전 사례] Claude Code로 스케줄러 만들기 https://brunch.co.kr/@publichr/180

Leave a Comment

© 2026 Marketer • Built with GeneratePress
Privacy PolicyTermsContact