[10분 설치] Claude Code 설치 방법: Windows·Mac 터미널 초보도 한 번에 (구독/SDK·API 키 주의)
영화 '매트릭스'에 나오는 해커들처럼 검은 화면(터미널)에 알 수 없는 영어를 타닥타닥 치는 모습, 한 번쯤 동경해 본 적 있으신가요? 최근 전 세계 개발자와 직장인들 사이에서 가장 뜨거운 Claude Code(클로드 코드)는 바로 그 검은 터미널 화면에서 작동하는 AI 코딩 에이전트입니다.
"저는 개발자가 아닌데 터미널을 어떻게 쓰나요?"라며 지레 겁먹을 필요는 없습니다. 터미널은 마우스 대신 키보드로 명령을 내리는 단순한 '텍스트 입력창'일 뿐입니다. 이 글에서는 초보자도 10분 안에 윈도우(Windows)와 맥(Mac)에 Claude Code를 안전하게 설치하고 첫 실행까지 끝낼 수 있도록, 공식 문서 흐름을 기준으로 가장 직관적인 설치 순서를 정리했습니다.
- 복잡한 사전 설치 없이 운영체제별 공식 설치 명령어 한 줄을 복사해서 붙여넣기만 하면 자동으로 설치됩니다.
- 설치가 끝난 후 터미널에
claude를 입력하면 첫 실행을 시작할 수 있습니다. - 계정/결제 안내: Claude Code는 보통 Claude 구독 플랜(Pro/Max/Teams/Enterprise)으로 사용하거나, API(Console) 키로도 사용할 수 있습니다. (작성 시점 기준)
- 회사 PC는 보안 정책 때문에 스크립트 실행/다운로드가 제한될 수 있습니다. 막히면 억지로 우회하지 말고 정책 확인이 먼저입니다.
- 설치 후 바로 안 된다고 판단하지 말고, 터미널을 완전히 닫고 다시 열어 PATH 반영부터 확인하세요.
- 문자/메일/광고 링크로 “설치 파일”을 받지 마세요. 공식 설치 명령어만 사용하세요.
※ “터미널 초보”라면, 본문 FAQ의 Q1~Q3을 먼저 읽고 따라오면 훨씬 쉽습니다.
1단계: 왜 Claude Code를 써야 할까? (웹 버전과의 차이)
웹 브라우저 안의 클로드(claude.ai)나 챗GPT는 보통 내가 파일을 업로드하고, 결과를 다시 복사해 붙여넣는 방식으로 사용합니다.
반면 Claude Code는 로컬(내 컴퓨터)에서 프로젝트 폴더를 기준으로 작업할 수 있어, 터미널에서 “현재 폴더의 파일을 요약해줘”, “에러 원인을 찾아줘” 같은 요청을 더 빠르게 이어갈 수 있습니다. (사용 환경/권한에 따라 가능한 범위는 달라질 수 있습니다.)
2단계: 설치 전 필수 요구사항 (PC & 계정 확인)
- 운영체제(OS): Windows / macOS 환경에서 설치 가능하며, 최신 업데이트 환경을 권장합니다.
- 윈도우 추가 요구사항: 윈도우에서는 Git for Windows가 필요할 수 있습니다. 설치되어 있지 않다면 먼저 설치하세요.
- 계정 준비: 일반적으로 Claude 구독 플랜으로 로그인해 사용하거나, 개발자라면 API 키(ANTHROPIC_API_KEY) 방식으로도 사용할 수 있습니다.
3단계: 맥(Mac)에서 설치하기
- 스포트라이트(
Cmd + Space) → Terminal 실행 - 아래 명령어를 복사해 붙여넣고 엔터를 누릅니다.
curl -fsSL https://claude.ai/install.sh | bash
※ 설치 중 관리자 비밀번호(맥 로그인 암호)를 물어보면 입력해 주세요.
4단계: 윈도우(Windows) PowerShell에서 설치하기
- 시작 메뉴 검색 → PowerShell 실행
- 아래 명령어를 복사해 붙여넣고 엔터를 누릅니다.
irm https://claude.ai/install.ps1 | iex
5단계: 첫 실행 (구독 로그인 vs API 키 방식)
설치가 끝나면 터미널에서 아래처럼 실행해 보세요.
- 터미널(또는 PowerShell)에서
claude입력 후 엔터 - 구독(Claude Pro/Max 등)로 쓰는 경우: 브라우저가 열리며 로그인/승인 화면이 나올 수 있습니다. 안내에 따라 로그인 후 돌아오면 됩니다.
- API(Console)로 쓰는 경우: 보통은 API 키(ANTHROPIC_API_KEY)를 환경변수로 설정한 뒤 사용합니다. (이 경우 사용량이 종량제(PAYG)로 과금될 수 있습니다.)
※ 만약 claude 입력 시 “명령어를 찾을 수 없음”이 뜨면, 터미널을 완전히 종료했다가 새로 열고 다시 시도해 보세요.
중요: API 과금 관련 주의사항
Claude Code를 구독으로 사용하려 했는데도, 내 컴퓨터에 ANTHROPIC_API_KEY가 이미 설정되어 있으면 구독 대신 API 키가 우선 인식되어 종량제(PAYG) 과금이 발생할 수 있습니다.
- 원치 않는 과금을 피하려면: 실행 전에 환경변수에 API 키가 등록되어 있는지 확인하고, 필요 없다면 제거/비활성화하세요.
- 개발자가 API로 쓰려면: 반대로 이 키가 정확히 설정되어 있어야 합니다.
- Windows/PowerShell:
echo $env:ANTHROPIC_API_KEY - macOS/Linux:
echo $ANTHROPIC_API_KEY
※ 값이 출력되면 “API 키가 잡혀 있는 상태”입니다. 구독 기반으로만 쓰려면 키를 제거/비활성화한 뒤 다시 실행하세요.
삭제/언인스톨: Claude Code를 깨끗하게 제거하는 법
설치가 꼬였거나, 회사 PC 정책 때문에 더 이상 사용하지 않기로 했을 때는 “대충 지우기”보다 설치 방식에 맞춰 깔끔하게 제거하는 것이 재설치/업데이트 문제를 막는 가장 좋은 방법입니다.
- 삭제 전에 먼저 중복 설치 여부를 확인하세요. (Windows:
where.exe claude/ Mac:which -a claude) - 중복 경로가 2개 이상 나오면, 한쪽만 지워서는 “명령어는 남아있는데 실행이 안 되는” 상태가 될 수 있습니다.
- 삭제 후에는 터미널을 완전히 종료 후 재실행해서 PATH 캐시를 리프레시하는 것이 안전합니다.
1) Mac: Homebrew로 설치한 경우 (권장 제거 루트)
brew uninstall --cask claude-code
※ 제거 후에도 claude가 살아있다면, 다른 방식(공식 스크립트 설치 등)으로 중복 설치된 가능성이 있으니 which -a claude로 경로를 확인하세요.
2) Windows: WinGet으로 설치한 경우 (권장 제거 루트)
winget uninstall Anthropic.ClaudeCode
※ 제거 후에도 “인식할 수 없음/경로 꼬임”이 남으면, PowerShell을 닫았다가 다시 열고 where.exe claude로 잔여 경로를 점검하세요.
3) Windows: 제어판/설정에서 제거 (일반 제거 루트)
- 경로: [설정] → [앱] → [설치된 앱]에서 Claude Code를 찾아 제거
- 제거 후 PC 재부팅 또는 터미널 재시작을 권장합니다.
4) “완전 초기화”가 필요할 때 (재설치 꼬임 방지)
삭제 후에도 실행이 꼬이거나 버전이 뒤섞인 느낌이라면, 아래 순서로 “완전 정리”를 한 뒤 재설치하는 것이 가장 빠릅니다.
- Claude Code 제거 (Homebrew/WinGet/앱 제거 중 설치 방식에 맞는 방법)
- 터미널 완전 종료 후 재실행
- 경로 점검: Windows는
where.exe claude, Mac은which -a claude - 경로가 더 이상 안 잡히면 정상 정리 완료 → 다시 “공식 설치 1줄”로 재설치
오늘의 체크리스트 (10분 세팅)
- ☐ (윈도우) Git for Windows 설치 여부 확인
- ☐ 운영체제에 맞는 설치 명령어 복사 → 터미널에 붙여넣기
- ☐
claude실행 - ☐ 구독 로그인 방식인지, API 키 방식인지 내 사용 경로를 확정
- ☐ (API 사용 시) 과금 방식(PAYG)과 키 관리 주의
- ☐ 필요 시, 설치 방식에 맞춰 깔끔하게 삭제(언인스톨) 절차까지 확인
자주 묻는 질문(FAQ) / 트러블슈팅
Q1. 터미널(검은 화면)을 태어나서 처음 써보는데 정말 괜찮을까요?
네, 걱정하지 마세요. Claude Code의 설치 명령어는 '복사해서 붙여넣기'만 하면 끝나는 자동화 스크립트입니다. 마우스 클릭 대신 엔터 키를 치는 것뿐이라고 생각하시면 쉽습니다. 본문에 안내된 claude 실행 후에는 평범한 챗봇처럼 대화로 명령을 내릴 수 있으니 겁먹지 말고 첫 명령어를 입력해 보세요.
Q2. 윈도우에서 설치 명령어를 쳤는데 아무 일도 안 일어나거나 에러가 떠요.
윈도우 사용자가 가장 먼저 확인해야 할 3가지는 다음과 같습니다.
- Git for Windows 설치: Claude Code가 내부적으로 파일을 추적하기 위해 꼭 필요합니다.
- 터미널 재시작: 설치 직후에는 윈도우가 경로를 인식하지 못할 수 있습니다. 파워쉘(PowerShell) 창을 완전히 닫았다가 다시 열어보세요.
- 관리자 권한: 파워쉘 아이콘을 우클릭하여 [관리자 권한으로 실행]한 뒤 명령어를 다시 시도해 보세요.
Q3. PowerShell 대신 명령 프롬프트(CMD)를 써도 되나요?
가능합니다. 다만 윈도우의 최신 표준은 PowerShell이며, 공식 설치 명령어(irm)도 PowerShell 기반으로 제작되었습니다. 굳이 CMD를 쓰셔야 한다면 npm 설치 방식을 이용해야 하는데, 이는 사전 준비 과정이 더 복잡하므로 초보자라면 본문에서 안내한 PowerShell 방식을 강력히 권장합니다.
Q4. 회사 PC인데 설치나 로그인이 막힙니다. 어떻게 하죠?
대부분의 회사는 보안상의 이유로 외부 스크립트 다운로드나 특정 포트 접근을 차단합니다. 사내 IT 정책을 우회하려고 시도하면 보안 위반으로 불이익을 받을 수 있으니, 먼저 IT 부서에 "AI 코딩 도구 사용이 가능한지" 확인하는 것이 우선입니다. 또한 프록시(Proxy) 환경인 경우 별도의 네트워크 설정이 필요할 수 있습니다.
Q5. 클로드와 대화하다가 멈추거나 끄고 싶을 땐 어떻게 하나요?
터미널에서 클로드의 동작을 강제로 멈추거나 대화를 종료하고 싶을 때는 키보드의 Ctrl + C를 누르시면 됩니다. 다시 실행하고 싶을 때는 언제든 claude를 입력하면 됩니다. 또한 /help를 입력하면 사용 가능한 모든 명령어 목록을 볼 수 있습니다.
Q6. 내 컴퓨터의 모든 파일이 Anthropic 서버로 전송되는 건가요?
아닙니다. Claude Code는 오직 현재 명령을 내린 폴더(작업 디렉터리) 내의 파일들만 읽습니다. 컴퓨터 전체를 훑는 방식이 아니니 안심하셔도 됩니다. 다만, 작업 중인 폴더 내에 민감한 개인 정보가 담긴 파일이 있다면 사전에 다른 곳으로 옮겨두는 것을 권장합니다.
Q7. 설치한 Claude Code는 어떻게 업데이트하나요?
본문의 Native Install 방식을 사용하셨다면, 업데이트는 매우 간단합니다. 터미널에서 claude update라고 입력하기만 하면 알아서 최신 버전으로 갱신됩니다. 수동으로 재설치할 필요가 없어 매우 편리합니다.
Q8. Claude 구독(Pro/Teams 등)을 쓰고 있는데도 API 요금이 나갈 수 있나요?
가능합니다. Claude Code는 로그인 방식과 환경 설정에 따라 구독 인증으로 동작할 수도 있고, 컴퓨터에 API 키(예: ANTHROPIC_API_KEY)가 설정되어 있으면 이를 우선적으로 사용해 종량제(API) 과금으로 동작할 수도 있습니다.
- 확인 방법: 터미널에서 환경변수에 API 키가 설정되어 있는지 점검합니다. (Windows/PowerShell:
echo $env:ANTHROPIC_API_KEY, macOS/Linux:echo $ANTHROPIC_API_KEY) - 요금 폭탄 방지: API 과금을 원치 않으면 해당 키를 제거/비활성화한 뒤 다시 실행하세요. 반대로 API를 쓰려면 Console(개발자) 결제/크레딧 상태를 확인해야 합니다.
※ 결제/과금 정책은 플랜 및 버전에 따라 바뀔 수 있으니, 사용 중인 계정의 결제 화면(구독/Console)을 한 번 확인하는 것이 가장 안전합니다.
Q9. 삭제(언인스톨) 후에도 claude가 계속 인식돼요. 왜 그런가요?
대부분 중복 설치 또는 PATH에 남아있는 다른 경로 때문입니다. Windows는 where.exe claude, Mac은 which -a claude로 경로가 몇 개 잡히는지 확인한 뒤, 남아있는 설치 경로의 설치 방식을 찾아 동일한 방식으로 제거하세요.
관련 글 (디지털 라이프 시리즈)
- [10분 해결] 포맷 없이 PC 속도 올리는 8단계 조치법
- [10분 세팅] 검색 스트레스 안녕! 개인·업무 공통 파일명 규칙 표준안
- [10분 세팅] 노션 초보 탈출! 복붙해서 바로 쓰는 필수 템플릿 3종
댓글
댓글 쓰기