쉽게 설치하는 클로드코드(Claude Code) 세팅가이드(맥)

요즘 AI 도구를 본격적으로 쓰려고 하면 터미널(Terminal)이라는 글자만 있는 창을 만나게 됩니다. 클로드 코드(Claude Code)도 터미널에서 쓰는 AI 도구입니다. 평소 Spotlight와 Finder로만 맥을 써 왔다면 낯설겠지만, 터미널은 클릭으로 하던 일을 짧은 한 줄 명령으로 시키는 곳입니다.

설치한 뒤에는 웹 채팅처럼 평소 말로 요청합니다. 다만 Claude Code는 실제 파일을 만들고 명령을 실행하므로, 어느 폴더에서 일하는지와 무엇을 허용했는지, 결과 파일이 요청대로인지까지 함께 봐야 합니다.

클로드 코드(Claude Code)는 앤트로픽이 만든 터미널 기반 AI 코딩 도구입니다. 맥에서는 터미널에 curl -fsSL https://claude.ai/install.sh | bash 한 줄로 설치하고, claude를 실행해 브라우저로 로그인한 뒤 /config에서 답변 언어를 한국어로 정하면 첫 작업을 맡길 수 있습니다.

이 글은 2026년 10월 4일 공식 문서 기준입니다. 이미 설치했다면 claude --version으로 버전이 나오는지 보고, 설치를 반복하지 않습니다. 설치 중 나오는 오류 메시지별 해결법은 글 끝 자주 발생하는 문제에 정리했습니다. 윈도우 PC를 쓴다면 윈도우용 가이드를 봅니다.

터미널에서 AI 도구를 쓰면 달라지는 세 가지

터미널은 글자로 명령을 입력해 컴퓨터를 조작하는 프로그램이고, 맥에서는 기본 앱인 터미널이 이 일을 합니다. CLI(Command Line Interface)는 이렇게 터미널에서 실행하는 프로그램을 말하며, 클로드 코드도 CLI 프로그램입니다.

AI가 글을 읽고 분석하고 쓰는 능력은 웹 채팅과 같습니다. 달라지는 것은 자료가 들어가는 길, 결과가 남는 곳, AI가 실행할 수 있는 일입니다.

웹 채팅과 터미널의 클로드 코드

구분	웹 채팅	터미널의 클로드 코드
자료가 들어가는 길	사람이 첨부하거나 붙여 넣음	작업 폴더의 파일을 직접 읽음
결과가 남는 곳	대화창, 사람이 복사해 저장	작업 폴더에 파일로 저장
실행할 수 있는 일	서비스가 제공하는 기능 안에서	허용한 범위의 파일 수정, 명령 실행

웹 채팅도 드라이브 같은 서비스를 연결하면 파일을 다룹니다. 터미널 도구의 가장 큰 차이는 내 컴퓨터의 폴더 하나를 작업 공간으로 정하고 그 안에서 일한다는 점입니다.

요청 한 번이 진행되는 순서

요청 하나는 다섯 단계로 끝납니다. 마지막 단계가 빠지면 AI가 다른 폴더에 저장했거나 요청과 다르게 쓴 경우를 놓칩니다.

클로드 코드에 요청 하나를 맡길 때

1. 11. 요청할 일을 평소 말로
   명령어는 외우지 않아도 됨
2. 22. 읽기작업 폴더에서
   필요한 파일을 엶
3. 33. 작업과 저장Manual 모드는
   저장 전에 승인을 물음
4. 44. 완료 보고읽은 파일과
   만든 파일을 알려 줌
5. 55. 사람의 확인실제 파일을 열어
   요청과 대조

입력하는 곳이 두 군데입니다

같은 터미널 창 안에 입력하는 곳이 두 군데라서, AI에게 할 요청을 터미널 명령 입력줄에 넣거나 터미널 명령을 클로드 코드 입력창에 넣으면 의도와 다르게 동작합니다. 아래 단계마다 어디에 입력하는지 함께 적었습니다.

터미널 명령 입력줄과 클로드 코드 입력창

구분	터미널 명령 입력줄	클로드 코드 입력창
화면에서 찾는 법	% 뒤의 커서	claude 실행 뒤 나오는 입력칸
입력하는 것	터미널 명령	AI에게 하는 요청, /로 시작하는 명령
예	claude --version, 폴더 이동	파일 정리 요청, /exit

