Claude Code 설치 튜토리얼 (Mac & Windows)

터미널에서 AI 페어 프로그래밍을 시작해봅시다. 이 글에서는 macOS와 Windows에 Claude Code를 설치하고 첫 세션을 실행하는 방법까지 단계별로 정리했습니다.

Claude Code는 Anthropic이 만든 공식 CLI(명령줄) 코딩 에이전트입니다. 터미널에서 자연어로 명령을 내리면 코드를 읽고, 수정하고, 테스트를 실행하고, Git 작업까지 대신 해줍니다.

---

1. 설치 전 준비 (시스템 요구사항)

설치하기 전에 내 컴퓨터가 아래 조건을 만족하는지 확인하세요.

⚠️ 주의: 무료 Claude.ai 플랜으로는 Claude Code를 사용할 수 없습니다. 유료 구독(Pro/Max 등) 또는 API 크레딧이 있는 Console 계정이 필요합니다.

---

2. macOS에 설치하기

방법 1: 네이티브 설치 (권장)

터미널(Terminal) 앱을 열고 아래 명령어를 붙여넣은 뒤 실행하세요.

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

네이티브 설치 방식은 백그라운드에서 자동으로 최신 버전으로 업데이트되므로 가장 편리합니다.

방법 2: Homebrew 사용

이미 Homebrew를 쓰고 있다면 아래 명령어로 설치할 수 있습니다.

복사
brew install --cask claude-code

💡 Homebrew로 설치하면 자동 업데이트가 되지 않습니다. 업데이트하려면 brew upgrade claude-code를 직접 실행하세요.

---

3. Windows에 설치하기

Windows에서는 사용 중인 터미널 종류에 따라 명령어가 다릅니다.

프롬프트가 PS C:\ 로 시작하면 PowerShell, C:\ 로만 시작하면 CMD입니다.

방법 1: 네이티브 설치 (권장)

PowerShell에서:

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

**CMD(명령 프롬프트)**에서:

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

관리자 권한(Administrator)으로 실행할 필요는 없습니다.

방법 2: WinGet 사용

Windows 패키지 관리자 WinGet을 쓴다면:

복사
winget install Anthropic.ClaudeCode

💡 WinGet으로 설치하면 자동 업데이트가 되지 않습니다. winget upgrade Anthropic.ClaudeCode로 직접 업데이트하세요.

💡 Git for Windows 설치 권장

Windows 네이티브 환경에서는 Git for Windows를 함께 설치하는 것을 권장합니다. Git Bash가 있으면 Claude Code가 Bash 도구를 사용할 수 있어 더 많은 기능을 활용할 수 있습니다. (설치하지 않으면 PowerShell을 셸 도구로 사용합니다.)

자주 만나는 오류

• The token '&&' is not a valid statement separator → CMD가 아니라 PowerShell에 있는 것입니다. PowerShell용 명령어(irm ...)를 쓰세요.
• 'irm' is not recognized as an internal or external command → PowerShell이 아니라 CMD에 있는 것입니다. CMD용 명령어를 쓰세요.

---

4. 설치 확인

설치가 끝나면 새 터미널을 열고 버전을 확인해 정상 설치 여부를 점검합니다.

복사
claude --version

더 자세한 진단을 원하면 아래 명령어를 실행하세요. 설치 상태와 설정을 점검해줍니다.

복사
claude doctor

command not found 같은 오류가 난다면 터미널을 완전히 닫았다가 다시 열어보세요.

---

5. 로그인 (인증)

작업할 프로젝트 폴더에서 claude 명령으로 Claude Code를 실행하면, 처음 실행 시 로그인 안내가 나타납니다.

복사
claude

화면 안내에 따라 브라우저에서 로그인을 완료하면 됩니다. 다음 계정 중 하나로 로그인할 수 있습니다.

• Claude Pro / Max / Team / Enterprise 구독 (권장)
• Claude Console (선불 크레딧 기반 API 계정)
• Amazon Bedrock / Google Vertex AI / Microsoft Foundry (엔터프라이즈 클라우드)

한 번 로그인하면 인증 정보가 저장되어 다시 로그인할 필요가 없습니다. 나중에 계정을 바꾸려면 세션 안에서 /login을 입력하세요.

---

6. 첫 세션 시작하기

작업하려는 프로젝트 폴더로 이동한 뒤 claude를 실행합니다.

복사
cd /path/to/your/project
claude

실행되면 현재 버전, 모델, 작업 디렉터리가 표시된 프롬프트가 나타납니다. 이제 자연어로 대화하듯 명령을 내려보세요.

복사
이 프로젝트가 무슨 일을 하는지 설명해줘

복사
main 파일에 hello world 함수를 추가해줘

Claude Code는 파일을 수정하기 전에 항상 변경 내용을 보여주고 승인을 요청합니다. 안심하고 사용하세요.

---

7. 꼭 알아두면 좋은 명령어

셸 명령어 (터미널에서 실행)

세션 명령어 (Claude Code 실행 중에 입력)

💡 초보자 팁

• / 를 입력하면 모든 명령어와 스킬 목록이 나옵니다.
• Tab 키로 명령어 자동완성, ↑ 키로 이전 명령 기록을 불러올 수 있습니다.
• Shift+Tab 으로 권한 모드를 전환할 수 있습니다.

---

8. 업데이트와 제거

업데이트

• 네이티브 설치: 백그라운드 자동 업데이트. 즉시 업데이트하려면 claude update
• Homebrew: brew upgrade claude-code
• WinGet: winget upgrade Anthropic.ClaudeCode

제거 (네이티브 설치 기준)

macOS:

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

Windows (PowerShell):

복사
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

---

마치며

이제 Claude Code 설치가 모두 끝났습니다! 터미널에서 claude를 실행하고, 평소 동료에게 부탁하듯 자연어로 작업을 요청해보세요. 코드 분석, 버그 수정, 리팩토링, 테스트 작성, Git 커밋까지 — 대부분의 개발 작업을 함께 처리할 수 있습니다.

더 자세한 내용은 Claude Code 공식 문서를 참고하세요.

---

이 글은 Anthropic 공식 문서(2026년 6월 기준)를 바탕으로 작성되었습니다.

특정 폴더를 만들고 이 폴더안에서 claude를 실행한다. 다음과 같이 폴더를 신뢰하냐는 질문이 나오면 1번을 선택하고 엔터를 입력한다.

복사
 Security guide

 ❯ 1. Yes, I trust this folder
   2. No, exit

클로드에서 어떤 작업을 시키면 , 특정 명령이나 폴더를 사용할 때 다음과 같이 물어볼 수 있다. 그러면 1번이나 2번을 한다.

복사
 Do you want to allow Claude to fetch this content?
   1. Yes
 > 2. Yes, and don't ask again for docs.anthropic.com
   3. No, and tell Claude what to do differently (esc)

이게 귀찮으면 shift+tab 을 눌러서 auto mode를 선택하는 것이 편하다.

auto mode로 하면 문제가 될만하지 않으면 다 자동으로 yes처리 된다.

---

복사
claude code의 status bar에 현재 폴더 정보, git 브랜치 정보 등을 보여지도록 설정해주세요. claude code 상태 표시줄에, 현재시간, 현재 작업폴더 등 다양한 정보가 잘 보여지도록 설정해주세요.