💬 레슨

Claude Code 설치 — 딱 한 줄 붙여넣기

유료 계정을 준비하고, 공식 설치 명령 한 줄을 붙여넣으면 1분이면 깔려요. Mac·Windows 모두 WSL 없이.

① 이 레슨의 목표

드디어 설치! 딱 한 줄이에요

앞 레슨에서 터미널(맥)·PowerShell(윈도우) 여는 법과 복사→붙여넣기를 익혔죠. 이제 그 창에 공식 설치 명령 딱 한 줄을 붙여넣어 Claude Code를 설치해요. 1분이면 끝나요.

순서는 이래요 — ①유료 계정 준비 → ②창 열기 → ③한 줄 붙여넣기 → ④필요하면 PATH 잡기 → ⑤설치됐는지 확인. 하나씩 갈게요.

설명을 따라 진행하면, 여기서 직접 쳐보게 돼요 👇

~/my-shop

$ _

📚 「Claude Code 설치 — 딱 한 줄 붙여넣기」 레슨 내용 전체 텍스트로 훑어보기

드디어 설치! 딱 한 줄이에요

순서는 이래요 — ①유료 계정 준비 → ②창 열기 → ③한 줄 붙여넣기 → ④필요하면 PATH 잡기 → ⑤설치됐는지 확인. 하나씩 갈게요.

Claude Code는 유료 구독이 있어야 써요

무료 계정으론 로그인이 안 돼요. Pro·Max·Team 중 하나가 필요해요. (설치는 지금 하고, 로그인은 다음 레슨에서 해요 — 지금 당장 계정이 없어도 설치는 진행할 수 있어요.)

어떤 걸 고를까?

· Pro (월 약 $20) — 처음 배우고 가볍게 쓰기에 충분해요. 여기서 시작하길 권해요.
· Max — 하루 종일 많이 쓰거나 큰 작업을 할 때. 나중에 올려도 돼요.
플랜 보기·결제: claude.com/pricing. 결제는 해외결제 되는 신용/체크카드·PayPal·가상카드(토스·카카오페이 등)로 가능해요.

💡 회사·워크숍에서 계정을 받았다면 그걸 쓰면 돼요. 그대로 다음으로 넘어가세요.

앞 레슨에서 배운 대로, 내 컴퓨터에 맞는 창을 하나 열어요.

🍎 맥

⌘ + 스페이스바 → 터미널 입력 → Enter

🪟 윈도우

윈도우 키 → PowerShell 입력 → 'Windows PowerShell' 클릭 (맨 앞이 PS로 시작하는지 확인!)

창이 떴나요? 그럼 다음 단계에서 명령 한 줄을 붙여넣어요.

🪟 윈도우를 쓰신다면 이 단계를 건너뛰고 ⑤로 가세요.

아래 한 줄을 복사해, 터미널에 붙여넣고 Enter

curl -fsSL https://claude.ai/install.sh | bash
붙여넣기는 터미널 안에서 ⌘+V, 그다음 Enter. 글자들이 주르륵 지나가며 설치돼요. '완료(done)' 비슷한 말이 나오고 멈추면 끝난 거예요.

설치가 끝나면 바로 PATH도 잡아줘요

설치 명령이 끝난 뒤, 같은 터미널에 아래 한 줄을 붙여넣고 Enter를 눌러요.
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
그다음 터미널 창을 완전히 닫고 새로 열어야 PATH가 반영돼요. 새 창에서 claude --version을 확인합니다.

중간에 이런 게 떠도 괜찮아요

· 설치가 몇십 초 걸릴 수 있어요. 글자가 멈춘 듯 보여도 기다리세요.
· 비밀번호를 물으면(맥 로그인 암호) 쳐도 화면엔 아무 글자도 안 보여요 — 정상이에요. 끝까지 치고 Enter.

💡 맥은 터미널에서 curl -fsSL https://claude.ai/install.sh | bash를 쓰고, 윈도우 PowerShell은 irm https://claude.ai/install.ps1 | iex를 써요. 설치와 PATH 등록이 끝났으면 ⑦에서 확인해요.

