홈/목차
3분MY
다음 챕터

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

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

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.터미널을 완전히 닫고 새로 연 뒤, 위의 설치 명령을 다시 붙여넣기

그래도 안 되면

claude doctor 결과(또는 오류 화면)를 캡처해서 영상 댓글로 남겨 주세요. 받은 오류는 이 목록에 계속 추가합니다.

BONUS

윈도우 터미널을 맥처럼

설치가 끝난 윈도우 사용자용. 색·폰트·아이콘·자동완성까지 한 번에 바꿉니다.

$p=Join-Path $env:TEMP 'win-iterm2-install.ps1'; Invoke-WebRequest -UseBasicParsing 'https://raw.githubusercontent.com/jsk3342/win-iterm2/main/install.ps1' -OutFile $p; powershell.exe -NoProfile -ExecutionPolicy Bypass -File $p

PowerShell에 붙여넣기 · 관리자 권한 필요 없음 · 여러 번 실행해도 안전 · 끝나면 Windows Terminal을 새로 열기만 하면 됩니다.

Windows Terminal

트루컬러·탭·분할

PowerShell 7

최신 셸

oh-my-posh

경로·git 표시 프롬프트

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가 실제로 확인돼야 완료로 표시