한눈에 보는 순서

시작 전에 사양과 계정을 확인합니다.

• 사양: macOS 13.0(Ventura) 이상, 메모리 4GB 이상입니다. Apple Silicon 맥과 Intel 맥 모두 같은 명령으로 설치합니다.
• 계정: Pro, Max, Team, Enterprise 구독이나 Console 계정이 있어야 합니다. 무료 Claude.ai 플랜으로는 쓸 수 없습니다. Console의 API 사용료는 Claude 구독료와 따로 청구됩니다.

설치부터 첫 작업까지

1. 11. 설치터미널에
   설치 명령 한 줄
2. 22. 폴더와 로그인작업 폴더에서
   claude 실행
3. 33. 한국어 설정/config의
   Language
4. 44. 첫 작업입력창에
   파일 작업 요청
5. 55. 결과 확인Finder나
   터미널로 열기

Git과 공식 스킬은 첫 작업에 필요하지 않습니다. 작업 기록을 남기거나 반복 작업을 묶고 싶을 때 뒤의 선택 단계에서 추가합니다.

1. 터미널을 열고 설치합니다

⌘ Command + Space를 누르면 화면 가운데에 Spotlight 검색창이 뜹니다. "터미널" 또는 "Terminal"을 입력하고 엔터를 누르면 터미널이 열립니다. 맥 기본 셸에서는 입력줄 끝에 % 표시가 보이고, 그 뒤에 명령을 입력합니다.

아래 한 줄을 복사해 터미널에 붙여 넣고 엔터를 누릅니다.

명령 앞에 sudo는 붙이지 않습니다. 설치 스크립트는 사용자 폴더(~/.local/bin)에 설치하도록 만들어져 있어서 sudo를 붙이면 오류를 내고 멈춥니다. 맥 비밀번호도 묻지 않습니다.

설치 마지막에 ~/.local/bin is not in your PATH 안내가 나왔다면 아래 한 줄을 한 번만 실행합니다. PATH는 터미널이 명령을 찾는 폴더 목록이고, 이 줄은 맥 기본 셸인 zsh의 설정 파일에 설치 폴더를 추가합니다.

설치가 끝나면 새 터미널 창을 열고 버전을 확인합니다. 기존 창에서 실행 중인 작업은 그대로 둬도 됩니다.

터미널, zsh

> claude --version

2.1.280 (Claude Code)

버전 번호가 나오면 설치가 끝난 것입니다

설치 스크립트로 깔면 이후 새 버전은 백그라운드에서 자동으로 받습니다.

Homebrew로 프로그램을 관리하고 있다면 brew install --cask claude-code로 설치해도 됩니다. 이 방식은 brew upgrade claude-code로 갱신하고, claude-code는 약 한 주 늦은 stable 채널, claude-code@latest는 최신 채널입니다. 위 설치 스크립트와 Homebrew 가운데 하나만 씁니다.

2. 작업 폴더를 만들고 로그인합니다

클로드 코드는 실행한 폴더 안에서 일하므로, 처음에는 원본 자료가 없는 새 폴더를 만듭니다. 아래 명령을 터미널에 한 줄씩 입력합니다. 첫 줄은 폴더를 만들고, 둘째 줄은 그 폴더로 이동하며, 셋째 줄은 현재 위치를 보여 줍니다.

터미널, zsh

> pwd

/Users/사용자이름/Projects/claude-practice

경로 끝이 Projects/claude-practice인지 봅니다

같은 터미널에 open .을 입력하면 이 폴더가 Finder로 열립니다. 맡길 업무 파일이 있다면 원본이 아니라 복사본을 이 폴더에 넣습니다. 요청이 잘못돼도 원본은 그대로 남습니다. 회사 자료라면 외부 AI 서비스에 넣어도 되는지 조직의 기준을 먼저 봅니다.

준비가 끝나면 아래 명령으로 클로드 코드를 실행합니다. 이 옵션은 이번 세션만 Manual 모드로 시작하고, 다른 세션의 기본 설정은 바꾸지 않습니다.

화면 테마 같은 첫 설정을 물으면 화살표 키와 엔터로 고릅니다. 이어서 브라우저가 열리면 앤트로픽 계정으로 로그인하고 터미널로 돌아옵니다. 인증 완료 표시와 메시지 입력창이 보이면 준비가 끝난 것입니다. API 키를 설정해 둔 컴퓨터라면 로그인 대신 그 키를 쓸지 묻습니다.

