Claude Code 설치 방법 — 비개발자도 따라하는 설치 가이드
“AI 코딩 도구를 써보고 싶은데 설치부터 막힌다” — 이 문장에 해당된다면 10분만 투자하라. Claude Code 설치는 딱 3단계다. Node.js 설치, Claude Code 설치, 첫 실행. 나도 처음엔 터미널을 열어본 적 없는 상태에서 시작했다. 8년 차 개발자였지만 해고 후 새로 시작하는 마음으로, 비개발자 관점에서 각 단계를 스크린샷 수준으로 정리한다.
Claude Code가 뭔가 — 30초 요약
Claude Code는 터미널에서 실행되는 AI 코딩 도구다.
핵심은 이거다:
한국어로 “이런 거 만들어줘”라고 말하면
코드를 작성하고 파일을 만들고 실행까지 한다.
운전면허로 비유하면:
엔진 구조를 몰라도 운전은 할 수 있다.
Claude Code도 프로그래밍 언어를 몰라도
“한국어로 말하면 컴퓨터가 움직인다”만 알면 된다.
설치 전 준비물
| 항목 | 필요 여부 | 비고 |
|---|---|---|
| 컴퓨터 (Mac/Windows/Linux) | 필수 | 모두 지원 |
| 인터넷 연결 | 필수 | |
| Claude 계정 | 필수 | claude.ai에서 가입 |
| Claude Pro 구독 ($20/월) | 권장 | 무료는 사용량 제한 |
| Node.js 18 이상 | 필수 | 아래에서 설치 |
| 코딩 경험 | 불필요 |
1단계: Node.js 설치 (3분)
Claude Code는 Node.js 위에서 돌아간다.
Node.js는 JavaScript를 실행하는 프로그램인데,
이걸 이해할 필요는 없다. 그냥 설치만 하면 된다.
Mac
터미널을 연다 (Spotlight에서 “터미널” 검색).
아래 명령어를 복사해서 붙여넣고 Enter.
brew는 Mac용 프로그램 설치 도구다. 앱스토어의 터미널 버전이라고 생각하면 된다.
brew install node
brew가 없다면 먼저 이걸 실행 (brew 자체를 설치하는 명령어):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Windows
- https://nodejs.org 접속
- LTS 버전 다운로드 (초록색 버튼)
- 설치 파일 실행 → 다음 → 다음 → 완료
설치 확인
터미널에서:
node --version
v18 이상 숫자가 나오면 성공이다.
2단계: Claude Code 설치 (1분)
터미널에서 아래 명령어 한 줄.
npm은 Node.js와 함께 설치되는 패키지 관리자다. 앱을 설치하는 명령어라고 생각하면 된다.
npm install -g @anthropic-ai/claude-code
끝이다.
설치 확인:
claude --version
버전 번호가 나오면 성공이다.
3단계: 첫 실행 (2분)
작업 폴더 만들기
mkdir my-first-project
cd my-first-project
Claude Code 시작
claude
이 한 글자면 된다.
처음 실행하면 Claude 계정 로그인 화면이 나온다.
브라우저가 열리면서 인증하면 끝.
첫 번째 지시
Claude Code가 열리면 한국어로 지시한다:
이 폴더에 "안녕하세요 Claude Code입니다"라고 적힌 hello.txt 파일을 만들어줘
파일이 만들어지면 설치 성공이다.
Claude Code 작동 흐름
코드를 읽을 줄 몰라도
코드를 시킬 줄은 알게 되는 것이다.
실제로 할 수 있는 것
직접 해본 것
블로그 자동 발행 —
마크다운으로 글을 쓰면 API로 자동 발행.
실제로 이 블로그도 Claude Code로 만든 스크립트로 발행하고 있다.
“Blogger API로 자동 발행하는 스크립트 만들어줘” 한 줄로 30분 만에 완성했다.
스레드 자동 발행 —
Threads API로 본문 + 댓글 밀기까지 자동 발행.
이것도 Claude Code에게 지시해서 만들었다.
이런 것도 할 수 있다
- 파일 이름 일괄 변경 — “IMG_0001.jpg”를 날짜 형식으로 한번에 변경
- PDF에서 텍스트 추출 — 계약서에서 원하는 정보만 뽑아서 정리
- 엑셀 데이터 정리 — “이메일 컬럼 기준으로 중복 삭제해줘”면 된다
자주 하는 실수
실수 1: Node.js 설치 안 함
npm: command not found 에러가 나면
Node.js가 설치 안 된 것이다.
1단계로 돌아가라.
실수 2: 관리자 권한 없이 설치
Windows에서 EACCES 에러가 나면
관리자 권한으로 터미널을 열어라.
Mac에서는 sudo npm install -g @anthropic-ai/claude-code.
실수 3: Claude 계정 미가입
Claude Code를 실행하면 로그인이 필요하다.
미리 claude.ai에서 가입해두라.
지금 바로 해볼 것
설치가 끝났으면 터미널을 열고 이 3줄을 쳐라:
mkdir my-first-project
cd my-first-project
claude
그리고 한국어로 “이 폴더에 hello.txt 파일을 만들어줘”라고 입력하라. 파일이 생기면 성공이다. 여기서 멈추지 말고 다음 글로 넘어가라:
자주 묻는 질문
Claude Code를 설치하려면 뭐가 필요한가?
Node.js 18 이상과 Claude Pro 이상 구독이 필요하다.
macOS, Windows, Linux 모두 지원한다.
설치는 터미널에서 명령어 한 줄이면 끝난다.
Claude Code는 무료인가?
Claude Code 자체는 무료지만,
실행하려면 Claude Pro($20/월) 이상 구독이 필요하다.
무료 Claude 계정으로는 사용이 제한적이다.
코딩을 몰라도 Claude Code를 쓸 수 있나?
쓸 수 있다.
한국어로 원하는 걸 설명하면
Claude Code가 코드를 작성한다.
다만 터미널에서 명령어를 입력하는
기본 조작은 알아야 한다.
댓글
댓글 쓰기