내 컴퓨터에 맞는 명령을 복사해 붙여넣고 엔터. 이미 깔린 건 건너뛰고, 끝나면 성공 여부까지 확인해 줍니다.
시작 메뉴에서 ‘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.터미널을 완전히 닫고 새로 연 뒤, 위의 설치 명령을 다시 붙여넣기
목록에 없나요? 설치 도우미에게 물어보세요
화면에 뜬 글이나 캡처를 보내면 다음에 칠 것을 알려 드려요. AI가 먼저 답하고, 안 풀리면 운영자가 직접 봐요.
PERMISSIONS
클로드가 ‘이거 해도 될까요?’ 하고 물을 때 보는 표입니다. 처음부터 전부 허용할 필요는 없습니다.
‘허용’은 지금 요청을 진행할지에 대한 선택입니다. 이번 한 번과 계속 허용은 다릅니다 — 계속 허용하기 전에는 그 규칙이 어떤 도구·대상까지 포함하는지 확인하세요. 이 표가 권한을 자동으로 바꾸지는 않습니다.
클로드와 같이 정하기
실행된 클로드 코드에 붙여넣으세요. 복사하면 위 표도 같이 들어갑니다. 오늘 맡길 작업은 내 상황에 맞게 바꿔도 됩니다.
설명을 읽고 내가 고른 뒤, 실제로 적용됐는지 확인합니다. 추천 답변만으로 설정이 바뀌었다고 보지 마세요. 뜻을 모르겠으면 권한 요청 화면을 도우미에 물어보세요 — 비밀번호·인증 코드·API 키는 보내지 마세요.
FIRST USE
맥은 iTerm2, 윈도우는 Windows Terminal. 설치가 끝나면 새 창을 열어 시작하세요.
claudeClaude 이름과 대화 입력칸이 보임오늘 뉴스 정리해서 알려줘응답이 나옴. 날짜·출처도 확인/model현재 모델과 목록. 방향키·Enter로 선택/effort지원 모델의 슬라이더. 처음은 기본값/resume목록에서 대화를 고르면 이전 내용이 보임/compact요약해 공간을 비움. 뒤에 남길 내용을 적고, 중요한 요구가 남았는지 확인/clear이전 내용을 넣지 않은 새 대화 시작/exit터미널 명령 입력으로 돌아옴다시 쓸 때
새 터미널 → claude → 이어갈 대화는 /resume
설치 명령을 매번 다시 넣지 않습니다. 영상과 답이 달라도 잘못한 게 아닙니다.
아래 사용량 숫자
5h = 5시간 구간에 쓸 수 있는 양, 7d = 일주일 전체 총량의 사용률. 주간이 남아도 5시간 한도에 닿으면 그 갱신까지 기다립니다. 컨텍스트 = 지금 대화·자료를 담는 공간의 사용률(처음엔 ‘확인 전’일 수 있음).
Pro·Max 구독으로 연결하고 추가 사용을 꺼두면 포함 한도 안에서만 씁니다. 별도 결제가 필요한 모델·추가 사용을 고르면 비용이 생길 수 있습니다.
끝에서 직접 확인하세요
2026-10-13 기준 · 메뉴는 모델·계정·버전에 따라 다를 수 있습니다
BONUS
선택입니다. 설치가 끝난 뒤, 내 컴퓨터에 맞는 한 줄을 붙여넣으세요. 관리자 권한 필요 없음 · 여러 번 실행해도 안전.
PowerShell에 붙여넣기 → 끝나면 Windows Terminal을 새로 열기
Windows Terminal
트루컬러·탭·분할
PowerShell 7
최신 셸
oh-my-posh
경로·git 표시 프롬프트
Nerd Font
아이콘까지 깨짐 없이
iTerm2에 붙여넣기 → 끝나면 ⌘Q로 완전히 끄고 다시 열기
배색
짙은 남색 바탕·선명한 글자색
위 상태 막대
시계·메모리·CPU
agnoster 프롬프트
폴더·git을 색 칸으로
D2Coding Nerd Font
한글·아이콘 고르게
사용량 표시는 기본 설치에 이미 들어 있습니다 · 지금 쓰는 설정이 있으면 그대로 써도 됩니다
WHAT'S INSIDE
이미 설치된 건 건너뜀 · Apple Silicon 자동 대응 · 클로드 코드와 새 터미널의 PATH가 실제로 확인돼야 완료로 표시