클로드 코드 설치 방법｜Windows·Mac 설치부터 첫 실행까지 초보자 가이드

 

클로드 코드 설치 방법 Windows Mac 초보자 가이드

클로드 코드 설치 방법을 찾아보면 PowerShell, CMD, 터미널, WinGet 같은 용어부터 나와 처음 사용하는 사람에게는 어렵게 느껴질 수 있습니다.

하지만 Claude Code를 설치하기 위해 모든 개발 용어를 알아야 하는 것은 아닙니다.

현재 Claude Code는 Windows와 macOS, Linux 등에서 사용할 수 있으며, Anthropic은 공식 문서에서 Native Install을 권장 설치방법으로 안내하고 있습니다.

처음 설치한다면 아래 흐름부터 기억하면 됩니다.

내 운영체제 확인 → 설치 명령 실행 → 설치 확인 → claude 실행 → 로그인

특히 Windows 사용자라면 자신이 PowerShell을 열었는지 CMD를 열었는지 확인하는 것이 중요합니다. 두 환경에서 사용하는 설치 명령이 다르기 때문입니다.

클로드 코드 설치 전 무엇을 확인해야 할까.

먼저 내 컴퓨터에서 Claude Code를 실행할 수 있는지 확인합니다.

현재 공식 시스템 요구사항에는 macOS 13 이상, Windows 10 1809 이상 등이 안내돼 있습니다.

메모리는 4GB 이상이 필요하며 인터넷 연결도 필요합니다.

Windows에서는 PowerShell이나 CMD를 사용할 수 있고, macOS에서는 터미널을 이용하면 됩니다.

여기서 초보자가 알아둘 것이 하나 있습니다.

Claude Code를 설치하기 위해 무조건 VS Code부터 설치해야 하는 것은 아닙니다.

Claude Code 자체를 먼저 설치하고 터미널에서 실행할 수 있습니다.

VS Code 연동은 Claude Code 설치가 정상적으로 끝난 뒤 별도로 진행해도 됩니다.

Windows에서 클로드 코드는 어떻게 설치할까.

 Windows PowerShell에서 클로드 코드 설치를 준비하는 초보자

Windows에서는 여러 설치방법을 선택할 수 있습니다.

처음 사용하는 사람이라면 PowerShell을 이용하는 방법을 먼저 알아두면 편합니다.

Windows 검색창에서

PowerShell

을 검색해 실행합니다.

PowerShell 화면이 열렸다면 Anthropic 공식 설치 페이지에 안내된 Windows PowerShell용 설치 명령을 복사해 실행합니다.

현재 공식 Native Install 명령은 다음과 같습니다.

irm https://claude.ai/install.ps1 | iex

명령을 입력한 뒤 설치가 진행될 때까지 기다립니다.

중요한 점은 인터넷에서 오래전에 작성된 설치 명령을 복사하기보다 실제 설치 시점의 Anthropic 공식 페이지에서 명령을 다시 확인하는 것입니다.

PowerShell과 CMD를 어떻게 구별할까.

Windows 클로드 코드 PowerShell 설치와 실행 3단계

Windows 초보자라면 여기서 많이 막힐 수 있습니다.

두 화면은 비슷해 보이지만 설치 명령이 다릅니다.

PowerShell에서는 명령줄 앞부분에 보통

*PS C:*

와 같은 표시가 나타납니다.

CMD에서는

*C:*

처럼 PS가 없는 형태로 표시됩니다.

PowerShell을 열었다면 PowerShell용 명령을 사용하고 CMD를 열었다면 CMD용 명령을 사용해야 합니다.

명령을 실행했는데 구문 관련 오류가 발생한다면 내가 어느 터미널을 열었는지부터 다시 확인해보세요.

Windows에서 WinGet으로도 설치할 수 있을까.

가능합니다.

Windows 환경에서는 WinGet을 이용한 설치방법도 제공됩니다.

현재 공식 명령은 다음과 같습니다.

winget install Anthropic.ClaudeCode

WinGet 방식은 명령이 비교적 짧다는 장점이 있습니다.

다만 Native Install과 업데이트 방식에 차이가 있습니다.

Native Install은 업데이트를 백그라운드에서 자동으로 처리할 수 있지만 WinGet으로 설치한 경우에는 기본적으로 업데이트를 직접 확인해야 합니다.

WinGet 설치본을 업데이트할 때 사용하는 명령은 다음과 같습니다.

winget upgrade Anthropic.ClaudeCode

따라서 초보자라면 단순히 명령이 짧다는 이유만으로 선택하기보다 업데이트 방식까지 함께 알아두는 것이 좋습니다.

