02장. Claude Code 설치 및 설정 — Claude Code 완벽 가이드

Claude Code 완벽 가이드

⚙️ CHAPTER 02 / 13

Claude Code 설치 및 설정

📚 Claude Code 완벽 가이드 ⏱ 읽는 시간 약 3분 📅 2026년 3월

이 장의 내용

1. 사전 요구사항
2. 설치 방법
3. 프로젝트 초기화
4. CLAUDE.md 활용
5. 설정 파일 구조

01사전 요구사항

Node.js

18 이상 필요

운영체제

macOS / Linux / Windows

계정

Anthropic 계정 또는 API 키

인터넷

항상 필요 (모델 호출)

02설치 방법

bash

# npm으로 전역 설치
npm install -g @anthropic-ai/claude-code

# 설치 확인
claude --version

# 첫 실행 (인증 절차 진행)
claude

ℹ️

Claude Code는 Pro 플랜($20/월) 또는 API 키가 있어야 사용할 수 있습니다. 2026년부터 Pro 플랜에 Opus 4.6을 포함한 모든 모델이 포함됩니다.

03프로젝트 초기화

새 프로젝트에서 처음 사용할 때는 /init으로 시작하세요.

bash

# 프로젝트 디렉토리에서 실행
cd my-project
claude

# Claude Code 내부에서
/init   # CLAUDE.md 자동 생성

04CLAUDE.md 활용

CLAUDE.md는 Claude와의 모든 대화에 자동으로 포함되는 프로젝트 전용 지시사항 파일입니다.

markdown

# CLAUDE.md 예시

## 프로젝트 개요
- Next.js 14 + TypeScript + Tailwind CSS
- 백엔드: FastAPI (Python 3.11)

## 코딩 컨벤션
- 함수명: camelCase, 컴포넌트: PascalCase
- 모든 async 함수에는 try-catch 필수
- 커밋 메시지: Conventional Commits 형식

## 자주 사용하는 명령어
- 개발 서버: `npm run dev`
- 테스트: `pytest tests/`

⚠️

CLAUDE.md에 너무 많은 내용을 추가하면 역효과가 납니다. 실제로 효과적인 지시사항만 선별하여 주기적으로 정제하세요.

05설정 파일 구조

파일/폴더	위치	역할
CLAUDE.md	프로젝트 루트	프로젝트 컨텍스트, 개발 규칙
.claude/commands/	프로젝트	커스텀 슬래시 명령어
.claude/settings.json	프로젝트	훅, 권한 등 프로젝트 설정
~/.claude/commands/	전역	모든 프로젝트에서 사용 가능한 명령어
~/.claude/settings.json	전역	사용자 전역 설정

💡

/memory로 CLAUDE.md를 편집하고 /doctor로 설치 상태를 점검하세요.

출처: github.com/wesammustafa/Claude-Code-Everything-You-Need-to-Know