시작하기 전에
Claude Code는 여러분 컴퓨터의 터미널, 즉 명령어를 입력하는 텍스트 창에서 실행돼요. 또한 유료 Claude 요금제(Pro 또는 Max)가 필요해요. 무료 요금제에서는 Claude Code가 지원되지 않거든요.
좋은 소식이 있어요. 공식 설치 프로그램을 사용하면 Node.js를 설치할 필요가 없어요. 딱 한 번의 명령어로 다 끝낼 수 있거든요.
Windows 사용자는 먼저 이것부터 해야 해요: Claude Code를 사용하려면 Windows용 Git이라는 무료 도구가 필요해요. (이건 백그라운드에서 사용되는 거라 직접 배우거나 사용할 필요는 없어요.) Windows를 사용 중이고 아직 Git이 없다면, 계속 진행하기 전에 먼저 설치해 주세요:
git-scm.com/downloads/win으로 가서 설치 프로그램을 다운로드해요.
설치 프로그램을 실행해요. 각 화면에서 '다음'을 눌러 기본 설정을 그대로 유지해요. 화면이 여러 개 나오더라도 아무것도 변경할 필요 없어요.
어떤 편집기를 사용할지 묻는다면, 기본값으로 두고 '다음'을 눌러요.
"Adjusting your PATH environment" 화면이 나오면, 이미 선택되어 있는 옵션을 그대로 둬요.
Git이 설치되어 있는지 확실하지 않다면? 어떻게든 설치해세요. 다시 설치해도 아무 문제 없어요. Mac 사용자는 이 부분을 건너뛰어도 돼요. 추가로 필요한 건 아무것도 없어요.
1단계 — 터미널 열기
컴퓨터에서 터미널을 열어요. 여는 방법은 시스템마다 달라요:
Windows 10: Windows 키 + R을 누르고
cmd를 입력한 다음 Enter를 눌러요. 명령 프롬프트가 열릴 거예요.Windows 11: 작업 표시줄의 검색창을 클릭하거나 (Windows 키를 눌러도 돼요)
Terminal이라고 입력한 다음 결과에서 Terminal을 클릭해요. 또는 시작 버튼을 마우스 오른쪽 버튼으로 클릭하고 Terminal을 선택해도 돼요.Mac: Cmd + Spacebar를 눌러 Spotlight를 열고
Terminal이라고 입력한 다음 Enter를 눌러요.
입력할 수 있는 빈 줄이 있는 창이 나타날 거예요. 아래의 모든 명령어를 여기에 입력하면 돼요.
2단계 — 설치 프로그램 실행
시스템에 맞는 명령어를 복사해서 터미널에 붙여넣고 Enter를 누르세요.
Mac:
curl -fsSL https://claude.ai/install.sh | bash
Windows 11 (및 Terminal/PowerShell을 사용하는 Windows 10):
irm https://claude.ai/install.ps1 | iex
Windows 10 (1단계에서 cmd로 명령 프롬프트를 연 경우):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
설치가 진행되는 동안 텍스트가 스크롤되는 걸 볼 수 있을 거예요. 완료되면 Claude Code가 성공적으로 설치되었다는 메시지가 표시돼요. 대신 오류가 보인다면, 아래의 문제 해결 섹션을 확인해 보세요.
3단계 — 새 터미널 창 열기
이 단계는 쉽게 건너뛰기 쉽지만 중요해요. 터미널 창을 완전히 닫고 새 창을 다시 열어주세요 (1단계에서 사용한 것과 동일한 방법으로).
설치 프로그램이 Claude Code를 시스템에 추가하지만, 터미널은 새 창을 시작할 때만 변경 사항을 인식해요. 이 단계를 건너뛰는 것이 다음 단계가 "작동하지 않는" 것처럼 보이는 가장 흔한 이유예요.
4단계 — Claude Code 시작 및 로그인
새 터미널 창에서 다음을 입력하세요:
claude
처음 실행할 때 어떻게 로그인할지 물어볼 거예요. API 키가 아닌, Claude 계정으로 로그인하는 것을 선택하세요. 그러면 Claude 계정으로 로그인할 수 있는 브라우저 창이 열릴 거예요. 로그인하면 터미널로 돌아갈 수 있어요. 이제 Pro 또는 Max 구독이 Claude Code에서 작동할 거예요.
이게 다예요. 이제 터미널에서 직접 질문이나 요청을 입력할 수 있어요.
문제 해결
설치 단계는 모든 시스템에서 동일하지만, 문제가 발생하면 사용 중인 시스템에 따라 해결 방법이 달라질 수 있어요. 가장 흔한 문제들을 알려드릴게요.
설치 후 "claude가 인식되지 않습니다" 또는 "명령을 찾을 수 없습니다"
이것은 거의 항상 3단계를 건너뛰었기 때문이에요. 터미널을 완전히 닫고, 완전히 새로운 창을 연 다음, claude를 다시 입력해 보세요. 터미널은 새로운 세션을 시작할 때만 새로 설치된 명령어를 인식해요.
Windows: "irm이 인식되지 않습니다" (PowerShell이 아닌 명령 프롬프트에서 실행 중)
irm 명령이 "내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다."와 같은 오류를 반환하면, PowerShell이 아닌 명령 프롬프트(CMD)에서 실행 중인 거예요. 어느 쪽인지 확인하려면 줄 시작 부분을 보면 돼요. PowerShell은 PS C:\...를 표시하고, 명령 프롬프트는 C:\...만 표시해요.
대신 명령 프롬프트 버전을 사용하세요:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows 10: "SSL/TLS 보안 채널을 만들 수 없습니다"
이 문제는 오래된 Windows 10 시스템에서 발생할 수 있어요. PowerShell에서 아래 줄을 먼저 실행한 다음, 설치 프로그램 명령을 다시 실행하세요:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 irm https://claude.ai/install.ps1 | iex
Windows: "Windows의 Claude Code에는 git-bash가 필요합니다"
이것은 Windows용 Git이 설치되지 않았거나 (또는 Claude Code가 찾지 못하는 경우) 를 의미해요. 위쪽의 "시작하기 전에" 섹션으로 돌아가서 Windows용 Git을 설치한 다음, 터미널을 닫고 새 터미널을 연 후 claude를 다시 실행하세요.
Mac: 보안 또는 "권한" 메시지
공식 설치 프로그램이 Claude Code를 여러분의 폴더(홈 디렉토리 안)에 설치하기 때문에, 이전 설치 방법에서 발생했던 권한 오류는 여기서는 발생하지 않아요. Mac에서 claude를 처음 실행할 때 앱을 확인할 수 없다는 보안 팝업이 표시되면, 시스템 설정 → 개인정보 보호 및 보안으로 가서 claude에 대한 메시지를 스크롤하여 '모두 허용'을 클릭하세요. 그런 다음 터미널에서 claude를 다시 실행하세요.
여전히 문제가 있나요?
설치 후, 이 명령어를 실행하면 Claude Code가 스스로를 확인하고 무엇이 잘못되었는지 알려줄 거예요:
claude doctor
이 명령어는 설치 상태와 일반적인 설정을 검토하고, 보통 무엇을 수정해야 하는지 정확하게 알려줄 거예요.