윈도우든 맥이든 명령어 한 줄로 설치
설치부터 첫 실행 · 로그인까지 단계별로 안내합니다
클로드코드는 Claude.ai 구독이 있어야 사용 가능합니다
구독을 마친 뒤 본인 OS에 맞는 설치 단계로 이동하세요
아래 사이트에 접속해서 회원가입을 진행하세요:
https://claude.ai또는 바로 이동 — claude.ai
클로드코드는 Pro 요금제부터 사용 가능합니다. (무료 플랜으로는 사용 불가)
처음에는 Pro로 가볍게 시작하세요
입문자라면 Pro 요금제로 시작하는 것을 추천합니다 — 부담 없이 클로드코드의 기본 기능을 충분히 익힐 수 있습니다
다만 클로드코드에 익숙해지고 웹·앱 개발 · 자동화 · 다양한 프로젝트로 사용 범위가 넓어지면 토큰 한계가 빠르게 다가옵니다 — 그때는 Max 요금제 ($100)로 자연스럽게 옮겨가게 됩니다
가볍게 알고 시작하시되, 부담은 없이 Pro부터 진행하시면 됩니다
API 키 로그인은 피하세요
설치 후 로그인 메뉴에 API 키(API Key)로 로그인하는 옵션이 보입니다. 하지만 이건 사용량(토큰) 기반 과금 방식이라 자주 쓰는 경우 구독 요금제보다 훨씬 비싸게 나옵니다
일반 사용자는 Pro / Max 구독 요금제로 로그인을 강력히 추천합니다
윈도우와 맥은 설치 명령어가 다릅니다
본인 환경에 맞는 카드로 이동하세요
Git 설치부터 첫 로그인까지 차근차근
Windows PowerShell 기준
4단계만 따라하면 끝납니다
클로드코드는 Git이 반드시 먼저 설치되어 있어야 합니다.
https://git-scm.com/downloads/winPowerShell 입력관리자 권한으로 오픈을 추천합니다
각자 PC 환경이 매우 다르기 때문에, 가급적 대부분의 PC 환경에서 이슈가 없도록 하기 위함입니다
아래 명령어를 PowerShell에 복붙하고 Enter:
irm https://claude.ai/install.ps1 | iex설치가 자동으로 진행됩니다. 완료될 때까지 기다려주세요.
'irm' is not recognized 오류가 나오면
PowerShell이 아니라 명령프롬프트 터미널(CMD) 창이어서 그럴 수 있습니다
반드시 Windows PowerShell로 다시 열어주세요 (PowerShell 창 제목줄에는 PS C:\로 표시됩니다)
claude처음 실행하면 로그인 화면이 나옵니다. 위에서 가입한 Claude.ai 계정(Pro · Max · Team · Enterprise)으로 로그인하면 됩니다.
로그인 후에는 매번 로그인할 필요 없이 바로 사용 가능합니다.
iTerm2 열기 → 명령어 한 줄 → 로그인
iTerm2 기준
3단계만 따라하면 됩니다
Spotlight(⌘ + Space) → iterm 입력 → Enter
iTerm2가 없다면
다음 사이트에서 무료 다운로드 후 설치 — iterm2.com
아래 명령어를 iTerm2에 복붙하고 Enter:
curl -fsSL https://claude.ai/install.sh | bash설치 중 주의사항
• 맥 비밀번호 입력 요청이 오면 입력하세요 (입력해도 화면에 안 보이는 게 정상)
• 설치에 수 분이 걸릴 수 있습니다. 기다려 주세요
• 중간에 Xcode Command Line Tools 설치 팝업이 뜨면 설치 버튼 클릭 (Git이 함께 설치됩니다)
claude처음 실행하면 로그인 화면이 나옵니다. 위에서 가입한 Claude.ai 계정(Pro · Max · Team · Enterprise)으로 로그인하면 됩니다.
로그인 후에는 매번 로그인할 필요 없이 바로 사용 가능합니다.
윈도우든 맥이든
동일한 명령어로 사용합니다
| 명령어 | 설명 |
|---|---|
claude |
클로드코드 시작 |
/exit |
클로드코드 종료 |
윈도우는 PowerShell과 명령프롬프트(CMD)가 둘 다 있는데, 클로드코드 설치 명령어(irm)는 PowerShell 전용입니다. 창 제목에 PS C:\가 보이면 PowerShell이 맞습니다
설치 중 비밀번호 입력 요청이 나올 때 입력해도 화면에 안 보이는 게 정상입니다. 그냥 입력하고 Enter
맥에서 설치 중 자동으로 뜰 수 있습니다. 설치 버튼을 누르면 Git이 함께 설치되니 안심하고 진행하세요
윈도우는 PC 환경이 매우 다양하기 때문에 관리자 권한으로 실행하면 환경 이슈를 줄일 수 있습니다. 검색 결과에서 마우스 오른쪽 클릭 → "관리자 권한으로 실행"
API 키 방식은 사용량 기반 과금이라 자주 쓰면 구독제보다 훨씬 비싸집니다. Claude.ai의 Pro · Max 구독으로 로그인하세요
인터넷 환경에 따라 수 분 정도 걸릴 수 있습니다. 그 이상 진행이 안 되면 터미널을 닫고 다시 열어 명령어를 재실행하거나, 인터넷 연결을 확인해 주세요
"이런것도 됩니다"
클로드코드에게 한국 사용자 친화적인 iTerm2 설정을 맡기는 방법
iTerm2에서 아래 명령어로 실행하세요. 설정 자동화를 위해 권한을 자동 허용하는 옵션입니다:
claude --dangerously-skip-permissions아래 프롬프트를 복사해서 클로드코드에 붙여넣고 Enter:
iTerm2 처음 설치했는데, 한국 사용자가 선호하는 주요 설정을 알아서 해줘
정확히 확인해서, 최신 iTerm2 에서 지원하는 설정인지 확인 후, 필요한 주요 설정해줘클로드코드가 iTerm2 설정 파일을 검토하고 한국 사용자에게 적합한 설정(폰트·색상·단축키 등)을 자동으로 적용합니다.
설정이 끝나면 iTerm2를 완전히 종료(⌘ + Q)한 뒤 다시 실행하세요. 새 설정이 적용된 상태로 열립니다.
claude새 iTerm2를 사용해보면서 불편한 점이 있으면 카톡처럼 가볍게 이야기해 보세요. 예를 들어:
클로드코드가 알아서 다듬어 줍니다.
--dangerously-skip-permissions 옵션 주의
이 옵션은 클로드코드가 모든 명령을 묻지 않고 실행합니다. 이번처럼 본인 PC 설정을 맡기는 신뢰 가능한 작업에만 사용하세요
일반 작업에서는 그냥 claude로 실행해서, 작업마다 묻고 진행하는 게 안전합니다
처음하는 클로드코드 Part2 · 설치 비주얼 가이드
Windows PowerShell · macOS iTerm2 기준