Close AI Club/ Claude Code 세팅 가이드
3분MY

다음 장 · 2장 · 5분

도구 이해하기 — 왜 이걸 다 깔아요?

Node.js, Python, Git, Claude Code. 각각 뭘 하는 건지, 왜 필요한지.

클로드 코드 설치 — 터미널에 한 줄 붙여넣기

내 컴퓨터에 맞는 명령을 복사해 붙여넣고 엔터. 이미 깔린 건 건너뛰고, 끝나면 성공 여부까지 확인해 줍니다.

Windows

시작 메뉴에서 ‘PowerShell’ 검색해서 열기 (명령 프롬프트 아님)

irm https://raw.githubusercontent.com/jsk3342/claude-setup/main/install.ps1 | iex
macOS

⌘ + Space → ‘터미널’ 검색해서 열기

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/jsk3342/claude-setup/main/install.sh)"
설치됐나 확인두 줄이면 끝막혔다면오류 메시지별 해결법권한 고르기맡길 일마다 무엇을 볼지첫 사용 메모어느 창에 뭘 넣는지 한 장터미널 꾸미기영상 속 화면 한 줄로 · 맥·윈도우설치되는 것이 한 줄이 까는 도구

CHECK

제대로 깔렸는지 확인

설치가 끝나면 터미널을 새로 열고 차례로 붙여넣으세요.

1. 버전 확인

숫자가 나오면 성공. 예: 2.1.211 (Claude Code)

claude --version

2. 이상하면 자가 진단

설치 상태와 설정 오류를 읽기만 해서 알려줍니다. 아무것도 바꾸지 않습니다.

claude doctor

3. 첫 대화

작업할 폴더에서 claude 를 치면 브라우저가 열리고 로그인합니다. Pro 이상 구독이 필요합니다.

claude

TROUBLESHOOTING

막혔을 때 — 화면에 뜬 문구로 찾기

영상 댓글로 실제 들어온 오류와 공식 문제 해결 문서를 기준으로 정리했습니다. 해당하는 줄을 눌러 펼치세요.

공통command not found: claude / 'claude'은(는) 인식되지 않습니다

왜: 설치는 됐는데 터미널이 아직 새 위치를 모릅니다. 대부분 터미널을 새로 열면 끝납니다.

  1. 1.터미널 창을 완전히 닫고(맥은 ⌘Q) 새로 연 뒤 다시 확인

    claude --version
  2. 2.맥에서 그래도 안 되면 — 설치 위치를 등록하고 다시 확인

    echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc
  3. 3.윈도우에서 그래도 안 되면 — PowerShell에 붙여넣고, PowerShell을 다시 열기

    $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User') [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
윈도우'irm'은(는) 내부 또는 외부 명령이 아닙니다

왜: 명령 프롬프트(CMD)에 붙여넣었습니다. 설치 명령은 PowerShell용입니다.

  1. 1.시작 메뉴에서 ‘PowerShell’을 검색해 열고, 위의 윈도우 명령을 다시 붙여넣기. 앞에 PS C:\ 가 보이면 PowerShell이 맞습니다.

윈도우'bash'을(를) 인식할 수 없습니다 / -fsSL 매개 변수를 찾을 수 없습니다

왜: 맥용 명령을 윈도우에 붙여넣었습니다.

  1. 1.위쪽 ‘Windows PowerShell’ 칸의 명령(irm으로 시작)을 복사해서 다시 붙여넣기

윈도우이 시스템에서 스크립트를 실행할 수 없으므로… (running scripts is disabled)

왜: PowerShell 보안 설정이 스크립트를 막고 있습니다. 내 계정에서만 풀면 됩니다(관리자 권한 불필요).

  1. 1.PowerShell에 붙여넣고 엔터, 그다음 설치 명령을 다시 실행

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
맥Password: 비밀번호를 치라고 나와요

왜: 설치 도구가 맥 시스템 폴더를 만들 때 필요한 정상 단계입니다.

  1. 1.맥 잠금 해제할 때 쓰는 비밀번호를 치고 엔터. 입력해도 화면에 글자가 안 보이는 게 정상입니다.

공통로그인 창이 안 열려요 / OAuth error (400, Invalid code)

왜: 로그인 코드가 만료됐거나 일부만 붙여넣어졌습니다.

  1. 1.브라우저가 안 열리면 터미널에서 c 를 눌러 로그인 주소를 복사 → 브라우저에 붙여넣기

  2. 2.코드 붙여넣기가 안 먹히면 새 터미널에서 아래 명령으로 다시 로그인하고, 받은 코드를 바로 붙여넣기

    claude auth login
