Skip to main content

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

· 2 min read
파파팟
Claude Code 플레이북 저자

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가 돌아가는 상태다. 이제 제대로 활용하려면:

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