[AI] Claude Code CLI 설치 가이드

📌 Claude Code CLI 설치 및 실행 방법

최근 개발 생산성을 높이기 위해 Claude Code CLI를 사용하는 분들이 많아지고 있습니다.
이번 글에서는 Windows와 Mac 환경에서 Claude Code를 설치하고, 초기 설정까지 진행하는 방법을 정리해보겠습니다.

---

1️⃣ Claude Code 설치

먼저 터미널(또는 명령 프롬프트)을 실행한 뒤 아래 명령어를 입력합니다.

✔ Windows

npm install -g @anthropic-ai/claude-code

✔ Mac

sudo npm install -g @anthropic-ai/claude-code

 

---

2️⃣ 초기 실행 및 색상 선택

설치가 완료되면 아래 명령어로 실행할 수 있습니다.

claude

 

먼저 인터페이스 스타일(색상 등)을 선택하는 화면이 나타납니다.

저는 기본값(1번)을 선택하였습니다.

---

3️⃣ 로그인 방식 선택

다음으로 로그인 방식을 선택하는 화면이 나타납니다.

• 1번: 계정 로그인 (권장)
• 2번: 사용량 기반 과금 방식

일반적으로는 1번(계정 로그인)을 선택하시는 것을 권장드립니다.

 

실제로 사용해보면 과금 방식은 사용량에 따라 비용이 발생하며,

간단한 코드 생성만으로도 비용이 빠르게 누적될 수 있습니다.

---

4️⃣ 브라우저 인증 진행

로그인 방식을 선택하면 웹 브라우저가 자동으로 열립니다.

화면에 표시되는 승인 버튼을 클릭해 주세요.

 

이 과정을 통해 CLI와 계정이 연결됩니다.

---

5️⃣ 설치 완료 및 초기 안내

설치가 정상적으로 완료되었다는 메시지가 표시됩니다.

터미널로 돌아와서 안내에 따라 Enter 키를 눌러 진행합니다.

이후 간단한 사용 가이드가 출력됩니다. Enter 키를 눌러 진행합니다.

---

6️⃣ 폴더 신뢰 여부 확인

Claude Code는 실행 시 현재 디렉토리를 기준으로 동작하기 때문에
폴더를 신뢰하는지 묻는 메시지가 표시됩니다.

 

일반적인 개발 환경이라면 Enter를 눌러 진행하시면 됩니다.

※ 해당 메시지는 실행할 때마다 표시될 수 있습니다.

 

---

7️⃣ 실행 확인 및 종료 방법

아래와 같이 CLI 화면이 정상적으로 표시된다면
이제 Claude Code를 사용할 준비가 완료된 것입니다.

테스트 후 종료하려면 아래 명령어를 입력합니다.

/exit

---

✅ 마무리

지금까지 Claude Code CLI 설치부터 실행까지 간단히 정리해보았습니다.