Claude Code 설치 방법 가이드 2026 — Mac·Windows·Linux 전부 정리
Claude Code 설치 방법을 처음부터 끝까지 헷갈리지 않게 정리했습니다. Mac, Windows, Linux 운영체제별 명령어와 로그인·첫 실행까지 단계별로 따라오시면 5분 안에 바로 사용할 수 있습니다.
Claude Code 설치 전 꼭 확인할 것
Claude Code를 설치하기 전에 세 가지를 먼저 점검하세요.
첫째, 터미널(명령 프롬프트) 이 필요합니다. Mac은 ‘터미널’, Windows는 ‘PowerShell’ 또는 ‘CMD’를 사용합니다. 터미널을 처음 열어보는 분이라면 이름만 보고 겁먹지 않아도 됩니다. 명령어 한 줄 복붙하는 것이 전부입니다.
둘째, 작업할 코드 프로젝트 가 있어야 합니다. 빈 폴더라도 괜찮습니다.
셋째, Claude 계정 이 필요합니다. Pro, Max, Team, Enterprise 플랜 중 하나이거나, Anthropic Console 계정(API 크레딧 선불)이 있으면 됩니다. Amazon Bedrock, Google Vertex AI, Microsoft Foundry를 통한 기업용 접근도 지원됩니다.
Claude Code 설치 방법 — 운영체제별 명령어
Mac / Linux / WSL 설치
터미널을 열고 아래 명령어 한 줄을 붙여넣은 뒤 Enter를 누르세요.
curl -fsSL https://claude.ai/install.sh | bash
설치가 완료되면 자동으로 최신 버전으로 업데이트됩니다. 별도로 업데이트 명령을 입력할 필요가 없습니다.
Homebrew를 사용하는 Mac 사용자라면 아래 방법도 가능합니다.
brew install --cask claude-code
Homebrew로 설치하면 자동 업데이트가 되지 않습니다. 새 버전을 받으려면 주기적으로 brew upgrade claude-code를 실행해야 합니다.
Windows PowerShell 설치
PowerShell을 열고 아래 명령어를 실행하세요. 프롬프트에 PS C:\가 보이면 PowerShell입니다.
irm https://claude.ai/install.ps1 | iex
Windows CMD 설치
CMD(명령 프롬프트)를 열고 아래 명령어를 실행하세요. 프롬프트에 C:\만 보이면 CMD입니다.
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
잠깐!
&&가 “올바른 문 구분자가 아닙니다”라는 오류가 뜨면 지금 PowerShell에 있는 겁니다. 반대로irm을 인식 못 한다고 뜨면 CMD에 있는 겁니다. 창 제목이나 프롬프트 모양으로 구분하세요.
WinGet으로 설치 (Windows)
Microsoft Store 방식의 패키지 관리자를 선호하는 분은 아래 명령어를 사용하세요.
winget install Anthropic.ClaudeCode
WinGet도 자동 업데이트가 되지 않으므로 winget upgrade Anthropic.ClaudeCode로 수동 업데이트해야 합니다.
Linux 패키지 매니저 설치
Debian, Fedora, RHEL, Alpine 계열 리눅스는 apt, dnf, apk를 통한 설치도 지원합니다. 자세한 내용은 공식 문서의 Linux 패키지 매니저 섹션을 참고하세요.
설치 후 로그인하는 방법
설치가 끝났다면 계정 연결이 필요합니다. 터미널에 아래 명령어를 입력해 Claude Code 대화형 세션을 시작하세요.
claude
처음 실행하면 자동으로 로그인 안내가 표시됩니다. 이미 세션이 열려 있다면 /login 명령으로 로그인 화면을 불러올 수 있습니다.
로그인에 성공하면 자격 증명이 시스템에 저장됩니다. 다음부터는 claude 명령만 입력해도 바로 시작됩니다. 계정을 바꾸고 싶을 때만 다시 /login을 입력하면 됩니다.
첫 번째 세션 시작하기
로그인까지 완료했다면 실제로 사용해볼 차례입니다. 작업하려는 프로젝트 폴더로 이동한 뒤 claude를 실행하세요.
cd /path/to/your/project
claude
환영 화면이 뜨면 성공입니다. 여기서 자연어로 질문을 입력하면 됩니다.
처음 해볼 수 있는 질문 예시
| 목적 | 입력 예시 |
|---|---|
| 프로젝트 파악 | 이 프로젝트는 무엇을 하나요? |
| 폴더 구조 이해 | 폴더 구조를 설명해주세요 |
| 기능 추가 | 주 파일에 hello world 함수 추가 |
| 버그 수정 | 사용자가 빈 양식을 제출할 수 있는 버그 수정 |
| 커밋 | 설명적인 메시지로 변경 사항 커밋 |
Claude Code는 파일 수정 전에 반드시 승인을 요청합니다. 처음에는 변경 사항 하나하나를 확인하고, 익숙해지면 “모두 수락” 모드를 사용하면 됩니다.
자주 쓰는 핵심 명령어 한눈에 보기
Claude Code를 처음 쓸 때 알아두면 좋은 명령어를 정리했습니다.
| 명령어 | 기능 |
|---|---|
claude | 대화형 모드 시작 |
claude "task" | 일회성 작업 바로 실행 |
claude -p "query" | 질문 후 바로 종료 |
claude -c | 가장 최근 대화 이어서 시작 |
claude -r | 이전 대화 목록에서 선택해 재개 |
/clear | 현재 대화 기록 초기화 |
/help | 사용 가능한 명령어 전체 보기 |
exit 또는 Ctrl+D | Claude Code 종료 |
Claude Code 설치 방법 요약
Claude Code 설치는 세 단계로 끝납니다.
- 운영체제에 맞는 명령어 한 줄 실행 → 설치 완료
claude입력 후 계정 로그인- 프로젝트 폴더에서
claude실행 → 바로 사용
터미널이 낯설어도 명령어를 복붙하는 것만으로 설치가 가능합니다. 설치 후에는 자연어로 대화하듯 입력하면 Claude가 코드를 분석하고 수정까지 직접 처리해줍니다. 코드 작업 흐름을 크게 바꿔줄 도구이니, 오늘 바로 설치해서 직접 써보시길 추천합니다.
