클로드 코드 설치 방법: 맥에서 명령어 한 줄이면 끝

"클로드 코드 설치"를 검색하면 방법이 여러 갈래로 나옵니다. npm으로 깔라는 글, Homebrew를 먼저 설치하라는 글, 공식 스크립트를 쓰라는 글이 섞여 있습니다. 결론부터 말하면 맥에서는 터미널에 아래 한 줄이면 끝입니다.

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

그런데 명령어를 치기 전에 반드시 확인할 게 하나 있습니다. Claude Code(클로드 코드)는 무료 플랜으로는 쓸 수 없습니다. 설치는 되지만 로그인 단계에서 막힙니다. 이 이야기부터 먼저 하고 설치로 넘어가겠습니다.

터미널을 한 번도 안 열어보셨어도 괜찮습니다. 이 글은 다섯 단계를 그대로 따라 하도록 만들었습니다. 터미널 실행, 설치 명령어 입력, 설치 확인, 로그인, 첫 부탁까지입니다. 단계마다 "이렇게 보이면 성공"을 적어 두었으니 화면과 비교하며 내려가시면 됩니다. 설치 명령어는 유통기한이 짧은 정보라 막히면 공식 문서를 한 번 더 확인해 보세요.

요금: 무료 플랜 불가, Pro 이상 필요

먼저 짚고 갑니다. 이 부분에서 헛걸음하는 분이 많습니다.

공식 문서는 이렇게 못 박습니다. Claude Code는 Pro, Max, Team, Enterprise 또는 Console 계정이 필요하고, 무료 Claude.ai 플랜에는 Claude Code 접근이 포함되지 않습니다. 브라우저에서 claude.ai에 무료로 로그인해 대화하던 것과는 다른 이야기입니다.

여기서 헷갈리기 쉬운 지점이 있습니다. 설치 자체는 무료 계정이어도 됩니다. 명령어는 잘 돌아가고 claude --version도 정상으로 뜹니다. 막히는 건 그다음, 로그인해서 실제로 일을 시키려는 순간입니다. 그러니 설치가 됐다고 해서 쓸 수 있다는 뜻은 아닙니다.

같은 계열 도구인 Codex CLI(코덱스 CLI)는 이 점이 반대입니다. Codex(코덱스)는 무료 플랜을 포함해 ChatGPT(챗지피티) 전 플랜에 들어 있어서 일단 맛은 볼 수 있습니다. 돈을 안 쓰고 터미널 AI를 먼저 겪어 보고 싶다면 Codex 쪽이 문턱이 낮습니다. 저라면 무료로 Codex를 며칠 써 보고 감을 잡은 뒤에 Claude Code 구독을 결정하겠습니다. 순서를 그렇게 잡으면 최소한 "구독했는데 안 맞더라"는 일은 피할 수 있습니다.

준비물: 유료 구독과 macOS 13 이상

준비물은 세 가지입니다. 어느 하나라도 안 맞으면 설치가 막히니 먼저 훑어 두세요.

윈도우를 쓰고 계시다면 설치 명령어가 다릅니다. 윈도우 편은 별도 글로 정리했습니다.

스텝 1: 터미널 실행

키보드에서 Command와 스페이스 바를 같이 눌러 스포트라이트 검색을 엽니다. 여기에 "터미널"을 입력하고 Enter를 누릅니다. 응용 프로그램 폴더의 유틸리티 안에서 Terminal을 찾아 열어도 같습니다.

이렇게 보이면 성공입니다. 흰(또는 검은) 창이 뜨고 커서가 깜박입니다. 이 창이 오늘의 작업대입니다. 터미널이라는 환경 자체가 궁금하시더라도 지금은 넘어가셔도 됩니다. 이 글은 창을 열고 명령어를 붙여넣는 것만으로 끝나게 만들었습니다. 터미널을 처음부터 익히고 싶으시면 터미널 첫 설정 레슨이 따로 있습니다.

스텝 2: 설치 명령어 입력

아래 한 줄을 그대로 복사해 터미널 창에 붙여넣고 Enter를 누릅니다.

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

앞에 sudo를 붙이지 마세요. 다른 설치 가이드를 보다 보면 sudo를 습관처럼 붙이게 되는데, 여기서는 오히려 문제가 됩니다. Claude Code는 내 홈 폴더 안에 설치되기 때문에 관리자 권한이 필요 없습니다. sudo를 붙이면 엉뚱하게 관리자 계정의 홈 폴더에 깔려서 정작 내 창에서는 claude 명령이 안 먹힙니다. 설치 스크립트도 이걸 알고 있어서 sudo를 감지하면 아예 실행을 거부하고 이유를 알려 줍니다.

