실전 가이드

Claude Code 설치와 시작 방법: 단계별 가이드

요구 사항, macOS·Linux·Windows 설치, 첫 세션, 요금제, VS Code와 JetBrains 연동까지. Anthropic 공식 문서에 따른 Claude Code.

작성: Audryk · 2026년 10월 20일

• 실전 가이드
• 코딩 에이전트
• #가이드
• #Claude Code

Claude Code는 Anthropic의 코딩 에이전트다. 터미널, IDE, 데스크톱 앱, 웹에서 프로젝트를 읽고, 변경을 제안하고, 명령을 실행한다. 이 가이드는 공식 문서를 따르며, 모든 명령을 2026-10-20에 문서와 대조해 확인했다. 사용량 수치와 요금제는 Claude Code 도구 페이지를 참고하라.

시작하기 전에

• 운영체제: macOS 13.0 이상, Windows 10 1809 이상(또는 Windows Server 2019), Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+(Anthropic).
• 하드웨어: RAM 4GB 이상, x64 또는 ARM64 프로세서. 인터넷 연결이 필요하다.
• 셸: Bash, Zsh, PowerShell, CMD.
• 지역: Claude Code는 Anthropic이 지원하는 국가에서만 제공된다.
• 계정: Claude Pro, Max, Team, Enterprise 구독 또는 Claude Console 계정(선결제 크레딧을 쓰는 API). claude.ai 무료 요금제에는 Claude Code가 포함되지 않는다. Amazon Bedrock, Google Cloud, Microsoft Foundry도 지원한다.

Claude Code 설치

네이티브 설치 프로그램이 Anthropic이 권장하는 방법이며, 백그라운드에서 스스로 업데이트한다.

macOS, Linux, WSL:

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

Windows PowerShell:

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

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

설치 프로그램은 내려받는 동안 진행 상황을 표시하지 않는다. 설치 후에는 새 터미널을 연다. 기본적으로 자동 업데이트가 없는 대안이 두 가지 있다.

brew install --cask claude-code

winget install Anthropic.ClaudeCode

Homebrew의 claude-code cask는 안정 채널을 따르며(약 일주일 늦고, 큰 회귀가 있는 릴리스는 건너뛴다), claude-code@latest는 모든 릴리스를 나오는 즉시 받는다. Debian, Fedora, RHEL, Alpine용으로 서명된 apt, dnf, apk 저장소도 제공된다.

npm으로 설치: 이 패키지는 Node.js 22 이상이 필요하며 같은 네이티브 바이너리를 설치한다. Anthropic은 sudo npm install -g를 권하지 않는다(권한 문제와 보안 위험).

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

Windows 참고 사항

Claude Code는 Windows에서 네이티브로, 또는 WSL 안에서 실행된다. 네이티브 설치에는 관리자 권한이 필요 없다. Git for Windows는 선택 사항이다. 설치되어 있으면 Claude Code가 Bash 도구에 Git Bash를 쓰고, 없으면 PowerShell을 쓴다. 샌드박싱(격리된 명령 실행)은 WSL 2에서만 지원된다. WSL에서는 PowerShell이 아니라 Linux 터미널에서 설치하고 claude를 실행한다.

설치 확인

claude --version

이 명령은 버전 번호 뒤에 "(Claude Code)"를 출력한다. 셸이 claude를 찾을 수 없다고 하면 설치 디렉터리가 아직 PATH에 없는 것이다. 세션을 시작하지 않고 더 자세히 점검하려면 다음을 실행한다.

claude doctor

첫 세션

프로젝트로 이동해 에이전트를 시작한다.

cd /path/to/your/project
claude

처음 사용할 때 Claude Code가 브라우저를 열어 로그인하며, 이후 자격 증명이 저장된다. 환경 변수 ANTHROPIC_API_KEY가 설정되어 있고 이를 승인하면 로그인 단계는 건너뛴다. Console 계정에서는 비용 추적을 위한 "Claude Code" 워크스페이스가 자동으로 만들어진다.

먼저 간단한 질문으로 시작해 본다. 예를 들면 다음과 같다.

what does this project do?

그다음에는 작은 변경을 해 본다. Claude Code는 수정 내용을 보여 주고, 세션의 권한 모드에 따라 승인을 요청한다. Shift+Tab으로 모드를 순환할 수 있다.

add a hello world function to the main file

Anthropic 퀵스타트의 핵심 명령은 다음과 같다.

