Grace 프로필 사진

Hello there

안녕하세요, 팀보더(Teamborder) Grace입니다.

팀보더는 AI 강의와 AX(AI 전환) 시스템 구축, 그리고 브랜딩·마케팅 전반을 함께 만드는 에이전시입니다. 이 가이드는 비개발자도 Claude Code를 쉽게 시작할 수 있도록 직접 정리한 자료입니다.

Teamborder · Grace 더 알아보기 →
Setup Guide

Claude Code 설치 가이드

비개발자를 위한 단계별 안내 · 맥 / 윈도우 모두 지원

📋 이 가이드에 담긴 내용
  1. Claude Desktop 앱 설치 (PC 버전)
  2. Git 설치
  3. Node.js 설치 (Claude Code CLI를 위한 선행 조건)
  4. Claude Code CLI 설치 및 로그인
  5. OMC(oh-my-claudecode) 플러그인 설치
  6. Claude for Chrome — 브라우저 확장 설치
💡 시작하기 전에 — Claude Pro 요금제 사용자는 Claude Code를 사용할 수 있습니다(사용량 제한 있음). 데스크탑 앱의 Code / Cowork 메뉴가 비활성화되어 있다면, 아래 단계들을 진행하지 않은 상태일 가능성이 높습니다.
✅ 이미 Claude Desktop 앱이 설치된 분은 1번을 건너뛰고 2번(Git 설치)부터 진행하세요.

1Claude Desktop 앱 설치 (PC 버전)

Claude Desktop은 브라우저 없이 PC에서 바로 Claude를 사용할 수 있는 공식 앱입니다. Code / Cowork 메뉴는 이 데스크탑 앱 안에 들어 있습니다.

설치 단계

1. https://claude.ai/download 접속

2. "Download for Mac" 버튼 클릭 (애플 실리콘 / 인텔 자동 감지)

3. 다운받은 .dmg 파일 실행

4. Claude 아이콘을 Applications 폴더로 드래그해서 설치

5. Launchpad 또는 Spotlight(⌘ + Space)에서 "Claude" 검색 → 실행

6. Pro 요금제 계정으로 로그인

✅ 설치 확인: 앱 실행 후 좌측/상단 메뉴에 Code, Cowork 항목이 보이면 정상 (단, 활성화는 다음 단계들 완료 후)
설치 단계

1. https://claude.ai/download 접속

2. "Download for Windows" 버튼 클릭

3. 다운받은 .exe 설치 파일 실행

4. 설치 마법사가 자동으로 진행됩니다 (별도 옵션 선택 없음)

5. 설치 완료 후 시작 메뉴에서 "Claude" 검색 → 실행

6. Pro 요금제 계정으로 로그인

⚠️ SmartScreen 경고가 뜬다면 "추가 정보" → "실행"을 누르세요. 정식 서명된 Anthropic 앱입니다.
✅ 설치 확인: 앱 실행 후 메뉴에 Code, Cowork 항목이 보이면 정상 (단, 활성화는 다음 단계들 완료 후)

2Git 설치

Git은 Cowork 기능이 내부적으로 사용하는 필수 도구입니다.

방법 A — 가장 쉬운 방법

터미널을 엽니다 (Spotlight: ⌘ + Space → "터미널" 검색).

아래 명령어를 입력하세요:

git --version

이미 설치되어 있다면 git version 2.xx.x 같은 결과가 나옵니다. 설치되지 않았다면 자동으로 "개발자 도구를 설치하시겠습니까?" 팝업이 뜨는데 설치를 누르면 끝입니다.

방법 B — 공식 설치 파일

https://git-scm.com/download/mac 에서 다운로드

✅ 설치 확인: 터미널에서 git --version 입력 → 버전이 나오면 완료
설치 단계

1. https://git-scm.com/download/win 접속

2. "64-bit Git for Windows Setup" 다운로드

3. 설치 파일 실행 → 옵션은 모두 기본값(Next)으로 진행

4. 설치 완료

⚠️ 중요: 설치 후 열려 있던 터미널/PowerShell은 모두 닫고 새로 열어야 합니다 (PATH 환경변수 갱신).
✅ 설치 확인: Win → "powershell" 검색 → PowerShell 열기 → git --version 입력 → 버전이 나오면 완료

3Node.js 설치

Claude Code CLI는 Node.js 환경에서 동작합니다. 먼저 Node.js를 설치해야 합니다.