권한 모드는 Manual로 시작합니다

권한 모드는 클로드 코드가 파일을 고치거나 명령을 실행하기 전에 사람의 승인을 받을지 정하는 설정입니다. 실행 중에는 Shift + Tab으로 바꿀 수 있습니다.

권한 모드별 승인 방식

모드	Manual--permission-mode default	Auto별도 모델이 검토	Bypass확인을 대부분 건너뜀
파일 수정 전 사람에게 승인 요청	제공	제공하지 않음	제공하지 않음
동작을 판단하는 쪽	사람	별도 모델	대부분 생략

허가 창이 뜨면 대상 파일과 동작이 이번 요청과 맞는지 읽고 승인합니다. 클로드 코드 화면은 끄지 말고 다음 단계로 넘어갑니다.

3. 답변 언어를 한국어로 바꿉니다

한국어로 요청할 수도 있지만, 답변 언어를 설정해 두면 요청마다 적지 않아도 됩니다. 이 설정은 답변 언어만 바꾸며 메뉴 글자를 한국어로 번역하지는 않습니다.

클로드 코드 입력창에서 답변 언어 바꾸기

1. 11. /config 입력클로드 코드 입력창에
   /config
2. 22. Language로 이동화살표 키로 내려가
   엔터
3. 33. 직접 입력목록이 아니라 입력칸
   한국어 또는 korean
4. 44. 닫기엔터로 저장하고
   Esc로 닫기

다음 요청의 답변이 한국어로 나오면 설정이 저장된 것입니다. AI에게 보내는 요청은 계정 사용량을 씁니다.

4. 첫 작업을 맡기고 결과 파일을 엽니다

이제부터는 터미널 명령 대신 클로드 코드 입력창에 한국어 요청을 넣습니다. 첫 작업으로는 결과가 맞는지 바로 대조할 수 있는 일이 좋습니다. 예를 들어 회의록 텍스트 파일의 복사본을 meeting.txt라는 이름으로 작업 폴더에 넣었다면 이렇게 요청합니다.

Claude Code, claude-practice

> meeting.txt를 읽고 담당자, 할 일, 마감을 표로 정리해서 todo.md에 저장해줘.

Do you want to create todo.md?
1. Yes 2. No

파일 이름과 위치가 요청과 맞는지 읽고 승인합니다

meeting.txt를 읽고 todo.md를 만들었습니다.

허가 창에서는 파일 이름과 저장 위치를 읽고 이 작업에 맞으면 진행합니다. 완료 답변을 받으면 Finder에서 todo.md가 생겼는지 확인합니다. 클로드 코드 화면을 닫지 않고 터미널로 확인하려면 ⌘ Command + N으로 새 창을 열고 cd "$HOME/Projects/claude-practice"로 같은 폴더에 들어간 뒤 파일을 읽습니다.

표의 줄 수가 회의록의 항목 수와 같은지, 원문에 담당자나 날짜가 없는 항목이 '미정'으로 남았는지 봅니다. 원문에 없는 이름이나 날짜가 채워졌다면 그 항목을 짚어 "이 항목의 담당자와 마감은 원문에 없으니 미정으로 고쳐줘"라고 다시 요청합니다. cat은 파일 내용을 보여 주기만 하고 고치지 않습니다. Finder에서 파일을 선택하고 Space 키를 눌러 미리보기로 봐도 됩니다.

파일이 없으면 pwd로 지금 폴더를 보고, 클로드 코드가 실제로 어디에 저장했다고 답했는지 다시 읽습니다. 일부만 고칠 때도 고칠 곳과 그대로 둘 곳을 함께 적습니다. 예를 들어 todo.md에서 첫 번째 할 일의 마감만 바꿔 줘. 나머지 줄과 다른 파일은 그대로 둬.라고 요청한 뒤, 파일을 다시 열어 나머지 줄이 그대로인지 봅니다.

작업 폴더에서 맡기기 좋은 일

첫 작업처럼 원문과 결과를 사람이 바로 대조할 수 있는 일이 클로드 코드에 맡기기 좋습니다. 요청은 클로드 코드 입력창에 넣고, 확인은 새 터미널 창이나 Finder에서 합니다.

