클로드 코드 설치 방법과 기본 사용법 (2026년 10월 기준)

클로드 코드 설치는 터미널에 공식 설치 명령 한 줄을 붙여 넣고, claude를 실행해 로그인하면 끝납니다. 단, 무료 Claude 계정으로는 쓸 수 없고 유료 요금제나 Console 계정이 필요합니다.

이 글은 AI(Claude)가 Anthropic 공식 Claude Code 문서와 claude.com 가격 페이지를 확인해 작성했습니다. 확인일: 2026년 10월 7일. 가격과 한도는 바뀔 수 있으니 결제 전에 공식 화면을 다시 확인하세요.

2026년 10월 7일 기준으로 공식 문서에 적힌 내용만 순서대로 정리했습니다. 설치 명령은 운영체제마다 다르므로 본인 환경에 맞는 줄만 따라 하면 됩니다.

클로드 코드 설치 전에 필요한 것은?

공식 문서의 시작하기 페이지는 준비물로 터미널(명령 프롬프트), 작업할 코드 프로젝트, 그리고 계정을 꼽습니다. 계정은 Claude 구독(Pro, Max, Team, Enterprise)이나 Claude Console 계정, 또는 지원되는 클라우드 제공업체를 통한 접근 중 하나여야 합니다. 설치 페이지에는 "무료 claude.ai 플랜은 Claude Code 접근을 포함하지 않는다"고 적혀 있습니다.

claude.com 가격 페이지에서 확인한 요금제별 표기는 아래와 같습니다. 금액은 페이지에 표시된 달러 기준이며, 환율·부가세·최종 금액은 결제 화면에서 확인하세요.

요금제	표시된 가격	클로드 코드
Free	무료	포함되지 않음
Pro	월 $17(연간 결제 시), 월 $20	포함
Max	월 $100부터	포함
Team	좌석당 월 $20(연간 결제 시), 월 $25	포함
Enterprise	좌석당 월 $20(연간 결제) + API 요금 기준 사용량 비용	Team 기능 포함

요금제별 사용량 한도는 이번에 공식 문서로 확인하지 못해 적지 않습니다. 무료와 유료 차이는 앞서 올린 클로드 무료 사용량 한도와 유료 차이 글을 참고하세요.

시스템 요구 사항은 다음과 같습니다.

• 운영체제: macOS 13.0 이상, Windows 10 1809 이상 또는 Windows Server 2019 이상, Ubuntu 20.04 이상, Debian 10 이상, Alpine Linux 3.19 이상
• 하드웨어: RAM 4GB 이상, x64 또는 ARM64 프로세서
• 인터넷 연결 필수, Anthropic 지원 국가에서 사용

운영체제별 클로드 코드 설치 방법

공식 문서가 "권장"으로 안내하는 방식은 네이티브 설치입니다. 아래 순서대로 진행하세요.

1. 터미널을 엽니다. macOS는 터미널 앱, Windows는 PowerShell이나 명령 프롬프트(CMD)입니다.
2. 환경에 맞는 명령을 한 줄 붙여 넣고 실행합니다.
3. 설치가 끝나면 터미널을 새로 열고 claude --version을 입력해 버전이 나오는지 확인합니다.

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

네이티브 설치는 백그라운드에서 자동으로 업데이트됩니다. 다른 방법도 문서에 있습니다.

• Homebrew(macOS): brew install --cask claude-code. 이 방식은 자동 업데이트가 되지 않아 brew upgrade claude-code로 직접 올려야 합니다.
• WinGet(Windows): winget install Anthropic.ClaudeCode. 마찬가지로 winget upgrade Anthropic.ClaudeCode로 직접 업데이트합니다.
• npm: npm install -g @anthropic-ai/claude-code. Node.js 22 이상이 필요하다고 안내되며, sudo npm install -g는 쓰지 말라고 경고합니다.
• Debian·Fedora·RHEL·Alpine은 apt, dnf, apk 저장소로도 설치할 수 있습니다.

Windows는 Git for Windows가 없어도 설치됩니다. 문서에 따르면 Git이 없으면 PowerShell 도구로 명령을 실행하고, 있으면 Git Bash를 씁니다. WSL에서 쓸 때는 PowerShell이 아니라 WSL 터미널 안에서 리눅스용 명령을 실행해야 합니다.

클로드 코드 로그인과 첫 실행은 어떻게 하나요?

설치가 끝났다면 작업할 프로젝트 폴더로 이동해서 claude를 실행합니다.

cd /path/to/your/project
claude

처음 실행하면 로그인 안내가 나옵니다. 구독 계정이나 Console 계정은 안내에 따라 브라우저에서 인증하면 됩니다. ANTHROPIC_API_KEY 환경 변수를 설정해 두었다면 로그인 대신 해당 키를 승인할지 묻습니다. 계정을 바꾸거나 다시 인증할 때는 세션 안에서 /login을 입력합니다. 한 번 로그인하면 자격 증명이 저장되어 다시 로그인하지 않아도 된다고 문서에 적혀 있습니다.