공통Pro 또는 Max가 필요하다고 나와요 / 로그인 후 403

왜: 클로드 코드는 무료 플랜에서 쓸 수 없습니다(Pro 월 $20부터).

  1. 1.claude.ai/settings 에서 구독이 활성인지 확인 → 터미널에서 claude 를 다시 실행해 로그인

윈도우claude 를 치면 데스크톱 앱이 열려요

왜: 예전 버전 Claude 데스크톱 앱이 같은 이름을 먼저 잡고 있습니다.

  1. 1.Claude 데스크톱 앱을 최신으로 업데이트한 뒤 PowerShell을 다시 열기

공통NativeCommandError / ENOENT 가 떠요

왜: 예전 설치 스크립트에 있던 오류입니다. 지금은 고쳐졌습니다.

  1. 1.터미널을 완전히 닫고 새로 연 뒤, 위의 설치 명령을 다시 붙여넣기

목록에 없나요? 설치 도우미에게 물어보세요

화면에 뜬 글이나 캡처를 보내면 다음에 칠 것을 알려 드려요. AI가 먼저 답하고, 안 풀리면 운영자가 직접 봐요.

PERMISSIONS

권한 — 맡길 일에 따라 무엇을 볼지

클로드가 ‘이거 해도 될까요?’ 하고 물을 때 보는 표입니다. 처음부터 전부 허용할 필요는 없습니다.

하려는 작업처음 검토할 선택확인할 내용
  • 오늘 뉴스처럼 공개 자료 검색영상 첫 대화확인하고 허용이 요청에 필요한 검색을 허용무엇을 검색하는지. 검색어에 개인·회원 정보가 들어가지는 않는지
  • 내가 지정한 자료 읽기확인하고 허용내가 고른 자료를 읽도록 허용실제 파일과 위치. 내 컴퓨터 전체 자료를 읽으라는 뜻은 아님
  • 새 요약·초안 파일 만들기확인하고 허용저장할 위치를 확인하고 허용새 파일인지, 기존 파일을 덮어쓰는지
  • 기존 파일 수정·덮어쓰기확인하고 허용변경 내용을 확인한 뒤 허용대상 파일, 바뀔 내용, 되돌릴 방법
  • 파일 삭제내가 직접 결정삭제 대상과 범위를 확인한 뒤 결정복구 가능한지. ‘정리해줘’만으로 삭제에 동의한 것은 아님
  • 프로그램 설치·관리자 권한 명령내가 직접 결정출처·명령·필요성을 확인한 뒤 결정어떤 프로그램을 어디에서 설치하는지, 왜 관리자 권한이 필요한지
  • 자료를 외부 사이트·서비스에 보내기내가 직접 결정보낼 자료와 받는 곳을 확인한 뒤 결정개인·회원 정보, 인증 정보가 포함되는지
  • 글 공개·메시지 발송·배포내가 직접 결정공개될 내용과 대상을 확인한 뒤 결정초안 작성과 실제 공개·발송을 구분
  • 결제·유료 사용 설정내가 직접 결정금액·조건을 직접 확인하고 결정추가 과금, 반복 결제, 구독에 포함된 범위

‘허용’은 지금 요청을 진행할지에 대한 선택입니다. 이번 한 번과 계속 허용은 다릅니다 — 계속 허용하기 전에는 그 규칙이 어떤 도구·대상까지 포함하는지 확인하세요. 이 표가 권한을 자동으로 바꾸지는 않습니다.

클로드와 같이 정하기

실행된 클로드 코드에 붙여넣으세요. 복사하면 위 표도 같이 들어갑니다. 오늘 맡길 작업은 내 상황에 맞게 바꿔도 됩니다.

나는 Claude Code를 처음 써. 오늘은 뉴스를 검색해서 요약하는 작업부터 할 거야. 아래 권한 선택표를 기준으로 지금 필요한 권한과 아직 필요 없는 권한을 구분해줘. 현재 적용된 권한 설정을 확인할 수 있으면 읽어서 알려주고, 확인할 수 없는 부분은 추측하지 마. 이번 한 번 허용하는 것과 계속 허용하는 것의 차이를 설명해줘. 추천하는 선택, 이유, 실제 적용 위치를 내가 이해할 말로 알려줘. 아직 설정을 바꾸거나 권한을 넓히지는 말고, 내가 검토할 표로 먼저 보여줘.