원문과 바로 대조할 수 있는 일

맡길 일	요청할 결과	확인하는 방법
회의록을 할 일 표로	todo.md에 담당자, 할 일, 마감	원문 항목 수와 표의 줄 수
공지나 계약서의 이전 판과 새 판 비교	changes.md에 바뀐 줄만 전후로	내가 아는 변경과 대조
폴더 안 파일 목록	index.md에 이름과 한 줄 설명	ls 결과와 대조

세 가지 모두 원문을 주고, AI가 정리해 파일로 저장하고, 사람이 원문과 대조하는 순서입니다. 이전 판과 새 판을 비교할 때는 두 파일을 같은 폴더에 넣고 "바뀌지 않은 줄은 넣지 마"라고 적으면 결과가 짧아져 대조하기 쉽습니다.

실행한 폴더는 작업의 기준 위치일 뿐 완전히 격리된 공간은 아닙니다. 추가 폴더나 권한 설정에 따라 접근 범위가 넓어지므로, 중요한 자료를 맡기기 전에 실제로 허용된 도구 권한을 확인합니다. OpenAI 쪽 도구도 써 보려면 코덱스 CLI 세팅 가이드를, 같은 작업을 두 도구에 맡겨 비교한 기록은 코덱스 CLI와 클로드 코드 비교를 봅니다.

선택: 작업 기록을 남길 때 Git 준비

클로드 코드는 작업 기록을 남기고 되돌릴 때 Git을 씁니다. 맥은 Git이 없으면 설치 창을 띄워 주므로, 설치 여부를 확인하는 명령 하나로 설치까지 이어집니다. 클로드 코드가 열려 있으면 /exit로 나와 터미널 명령 입력줄에서 실행합니다.

git --version 결과에 따라

1. 11. 명령 실행터미널 명령 입력줄에
   git --version
2. 22. 버전이 나오면이미 설치됨
   다음 단계로
3. 33. 설치 창이 뜨면개발자 도구 설치 창에서
   설치, 몇 분 걸림
4. 44. 다시 확인git --version에
   버전 번호

Git을 설치했다고 수정 기록이 자동으로 저장되지는 않습니다. 기록을 남기려면 저장소를 만들고 원하는 변경을 커밋, 즉 기록으로 저장해야 합니다. 이 순서는 위 Git 입문 글에서 이어집니다.

선택: 반복 작업에 필요한 스킬 추가

스킬은 자주 쓰는 작업 방법을 클로드 코드에 묶어 넣어 두는 기능입니다. 첫 작업에 필요한 설치가 아니므로, 추가 기능이 필요할 때 출처와 내용을 보고 설치합니다. 아래는 앤트로픽의 공식 스킬 마켓플레이스를 등록하고 그 안의 예시 스킬 묶음을 설치하는 순서입니다.

공식 예시 스킬 묶음 설치

1. 11. claude 실행터미널에서
   claude
2. 22. 마켓플레이스 등록/plugin marketplace add
   anthropics/skills
3. 33. 묶음 설치/plugin install
   example-skills@anthropic-agent-skills
4. 44. 다시 시작/exit 뒤
   claude 재실행
5. 55. 자동 완성 확인/example까지 치면
   스킬 명령이 보임

2번과 3번 명령은 클로드 코드 입력창에 입력합니다.

이 묶음에는 새 스킬을 만드는 skill-creator, 화면 디자인을 돕는 frontend-design, 문서를 함께 쓰는 doc-coauthoring 같은 스킬이 들어 있습니다. 다시 시작한 뒤 입력창에 /example까지 치면 /example-skills:skill-creator 같은 명령이 자동 완성 목록에 나옵니다. 보이지 않으면 /plugin에서 설치 항목이 활성 상태인지 보고, 같은 설치 명령을 반복하기 전에 실패 메시지를 읽습니다.

클로드 코드에서 자주 쓰는 조작법

같은 조작이라도 입력하는 곳이 다릅니다.

하고 싶은 일과 입력하는 곳

하고 싶은 일	터미널 명령 입력줄	클로드 코드 입력창
클로드 코드 종료	–	/exit
다음에 다시 시작	cd "$HOME/Projects/claude-practice" 뒤 claude --permission-mode default	–
설정 바꾸기	–	/config
권한 모드 바꾸기	–	Shift + Tab
새 스킬 만들기	–	/example-skills:skill-creator
설치 상태 점검	claude doctor	–

