설치와 인증

Claude Code는 명령줄(CLI) 도구로 제공됩니다. Node.js가 설치돼 있다면 npm으로 전역 설치할 수 있습니다.

학습 목표

• Claude Code를 설치하는 방법을 안다.
• 계정 인증 흐름을 이해한다.
• 프로젝트 폴더에서 첫 세션을 연다.

사전 준비

• 터미널(macOS·Linux·WSL) 또는 Windows PowerShell
• Anthropic 계정 또는 API 키

설치

운영체제에 맞는 공식 설치 스크립트를 사용합니다.

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

패키지 매니저를 선호한다면 Homebrew나 WinGet으로도 설치할 수 있습니다.

brew install --cask claude-code        # macOS
winget install Anthropic.ClaudeCode    # Windows

설치가 끝나면 claude 명령을 사용할 수 있습니다.

claude --version

인증

처음 실행하면 인증을 요청합니다. 작업할 프로젝트 폴더로 이동한 뒤 실행하세요.

cd my-project
claude

브라우저를 통한 계정 로그인 또는 API 키 입력으로 인증을 진행합니다. 한 번 인증하면 자격 정보가 저장되어 다음부터는 바로 시작됩니다.

첫 세션 열기

인증을 마치면 대화형 프롬프트가 나타납니다. 여기에 자연어로 요청을 입력하면 됩니다.

> 이 프로젝트가 어떤 구조인지 설명해줘

종료하려면 /exit를 입력하거나 Ctrl+D를 누릅니다.

프로젝트 단위로 실행하기

Claude Code는 실행한 폴더를 작업 디렉터리로 삼아 그 안의 파일을 탐색합니다. 따라서 항상 프로젝트 루트에서 실행하는 것이 좋습니다. git 저장소라면 변경 사항을 추적하기에도 유리합니다.

요약

npm install -g @anthropic-ai/claude-code로 설치하고, 프로젝트 폴더에서 claude를 실행해 인증하면 첫 세션이 시작됩니다. 작업 디렉터리가 곧 탐색 범위이므로 프로젝트 루트에서 실행하세요.