Anthropic 의 Claude Code CLI 설치부터 블로그 원고 자동 생성까지 단계별로 따라하는 완전 초보자용 가이드. Node.js 설치, 로그인, 첫 프로젝트, 블로그 자동화 기초.
한 줄 결론
Claude Code 는 터미널 안에서 살아 움직이는 AI 코딩 동료입니다. 개발자가 아니어도 설치부터 첫 블로그 포스트 자동 생성까지 3시간이면 충분합니다.
설치는 두 번, 로그인은 한 번이면 끝입니다.
이 가이드만 그대로 따라오시면 여러분의 컴퓨터 안에 본인 전용 AI 비서가 들어앉습니다.
6
Step
15분
예상 소요
무료
가입·설치 비용
3종
지원 환경 (VS Code·Term·JetBrains)
이 튜토리얼로 얻는 것
터미널에서 claude 한 단어로 AI 와 대화하는 환경
파일을 직접 읽고/쓰고/수정하는 에이전트 모드 체험
블로그 원고 1편을 자동으로 만들어보는 최소 실습
예상 소요 시간: 1.5 ~ 3시간 (Node.js 가 이미 깔려 있다면 1시간 내외)
준비물
설치 전에 계정과 도구 네 가지만 확인하시면 됩니다.
[ ] Anthropic 계정 — claude.ai 가입 무료, 이후 Pro 구독 또는 API 과금 (유료)
[ ] Node.js 18 이상 — https://nodejs.org 의 LTS 다운로드 (무료)
[ ] 기본 터미널 — macOS: Terminal.app / Windows: PowerShell 또는 Git Bash (무료)
[ ] 텍스트 에디터 — VS Code 추천 (무료)
📖 용어 풀이 • CLI(Command Line Interface): 명령어를 직접 타이핑해서 프로그램을 조작하는 방식. 버튼 대신 글자로 명령합니다. • Node.js: JavaScript 프로그램을 컴퓨터에서 실행할 수 있게 해주는 런타임. Claude Code 는 이 위에서 돕니다. • LTS(Long Term Support): 장기 지원 버전. 안정성이 검증된 권장 버전입니다.
코드 화면
Step 1 — Node.js 설치 확인
Claude Code 는 npm 패키지로 배포됩니다.
그래서 Node.js 가 먼저 깔려 있어야 합니다.
터미널을 열고 아래 명령어를 입력해보세요.
node --version
v20.x.x 처럼 v 뒤에 숫자가 나오면 성공입니다.
"command not found" 가 나오면 https://nodejs.org 접속 후 LTS 버전을 다운로드해서 설치하시면 됩니다.
🟡 주의: Node.js 16 이하 구버전은 Claude Code 최신 기능을 지원하지 않습니다. 반드시 18 이상, 가능하면 20 LTS 를 설치하세요.
명령어 실행 결과
에디터 설치 화면
Step 2 — Claude Code 설치
다음 한 줄이면 설치가 끝납니다.
npm install -g @anthropic-ai/claude-code
-g 는 전역 설치 옵션입니다.
어느 폴더에서든 claude 명령어를 쓸 수 있게 해줍니다.
설치 완료 후 버전 확인:
claude --version
버전 번호가 출력되면 성공입니다.
📖 용어 풀이 • npm(Node Package Manager): Node.js 전용 패키지 관리자. 앱스토어 같은 개념인데 개발자용입니다. • 전역 설치(-g): 시스템 전체에서 쓸 수 있게 설치. 반대말은 특정 프로젝트 폴더에만 설치하는 "로컬 설치". • 패키지: 누가 미리 만들어 올려둔 코드 묶음. Claude Code 도 하나의 패키지입니다.
🟢 팁: VS Code 확장이 가장 빠른 경로입니다. 터미널 사용이 어색하시면 VS Code 를 먼저 설치하신 뒤, 그 안의 통합 터미널에서 같은 명령어를 치시면 됩니다.
명령어 실행 결과
작업 환경
Step 3 — 로그인과 첫 실행
작업 폴더를 만들고 그 안에서 Claude Code 를 실행합니다.
mkdir my-first-ai-project
cd my-first-ai-project
claude
처음 실행하면 Anthropic 로그인 링크가 터미널에 뜹니다.
링크를 복사해서 브라우저로 열면 자동으로 세션이 연결됩니다.
클로드코드 처음 실행 화면
이제 채팅창처럼 질문을 입력할 수 있습니다.
첫 테스트 명령을 한번 해보세요.
> 이 폴더에 hello.md 파일을 만들고 "안녕하세요" 라고 써줘
Claude 가 직접 파일을 만들어주면 에이전트 모드가 정상 작동 중이라는 뜻입니다.
기본 AI 챗봇과의 가장 큰 차이점이 여기에 있습니다. Claude Code 는 대답만 하는 게 아니라 컴퓨터를 직접 조작합니다.
🟢 팁: 처음에는 읽기 전용 요청("이 파일 요약해줘")부터 시작하시는 걸 권합니다. 파일을 지우거나 덮어쓰는 명령은 몇 번 익숙해진 뒤에 써도 충분합니다.
Node.js 공식 다운로드 화면
Step 4 — 첫 블로그 포스트 자동 생성
이번에는 블로그 원고 1편을 Claude 에게 맡겨 봅니다.
> 오늘 AI 업계 주요 뉴스 1건을 골라서 한국어 블로그 원고로 작성해줘. 2,000자 내외, 존댓말, 일반 IT 관심층 대상. 제목, 본문, 해시태그 순서로 정리.
2~3분이면 원고 1편이 나옵니다.
Claude 는 웹 검색 도구가 활성화되어 있으면 최신 뉴스를 직접 가져와 씁니다.
원고 출력 화면
자동화를 한 단계 올리기
더 정교한 자동화가 필요하면 프로젝트 루트에 CLAUDE.md 파일을 만들어 규칙을 적어두세요.
# CLAUDE.md
- 원고는 항상 3,000자 이상
- 존댓말 고정
- 해시태그는 10개 이내
다음부터 이 폴더에서 claude 를 실행하면 이 규칙이 자동으로 읽힙니다.
매번 반복 지시할 필요가 없어집니다.
📖 용어 풀이 • 에이전트 모드: AI 가 단순 대답을 넘어 파일·터미널을 직접 조작하는 실행 모드. • CLAUDE.md: Claude Code 가 매 대화 시작 시 자동으로 읽는 프로젝트 규칙 파일. • 슬래시 커맨드: /fix, /review 처럼 반복 작업을 한 글자로 줄여주는 단축 명령. • subagent: 메인 에이전트가 특정 작업을 위임하는 보조 에이전트. 스코프·권한을 따로 설정할 수 있습니다. • MCP(Model Context Protocol): Claude 가 외부 툴(GitHub, Playwright, Supabase 등)과 표준 방식으로 대화하게 해주는 프로토콜.
Claude code 공식 문서
Step 5 — 결과 확인과 문제 해결
아래 세 가지가 모두 성립하면 정상 설치입니다.
터미널에 claude 를 치면 대화 프롬프트가 뜬다
파일 생성·수정 요청이 실제 폴더에 반영된다
블로그 원고 요청에 2~3분 안에 원고 1편이 돌아온다
자주 묻는 문제 (FAQ)
Q. claude: command not found 가 뜹니다.
A. npm 전역 설치 경로가 PATH 환경변수에 등록되지 않아서 그렇습니다.
macOS/Linux 는 echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc 실행 후 터미널 재시작하세요. Windows 는 PowerShell 을 관리자 권한으로 다시 열어보시면 해결되는 경우가 많습니다.
Q. 로그인 후에도 "Not authenticated" 에러가 반복됩니다.
A. claude logout 으로 세션을 끊고 다시 claude 를 실행해서 재로그인해보세요.
그래도 안 되면 브라우저 쿠키를 지운 후 claude.ai 에서 먼저 로그인하고 다시 시도하시면 대부분 해결됩니다.
Q. 응답이 너무 느리거나 중간에 끊깁니다.
A. API 사용량 한도 초과일 가능성이 높습니다.
console.anthropic.com 에서 사용량을 확인하시고 필요 시 월 Pro 구독 또는 API 크레딧을 충전하시면 됩니다.
🟡 주의: 회사 계정·개인 계정 이중 로그인 상태에서 쿠키가 꼬이는 경우가 많습니다. 시크릿 창을 하나 열어 깨끗한 세션에서 로그인해보시면 빠르게 원인이 드러납니다.
