Claude Code 시작하기 — 설치부터 첫 실행까지 5분 가이드

Claude Code를 처음 써보려는데 어디서부터 해야 할지 모르겠다면, 이 글 하나로 끝난다.

설치 → API 키 → 첫 실행. 5분이면 된다.

1단계: 설치 (2분)

Node.js 18 이상이 필요하다. 터미널을 열고:

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

설치가 끝나면 확인:

claude --version

OS별 상세 가이드

Windows(PowerShell/WSL), macOS(Homebrew), Linux 환경별 상세 설치법은 설치 가이드에 정리해뒀다.

2단계: API 키 설정 (2분)

Claude Code를 쓰려면 Anthropic API 키 또는 Max 플랜 구독이 필요하다.

API 키 방식

1. console.anthropic.com에 가입
2. Settings → API Keys → Create Key 클릭
3. 키 복사 (sk-ant-api03-... 형식)
4. 환경변수 설정:

# macOS/Linux
export ANTHROPIC_API_KEY="sk-ant-api03-여기에-키-붙여넣기"

# 영구 저장하려면 ~/.bashrc 또는 ~/.zshrc에 추가

Max 플랜 방식

Claude Pro/Max 구독자라면 API 키 없이 바로 쓸 수 있다. 터미널에서 claude를 실행하면 브라우저 로그인으로 연결된다.

상세 가이드

키 발급 과정을 스크린샷과 함께 보려면 API 키 설정 챕터를 참고.

3단계: 첫 실행 (1분)

프로젝트 폴더로 이동해서 실행:

cd my-project
claude

이제 자연어로 지시하면 된다:

> 이 프로젝트 구조를 파악하고 README를 작성해줘

> src/utils.js에서 버그를 찾아서 수정해줘

> 로그인 API 엔드포인트를 만들어줘

Claude Code는 파일을 읽고, 수정하고, 터미널 명령을 실행한다. 변경 사항은 항상 확인 후 승인할 수 있다.

다음 단계

여기까지 했으면 Claude Code가 돌아가는 상태다. 이제 제대로 활용하려면:

• CLAUDE.md 작성법 — 프로젝트 규칙을 설정해서 AI가 맥락을 기억하게
• 권한 모드 — 자동 승인 설정으로 작업 속도 높이기
• 복붙 프롬프트 모음 — 바로 쓸 수 있는 프롬프트 9개

전체 커리큘럼은 시작하기에서.