3장. 설치와 로그인
필수 이 단계를 따라가려면 꼭 읽으세요.한 줄 요약: 공식 문서의 설치 명령을 붙여 넣고, 새 터미널 창에서
claude --version으로 확인합니다. 그다음 연습 폴더에서claude를 실행해 브라우저에서 로그인하면 준비가 끝납니다.
설치는 한 번만 하면 됩니다. 명령도 한 줄입니다.
붙여 넣기 전에 — 출처부터 확인
설치 명령은 바로 다음 절에 있습니다. 붙이기 전에 한 가지만 확인하세요.
설치 명령은 인터넷에서 받은 프로그램을 내 컴퓨터에서 바로 실행합니다. 편리하지만, 잘못된 사이트의 명령을 붙이면 나쁜 프로그램이 내 권한으로 실행될 수 있습니다.
그래서 처음 보는 사이트의 설치 명령은 그대로 붙여 넣지 마세요. 이 강좌의 명령도 마찬가지입니다. 공식 문서 「Quickstart」를 열어 같은 명령인지 눈으로 맞춰 보세요.
- 아쉬운 예: 블로그에서 찾은 설치 명령을 바로 터미널에 붙인다.
- 나은 예: 공식 문서를 열어 같은 명령인지 확인하고 붙인다.
터미널에 붙이는 명령은 어떤 것이든 출처를 먼저 보세요. 다른 프로그램을 설치할 때도 같은 습관이 지켜 줍니다.
확인 퀴즈
블로그에서 처음 보는 설치 명령을 찾았습니다. 어떻게 하는 것이 좋을까요?
운영체제별 설치 명령
터미널을 열고 내 컴퓨터에 맞는 명령 하나만 붙여 넣은 뒤 Enter를 누릅니다. 공식 문서의 명령입니다.[1]
맥·리눅스·WSL(Windows 안에서 리눅스를 쓰는 기능)은 이렇게 칩니다.
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell은 이렇게 칩니다.
irm https://claude.ai/install.ps1 | iex두 명령은 같은 일을 합니다. 앞부분이 설치 파일을 받고, |(세로 막대) 뒤가 받은 내용을 실행합니다. 조각의 뜻을 다 알지 못해도 설치할 수 있습니다.
자세히 (눌러서 펼치기)
내려받는 동안에는 진행 표시가 없습니다. 아무 일도 없어 보여도 창을 닫지 말고 기다리세요. 끝나면 Claude Code successfully installed!라는 문구가 보입니다.[3]
명령을 엉뚱한 창에 넣으면 오류가 납니다. 고장이 아니라 창을 잘못 고른 것입니다.[4]
'irm' is not recognized가 나온다: PowerShell이 아니라 CMD에 있습니다. PowerShell을 열어 다시 하세요.-fsSL때문에 오류가 난다: 맥·리눅스용 명령을 PowerShell에 넣은 것입니다. PowerShell용 명령을 쓰세요.
오류는 화면 언어에 따라 한글로 나올 수 있습니다. 뜻은 같습니다.
Windows에서는 관리자 권한으로 실행하지 않아도 됩니다.[5] 대부분은 위의 한 줄이면 충분합니다.
자세히 (눌러서 펼치기)
확인 퀴즈
설치 명령을 넣었는데 화면에 아무 변화가 없습니다. 어떻게 해야 할까요?
설치 확인
설치가 끝나면 새 터미널 창을 열고 이 명령을 칩니다.[8]
claude --version이렇게 번호가 나오면 성공입니다. 번호는 달라도 됩니다. 뒤에 (Claude Code)가 붙어 있는지 보세요.

