Claude Code 설치용 셸별 명령과 자주 나는 오류
아래 내용은 code.claude.com에 있는 Anthropic의 설정 문서를 바탕으로 하며, 2026-10-19에 읽었습니다.
시작하기 전에
- OS: macOS 13.0+, Windows 10 1809+ 또는 Windows Server 2019+, Ubuntu 20.04+, Debian 10+, 또는 Alpine Linux 3.19+.
- 하드웨어: RAM 4 GB 이상, x64 또는 ARM64.
- 네트워크: 인터넷 연결이 필요합니다.
- 계정: Claude Code를 사용하려면 Pro, Max, Team, Enterprise 또는 Console 계정이 필요합니다. 무료 claude.ai 플랜에는 포함되지 않습니다.
설치: 사용 중인 셸을 선택하세요
macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell (PS C:\가 프롬프트에 표시됨)
irm https://claude.ai/install.ps1 | iexWindows CMD (PS 없이 C:\가 프롬프트에 표시됨)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd설치 프로그램은 다운로드하는 동안 진행 표시를 보여주지 않습니다. 완료되면 새 터미널 창을 열고 다음을 실행하세요:
claude --version설치가 정상이라면 2.1.211 (Claude Code) 같은 버전 번호가 출력됩니다. 더 확실하게 확인하려면 claude doctor를 실행하세요.
사실은 셸을 잘못 선택해서 생기는 2가지 오류
| 오류 | 의미 |
|---|---|
The token '&&' is not a valid statement separator | CMD 명령을 PowerShell에 붙여넣었습니다 |
'irm' is not recognized as an internal or external command | PowerShell 명령을 CMD에 붙여넣었습니다 |
프롬프트를 확인하세요: PS C:\는 PowerShell이고, PS가 없는 C:\는 CMD입니다. 설치가 syntax error near unexpected token '<' 또는 403으로 실패한다면, 문서에서는 대체 설치 방법에 대한 문제 해결 페이지를 안내합니다.
성공적으로 설치했는데도 claude를 찾을 수 없다고 나오면, 설치 디렉터리가 아직 PATH에 없습니다. 먼저 새 터미널을 여세요. 그래도 해결되지 않으면 문제 해결 가이드의 "Fix your PATH" 섹션을 따르세요.
다른 설치 방법
| 방법 | 명령어 |
|---|---|
| Homebrew | brew install --cask claude-code |
| WinGet | winget install Anthropic.ClaudeCode |
| npm (Node.js 22 이상 필요) | npm install -g @anthropic-ai/claude-code |
| apt, dnf, apk | Debian, Fedora, RHEL 및 Alpine용 서명된 저장소 |
sudo npm install -g는 사용하지 마세요. 문서에서는 이 방법이 권한 문제와 보안 위험을 일으킬 수 있다고 경고합니다. 네이티브 설치는 백그라운드에서 자동으로 업데이트됩니다. Homebrew, WinGet 및 Linux 패키지 관리자 설치는 자동 업데이트되지 않으므로, 직접 brew upgrade claude-code 또는 winget upgrade Anthropic.ClaudeCode를 실행해야 합니다. claude update는 업데이트를 즉시 적용합니다.
첫 실행
cd your-project
claudeClaude Code는 처음 사용할 때 브라우저를 통해 로그인하라고 요청합니다. 기본 Windows에서는 Claude Code가 Bash 도구를 사용할 수 있도록 Git for Windows를 사용하는 것이 권장됩니다. 이것이 없으면 Claude Code는 셸 도구로 PowerShell을 사용합니다.
제거
macOS, Linux 및 WSL에서는:
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude설정은 ~/.claude와 ~/.claude.json에 저장됩니다. 이 파일들을 삭제하면 설정, 허용된 도구, MCP 서버 구성, 세션 기록이 모두 삭제됩니다.
이 글의 한계
이 글을 위해 설치 프로그램을 직접 실행하지는 않았습니다. 명령은 2026년 10월 기준 문서에서 가져온 것이며, 예시 버전 번호도 거기에 표시된 것입니다. 명령과 URL은 바뀔 수 있으므로, 무엇이든 실패하면 최신 설정 페이지를 우선 확인하세요. Claude Code에 대한 추가 노트는 주로 한국어로 my-blog.org/claude-code에서 더 많이 작성하고 있습니다.
FAQ
Claude Code 설치 명령은 무엇인가요? macOS, Linux 및 WSL에서는 curl -fsSL https://claude.ai/install.sh | bash를 사용합니다.
Windows에서 Claude Code는 어떻게 설치하나요? PowerShell에서는 irm https://claude.ai/install.ps1 | iex를 실행하세요. CMD에서는 위에 표시된 curl 기반 install.cmd 명령을 사용하세요.
정상적으로 설치됐는지 어떻게 확인하나요? 새 터미널을 열고 claude --version을 실행하세요.
Node.js가 필요한가요? 네이티브 설치 프로그램에는 필요하지 않습니다. npm 패키지는 Node.js 22 이상이 필요합니다.
무료 Claude 플랜을 사용할 수 있나요? 아니요. Claude Code를 사용하려면 Pro, Max, Team, Enterprise 또는 Console 계정이 필요합니다.
제가 직접 운영하는 사이트에 두는 무료 도구: 34개의 계산기와 사용법 가이드 - 대출, 퇴직금, 실수령 월급, 저축 vs 예금. 새로 추가된 도구는 광고 없이 한 번의 이메일로 안내됩니다.
출처
- 원문: https://dev.to/sungwoo_lee_e0f26be4a29fd/claude-code-install-3-shell-commands-and-the-2-errors-that-trip-you-opm (2026-10-25 · Sungwoo Lee)