설명을 읽고 내가 고른 뒤, 실제로 적용됐는지 확인합니다. 추천 답변만으로 설정이 바뀌었다고 보지 마세요. 뜻을 모르겠으면 권한 요청 화면을 도우미에 물어보세요 — 비밀번호·인증 코드·API 키는 보내지 마세요.

FIRST USE

첫 사용 메모 — 어느 창에 무엇을

맥은 iTerm2, 윈도우는 Windows Terminal. 설치가 끝나면 새 창을 열어 시작하세요.

  • 클로드 코드 켜기새 터미널 창claudeClaude 이름과 대화 입력칸이 보임
  • 첫 요청Claude 안오늘 뉴스 정리해서 알려줘응답이 나옴. 날짜·출처도 확인
  • 모델 보기·선택Claude 안/model현재 모델과 목록. 방향키·Enter로 선택
  • 생각하는 깊이 조절Claude 안/effort지원 모델의 슬라이더. 처음은 기본값
  • 이전 대화 이어가기Claude 안/resume목록에서 대화를 고르면 이전 내용이 보임
  • 같은 작업의 대화 정리Claude 안/compact요약해 공간을 비움. 뒤에 남길 내용을 적고, 중요한 요구가 남았는지 확인
  • 다른 작업으로 새 대화Claude 안/clear이전 내용을 넣지 않은 새 대화 시작
  • 클로드 종료Claude 안/exit터미널 명령 입력으로 돌아옴

다시 쓸 때

새 터미널 → claude → 이어갈 대화는 /resume

설치 명령을 매번 다시 넣지 않습니다. 영상과 답이 달라도 잘못한 게 아닙니다.

아래 사용량 숫자

5h = 5시간 구간에 쓸 수 있는 양, 7d = 일주일 전체 총량의 사용률. 주간이 남아도 5시간 한도에 닿으면 그 갱신까지 기다립니다. 컨텍스트 = 지금 대화·자료를 담는 공간의 사용률(처음엔 ‘확인 전’일 수 있음).

Pro·Max 구독으로 연결하고 추가 사용을 꺼두면 포함 한도 안에서만 씁니다. 별도 결제가 필요한 모델·추가 사용을 고르면 비용이 생길 수 있습니다.

끝에서 직접 확인하세요

2026-10-13 기준 · 메뉴는 모델·계정·버전에 따라 다를 수 있습니다

BONUS

터미널 꾸미기 — 영상 속 화면 그대로

선택입니다. 설치가 끝난 뒤, 내 컴퓨터에 맞는 한 줄을 붙여넣으세요. 관리자 권한 필요 없음 · 여러 번 실행해도 안전.

Windows

PowerShell에 붙여넣기 → 끝나면 Windows Terminal을 새로 열기

irm https://raw.githubusercontent.com/jsk3342/win-iterm2/main/get.ps1 | iex

Windows Terminal

트루컬러·탭·분할

PowerShell 7

최신 셸

oh-my-posh

경로·git 표시 프롬프트

Nerd Font

아이콘까지 깨짐 없이

바뀌는 것·되돌리는 법 보기
macOS

iTerm2에 붙여넣기 → 끝나면 ⌘Q로 완전히 끄고 다시 열기

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/jsk3342/mac-iterm2/main/install.sh)"

배색

짙은 남색 바탕·선명한 글자색

위 상태 막대

시계·메모리·CPU

agnoster 프롬프트

폴더·git을 색 칸으로

D2Coding Nerd Font

한글·아이콘 고르게

바뀌는 것·되돌리는 법 보기

사용량 표시는 기본 설치에 이미 들어 있습니다 · 지금 쓰는 설정이 있으면 그대로 써도 됩니다

WHAT'S INSIDE

이 한 줄이 설치하는 것

macOS
  1. 1Claude Code (Anthropic 공식 설치기)
  2. 2Homebrew — 맥 앱스토어 같은 설치 도구
  3. 3Node.js — 웹사이트·앱 개발 엔진
  4. 4Python 3 — 자동화·문서 처리
  5. 5Git — 작업 되돌리기·버전 관리
Windows
  1. 1Scoop — 윈도우용 설치 도구
  2. 2Node.js
  3. 3Python 3
  4. 4Git — 클로드 코드가 명령을 실행할 때도 씀
  5. 5Claude Code

이미 설치된 건 건너뜀 · Apple Silicon 자동 대응 · 클로드 코드와 새 터미널의 PATH가 실제로 확인돼야 완료로 표시