설치 단계

1. https://nodejs.org/ko 접속

2. LTS 버전 (왼쪽 권장 버튼) 다운로드

3. 다운받은 .pkg 파일 실행 → 계속 → 동의 → 설치

4. 설치 완료 후 터미널을 완전히 종료하고 다시 엽니다 (⌘ + Q).

✅ 설치 확인: 터미널에서 node --version 입력 → v20.x.x 같은 버전이 나오면 완료
설치 단계

1. https://nodejs.org/ko 접속

2. LTS 버전 (왼쪽 권장 버튼) 다운로드

3. 다운받은 .msi 파일 실행 → Next 계속 누르며 설치

4. 설치 완료 후 PowerShell을 완전히 종료하고 다시 엽니다.

✅ 설치 확인: PowerShell에서 node --version 입력 → v20.x.x 같은 버전이 나오면 완료

4Claude Code CLI 설치 및 로그인

Node.js가 설치되면 Claude Code CLI는 명령어 한 줄로 설치할 수 있습니다.

1단계 — 터미널에서 설치
npm install -g @anthropic-ai/claude-code

설치가 시작되며 1~2분 소요됩니다.

✅ 마지막에 added 1 package in 1s 또는 added 254 packages in 5s 같은 줄이 나오면 설치 성공입니다. (에러처럼 보여도 빨간 글씨가 아니면 정상 출력이에요.)

⚠️ 이런 에러가 뜬다면? — npm error code EACCES / permission denied

맥에 nodejs.org 공식 설치 파일로 Node를 설치한 경우, 글로벌 npm 폴더(/usr/local/lib/node_modules)에 쓰기 권한이 없어서 자주 발생합니다. 해결 방법은 두 가지입니다.

방법 A (가장 간단) — sudo를 붙여서 한 번만 실행

sudo npm install -g @anthropic-ai/claude-code

맥 로그인 비밀번호를 한 번 입력하면 진행됩니다. (입력해도 화면에 글자는 안 보입니다 — 정상)

방법 B (권장 · 매번 sudo 안 쓰는 영구 해결) — 사용자 폴더로 npm 글로벌 경로 변경:

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

그런 다음 sudo 없이 다시 설치:

npm install -g @anthropic-ai/claude-code

한 번 설정하면 이후 모든 글로벌 npm 설치가 권한 에러 없이 됩니다.

2단계 — 설치 확인
claude --version

1.x.x 같은 버전이 나오면 설치 완료입니다. 다음 단계에서 실제로 Claude Code를 실행합니다.

3단계 — Claude Code 실행 + 로그인

터미널에 아래 한 글자를 입력하고 엔터를 누르세요. 이게 Claude Code를 실행하는 명령입니다.

claude
이 화면이 보이면 ✓ 설치 성공

처음 실행하면 "Welcome to Claude Code"와 함께 "Choose the text style..."(테마 선택) 화면이 먼저 뜹니다. 이 화면이 보인다는 것 자체가 설치가 잘 됐다는 신호예요. 아직 브라우저가 안 열리는 게 정상입니다 — 로그인은 테마 선택 다음 단계에서 진행돼요.

테마는 Dark mode 그대로 Enter만 눌러도 됩니다 (나중에 /theme으로 변경 가능). 이어서 로그인 단계가 나오면 Enter → 브라우저가 자동으로 열리며 로그인 페이지로 이동합니다. Pro 요금제 계정으로 로그인하면 터미널에 > 같은 입력창이 뜨면서 Claude Code 인터랙티브 모드가 켜집니다. 이 상태에서 다음 5번 단계의 /plugin ... 명령들을 입력합니다.

※ 브라우저가 자동으로 안 열리면 터미널에 표시된 URL을 복사해 브라우저 주소창에 직접 붙여넣으면 됩니다.

💡 중요: 5번(OMC 설치) 단계의 /plugin marketplace add ..., /plugin install ... 같은 슬래시 명령어는 일반 터미널이 아니라 위에서 claude로 실행한 Claude Code 인터랙티브 모드 안에서 입력해야 합니다.
1단계 — PowerShell에서 설치
npm install -g @anthropic-ai/claude-code

설치가 시작되며 1~2분 소요됩니다.

✅ 마지막에 added 1 package in 1s 또는 added 254 packages in 5s 같은 줄이 나오면 설치 성공입니다. (에러처럼 보여도 빨간 글씨가 아니면 정상 출력이에요.)