• claude "task"는 초기 프롬프트와 함께 세션을 시작한다(예: claude "fix the build error"). claude -p "query"는 한 번 답하고 종료한다.
• claude -c는 현재 디렉터리의 가장 최근 대화를 이어 가고, claude -r는 이전 대화를 골라 이어 갈 수 있다.
• 세션 안에서: /help는 명령 목록을, /resume은 대화 재개를, /login은 계정 전환을, /clear는 기록 삭제를 하고, /exit(또는 Ctrl+D 두 번)로 종료한다.

비용과 요금제

Claude Code는 Claude의 유료 요금제에 포함된다(Anthropic, 확인일: 2026-10-20).

• Pro: 연간 결제 시 월 $17(선결제 $200), 월 결제 시 $20.
• Max: 월 $100부터, Pro 사용량의 5배 또는 20배.
• Team: 표준 좌석은 연간 결제 시 월 $20(월 결제 $25), Premium 좌석은 $100(월 결제 $125)이며 2명에서 150명 대상.
• Enterprise: 연간 결제 시 좌석당 월 $20에 API 요율의 사용량을 더하며, 최소 20좌석.

Console 계정에서는 사용량이 토큰 단위로 과금된다. Anthropic은 엔터프라이즈 배포 전반에서 평균 비용이 개발자 1명이 활동한 날 하루 약 13달러, 개발자당 월 150달러에서 250달러이며 사용자의 90%는 활동한 날 하루 30달러 미만이라고 밝힌다(Anthropic). /usage 명령은 세션의 사용량을 보여 주며, Pro와 Max 구독자의 사용량은 요금제에 포함된다. 이 요금제를 다른 에이전트와 비교하려면 예산에 맞는 코딩 에이전트 고르기 가이드를 참고하라.

Claude Code를 IDE와 연동하기

VS Code와 Cursor: 공식 확장은 VS Code 1.94.0 이상과 유료 Claude 또는 Console 계정이 필요하며 API 키는 필요 없다(Anthropic). 확장 보기(Mac은 Cmd+Shift+X, Windows와 Linux는 Ctrl+Shift+X)를 열고 "Claude Code"를 검색해 설치한다. 확장에는 CLI 사본이 포함되어 있으며, 통합 터미널에서 claude를 실행하려면 CLI도 따로 설치해야 한다. 다른 VS Code 포크(Devin Desktop, Kiro)는 Open VSX 레지스트리를 쓴다.

JetBrains(IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand): 플러그인에는 CLI가 포함되어 있지 않다. 먼저 CLI를 설치한 뒤 JetBrains Marketplace에서 Claude Code 플러그인을 설치하고 IDE를 다시 시작한다(Anthropic). 통합 터미널에서 claude를 실행하거나, 외부 터미널에서 시작한 세션에서 /ide를 입력한다. Cmd+Esc(Mac) 또는 Ctrl+Esc(Windows와 Linux)로 에디터에서 Claude Code를 연다.

업데이트와 제거

네이티브 설치는 스스로 업데이트된다. 바로 업데이트하려면 다음을 실행한다.

claude update

Homebrew는 brew upgrade claude-code, WinGet은 winget upgrade Anthropic.ClaudeCode를 쓴다. macOS, Linux, WSL에서 네이티브 설치를 제거하려면 다음을 실행한다.

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

더 알아보기

• Claude Code를 도구에 연결하기: MCP 서버 설정 방법.
• 비교: Claude Code, Codex, GitHub Copilot, Claude Code vs Codex, Claude Code 대안.
• 용어: 용어집의 코딩 에이전트와 컨텍스트 윈도우.

출처

• Claude Code Docs: Advanced setup, 확인일: 2026-10-20
• Claude Code Docs: Quickstart, 확인일: 2026-10-20
• Claude Code Docs: Manage costs effectively, 확인일: 2026-10-20
• Claude Code Docs: Use Claude Code in VS Code, 확인일: 2026-10-20
• Claude Code Docs: JetBrains IDEs, 확인일: 2026-10-20
• Anthropic: Claude pricing, 확인일: 2026-10-20

핵심 요약: Claude Code는 macOS, Linux, Windows에서 명령 하나로 설치되지만 유료 Claude 요금제 또는 Console 계정이 필요하다. VS Code 확장에는 CLI가 포함되고 JetBrains 플러그인에는 포함되지 않는다.

이 기사에서 오류를 발견하셨나요? 제보하기 · 정정 정책