이 명령어가 하는 일을 풀어 보면 이렇습니다. Anthropic의 공식 설치 스크립트를 내려받아 실행합니다. 스크립트는 내 맥의 종류(인텔인지 애플 실리콘인지)를 알아서 판별하고, 그에 맞는 파일을 받은 다음, 받은 파일이 진짜 Anthropic이 배포한 것인지 체크섬으로 대조합니다. 그 확인을 통과해야 설치로 넘어갑니다. 택배를 받으면 송장 번호를 대조해 보고 뜯는 것과 같습니다.

설치가 끝나면 어느 창에서든 claude라고만 쳐도 실행되도록 셸 설정까지 스크립트가 처리합니다. 본체는 ~/.local/share/claude 폴더에 들어가고, 그걸 가리키는 바로가기가 ~/.local/bin/claude에 생깁니다.

이렇게 보이면 성공입니다. Setting up Claude Code...라는 줄이 지나간 뒤 아래 안내가 뜹니다.

✅ Installation complete!

진행률 막대는 나오지 않으니 화면이 잠시 조용해도 정상입니다. 독(Dock)이나 런치패드에 아이콘은 생기지 않습니다. 원래 안 생기는 게 정상입니다.

스텝 3: 새 창에서 설치 확인

지금 열려 있는 터미널 창을 완전히 닫고 스텝 1과 같은 방법으로 새 창을 엽니다. 방금 한 셸 설정이 새로 여는 창부터 적용되기 때문입니다. 새 창에 아래를 입력합니다.

claude --version

이렇게 보이면 성공입니다.

2.1.238 (Claude Code)

위 출력은 이 글을 쓰며 제 맥에서 직접 확인한 결과입니다. 버전 숫자는 설치 시점마다 다릅니다. 숫자는 달라도 괜찮고, 괄호 안에 Claude Code라는 문구가 뜨면 설치는 정상입니다.

버전 이야기가 나온 김에 하나 덧붙이면, Claude Code는 업데이트를 따로 챙길 필요가 없습니다. 공식 스크립트로 깔면 백그라운드에서 알아서 최신 버전으로 올라갑니다. 실제로 제 맥의 설치 폴더를 열어 보니 그동안 거쳐 간 버전이 여섯 개 쌓여 있었습니다. 제가 업데이트 명령을 친 적은 한 번도 없습니다.

스텝 4: Claude 계정 로그인

같은 창에 이번엔 이렇게만 입력합니다.

claude

브라우저가 자동으로 열립니다. 평소 쓰는 Claude 계정으로 로그인하면 창이 다시 터미널로 이어집니다. 한 번 로그인하면 컴퓨터에 저장되니 다음부터는 이 단계가 없습니다.

여기가 앞에서 말한 갈림길입니다. 무료 계정으로 로그인하면 이 지점에서 막힙니다. 구독이 없다면 claude.ai에서 Pro 이상으로 올린 뒤 다시 시도하시면 됩니다.

이렇게 보이면 성공입니다. 터미널 안에 Claude Code의 대화 입력창이 뜹니다.

스텝 5: 첫 부탁 한 문장

입력창에 코드가 아니라 그냥 말을 적으면 됩니다. 이렇게 물어보세요.

이 폴더에 어떤 파일이 있는지 정리해 줘

Claude가 폴더를 읽고 정리해 답하는 걸 보셨다면 오늘 할 일은 끝났습니다. 터미널 환경 자체를 기초부터 쌓고 싶으시면 AI CLI 트랙이 여섯 편으로 준비돼 있습니다.

command not found와 로그인 거부 정리

claude를 쳤는데 "command not found"가 뜹니다. 대부분 창 때문입니다. 셸 설정은 새로 여는 창부터 적용되므로 설치할 때 쓰던 창에서는 못 찾습니다. 터미널을 완전히 닫고 새 창을 열어 다시 쳐보세요. 급하다면 지금 창에서 아래를 친 뒤 바로 실행할 수도 있습니다.

export PATH="$HOME/.local/bin:$PATH"
claude

설치하려는데 "do not run this installer with sudo"가 뜹니다. 명령어 앞에 sudo를 붙이셨다는 뜻입니다. 스크립트가 일부러 막은 것이니 sudo를 빼고 그대로 다시 실행하시면 됩니다.

로그인이 안 되고 계정이 거부됩니다. 무료 플랜일 가능성이 큽니다. Claude Code는 Pro 이상 구독이 필요합니다.

원인을 모르겠습니다. claude doctor를 치면 설치 상태를 점검해 줍니다. 세션을 시작하지 않고 진단만 출력하므로 부담 없이 쳐도 됩니다. 설치 방식, 버전, 자동 업데이트 상태, 그리고 문제가 있으면 그 원인과 해결 방법까지 같이 알려 줍니다.