2.1.318 (Claude Code)왜 새 창일까요? 이미 열려 있던 창은 예전 설정을 그대로 씁니다.[9] 그래서 설치를 마친 창에서는 안 되고 새 창에서는 되는 일이 생깁니다.
확인 퀴즈
설치가 끝난 뒤 claude --version 은 어디에서 쳐야 하나요?
command not found가 나올 때
새 창에서도 이런 말이 나올 수 있습니다. Windows에서는 not recognized라는 말이 나옵니다. 화면 언어에 따라 한글로 나올 수 있습니다. 뜻은 같습니다.
zsh: command not found: claude
bash: claude: command not found설치는 됐는데 터미널이 프로그램을 못 찾는다는 뜻입니다.[10]
터미널은 PATH(패스)라는 폴더 목록에서 프로그램을 찾습니다. 전화번호부라고 생각하면 쉽습니다. 프로그램이 있어도 목록에 안 적혀 있으면 못 찾습니다. 설치 프로그램은 고치는 법을 알려 줄 뿐, PATH를 직접 바꾸지는 않습니다.[11]
프로그램은 맥·리눅스에서 ~/.local/bin/claude, Windows에서 %USERPROFILE%\.local\bin\claude.exe에 있습니다.[12] 이 폴더를 목록에 더해 주면 됩니다. 아래는 공식 문서의 명령입니다. 내 컴퓨터에 맞는 것 하나만 쓰세요.
맥의 기본 셸(터미널 안에서 명령을 받는 프로그램)인 Zsh는 이렇게 씁니다.
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc대부분의 리눅스(Bash)는 이렇게 씁니다.
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrcWindows PowerShell은 이렇게 씁니다.
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')명령의 조각은 이런 뜻입니다.
echo줄: 설정을 파일에 저장합니다.>>는 파일 끝에 덧붙이는 기호입니다. 그래서 설정 파일의 기존 내용은 지워지지 않습니다.source줄: 저장한 설정을 지금 창에 적용합니다.- 한 번만 치기: 두 번 치면 같은 줄이 두 번 들어갑니다.
- Windows: 두 줄을 친 뒤 터미널을 다시 시작해야 합니다.[13]
그런 다음 claude --version을 다시 쳐 보세요. 번호가 나오면 해결된 것입니다.
그래도 안 되면 공식 문서 「Troubleshoot installation and login」을 보세요. claude가 실행은 된다면 claude doctor로 설치 상태를 읽어 볼 수 있습니다. 세션을 열지 않고 진단만 보여 줍니다.[14]
확인 퀴즈
설치는 끝났는데 command not found: claude 가 나옵니다. 무슨 뜻일까요?
로그인
새 창에서 2장의 연습 폴더로 옮겨 간 뒤 claude를 칩니다. 맥·리눅스는 이렇게 칩니다.
cd ~/hello-ai-연습/터미널
claudeWindows PowerShell은 이렇게 칩니다.
cd $HOME\hello-ai-연습\터미널
claude처음 실행하면 로그인하라는 안내가 나옵니다. 개인 구독자는 claude.ai 계정으로 로그인합니다.[15] 순서는 이렇습니다.[16]
- 브라우저가 열리면 로그인합니다.
- 브라우저가 안 열리면 터미널에서
c를 누릅니다. 로그인 주소가 복사되니 브라우저에 붙여 넣습니다. - 브라우저가 코드를 보여 주면 터미널의
Paste code here if prompted자리에 붙여 넣습니다. Login successful이 뜨면 Enter를 누릅니다.
로그인은 한 번이면 됩니다. 정보가 저장되어 다시 묻지 않습니다. 계정을 바꾸고 싶으면 실행 중에 /login을 칩니다.[17]
로그인 전후로 첫 설정 화면이 더 나올 수 있습니다. 폴더를 믿는지 묻는 창이 나올 수도 있습니다. 이 창은 4장에서 함께 봅니다. 지금은 Esc로 나가도 됩니다.
확인 퀴즈
claude 로그인 때 브라우저가 저절로 열리지 않으면 어떻게 하나요?
업데이트와 지우기
업데이트. 위의 한 줄로 설치했다면 따로 할 일이 없습니다. 백그라운드에서 자동으로 받고, 다음에 Claude Code를 켤 때 적용됩니다.[18] 바로 올리고 싶으면 터미널에서 claude update를 칩니다. 이미 최신이면 Claude Code is up to date라고 알려 줍니다.[19]
Homebrew나 WinGet으로 깔았다면 자동으로 올라가지 않습니다. 그 도구로 가끔 직접 올려야 합니다.[20]
지우기. 지우는 방법은 지금 필요 없으니 접어 두었습니다. 나중에 필요할 때 펼쳐 보세요.
자세히 (눌러서 펼치기)
맥·리눅스에서 위의 한 줄로 설치했다면 이 두 줄로 지웁니다.[21]
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/clauderm은 휴지통을 거치지 않고 바로 지우는 명령입니다. -r은 폴더 안까지 전부, -f는 묻지 않고 지우라는 옵션입니다. 글자를 꼭 확인하고 치세요. Windows와 다른 설치 방법은 공식 문서 「Advanced setup」의 Uninstall 절을 따르세요.
확인 퀴즈
공식 문서의 한 줄 명령으로 설치한 Claude Code의 업데이트는 어떻게 되나요?
직접 해 보기
- 공식 문서를 열어 설치 명령이 이 장과 같은지 확인합니다.
- 내 운영체제의 명령을 붙여 넣고 끝날 때까지 기다립니다.
- 새 창을 열어
claude --version을 칩니다.command not found가 나오면 위의 절을 따라갑니다. - 연습 폴더에서
claude를 실행해 로그인합니다. 신뢰 창이 뜨면Esc로 나옵니다. 입력창까지 들어갔다면/exit를 칩니다.
스스로 물어보세요. claude --version이 번호를 보여 주나? 그렇다면 다음 장에서 첫 일을 시켜 볼 수 있습니다.
정리
- 설치 명령은 공식 문서와 같은지 확인하고 붙인다.
- 맥·리눅스는
curl줄, Windows는 PowerShell의irm줄을 쓴다. 진행 표시가 없어도 기다린다. - 확인은 새 창에서
claude --version으로 한다. command not found가 나오면 새 창부터 열어 보고, 그래도 안 되면 PATH 줄을 더한다.- 로그인은 연습 폴더에서
claude를 실행해 브라우저에서 한 번만 한다. - 기본 설치는 자동으로 업데이트된다.
용어 정리
| 용어 | 읽는 법 | 한 줄 뜻 |
|---|---|---|
| PATH | 패스 | 터미널이 프로그램을 찾는 폴더 목록 |
| WSL | 더블유에스엘 | Windows 안에서 리눅스를 쓰는 기능 |
curl | 컬 | 인터넷에서 내용을 받아 오는 명령 |
irm | 아이알엠 | PowerShell에서 인터넷 내용을 받아 오는 명령 |
rm | 알엠 | 파일을 지우는 명령 |
이 장을 다 읽었나요?
기록은 이 브라우저에만 저장됩니다. 진행 현황은 전체 목차에서 볼 수 있어요.
다음 장: 4장. 첫 세션
참고 자료 (21개)
이 가이드는 이미 설치·로그인된 컴퓨터에서 실행해서, 설치와 로그인 과정은 직접 해 보지 않았습니다. 이 장의 설치·로그인 순서는 공식 문서의 설명입니다. Claude Code 공식 문서, 「Quickstart」. "curl -fsSL claude.ai | bash" / "irm claude.ai | iex" code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Terminal guide for new users」. "
irmfetches the file andiexruns it." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Quickstart」. "The install command shows no progress while it downloads Claude Code." code.claude.com · 「Terminal guide for new users」. "When the installer finishes, you'll see "Claude Code successfully installed!"" code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Quickstart」. "If you see
'irm' is not recognized as an internal or external command, you're in CMD, not PowerShell." code.claude.com · 「Troubleshoot installation and login」. "you ran the macOS/Linuxcurl -fsSL ... | bashinstaller in Windows PowerShell, wherecurlis an alias forInvoke-WebRequestand rejects the-fsSLflags" code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Advanced setup」. "You do not need to run as Administrator." code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Quickstart」. "Git for Windows is recommended on native Windows so Claude Code can use the Bash tool." / "If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead." code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Quickstart」. "brew install --cask claude-code" / "winget install Anthropic.ClaudeCode" code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Quickstart」. "When the installer finishes, open a new terminal window and run
claude --version." / "The command prints a version number followed by(Claude Code)." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Troubleshoot installation and login」. "a window that was already open keeps its old PATH, and a terminal inside an editor takes its PATH from the editor." code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Troubleshoot installation and login」. "If installation succeeded but you get a
command not foundornot recognizederror when runningclaude, the install directory isn't in your PATH." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Troubleshoot installation and login」. "Your shell searches for programs in directories listed in PATH" / "It prints the fix with that note but doesn't change PATH itself." code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Troubleshoot installation and login」. "the installer places
claudeat~/.local/bin/claudeon macOS/Linux or%USERPROFILE%\.local\bin\claude.exeon Windows" code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Troubleshoot installation and login」. "The
echocommand saves the setting for every new terminal, andsourceapplies it to the window you're in." / "Restart your terminal for the change to take effect." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Advanced setup」. "prints read-only installation and settings diagnostics without starting a session" code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Quickstart」. "Claude Code prompts you to log in on first use." code.claude.com · 「Authentication」. "Claude Pro, Max, or Ultra subscription: log in with your claude.ai account." code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Authentication」. "If the browser doesn't open automatically, press
cto copy the login URL to your clipboard, then paste it into your browser." / "If your browser shows a login code instead of redirecting back after you sign in, paste it into the terminal at thePaste code here if promptedprompt." / "When login completes, the terminal showsLogin successfuland prompts you to pressEnterto continue." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Quickstart」. "Once logged in, your credentials are stored and you won't need to log in again." / "To switch accounts later or re-authenticate, type
/logininside the running session." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Quickstart」. "Native installations automatically update in the background to keep you on the latest version." code.claude.com · 「Advanced setup」. "Updates download and install in the background, then take effect the next time you start Claude Code." code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「CLI reference」. "Update to latest version" code.claude.com · 「Advanced setup」. "If you're already on the newest version, it reports
Claude Code is up to date (<version>)." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Quickstart」. "Homebrew installations do not auto-update." / "Run
winget upgrade Anthropic.ClaudeCodeperiodically to get the latest features and security fixes." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Advanced setup」. "rm -f ~/.local/bin/claude" code.claude.com (확인일 2026-11-06) ↩︎