[Claude] Anthropic Claude Code 설치 및 초기 설정 가이드

Claude

이 포스팅은 로컬 환경(Windows 11, macOS, Ubuntu 22.04 등)에서 Node.js와 @anthropic-ai/claude-code CLI(이하 “클로드 코드”)를 설치하고 초기 설정하는 방법을 안내합니다. 예시 명령어는 운영체제별로 차이가 있으나 큰 틀은 동일합니다.

중요 요약

Node.js 설치 필요: npm으로 패키지를 설치·실행하기 위해 필요합니다.
클로드 코드는 유료(Anthropic) 계정 및 API 키가 필요합니다.
설치 후 초기 설정을 통해 계정을 연동하고, 설치 검증 명령을 실행하세요.

Node.js 설치

왜 설치하는가?

@anthropic-ai/claude-code는 npm 패키지로 배포됩니다. 따라서 npm(또는 npx)로 설치·실행하려면 Node.js가 필요합니다. 또한 많은 개발 도구가 Node를 런타임으로 사용합니다.

Windows에서 설치하기

공식 설치 프로그램 사용: https://nodejs.org/ 에서 LTS 버전 설치
또는 nvm-windows 사용(여러 버전 관리): https://github.com/coreybutler/nvm-windows

설치 후 PowerShell 또는 CMD에서 버전 확인:

node -v
npm -v

만약 nvm-windows로 설치했다면 예시:

nvm install 18.20.0
nvm use 18.20.0

macOS / Ubuntu(리눅스)에서 설치하기

권장: nvm(Node Version Manager)을 사용하면 여러 버전을 쉽게 관리할 수 있습니다.

설치 예시 (macOS / Ubuntu):

curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \ . "$NVM_DIR/nvm.sh"
nvm install --lts
node -v
npm -v

참고: nvm 사용법은 https://github.com/nvm-sh/nvm

설치 완료 후 버전 확인

모든 플랫폼에서 다음을 실행하세요:

node -v
npm -v

클로드 코드 설치하기

패키지: @anthropic-ai/claude-code

유의사항: 유료 계정 필요

클로드(Claude) API는 Anthropic의 유료 계정(또는 이용 가능한 요금제) 및 개인 API 키가 필요합니다. 설치 자체는 무료이지만, API 호출은 과금 대상일 수 있으므로 계정/요금제를 확인하세요.

설치 명령어

전역으로 설치하면 시스템 어디서나 claude 명령을 사용할 수 있습니다. 권장 명령(글로벌 설치):

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

설치 시 사용된 옵션 설명

-g 또는 --global: 전역 설치를 의미합니다. 전역 설치 시 claude 실행 파일이 npm의 global bin 경로에 설치되어, 터미널 세션 전체에서 바로 실행할 수 있습니다.

설치 후 확인

글로벌 설치시 다음으로 확인하세요:

claude --version
claude --help

명령어가 동작하지 않으면 npm의 global bin 경로가 PATH에 포함되어 있는지 확인하세요:

npm bin -g
# 출력된 경로가 PATH에 포함되어야 합니다.

초기 설정(필수): 계정 연동 (터미널 인터랙티브)

아래 절차는 claude 명령을 처음 실행하여 인터랙티브로 계정 연동과 기본 설정을 진행하는 흐름입니다. 각 단계는 예시 이미지(setting_1 ~ setting_7)를 참고하세요.

터미널에서 claude 명령을 처음 실행합니다.

claude

설정 1

컬러(테마) 설정 프롬프트가 나오면 원하는 컬러/테마를 선택합니다.

설정 2

웹 브라우저가 열리며 로그인/계정 연동 화면으로 이동합니다. 브라우저에서 로그인 후 연동을 허용하세요.

설정 3

웹에서 승인(Authorize) 버튼을 클릭합니다. 승인 후 터미널로 돌아옵니다.

설정 4

터미널에서 다음 단계로 진행하려면 엔터(Enter)를 누릅니다.

설정 5

안내 문구(예: “실수를 할 수 있습니다” 또는 사용 제한에 대한 경고)가 표시되면 내용을 확인하고 계속하려면 엔터를 누릅니다.

설정 6

워크스페이스 신뢰(trust workspace) 관련 안내가 나오면 필요에 따라 Trust 또는 Yes를 선택합니다.

설정 7

종료 시 Ctrl + c 두번을 통해 종료하거나, exit 명령어를 입력하면 종료할 수 있습니다.

설정이 완료되면 간단한 테스트 명령으로 연동을 확인합니다. 예시:

claude whoami

또는 패키지에 제공되는 테스트/diagnostic 커맨드가 있다면 해당 명령을 실행해 연결 유효성을 확인하세요.

참고: 실제 메시지와 화면 흐름은 claude CLI의 버전이나 배포 설정에 따라 다를 수 있습니다. 이미지를 참고해 각 프롬프트에 맞춰 진행하면 됩니다.

검증 가능한 체크리스트

node -v와 npm -v가 정상 출력되는가
npm install -g @anthropic-ai/claude-code 후 claude --version 또는 npx @anthropic-ai/claude-code --version 실행 가능 여부
계정 연동 후 터미널에서 claude 명령으로 간단한 대화를 시도해 볼 수 있는지 확인하세요 (예: claude whoami 또는 대화 메시지 입력).

참고 및 레퍼런스

Node.js: https://nodejs.org/
nvm: https://github.com/nvm-sh/nvm
nvm-windows: https://github.com/coreybutler/nvm-windows
(패키지) npm: https://www.npmjs.com/package/@anthropic-ai/claude-code
Claude Code 공식 문서: https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview

마무리하며

이번 포스팅에서는 Anthropic의 새로운 CLI 도구인 Claude Code의 설치 및 초기 설정 과정을 살펴보았습니다. 터미널 환경에서 AI와 직접 소통하며 개발 효율을 극대화해 보시기 바랍니다. 추가로 궁금한 점이나 막히는 부분이 있다면 공식 문서를 참고하거나 댓글로 소통해 주세요!

Twitter Facebook LinkedIn

[Claude] Anthropic Claude Code 설치 및 초기 설정 가이드

Dongle Seo.