Claude Code 설치 완벽 정리 — Mac/Windows/Linux 단계별 설정 가이드

뭘 만들 수 있나요?

Claude Code는 Anthropic의 AI 기반 코딩 어시스턴트로, 터미널에서 직접 작동하며 파일 편집, 명령 실행, 버그 디버깅을 자동으로 수행합니다.

구독 & 시스템 요구사항

1. 구독: Claude Pro 플랜 이상 필수

2. 운영체제: macOS Ventura 13.0+, Windows 10 1809+, Ubuntu 20.04+

3. RAM: 최소 4GB (8GB 권장)

설치 방법

macOS/Linux

curl -fsSL https://claude.ai/install.sh | bash

Windows

1. Git for Windows 설치: https://gitforwindows.org

2. PowerShell (관리자)에서 실행:

irm https://claude.ai/install.ps1 | iex

인증 & 초기화

1단계: 터미널에서 claude 입력 → 브라우저에서 로그인

2단계: 프로젝트 폴더에서 claude /init 입력 → CLAUDE.md 생성

주요 명령어

  • /init — 프로젝트 초기화 + CLAUDE.md 생성
  • /clear — 대화 기록 초기화
  • /compact — 대화를 요약해 가볍게 유지
  • /resume — 이전 세션 이어서 계속

주의할 점

  • 인증 에러: claude logout 후 다시 claude
  • 명령어 미응답: 터미널 재시작 또는 재설치
  • 성능 이슈: 8GB RAM 권장, 임시파일 정리 rm -rf /tmp/claude-*

자주 묻는 질문

Claude Code는 무료인가요?

아니요. Claude Pro 이상의 유료 플랜에만 포함됩니다.

Windows에서 설치가 안 될 때는?

Git for Windows가 먼저 설치되어야 합니다. PowerShell 관리자 권한으로 실행하고 보안 경고에서 Y를 입력하세요.

IDE 플러그인은?

VS Code와 JetBrains IDE용 공식 플러그인이 있습니다. 마켓플레이스에서 검색하여 설치하면 됩니다.

💡 핵심 팁

Claude Code의 진짜 가치는 설치 후에 시작됩니다. 처음 사용할 때는 CLAUDE.md를 먼저 작성하여 프로젝트 규칙을 명확히 정의하면, Claude가 여러분의 코딩 스타일을 더 잘 이해하고 정확한 코드를 작성합니다.

1개의 답글

뉴스레터 무료 구독

👉 이 게시글도 읽어보세요