[03편] Claude Code 설치하는 방법

TL;DR - 바쁘면 이것만 실행하세요.

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Window PowerShell
irm https://claude.ai/install.ps1 | iex

# Window CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

# 첫 실행
cd ~/your-project
claude

→ 끝! 로그인 화면이 뜨면 안내대로 따라가면 됩니다.

왜 Claude Code 설치를 03편에 했는가?

사실 작성 한 줄 알았습니다. 그래서 제목을 다 수정해야 하나 싶었는데.

생각해보니 "그럴 필요가 없다" 가 제 생각입니다.

이유는 간단합니다. Claude Code는 결국 터미널 위에서 도는 CLI 라서

터미널이 쾌적해야 Claude Code도 잘 쓸 수 있기 때문입니다.

즉 준비운동은 끝났으니. 실행만 해보면 됩니다.

Claude Code는 뭔가요? - 1분 정리

터미널에서 동작하는 Anthropic 공식 AI 코딩 에이전트

++ChatGPT++ vs ++Claude Code++ : 차이점

왜 Claude Code인가? - "ChatGTP가 더 편한데요" 라는 분들에게

대부분 사람들은 ChatGPT 가 편하다고 합니다.
이유 거의 같습니다 - "메모리" 기능 때문이죠.
"내가 했던 질문들이 ChatGPT는 모두 학습하고 있다"고 믿기 때문입니다.

혹시 ChatGPT 에서 이런 프롬프트를 써본 적 있으신가요?

나는 개발자에서 기획자로 넘어가는 중인 사람이고. 경력은 10년차인데~
내가 지금 Develog 라는 포스팅을 써야하는데.. 
Develog 우리팀원이 만든 자기개발 전용 블로그 사이트야 
https://develog.kiweb.or.kr/
Claude Code 설치하는 방법에 대해서 포스팅 하고싶은데.
내가 원하는 출력 결과물은  아래와 같아.

## 개요
[누구나 이해하기 쉽게 한줄이 되도록 작성]

## 타겟
- 타겟1
- 타겟2 
....

흔히 "AI 잘 쓰려면 프롬프트를 잘 써야 한다."고 하죠, 저도 동의 합니다.

동의는 하지만 글쎄요. 이미 이 정도로 프롬프트를 잘 쓴 상황이라면 사실 내가 무엇을 해야 할지, 어떤 문제를 풀어야 할지는 이미 결정이 끝난 상태 아닐까요? 정작 필요한 건 답이나 아이디어인데, 그걸 얻기 위해 매번 똑같은 맥락을 다시 타이핑하고 있는 셈입니다.

결국 AI는 도구입니다. 내 시간을 아껴주기 위한 수단이죠.

다른 사람들이 쓰는 AI와 내가 쓰는 AI가, 정말로 같은 시간을 아껴주고 있는 걸까요?

한 번쯤은 고민해 볼 만한 질문이라고 생각합니다.

Claude Code가 다른 점은 곧 다룰 CLAUDE.md 에서 본격적으로 드러납니다. 매번 길게 프롬프트 써넣지 않아도.
나의 역할과 프로젝트 맥락을 Claude가 이미 알고 시작하거든요.

설치

저는 맥을 사용중이라, 윈도우 샘플을 작성을 할 수가 없습니다.

대신 Window 를 쓰시는 분들에게 좋은 글이 있어서 추천드립니다.

https://ai-labs.kiweb.or.kr/tips/post/claude-code-cli-setup-guide-HVOyGMUALwjZ9RT

맥 기준으로는, 설치방법이 크게 3가지 형태가 존재하는데요.

• crul
• brew
• npm

예전에는 npm 만으로 설치가 가능했었는데 (node 진영 개발자라 너무 편했습니다..)

이제는 Native install 이 따로 만들어져서, Node 환경 의존하지 않는 형태로 진행하는 curl 와 brew 를 추천합니다.

curl -fsSL https://claude.ai/install.sh | bash

# 최신 채널 (새 버전 즉시 받음)
brew install --cask claude-code@latest

# 업그레이드 (수동)
brew upgrade claude-code

→ Homebrew를 이미 쓰는 사람에게 깔끔한 옵션. 단, 자동 업데이트 안 됨 — 주기적으로 brew upgrade 해야 함.

첫 실행

# 작업할 폴더로 이동
cd ~/my-project

# 실행
claude

Tip: claude 를 한글로 변경해서 작성하면 "치명ㄷ" 가 되요 치명ㄷ... 치명ㄷ... 치명ㄷ...

처음 실행하면 :

1. 로그인 흐름이 뜬다(Claude.ai 구독 인증 또는 API 키)
2. 안내대로 진행하면 브라우저 창이 자동으로 열림
3. 인증 후 터미널로 돌아오면 프롬프트 대기 상태( > 표시 )

이제 아무거나 입력해보자.

Claude가 Read , Bash 같은 도구를 쓰겠다고 권한 요청을 합니다. 처음에는 매번 Yes/Allow 로 승인하면 됩니다.

참고로 Claude 를 종료하고 싶다면.

exit

명령어를 작성하시면 됩니다.

자주 막히는 곳 (FAQ)

Q1. "command not found: claude"

→ PATH가 안 잡혔다. 셸 재시작 또는:

source ~/.bashrc 
## 또는
source ~/.zshrc

Q2. macOS에서 "확인되지 않는 개발자 경고"

→ 시스템 환경설정 → 개인정보 보호 및 보안 → 하단의 “그래도 열기”

Q3. Windows WSL에서 한글이 깨짐

→ 01편 Ghostty 한글 폰트 설정 참고. WSL의 경우 Windows Terminal 폰트를 D2Coding이나 유사 폰트로 변경.

Q4. 업데이트는 어떻게?

• Native(curl) : 자동 (백그라운드)
• Homebrew : brew upgrade claude-code

출처 및 참고

• 공식 설치 가이드: https://code.claude.com/docs/en/setup
• Claude Code 가격: https://claude.com/pricing

TMI : 교강사 시절 이야기

학생들이 query 라는 단어를 너무 느리게 쳐서, 노하우를 한번 전수를 해준적이있죠,

"query" 라고 생각하지말고, "볃교" 라고 생각해봐.

query 를 한글 모드에서 그대로 치면, "볃교" 가 되거든요. 그 순간 학생들이 "볃교, 볃교, 볃교" 하면서 타이핑이 빨라졌던 기억이 납니다. db.query("") , DOM 계열에서 document.querySelector 쓸때마다, 자신감 붙어서 타이핑 하던 모습이
갑자기 생각나네요..

claude 쓰실때도, "치명ㄷ" 라고 생각하면 오타안납니다..ㅋ