🔥<24기 AI 스터디> 블라인드 최저가로 신청하세요 🔥

📰
최신 AI 소식
지피터스_강지인
지피터스_강지인
🐶 AI 찐친
☕ 커피챗 오픈
·최신 AI 소식에 게시됨

클로드 코드 설치 안 될 때: command not found 두 줄로 해결

클로드 코드를 깔았는데 claude 를 쳤을 때 command not found 가 뜬다면, 설치는 이미 끝난 겁니다. 터미널이 파일 위치를 모를 뿐입니다. 아래 두 줄을 붙여넣으면 해결됩니다.

맥이면 이 두 줄입니다. 그대로 복사해서 붙여넣으세요.

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

리눅스는 두 줄 다 ~/.bashrc 로 바꿉니다.

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

claude --version 을 쳐서 숫자가 나오면 끝난 겁니다.

클로드 코드 설치 안 될 때 - zsh: command not found: claude

왜 이렇게 되나요

설치 프로그램은 ~/.local/bin/claude 에 파일을 놓습니다.

터미널은 아무 데나 뒤지지 않습니다. PATH라는 목록에 적힌 폴더만 찾아봅니다. 이 폴더가 목록에 없으면 파일이 눈앞에 있어도 못 찾습니다.

위의 두 줄이 하는 일이 그겁니다. 첫 줄은 목록에 폴더를 추가하고, 둘째 줄은 그걸 지금 터미널에 적용합니다. 둘째 줄 대신 터미널을 껐다 켜도 똑같습니다.

에러 문구는 컴퓨터마다 조금씩 다른데 전부 같은 뜻입니다.

  • 맥: zsh: command not found: claude
  • 리눅스: bash: claude: command not found
  • 윈도우: 'claude' is not recognized as an internal or external command

윈도우는 이렇게 합니다

파워셸을 열고 이 두 줄을 붙여넣습니다.

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

그리고 터미널을 반드시 껐다 켜야 합니다. 윈도우는 이 설정이 새 창부터 적용됩니다.

아직 설치 전이라면

명령어 한 줄이면 됩니다. Node.js 같은 걸 미리 깔 필요 없습니다.

맥, 리눅스, WSL은 이 줄입니다.

curl -fsSL https://claude.ai/install.sh | bash

윈도우 파워셸은 이 줄입니다.

irm https://claude.ai/install.ps1 | iex

윈도우 CMD는 명령이 다릅니다. 창 맨 앞에 PS 가 붙어 있으면 파워셸, 그냥 C:\ 로 시작하면 CMD입니다. 여기서 헷갈리면 설치가 시작도 안 됩니다.

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

홈브루나 윈겟을 쓰던 분은 brew install --cask claude-code 나 winget install Anthropic.ClaudeCode 도 됩니다. 다만 이렇게 깔면 자동 업데이트가 안 돼서 직접 올려줘야 합니다.

계정 조건이 하나 있습니다. Pro, Max, Team, Enterprise, Console 중 하나가 필요합니다. 무료 클로드 계정으로는 안 됩니다. 설치는 멀쩡히 끝났는데 로그인에서 막힌다면 대개 이겁니다.

두 줄을 넣었는데도 안 될 때

세 가지만 순서대로 보면 됩니다.

1. 터미널을 새로 열었나요. 창을 완전히 닫았다가 다시 열어보세요. 이것만으로 풀리기도 합니다.

2. VS Code 확장만 깔지 않았나요. 확장은 자기 폴더 안에 사본을 갖고 있고 PATH에는 넣지 않습니다. 확장만 깔았다면 ~/.local/bin/claude 자체가 없습니다. 터미널에서 쓰려면 위의 설치 명령을 따로 돌려야 합니다. VS Code 안에서 붙여 쓰는 방법은 VS Code에서 클로드 코드 쓰는 법에 정리해뒀습니다.

3. 설치본이 여러 개 아닌가요. 버전이 이상하게 낮게 나오거나, 지웠는데 계속 실행되면 이겁니다. 이 줄로 확인합니다.

which -a claude

여러 줄이 나오고 경로가 서로 다르면 설치본이 겹친 것입니다. 옛날 방식으로 깔았던 것들을 지우면 됩니다.

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/local

같은 경로가 여러 번 나오는 건 괜찮습니다. 제 맥도 네 번 나오는데 아무 문제 없습니다.

설치 명령부터 실패할 때

