CLAUDE 설치 및 사용
Claude Code 설치 튜토리얼 (Mac & Windows)
터미널에서 AI 페어 프로그래밍을 시작해봅시다. 이 글에서는 macOS와 Windows에 Claude Code를 설치하고 첫 세션을 실행하는 방법까지 단계별로 정리했습니다.
Claude Code는 Anthropic이 만든 공식 CLI(명령줄) 코딩 에이전트입니다. 터미널에서 자연어로 명령을 내리면 코드를 읽고, 수정하고, 테스트를 실행하고, Git 작업까지 대신 해줍니다.
1. 설치 전 준비 (시스템 요구사항)
설치하기 전에 내 컴퓨터가 아래 조건을 만족하는지 확인하세요.
| 항목 | 요구사항 |
|---|---|
| 운영체제 | macOS 13.0 이상 / Windows 10 (1809 빌드 이상) 또는 Windows Server 2019 이상 |
| 하드웨어 | RAM 4GB 이상, x64 또는 ARM64 프로세서 |
| 네트워크 | 인터넷 연결 필수 |
| 셸(Shell) | macOS: Bash, Zsh / Windows: PowerShell, CMD |
| 계정 | Claude Pro, Max, Team, Enterprise 구독 또는 Console(API) 계정 |
⚠️ 주의: 무료 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 | 대화형 모드 시작 |
claude "작업내용" | 한 번에 작업 실행 |
claude -p "질문" | 한 번 질문하고 바로 종료 |
claude -c | 현재 폴더의 가장 최근 대화 이어가기 |
claude -r | 이전 대화 목록에서 선택해 재개 |
세션 명령어 (Claude Code 실행 중에 입력)
| 명령어 | 설명 |
|---|---|
/help | 사용 가능한 명령어 보기 |
/clear | 대화 기록 초기화 |
/login | 계정 재로그인 / 전환 |
/exit 또는 Ctrl+D | 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 상태 표시줄에, 현재시간, 현재 작업폴더 등 다양한 정보가 잘 보여졌으면 합니다.
댓글
댓글을 작성하려면 이 필요합니다.