자주 묻는 질문

클로드 코드는 맥의 어느 버전부터 설치할 수 있나요?

macOS 13.0(Ventura) 이상에서 동작합니다. 화면 왼쪽 위 사과 메뉴에서 "이 Mac에 관하여"를 눌러 버전을 보고, 13.0보다 낮으면 먼저 업데이트합니다. Apple Silicon(M1 이후) 맥과 Intel 맥 모두 같은 명령으로 설치합니다.

무료 클로드 계정으로도 클로드 코드를 쓸 수 있나요?

쓸 수 없습니다. 앤트로픽 공식 문서는 클로드 코드에 Pro, Max, Team, Enterprise 구독이나 Console 계정이 필요하다고 안내합니다. 아마존 베드록, 구글 클라우드, 마이크로소프트 파운드리 같은 클라우드 서비스에 연결해 쓰는 방법도 있습니다.

Node.js나 Homebrew를 먼저 깔아야 하나요?

설치 스크립트로 깔면 둘 다 필요하지 않습니다. 클로드 코드는 자체 실행 파일로 돌아갑니다. npm install -g @anthropic-ai/claude-code 방식으로 설치할 때만 Node.js 22 이상이 필요하고, Homebrew는 brew install --cask claude-code로 설치할 때만 있으면 됩니다.

맥 기본 셸이 zsh인데 bash로 바꿔야 하나요?

zsh를 그대로 씁니다. macOS 카탈리나(10.15) 이후 기본 셸이 zsh이고, 설치 명령 끝의 bash는 설치 스크립트를 실행하는 데만 쓰입니다. 다른 안내에서 .bash_profile을 고치라고 하면, 지금 쓰는 셸이 zsh인 경우 .zshrc가 그 역할을 하는 파일입니다.

맥에서 클로드 코드 설치 중 자주 발생하는 문제

command not found: claude가 나오면 실행 파일이 없는 경우와 PATH에 설치 폴더가 빠진 경우를 아래 순서로 나눠 봅니다.

claude를 찾지 못할 때 보는 순서

1. 11. 새 터미널설치 뒤 새 창에서
   claude --version
2. 22. 실행 파일~/.local/bin/claude
   파일이 있는지
3. 33. 전체 경로 실행~/.local/bin/claude --version
   이 되는지
4. 44. PATH 추가전체 경로로 되면
   .zshrc에 PATH 한 줄
5. 55. claude doctor실행은 되는데 이상하면
   설치와 설정 진단

claude doctor는 설치 상태, 설정 파일 오류, 자동 갱신 여부를 한 화면에 보여 줍니다. 실행 파일을 찾지 못하는 상태에서는 이 명령도 실행되지 않으므로 1번부터 4번을 먼저 봅니다. 명령별 결과 해석은 설치 오류 가이드에 있습니다.

• "do not run this installer with sudo": 설치 명령에 sudo를 붙인 경우입니다. sudo 없이 같은 명령을 다시 입력합니다.
• 설치 중 curl 오류나 403이 뜹니다: 네트워크, 프록시, 인증서, 지원 지역 등 원인이 여러 가지입니다. 회사 기기라면 정책을 우회하지 말고 담당자에게 오류 문구를 보여 주고 허용된 접속 경로를 묻습니다.
• 로그인 창이 열리지 않습니다: 터미널에 나온 주소를 복사해 브라우저 주소창에 직접 붙여 넣어도 로그인할 수 있습니다.
• git 설치 창이 뜨지 않습니다: 터미널에 xcode-select --install을 입력하면 같은 설치 창이 열립니다.

Sources

• Claude Code 설치 안내
• 권한 모드 선택
• 공식 스킬 저장소

3줄 요약

1. 맥에서는 공식 설치 스크립트 한 줄로 Claude Code를 설치하며 Homebrew와 Node.js 없이 macOS 13.0 이상에서 동작합니다.

2. 처음 claude를 실행하면 브라우저로 로그인하며 Pro, Max, Team, Enterprise 구독이나 Console 계정이 필요하고 무료 플랜으로는 쓸 수 없습니다.

3. 답변 언어는 /config의 Language에 한국어를 입력해 바꾸고, 설치 문제는 실행 파일과 PATH를 본 뒤 claude doctor로 진단합니다.