Claude Code 설치 방법을 찾고 있다면, 아마 나와 비슷한 상황일 가능성이 높다. Claude는 써봤는데, Code는 뭔가 다르다고 하니 한번 써보고 싶은 것.
직접 설치해보면서 느낀 건 "생각보다 복잡하지는 않은데, 모르면 첫 단계에서 막힌다"는 것이었다. 그 막히는 지점들을 중심으로 정리해봤다.
Claude Code가 일반 Claude와 다른 이유
웹에서 쓰는 Claude(claude.ai)는 브라우저 안에서 대화로 작동한다. 파일을 붙여넣고, 질문하고, 답을 받는 구조다.
Claude Code는 다르다. 내 컴퓨터의 터미널(명령어 입력창)과 연결되어, 실제 파일을 읽고 수정하고 실행하는 것까지 직접 한다. 그래서 브라우저가 아닌 별도 설치가 필요한 것이다.
쉽게 비교하면 이렇다.
- 일반 Claude: 내가 코드를 복사해서 가져오면 봐주는 조수
- Claude Code: 내 컴퓨터 안으로 들어와 직접 파일을 열어 작업하는 조수
코딩을 잘 몰라도, 이 차이는 체감이 된다. 실제로 쓰다 보면 내가 뭔가를 복사해서 붙이는 과정이 아예 없어지는 느낌이랄까.
설치 전에 반드시 확인할 것 — Node.js
Claude Code는 npm이라는 패키지 관리자를 통해 설치한다. 그리고 npm은 Node.js를 설치해야 함께 따라온다.
비전공자 입장에서 이 부분이 가장 낯선 첫 장벽이다.
Node.js가 뭔지 몰라도 괜찮다. 일단 설치부터 하면 된다.
- 브라우저에서 nodejs.org 접속
- "LTS" 버전 다운로드 (LTS는 안정 버전이라는 뜻)
- 설치 파일 실행 — 계속 "다음" 누르면 끝
설치가 끝나면 터미널을 열고 아래를 입력해서 확인한다.
node -v
숫자가 뜨면 성공이다. 예를 들어 v20.11.0 같은 형태로 나온다. 아무것도 안 뜨거나 오류가 나면 Node.js 설치를 다시 시도해야 한다.
터미널은 Mac이면 "터미널" 앱, Windows면 "명령 프롬프트" 또는 "PowerShell"을 쓰면 된다.
Claude Code 설치 — 명령어 3줄로 끝
Node.js 준비가 됐다면 Claude Code 설치는 빠르다.
터미널에서 아래 명령어를 순서대로 입력한다.
- Claude Code 설치
npm install -g @anthropic-ai/claude-code
- 설치 확인
claude --version
- 로그인 및 초기 설정
claude
처음 claude 명령어를 실행하면 Anthropic 계정 연결 절차가 시작된다. 브라우저가 열리면서 로그인 화면이 나오거나, API 키를 입력하라는 안내가 나온다.
내가 처음 막혔던 부분이 여기다. Claude.ai 계정으로 바로 로그인되는 줄 알았는데, Claude Code는 Anthropic의 API를 사용하기 때문에 API 키가 필요한 경우가 있다. 이 부분은 아래 요금 섹션에서 같이 설명한다.
Windows에서 추가로 해야 할 수 있는 것
Windows 환경에서는 PowerShell 실행 정책 문제로 설치가 막히는 경우가 있다. 이때는 PowerShell을 관리자 권한으로 열고 아래를 입력한다.
Set-ExecutionPolicy RemoteSigned
이후 다시 설치 명령어를 실행하면 대부분 해결된다.
설치 후 처음 해볼 수 있는 것들
코드를 전혀 몰라도 바로 써볼 수 있는 예시 두 가지다.
첫 번째는 파일 요약이다. 터미널에서 어떤 폴더로 이동한 다음 claude를 실행하고, "이 폴더에 있는 파일들을 설명해줘"라고 자연어로 입력하면 된다. Claude Code가 폴더 구조를 읽어서 설명해준다.
두 번째는 문서 작성이다. "README.md 파일을 만들어서 이 프로젝트를 소개하는 내용을 써줘"처럼 요청하면 실제로 파일이 생성된다. 결과물이 내 폴더에 저장되는 걸 보면 꽤 신기하다.
처음엔 "이게 작동하는 건지" 반신반의했는데, 파일이 실제로 생기는 순간 실감이 난다.
요금과 API 비용 — 헷갈렸던 부분 정리
Claude Code는 현재 Claude 구독 플랜(Pro, Max 등)이 있으면 포함해서 사용할 수 있는 경우가 있다. 단, 사용 방식에 따라 다르다.
- Claude.ai 계정으로 연결하는 경우: 기존 구독 플랜 내에서 사용 가능
- API 키를 직접 발급해서 사용하는 경우: 사용량에 따라 별도 비용 발생
API 방식은 Anthropic 콘솔(console.anthropic.com)에서 키를 발급받아야 한다. 요금은 입력/출력 토큰 기준으로 부과되며, 가벼운 작업이라면 하루 몇백 원 수준일 수 있지만, 긴 파일을 많이 다루면 예상보다 늘어날 수 있다.
무료로 시작해보고 싶다면 Claude.ai 계정 연동 방식부터 시도해보는 게 낫다. API 비용이 어떻게 쌓이는지 모르는 상태에서 API 키부터 쓰면 나중에 당황할 수 있다.
막혔을 때 확인해볼 것들
설치 과정에서 가장 자주 마주치는 문제들이다.
- "claude 명령어를 찾을 수 없다"는 오류: 터미널을 껐다 다시 열면 해결되는 경우가 많다
- Node.js 버전 문제: 너무 오래된 버전(v16 이하)이면 설치가 안 될 수 있다. LTS 최신 버전으로 업데이트
- 권한 오류: Mac에서는 명령어 앞에 sudo를 붙여서 실행해보는 것도 방법이다
비전공자 입장에서 터미널 자체가 낯설어서 오류 메시지를 봐도 뭘 해야 할지 모르는 게 제일 힘들다. 오류 메시지 전체를 복사해서 Claude.ai에 붙여넣고 "이게 무슨 오류야?"라고 물어보는 게 의외로 제일 빠른 해결책이었다.
설치 자체는 어렵지 않다. 터미널이 처음이라면 그 낯섦을 넘는 게 실제 관문이고, 그 다음은 생각보다 순탄하다.