Mac에서 클로드 코드는 어떻게 설치할까.

macOS에서는 터미널을 열어 Native Install 명령을 사용할 수 있습니다.

현재 공식 설치 명령은 다음과 같습니다.

curl -fsSL https://claude.ai/install.sh | bash

설치가 완료되면 터미널에서 Claude Code가 정상적으로 설치됐는지 확인합니다.

macOS에서는 Homebrew를 이용하는 방법도 제공됩니다.

Homebrew를 사용하는 사람이라면 다음 방식도 선택할 수 있습니다.

brew install --cask claude-code

다만 Homebrew 설치본은 Native Install과 업데이트 방식이 다릅니다.

처음 사용하는 사람이라면 여러 방법을 섞어서 설치하기보다 한 가지 설치방법을 선택해 끝까지 진행하는 것이 좋습니다.

설치가 제대로 됐는지 어떻게 확인할까.

claude version과 claude doctor로 Claude Code 설치 확인하는 방법

설치 명령이 끝났다고 바로 다음 단계로 넘어가지 말고 정상적으로 설치됐는지 확인하는 것이 좋습니다.

터미널에 다음 명령을 입력합니다.

claude --version

정상적으로 설치됐다면 Claude Code 버전 정보가 나타납니다.

버전이 표시된다면 기본 설치가 정상적으로 된 것으로 볼 수 있습니다.

좀 더 자세하게 설치와 설정 상태를 확인하고 싶다면 다음 명령도 사용할 수 있습니다.

claude doctor

이 명령은 설치 상태와 설정 문제 등을 진단하는 데 사용할 수 있습니다.

초보자라면 문제가 생겼을 때 무작정 재설치하기보다 claude doctor로 먼저 상태를 확인해보는 것도 좋은 방법입니다.

설치가 끝났다면 어떻게 실행할까.

이제 실제 Claude Code를 실행해봅니다.

터미널에서 다음과 같이 입력합니다.

claude

그러면 Claude Code의 대화형 세션이 시작됩니다.

처음 실행하는 경우 로그인 과정이 나타날 수 있습니다.

화면 안내에 따라 계정 인증을 진행하면 됩니다.

여기까지 완료했다면 Claude Code 설치와 첫 실행의 기본 과정은 끝난 것입니다.

무료 Claude 계정만 있어도 실행할 수 있을까.

이 부분은 설치와 이용을 구분해서 봐야 합니다.

프로그램을 설치하는 것과 실제 Claude Code 서비스를 사용할 수 있는 계정 자격은 별개의 문제입니다.

현재 Anthropic 공식 안내에서는 Claude Code 이용에 Pro, Max, Team, Enterprise 또는 Console 계정 등이 필요하다고 안내하고 있습니다.

무료 Claude.ai 플랜에는 Claude Code 접근이 포함되지 않습니다.

따라서 프로그램 설치까지 완료했는데 로그인 이후 사용 단계에서 막힌다면 설치 오류만 찾지 말고 자신의 Claude 계정과 요금제도 확인해야 합니다.

가격과 Pro·Max·API 비용 차이는 별도의 요금제 글에서 자세히 다루겠습니다.

Windows에서 Git for Windows도 꼭 설치해야 할까.

현재 Native Windows에서 Git for Windows는 필수는 아닙니다.

Git for Windows가 없다면 Claude Code는 PowerShell을 이용해 셸 명령을 실행할 수 있습니다.

다만 Anthropic은 Native Windows에서 Git for Windows 설치를 권장하고 있습니다.

Git for Windows가 설치돼 있으면 Claude Code가 Git Bash를 Bash 도구로 사용할 수 있기 때문입니다.

처음 Claude Code를 시험해보는 단계라면 이것 때문에 설치 자체를 미룰 필요는 없습니다.

하지만 앞으로 실제 개발 프로젝트와 Git을 함께 사용할 계획이라면 알아둘 만한 부분입니다.

설치 후 ‘claude’를 입력했는데 실행되지 않는다면.

가장 먼저 설치 확인 명령을 실행해봅니다.

claude --version

버전 정보가 나오지 않는다면 설치가 정상적으로 끝나지 않았거나 실행 경로와 관련된 문제가 있을 수 있습니다.

그다음에는

claude doctor

를 이용해 설치와 설정 상태를 확인합니다.

Windows라면 PowerShell과 CMD 명령을 잘못 사용하지 않았는지도 다시 확인합니다.