🍎 맥을 쓰신다면 이미 ④에서 끝났어요. 여기는 건너뛰고 ⑥으로 가세요.

아래 한 줄을 복사해, PowerShell에 붙여넣고 Enter

irm https://claude.ai/install.ps1 | iex
붙여넣기는 PowerShell 창에 대고 마우스 오른쪽 클릭(또는 Ctrl+V), 그다음 Enter. 글자가 지나가며 설치돼요. 멈추면 끝난 거예요.

알아두면 안 당황해요

· 설치가 몇십 초 걸려요. 멈춘 듯 보여도 기다리세요.
· 예전엔 윈도우에서 'WSL'이라는 복잡한 걸 깔아야 했지만, 이제 필요 없어요. 이 한 줄이면 끝!
· Git for Windows는 나중에 깔아도 되는 선택 사항이에요. 지금은 신경 쓰지 마세요.

설치가 끝났으면 ⑥으로 가요.

설치가 끝났는데 claude --version에서 command not found 또는 인식되지 않습니다가 나오면, Claude가 깔린 폴더가 터미널의 PATH에 아직 안 들어간 거예요.

먼저 제일 쉬운 해결

터미널/PowerShell 창을 완전히 닫고 새로 열기 → claude --version 다시 입력. 설치 프로그램이 경로를 잡았는데 현재 창만 모르는 경우가 많아요.

🍎 맥에서 계속 안 되면

아래 한 줄을 터미널에 붙여넣고 Enter를 누른 뒤, 창을 닫았다가 새로 열어요. ④에서 이미 했다면 다시 안 해도 됩니다.
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
Claude Code의 native installer는 보통 ~/.local/bin/claude에 실행 파일을 연결해요. 그래서 이 폴더를 PATH에 넣어주는 거예요.

🪟 윈도우 PowerShell에서 계속 안 되면 — 이미지 순서대로

1단계 — PATH에 영구 등록
현재 PowerShell 창에 아래 한 줄을 그대로 붙여넣고 Enter를 눌러요. 아무 메시지도 안 나오면 정상이에요.

[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.local\bin", "User")

2단계 — PowerShell 창 완전히 닫기 새 탭만 열지 말고, X 버튼으로 PowerShell 창 자체를 닫아야 해요.
3단계 — PowerShell 새로 열기 시작 메뉴 → “PowerShell” 검색 → 실행.
4단계 — PATH 등록 확인
새 PowerShell 창에서 아래 명령을 붙여넣고 Enter를 눌러요.
$env:Path -split ';' | Select-String ".local\\bin"
C:\Users\내이름\.local\bin처럼 출력되면 성공입니다. 윈도우 native installer는 보통 %USERPROFILE%\.local\bin\claude.exe 쪽을 써요. 그다음 claude --version으로 최종 확인하세요.

설치가 잘 됐는지 여기서 같이 연습해봐요. 아래처럼 claude --version을 쳐서(또는 붙여넣어서) 버전 숫자가 나오면 성공이에요. 맥·윈도우 똑같아요.

claude --version — 설치 확인 — 버전 숫자가 보이면 성공!

🎉 버전 숫자(예: 2.x.x)가 나왔다면 설치 성공이에요! 만약 계속 command not found나 인식되지 않습니다가 나오면, 바로 앞의 ⑥ PATH 단계를 적용하고 창을 새로 연 뒤 다시 확인하세요.

한 줄로

유료 계정을 준비하고, 창에 공식 설치 한 줄을 붙여넣어 Claude Code를 깔았어요. (맥 curl … | bash / 윈도우 irm … | iex) 설치 직후 명령을 못 찾으면 PATH를 잡고 새 창을 열어요. claude --version으로 버전이 보이면 설치 완료!

다음 레슨에서

설치는 됐지만 아직 로그인이 남았어요. 다음 레슨에서 웹 브라우저로 로그인하고, 다시 터미널로 돌아오는 마지막 관문을 함께 넘어요. 여기까지 오셨으면 거의 다 왔어요! 🙌