클로드 코드 설치방법 맥북 에어 M1 터미널앱 — “command not found” 오류까지 해결

클로드 코드 설치방법 어렵다고 느끼셨죠? 필자도 오늘 클로드 코드를 맥북 에어 M1에 설치하면서 딱 이 상황을 겪었어요.

설치는 됐다고 나오는데 막상 claude --version 치면

zsh: command not found: claude

이거 뜨는 분들 분명 있을 거예요. 저도 그랬거든요. 결론부터 말하면 설치가 안 된 게 아니라 PATH 설정만 빠진 것이고, 명령어 한 줄로 1초 해결됩니다.

클로드 코드란?

Anthropic이 만든 터미널 기반 AI 코딩 에이전트예요. 채팅으로 지시하면 실제 파일을 읽고, 코드를 수정하고, 명령어를 실행해줍니다. ChatGPT처럼 코드 보여주고 끝이 아니라 직접 작업해주는 게 핵심 차이예요.

M1 맥북 에어 포함 Apple Silicon 전 기종 정식 지원합니다.

설치 전 확인사항

• macOS: Ventura(13.0) 이상 권장
• 칩: M1 이상 또는 Intel 모두 OK
• 플랜: Claude Pro / Max / Teams 중 하나 필요 (무료 플랜은 CLI 사용 불가)
• 인터넷 연결

클로드 코드 설치방법 — 맥북 에어 M1 기준

1단계. 터미널 열기

Spotlight(Command + Space) → “터미널” 검색 → 실행

2단계. 설치 명령어 실행

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

잠깐 기다리면 이렇게 뜹니다:

✔ Claude Code successfully installed!
  Version: 2.1.78
  Location: ~/.local/bin/claude

여기서 끝난 것 같지만 아직 아닙니다.

노란 경고 문구를 자세히 보면:

⚠ Setup notes:
• Native installation exists but ~/.local/bin is not in your PATH.

→ 설치는 됐는데 터미널이 claude 명령어 위치를 모르는 상태예요.

3단계. PATH 설정 (핵심)

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

이 한 줄이 ~/.local/bin 경로를 터미널이 찾을 수 있게 등록해줍니다.

4단계. 설치 확인

claude --version

2.1.78 (Claude Code)

이렇게 버전 숫자가 뜨면 완료입니다. ✅

“command not found” 오류 원인 정리

상황	원인
설치 직후 바로 claude 입력	PATH 미설정
터미널 재시작 후에도 오류	~/.zshrc 반영 안 됨
Homebrew로 설치한 경우	경로 다를 수 있음 (/opt/homebrew/bin)

설치 후 실행 방법

작업할 프로젝트 폴더로 이동 후:

cd ~/내프로젝트폴더
claude

한국어로 대화 가능합니다. 코드 명령어 몰라도 됩니다.

> 이 폴더 구조 분석해줘
> functions.php 파일에 버그 있는지 찾아줘
> README 파일 한국어로 작성해줘

이런 식으로 자연어로 지시하면 실제 파일을 직접 수정해줍니다.

자주 묻는 질문

마치며

맥북 에어 M1에서 클로드 코드 설치방법, 요약하면:

1. curl -fsSL https://claude.ai/install.sh | bash
2. PATH 한 줄 추가
3. claude --version 확인

“command not found” 뜨더라도 당황하지 말고 PATH만 잡아주면 됩니다. 설치 후엔 한국어로 바로 대화 시작할 수 있어요.

📚 함께 읽으면 좋은 콘텐츠

클로드 AI 요금제 비교 및 무료로 쓰는 방법 총정리 (2026 최신)

클로드 AI 비교 vs 챗GPT 후기 – 2026년 직접 써보고 결정했습니다

SKT 데이터 함께쓰기 이틀만에 21GB 날린 이유 – 맥북 테더링 데이터 폭탄의 범인은?

제미나이 챗GPT 사주 비교 – 7개 AI로 직접 테스트한 충격 결과 (2026)