내 컴퓨터에 맞는 명령을 복사해 붙여넣고 엔터. 이미 깔린 건 건너뛰고, 끝나면 성공 여부까지 확인해 줍니다.
시작 메뉴에서 ‘PowerShell’ 검색해서 열기 (명령 프롬프트 아님)
⌘ + Space → ‘터미널’ 검색해서 열기
CHECK
설치가 끝나면 터미널을 새로 열고 차례로 붙여넣으세요.
1. 버전 확인
숫자가 나오면 성공. 예: 2.1.211 (Claude Code)
2. 이상하면 자가 진단
설치 상태와 설정 오류를 읽기만 해서 알려줍니다. 아무것도 바꾸지 않습니다.
3. 첫 대화
작업할 폴더에서 claude 를 치면 브라우저가 열리고 로그인합니다. Pro 이상 구독이 필요합니다.
TROUBLESHOOTING
영상 댓글로 실제 들어온 오류와 공식 문제 해결 문서를 기준으로 정리했습니다. 해당하는 줄을 눌러 펼치세요.
command not found: claude / 'claude'은(는) 인식되지 않습니다왜: 설치는 됐는데 터미널이 아직 새 위치를 모릅니다. 대부분 터미널을 새로 열면 끝납니다.
1.터미널 창을 완전히 닫고(맥은 ⌘Q) 새로 연 뒤 다시 확인
2.맥에서 그래도 안 되면 — 설치 위치를 등록하고 다시 확인
3.윈도우에서 그래도 안 되면 — PowerShell에 붙여넣고, PowerShell을 다시 열기
'irm'은(는) 내부 또는 외부 명령이 아닙니다왜: 명령 프롬프트(CMD)에 붙여넣었습니다. 설치 명령은 PowerShell용입니다.
1.시작 메뉴에서 ‘PowerShell’을 검색해 열고, 위의 윈도우 명령을 다시 붙여넣기. 앞에 PS C:\ 가 보이면 PowerShell이 맞습니다.
'bash'을(를) 인식할 수 없습니다 / -fsSL 매개 변수를 찾을 수 없습니다왜: 맥용 명령을 윈도우에 붙여넣었습니다.
1.위쪽 ‘Windows PowerShell’ 칸의 명령(irm으로 시작)을 복사해서 다시 붙여넣기
이 시스템에서 스크립트를 실행할 수 없으므로… (running scripts is disabled)왜: PowerShell 보안 설정이 스크립트를 막고 있습니다. 내 계정에서만 풀면 됩니다(관리자 권한 불필요).
1.PowerShell에 붙여넣고 엔터, 그다음 설치 명령을 다시 실행
Password: 비밀번호를 치라고 나와요왜: 설치 도구가 맥 시스템 폴더를 만들 때 필요한 정상 단계입니다.
1.맥 잠금 해제할 때 쓰는 비밀번호를 치고 엔터. 입력해도 화면에 글자가 안 보이는 게 정상입니다.
로그인 창이 안 열려요 / OAuth error (400, Invalid code)왜: 로그인 코드가 만료됐거나 일부만 붙여넣어졌습니다.
1.브라우저가 안 열리면 터미널에서 c 를 눌러 로그인 주소를 복사 → 브라우저에 붙여넣기
2.코드 붙여넣기가 안 먹히면 새 터미널에서 아래 명령으로 다시 로그인하고, 받은 코드를 바로 붙여넣기
Pro 또는 Max가 필요하다고 나와요 / 로그인 후 403왜: 클로드 코드는 무료 플랜에서 쓸 수 없습니다(Pro 월 $20부터).
1.claude.ai/settings 에서 구독이 활성인지 확인 → 터미널에서 claude 를 다시 실행해 로그인
claude 를 치면 데스크톱 앱이 열려요왜: 예전 버전 Claude 데스크톱 앱이 같은 이름을 먼저 잡고 있습니다.
1.Claude 데스크톱 앱을 최신으로 업데이트한 뒤 PowerShell을 다시 열기
NativeCommandError / ENOENT 가 떠요왜: 예전 설치 스크립트에 있던 오류입니다. 지금은 고쳐졌습니다.
1.터미널을 완전히 닫고 새로 연 뒤, 위의 설치 명령을 다시 붙여넣기
그래도 안 되면
claude doctor 결과(또는 오류 화면)를 캡처해서 영상 댓글로 남겨 주세요. 받은 오류는 이 목록에 계속 추가합니다.
BONUS
설치가 끝난 윈도우 사용자용. 색·폰트·아이콘·자동완성까지 한 번에 바꿉니다.
PowerShell에 붙여넣기 · 관리자 권한 필요 없음 · 여러 번 실행해도 안전 · 끝나면 Windows Terminal을 새로 열기만 하면 됩니다.
Windows Terminal
트루컬러·탭·분할
PowerShell 7
최신 셸
oh-my-posh
경로·git 표시 프롬프트
Nerd Font
아이콘까지 깨짐 없이
맥은 기본 터미널로도 충분합니다 · 맥용 꾸미기는 준비 중
WHAT'S INSIDE
이미 설치된 건 건너뜀 · Apple Silicon 자동 대응 · 클로드 코드와 새 터미널의 PATH가 실제로 확인돼야 완료로 표시