로그인 후 첫 질문으로는 문서가 예시로 든 아래 문장이 무난합니다.

what does this project do?

프로젝트 파일을 읽고 요약해 줍니다. 파일을 수정할 때 승인 여부를 묻는지는 권한 모드에 따라 다릅니다. 공식 시작하기 문서에 따르면 Claude Code v2.1.283 이상에서는 대화형 터미널 세션의 기본 시작 권한 모드가 자동 모드여서, 분류기가 동작을 검토하고 대부분의 파일 수정과 명령 실행이 묻지 않고 진행될 수 있습니다. 설정이나 조직 정책으로 다른 모드가 기본일 수도 있으니, 세션 중 Shift+Tab을 눌러 권한 모드를 바꾸고 현재 모드를 확인하세요.

클로드 코드 사용법: 자주 쓰는 기본 명령

공식 문서의 "Essential commands" 표를 기준으로 정리했습니다. 터미널에서 입력하는 명령과 세션 안에서 입력하는 명령이 다릅니다.

터미널에서 입력하는 명령:

명령	하는 일
claude	대화형 모드 시작
claude "task"	첫 요청을 넣고 대화형 모드 시작
claude -p "query"	한 번만 질문하고 종료
claude -c	현재 폴더의 가장 최근 대화 이어가기
claude -r	이전 대화 선택해 다시 열기

세션 안에서 입력하는 명령:

명령	하는 일
/help	사용할 수 있는 명령 보기
/clear	대화 기록 지우기
/exit	종료(Ctrl+D 두 번도 가능)
/login	계정 전환·재인증

요청은 구체적일수록 좋다고 문서가 조언합니다. "버그 고쳐줘"보다 "잘못된 비밀번호를 입력하면 빈 화면이 나오는 로그인 버그를 고쳐줘"처럼 쓰라는 예시가 있습니다. /를 입력하면 쓸 수 있는 명령 목록이 보이고, Tab으로 자동 완성, ↑로 이전 입력을 불러올 수 있습니다.

클로드 코드 설치할 때 막히기 쉬운 점

설치 문서에 직접 언급된 오류와 해결 방향을 모았습니다.

1. claude를 찾을 수 없다고 나올 때: 설치 폴더가 PATH에 아직 없다는 뜻입니다. 터미널을 새로 열고 다시 시도하고, 그래도 안 되면 공식 문서의 PATH 수정 안내를 따릅니다.
2. PowerShell에서 아래 오류가 나올 때: CMD용 명령을 PowerShell에 붙여 넣은 경우입니다.

The token '&&' is not a valid statement separator

1. CMD에서 아래 오류가 나올 때: PowerShell용 명령을 CMD에 붙여 넣은 경우입니다. 프롬프트에 PS C:\가 보이면 PowerShell, PS 없이 C:\이면 CMD입니다.

'irm' is not recognized as an internal or external command

1. 설치 명령이 syntax error near unexpected token '<', 403 등 curl 오류로 실패할 때: 공식 설치 문제 해결 페이지에서 오류별 해결책과 대체 설치 방법을 확인합니다.
2. Alpine Linux: 기본으로 bash와 curl이 없어 설치 명령이 실패할 수 있습니다. 문서는 아래 패키지를 먼저 설치하라고 안내합니다.

apk add bash curl libgcc libstdc++ ripgrep

문서는 이어서 settings.json의 env에 USE_BUILTIN_RIPGREP을 0으로 설정하라고도 안내합니다.

설치 상태를 더 자세히 보려면 claude doctor를 실행합니다. 설치 상태와 설정 파일 오류를 진단해 주며 세션을 시작하지 않습니다. 수동으로 업데이트하려면 claude update를 씁니다.

확인한 자료와 주의할 점

확인일: 2026년 10월 7일. 아래 공식 페이지를 직접 열어 확인했습니다.

• Claude Code 고급 설정(설치): https://code.claude.com/docs/en/setup
• Claude Code 빠른 시작: https://code.claude.com/docs/en/quickstart
• Claude 요금제: https://claude.com/pricing

주의할 점은 다음과 같습니다.

• 가격과 포함 요금제는 바뀔 수 있습니다. 금액은 달러 표기 그대로이며 환산·부가세는 결제 화면에서 확인하세요.
• 요금제별 사용량 한도는 확인하지 못해 이 글에서 다루지 않았습니다.
• 설치 명령과 버전은 수시로 바뀝니다. 실행 전에 공식 설치 페이지의 최신 명령과 비교하세요.
• 인터넷에서 내려받은 스크립트를 바로 실행하는 방식이므로, 주소가 공식 문서에 적힌 것과 같은지 확인한 뒤 붙여 넣으세요.