Claude Code 설치와 로그인

이제 본격적으로 클로드 코드를 설치하고 로그인합니다. 현재 기준으로 가장 편리하게 개발할 수 있고, 성능이 좋으며, 생태계가 활성화되어 있는 AI 코딩 에이전트는 클로드 코드라고 생각합니다.

1. 설치 명령어

앞 장에서 열어둔 터미널에서 아래 명령어를 입력하면 됩니다. Windows라면 앞에서 연 명령 프롬프트(cmd) 가 열려 있는 상태여야 합니다.

Windows

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

Mac
```
sudo npm install -g @anthropic-ai/claude-code
```
Mac에서는 관리자 권한이 필요해 sudo를 붙입니다. 실행하면 PC 비밀번호를 물어봅니다. 비밀번호를 입력할 때 화면에 글자가 보이지 않는 것은 보안상 정상이니 당황하지 말고 입력 후 엔터를 누르세요.

설치 중 에러가 발생한다면 다음 장(설치 에러 해결)을 참고하세요.

-g 는 "global", 즉 컴퓨터 전체에서 claude 명령을 쓸 수 있도록 전역 설치한다는 의미입니다.

2. 첫 실행과 로그인

설치가 끝나면 터미널에 아래 명령을 입력합니다.

claude

처음 실행하면 몇 가지를 물어봅니다.

테마(색상) 선택 — 화면 색 표시 방식입니다. 기본값을 그대로 선택해도 됩니다.
로그인 방식 선택 — 어디서 로그인할지 물어봅니다.
- 1번(구독 계정으로 로그인): 권장. Pro/Max 정액 구독을 사용합니다.
- 2번(API 키 사용): 쓴 만큼 과금됩니다. 비용이 빠르게 늘 수 있어 권장하지 않습니다.
브라우저 인증 — 1번을 선택하면 웹 브라우저가 열립니다. "승인(Authorize)" 버튼을 눌러 로그인합니다.
폴더 신뢰 확인 — 클로드 코드는 현재 폴더의 파일에 접근하므로, 이 폴더를 신뢰하는지 묻습니다. 이 확인은 새 폴더에서 실행할 때마다 나옵니다. 엔터를 눌러 진행합니다.

아래와 같은 화면이 나타나면 클로드 코드를 사용할 준비가 된 것입니다.

실행 완료

3. 종료하기

클로드 코드를 종료하려면 다음 명령을 입력합니다.

/exit

Ctrl + C 를 두 번 눌러도 종료됩니다.

Claude Code는 "체감으로는 실무 경험이 있는 박사급 개발자"라고 생각하시면 됩니다. 매우 똑똑하지만, 지시를 제대로 해주지 않으면 엉뚱한 방향으로 한참 가 있는 경우가 있습니다. 그래서 이 책의 5장 이후에서 다루는 CLAUDE.md, 계획(Plan) 모드, 검증 같은 "방향을 잡아주는 기술"이 중요합니다.

4. 어디서 실행해야 할까?

클로드 코드는 작업하려는 프로젝트 폴더 안에서 실행하는 것이 핵심입니다. 클로드 코드는 실행한 폴더와 그 하위 폴더를 작업 범위로 삼기 때문입니다.

일반적인 흐름은 다음과 같습니다.

작업할 폴더를 하나 만듭니다(예: my-project).
VSCode에서 파일 → 폴더 열기로 그 폴더를 엽니다.
VSCode 상단 메뉴 터미널 → 새 터미널로 터미널을 엽니다.
터미널에 claude 를 입력해 실행합니다.

이제 그 폴더 안에서 클로드 코드와 대화하며 작업할 수 있습니다. 다음 장에서는 설치 중 자주 만나는 에러를 해결하는 방법을 정리합니다.