⚠️ 이런 에러가 뜬다면? — EACCES / EPERM / permission denied / access is denied

권한 문제로 글로벌 npm 폴더에 설치하지 못해서 발생합니다. PowerShell을 관리자 권한으로 실행한 뒤 다시 시도하면 해결됩니다.

방법 — 관리자 권한 PowerShell 열기

1. 시작 메뉴(Win) → "PowerShell" 검색
2. 검색 결과에서 마우스 오른쪽 클릭 → "관리자 권한으로 실행"
3. UAC 창에서 "예" 클릭
4. 새로 열린 PowerShell에서 다시:

npm install -g @anthropic-ai/claude-code

그래도 실행 정책 에러가 뜬다면 (execution of scripts is disabled) 아래 명령을 한 번 실행:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

"Y" 입력 후 엔터. 그런 다음 다시 npm 설치 명령을 실행합니다.

2단계 — 설치 확인
claude --version

1.x.x 같은 버전이 나오면 설치 완료입니다. 다음 단계에서 실제로 Claude Code를 실행합니다.

3단계 — Claude Code 실행 + 로그인

PowerShell에 아래 한 글자를 입력하고 엔터를 누르세요. 이게 Claude Code를 실행하는 명령입니다.

claude
이 화면이 보이면 ✓ 설치 성공

처음 실행하면 "Welcome to Claude Code"와 함께 "Choose the text style..."(테마 선택) 화면이 먼저 뜹니다. 이 화면이 보인다는 것 자체가 설치가 잘 됐다는 신호예요. 아직 브라우저가 안 열리는 게 정상입니다 — 로그인은 테마 선택 다음 단계에서 진행돼요.

테마는 Dark mode 그대로 Enter만 눌러도 됩니다 (나중에 /theme으로 변경 가능). 이어서 로그인 단계가 나오면 Enter → 브라우저가 자동으로 열리며 로그인 페이지로 이동합니다. Pro 요금제 계정으로 로그인하면 PowerShell에 > 같은 입력창이 뜨면서 Claude Code 인터랙티브 모드가 켜집니다. 이 상태에서 다음 5번 단계의 /plugin ... 명령들을 입력합니다.

※ 브라우저가 자동으로 안 열리면 PowerShell에 표시된 URL을 복사해 브라우저 주소창에 직접 붙여넣으면 됩니다.

💡 중요: 5번(OMC 설치) 단계의 /plugin marketplace add ..., /plugin install ... 같은 슬래시 명령어는 일반 PowerShell이 아니라 위에서 claude로 실행한 Claude Code 인터랙티브 모드 안에서 입력해야 합니다.
⚠️ 윈도우 권장 환경: 일부 기능에서 안정성을 위해 WSL(Windows Subsystem for Linux) 사용을 권장합니다. 일반 PowerShell에서도 동작하지만 문제가 발생하면 WSL 설치를 고려하세요. (PowerShell 관리자 권한으로 wsl --install 한 줄)

5OMC (oh-my-claudecode) 플러그인 설치

OMC는 Claude Code를 다중 에이전트 협업 환경으로 확장하는 플러그인입니다. Claude Code 입력창에 슬래시 명령 두 줄이면 끝납니다. 맥/윈도우 동일합니다.

💡 전제 — 4번 단계까지 끝나서 Claude Code가 실행되어 있어야 합니다. 터미널 화면에 > 입력창이 보이면 OK. (안 보이면 터미널에서 claude 입력해서 다시 진입)
1단계 — 마켓플레이스 추가

Claude Code 입력창(>)에 아래를 그대로 붙여넣고 Enter:

/plugin marketplace add https://github.com/yeachan-heo/oh-my-claudecode

"Marketplace added" 같은 성공 메시지가 뜨면 OK.

⚠️ 빨간색 보안 경고창이 뜨면? "외부 저장소에서 코드를 가져옵니다" 안내는 정상이니 그대로 진행하세요. 단 평소엔 외부 코드 받을 때 출처가 검증된 곳인지 한 번 확인하는 습관을 들이는 게 좋습니다.
2단계 — 플러그인 설치

이어서 같은 입력창에:

/plugin install oh-my-claudecode@omc

"정상적으로 설치되었습니다" 같은 알람이 뜨면 설치 완료.

3단계 — 설치 검증

Claude Code 입력창에 자연어로:

omc가 잘 설치되었는지 확인해줘

또는 슬래시 명령:

omc doctor

Claude가 진단 결과를 보여줍니다. "수정이 필요합니다"라고 나오면 그대로 답하면 됩니다:

그럼 수정해줘

1~2회 반복으로 자동 정리됩니다.

🛠 슬래시 명령 대신 GUI 메뉴로 설치하는 방법 (선택)

Claude Code 입력창에 /plugin 만 입력하면 같은 터미널 창 안에 플러그인 관리 메뉴가 뜹니다. 화살표 키로 사용자지정 → 개인 플러그인 → 마켓플레이스 추가로 들어가 위 URL을 입력해도 결과는 동일합니다. (위 1·2단계 슬래시 명령이 더 빠르고 정확하니 일반적으로는 그쪽 권장)

💡 OMC가 켜진 뒤 자주 쓰는 루틴들

권장 조합 (상황에 맞게 선택):

※ autopilot → ralph 삽입은 보통 비추천.

⚠️ 마켓플레이스 추가 시 클론 에러가 뜬다면?

HTTPS authentication failed 또는 SSH host key verification failed 같은 에러는 GitHub 인증이 비어 있어서 발생합니다. GitHub CLI(gh)로 한 번만 로그인해두면 깔끔하게 풀립니다.

① github.com/cli/cli/releases/latest에서 본인 OS용 설치 파일 다운로드 → 설치 (맥은 .pkg, 윈도우는 .msi). Apple Silicon이면 arm64.pkg, Intel 맥이면 amd64.pkg. 본인 맥 종류는 터미널에서 uname -m으로 확인 (arm64 = Apple Silicon).

② 새 터미널/PowerShell에서:

gh auth login

메뉴 응답: GitHub.com → HTTPS → Yes (Authenticate Git) → Login with a web browser. 화면의 일회용 코드 복사 → 엔터 → 브라우저 열림 → 코드 붙여넣고 Authorize → 터미널에 ✓ Logged in as ... 뜨면 끝.

③ Claude Code로 돌아와 1~3단계 다시 진행 → 통과합니다.

6Claude for Chrome — 브라우저 확장 설치

Claude for Chrome은 크롬 안에서 Claude를 바로 호출하고 웹페이지 자동화에 사용하는 공식 브라우저 확장입니다. 워크샵 후반의 웹 자동화 실습에 필요합니다.

💡 전제 — 크롬 브라우저(또는 크로미움 계열)가 설치되어 있어야 합니다. 또한 본인 Claude 계정으로 미리 claude.com에 로그인된 상태여야 OAuth 연결이 매끄럽습니다.
설치 단계

1. 크롬에서 claude.com/claude-for-chrome 접속

2. "Add to Chrome" (크롬에 추가) 버튼 클릭

3. 권한 확인 팝업이 뜨면 "확장 프로그램 추가" 클릭

4. 크롬 우측 상단 퍼즐(🧩) 아이콘 → Claude 항목 옆 핀(📌) 클릭해서 툴바에 고정

5. 툴바의 Claude 아이콘 클릭 → 본인 Claude 계정으로 로그인 (이미 claude.com에 로그인되어 있으면 한 번 클릭으로 연결됨)

⚠️ 로그인 흐름이 꼬일 때 — 평소 다른 브라우저(Safari, Arc 등)에서 Claude를 쓰셨다면, 확장 설치 직전 크롬에서도 한 번 claude.com에 로그인해두세요. OAuth 인증이 다른 브라우저로 튀는 걸 막아줍니다.
✅ 설치 확인: 크롬 툴바의 Claude 아이콘을 누르면 사이드 패널이 열리고, 현재 보고 있는 웹페이지에 대해 질문할 수 있으면 정상.

✅ 마지막 — 다 됐는지 한 번에 확인하기

설치를 다 한 것 같다고요? 터미널 명령어를 직접 외울 필요 없습니다. 클로드한테 한 줄 물어보면 끝이에요.

Step 1 — Claude Code 켜기

아래 둘 중 편한 방법 하나만 하면 됩니다.

화면에 > 입력창이 보이고 클로드 인사말이 떠 있으면 OK.

Step 2 — 클로드에게 한 줄로 확인 요청

위 > 입력창에 아래를 그대로 붙여넣고 엔터:

Git, Node, Claude Code 다 잘 깔렸는지 확인하고
4개 항목(Claude Desktop · Git · Node · Claude Code) 옆에 ✓ 또는 ✗ 로 알려줘.
✗ 있으면 어디 가서 어떻게 깔면 되는지 한 줄로 알려줘.

클로드가 직접 자기 컴퓨터를 확인해서 표로 정리해줍니다. 모두 ✓ 나오면 끝.

🔍 항목별로 직접 확인하고 싶다면 (클릭해서 펼치기)

각 항목을 클릭하면 확인 명령어와 "이게 나오면 정상" 기준이 열립니다. 위에서 아래로 하나씩 체크해보세요.

1Claude Desktop 앱이 잘 설치됐나요?▶

맥: Spotlight(⌘ + Space)에 "Claude" / 윈도우: 시작 메뉴에 "Claude" 검색 → 앱 실행 → 로그인.

✅ 이러면 정상: 앱이 열리고, 좌측/상단 메뉴에 Code·Cowork 항목이 보입니다. (비활성화 상태여도 메뉴가 보이면 앱 설치 자체는 성공)
2Git이 잘 설치됐나요?▶

터미널(맥) 또는 PowerShell(윈도우)에 입력:

git --version
✅ 이러면 정상: git version 2.xx.x 처럼 버전 숫자가 나옵니다.
❌ "command not found" / "인식할 수 없습니다"가 나오면 → 2번 섹션으로 돌아가 다시 설치.
3Node.js가 잘 설치됐나요?▶

터미널/PowerShell에 두 줄을 차례로 입력:

node --version
npm --version
✅ 이러면 정상: 각각 v20.x.x, 10.x.x 같은 버전 숫자가 나옵니다.
❌ 안 나오면 → 터미널을 완전히 껐다 켠 뒤 다시 시도. 그래도 안 되면 3번 섹션에서 재설치.
4Claude Code CLI가 잘 설치됐나요?▶

터미널/PowerShell에 입력:

claude --version
✅ 이러면 정상: 2.x.x (Claude Code) 같은 버전이 나옵니다.

이어서 실제 실행도 확인:

claude
✅ 이러면 정상: 처음이라면 "Welcome to Claude Code" + 테마 선택 화면이 뜨고(= 설치 성공 신호!), 이미 로그인까지 마쳤다면 > 입력창이 바로 뜹니다. 테마 선택 화면에서는 Enter → 로그인 진행하면 됩니다.
❌ "command not found"가 나오면 → 터미널 완전히 재시작 후 재시도, 그래도 안 되면 4번 섹션의 권한 에러(EACCES) 해결 방법 참고.
5OMC 플러그인이 잘 설치됐나요?▶

claude로 실행한 Claude Code의 > 입력창에 자연어로 물어보세요:

omc가 잘 설치되었는지 확인해줘
✅ 이러면 정상: 클로드가 OMC 버전과 상태를 진단해서 알려줍니다. "수정이 필요합니다"라고 나오면 "그럼 수정해줘"라고 답하면 자동으로 정리됩니다.
❌ OMC를 모른다고 하면 → 5번 섹션의 /plugin ... 두 줄부터 다시 진행.
6Claude for Chrome 확장이 잘 설치됐나요?▶

크롬 우측 상단 퍼즐(🧩) 아이콘을 눌러 목록에 Claude가 있는지 확인 → Claude 아이콘 클릭.

✅ 이러면 정상: 사이드 패널이 열리고, 지금 보고 있는 웹페이지에 대해 질문할 수 있습니다.
❌ 목록에 없으면 → 6번 섹션에서 다시 설치. 로그인이 꼬이면 크롬에서 claude.com에 먼저 로그인 후 재시도.
🎉 여기까지 됐으면 실습 시작 준비 완료 — 워크샵 실습 페이지로 이동하시면 됩니다.

자주 발생하는 문제

증상해결 방법
claude 입력했더니 "명령을 찾을 수 없음" 터미널을 완전히 닫고 다시 열기. 그래도 안 되면 Node.js 재설치
npm 입력 시 권한 오류 맥: 명령어 앞에 sudo 붙이기 / 윈도우: PowerShell을 관리자 권한으로 실행
데스크탑 앱 메뉴가 여전히 비활성화 데스크탑 앱을 완전히 종료(트레이 포함)하고 재시작
윈도우에서 자꾸 에러 발생 WSL 설치 권장: PowerShell 관리자 권한 → wsl --install