증상별로 원인이 거의 정해져 있습니다.

  • syntax error near unexpected token '<' 또는 403: 설치 파일 대신 웹페이지가 내려온 겁니다. 회사 네트워크나 보안 프로그램이 막고 있을 가능성이 큽니다.
  • irm is not recognized: CMD 창에서 파워셸 명령을 친 겁니다. 반대로 '&&' is not a valid statement separator 는 파워셸에서 CMD 명령을 친 겁니다.
  • Claude Code does not support 32-bit Windows: 시작 메뉴에서 뒤에 (x86)이 붙은 파워셸을 연 겁니다. (x86) 없는 쪽으로 다시 여세요.
  • claude 를 쳤는데 데스크탑 앱이 열림: 옛날 버전 데스크탑 앱이 이름을 가로챈 겁니다. 앱을 최신으로 올리면 됩니다.
  • 권한 오류: sudo chown -R $(whoami) ~/.local 로 폴더 주인을 내 계정으로 바꿉니다.

회사 네트워크가 의심되면 이 줄로 확인해보세요. 첫 줄에 200이 보이면 연결은 되는 겁니다.

curl -sI https://downloads.claude.ai/claude-code-releases/latest

sudo npm install -g 는 쓰지 마세요. 권한이 꼬입니다. 공식 문서도 하지 말라고 못 박아뒀습니다.

로그인에서 막힐 때

  • 403이 뜬다: 구독을 확인하세요. 무료 플랜은 안 됩니다. 회사 Console 계정이면 관리자에게 Claude Code 권한을 받아야 합니다.
  • 로그인 코드가 안 먹는다: 코드가 만료됐거나 복사하다 잘린 겁니다. 브라우저가 안 열리면 c 를 눌러 주소를 복사해 직접 붙여넣으세요.
  • WSL이나 원격 접속이라 브라우저가 안 열린다: 로그인하면 화면에 코드가 뜹니다. 그걸 터미널에 붙여넣으면 됩니다. 붙여넣기가 안 먹으면 claude auth login 을 쓰세요.
  • 원인을 모르겠다: /logout 하고 클로드 코드를 완전히 닫았다가 다시 로그인하면 대부분 풀립니다.

잘 깔렸는지 확인하는 법

두 줄이면 됩니다.

claude --version
claude doctor

claude doctor 는 세션을 시작하지 않고 상태만 알려줍니다. 2026년 8월 24일 제 맥에서 나온 결과인데, 계정 경로가 들어간 줄은 빼고 옮겼습니다.

Running: native (2.1.241)
Platform: darwin-arm64
Config install method: native
Search: OK (bundled)
Auto-updates: enabled
Last update attempt: success → 2.1.241

No installation issues found.

맨 아래 줄에 No installation issues found. 가 보이면 정상입니다. 문제가 있으면 여기에 그대로 적혀 나오니, 어디가 이상한지 모를 때 이 명령부터 쳐보세요.

자주 묻는 질문

무료 클로드 계정으로 쓸 수 있나요?

안 됩니다. Pro, Max, Team, Enterprise, Console 중 하나가 필요합니다.

Node.js를 먼저 깔아야 하나요?

위의 설치 명령을 쓰면 필요 없습니다. npm으로 깔 때만 Node.js 22 이상이 필요합니다.

윈도우에서 WSL을 꼭 써야 하나요?

아닙니다. 윈도우에서 바로 돌아갑니다.

claude 를 쳤는데 아무 반응이 없어요.

claude --version 부터 쳐보세요. 이것도 안 되면 PATH 문제라 맨 위의 두 줄로 해결됩니다. 버전은 나오는데 실행만 안 되면 claude doctor 를 쳐보세요.

완전히 지우려면요?

두 줄입니다.

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

설정까지 지우려면 홈 폴더의 .claude 도 지워야 하는데, 여기에 세션 기록이 다 들어 있어서 되돌릴 수 없습니다.

한 장으로 정리

  • claude 를 못 찾는다 → 맨 위 두 줄. 터미널 새로 열기.
  • 여전히 안 된다 → which -a claude 로 설치본이 겹쳤는지 확인.
  • 설치 명령이 실패한다 → 창을 잘못 열었거나 네트워크가 막고 있습니다.
  • 로그인이 안 된다 → 구독 등급부터. 무료 플랜은 안 됩니다.
  • 모르겠다 → claude doctor 가 대부분 짚어줍니다.

설치 명령과 오류 문구는 버전이 올라가면 바뀔 수 있습니다. 이 글은 2026년 8월 24일 공식 문서와 제 맥에서 확인한 내용이고, 윈도우와 리눅스 항목은 직접 재현하지 못해 문서 기준으로 적었습니다.

터미널이 처음이라면 CLI 뜻과 터미널·셸 차이를 먼저 보세요. 설치를 끝냈으면 클로드 코드로 뭐부터 자동화할까에 실무자 4명이 고른 업무가 정리돼 있습니다.