설치 명령을 여러 방식으로 반복해서 실행하기보다 어떤 방법으로 설치했는지 먼저 확인한 뒤 해당 설치방식에 맞춰 문제를 찾는 것이 좋습니다.

클로드 코드 업데이트는 어떻게 할까.

Native Install 방식은 기본적으로 백그라운드 자동 업데이트를 지원합니다.

즉, 처음 사용하는 사람이 매번 새로운 버전을 직접 찾아 설치할 필요가 줄어듭니다.

즉시 수동 업데이트가 필요할 때는 설치방식에 따라 방법이 달라질 수 있습니다.

Native Install에서는 다음 명령을 사용할 수 있습니다.

claude update

반면 WinGet 설치라면

winget upgrade Anthropic.ClaudeCode

처럼 해당 패키지 관리자의 업데이트 방식을 사용합니다.

Homebrew 설치 역시 Homebrew의 업그레이드 명령을 사용합니다.

그래서 설치방법을 기억해두는 것이 나중에 업데이트할 때도 중요합니다.

초보자가 가장 많이 헷갈리는 부분은.

첫 번째는 PowerShell과 CMD를 구분하지 않는 것입니다.

화면이 비슷해 보여도 설치 명령이 다릅니다.

두 번째는 설치와 로그인 문제를 같은 문제라고 생각하는 것입니다.

claude --version은 정상적으로 나오는데 서비스 이용이 되지 않는다면 설치보다 계정 인증이나 이용 자격을 확인해야 할 수 있습니다.

세 번째는 여러 설치방법을 한꺼번에 사용하는 것입니다.

Native Install을 했다가 WinGet을 실행하고 다시 npm 설치까지 반복하면 나중에 어떤 방식으로 설치됐는지 혼란스러울 수 있습니다.

처음에는 한 가지 공식 설치방법을 선택해 진행하는 것이 좋습니다.

클로드 코드 설치 FAQ.

Q. Windows에서도 Claude Code를 사용할 수 있나요?

가능합니다. 현재 Claude Code는 Native Windows와 WSL 환경을 지원합니다.

Q. Windows에서 관리자 권한으로 실행해야 하나요?

현재 공식 Native Windows 설치 안내에서는 관리자 권한으로 실행할 필요가 없다고 설명합니다.

Q. Node.js를 먼저 설치해야 하나요?

Native Install을 이용한다면 npm 설치를 위해 Node.js부터 준비하는 방식으로 시작할 필요는 없습니다. npm 설치방법도 별도로 제공되지만 공식 문서에서는 Native Install을 권장하고 있습니다.

Q. 설치됐는지 가장 간단하게 확인하는 방법은 무엇인가요?

터미널에서 claude --version을 실행해보세요. 버전 정보가 표시되는지 확인하면 됩니다.

Q. 설치 후 무엇을 입력해야 Claude Code가 시작되나요?

프로젝트에서 터미널을 열고 claude를 입력하면 대화형 세션을 시작할 수 있습니다.

처음 설치한다면 이 순서대로 하세요.

 클로드 코드 운영체제 확인부터 로그인 첫 실행까지 설치 순서

복잡한 설명이 부담스럽다면 아래 순서만 따라가도 됩니다.

1. Windows인지 Mac인지 운영체제를 확인합니다.

2. Anthropic 공식 설치 페이지에서 현재 설치 명령을 확인합니다.

3. Windows는 PowerShell과 CMD를 구분합니다.

4. 한 가지 설치방법을 선택해 설치합니다.

5. claude --version으로 정상 설치 여부를 확인합니다.

6. 문제가 있다면 claude doctor로 상태를 확인합니다.

7. claude를 실행합니다.

8. 화면 안내에 따라 로그인합니다.

여기까지 성공했다면 이제 설치방법을 계속 찾아볼 단계가 아니라 실제 Claude Code를 사용해볼 단계입니다.

처음에는 작은 프로젝트 폴더에서 실행한 뒤

“이 프로젝트의 구조부터 설명해줘.”

처럼 간단한 요청부터 시작해보는 것이 좋습니다.

함께 보면 좋은 글.

클로드 코드 사용법｜설치부터 첫 실행·VS Code·명령어·비용까지 초보자 가이드

Claude Code가 무엇인지부터 기본 명령어와 VS Code, 사용량까지 전체 흐름을 먼저 보고 싶다면 메인 가이드를 함께 확인해보세요.

※ Claude Code의 설치 명령, 시스템 요구사항, 지원 운영체제와 업데이트 방식은 변경될 수 있습니다. 실제 설치할 때는 Anthropic 공식 Claude Code 문서의 최신 안내를 다시 확인하시기 바랍니다.