설치했는데 command not found가 나올 때
재설치 전에 터미널 재시작·실행 파일 위치·PATH를 구분해 확인합니다. Claude Code 사례로 설명합니다.
설치 실패와 경로 문제를 구분하세요
command not found: claude 또는 “claude를 인식할 수 없습니다”는 터미널이 실행 프로그램을 찾지 못했다는 뜻입니다. 설치 파일이 없을 수도 있고, 설치됐지만 찾는 경로에 등록되지 않았을 수도 있습니다.
PATH는 터미널이 프로그램을 찾을 폴더 목록입니다. 작업 폴더를 뜻하는 경로와 다릅니다. 이 글은 무조건 재설치하거나 시스템 설정을 덮어쓰는 방식으로 해결하지 않습니다.
1. 가장 먼저 새 창에서 확인
- 설치가 끝났는지 성공·오류 안내를 확인합니다.
- 기존 터미널을 둔 채 새 터미널 창을 엽니다.
claude --version을 입력합니다.- 계속 같은 오류가 나오면 내 운영체제에 맞는 아래 확인을 진행합니다.
Mac: 실행 파일 자체 확인
~/.local/bin/claude --version
버전이 나오면 해당 위치에 프로그램은 있습니다. 파일이 없다는 오류라면 설치 완료 여부와 설치 안내의 실제 위치를 확인합니다. 다른 설치 방식을 섞었다면 위치가 다를 수 있습니다.
Windows PowerShell: 실행 파일 자체 확인
& "$env:USERPROFILE\.local\bin\claude.exe" --version
버전이 나오면 파일은 있지만 PATH 연결을 확인해야 하는 상황일 수 있습니다. & 기호도 명령의 일부입니다. PowerShell용이므로 Mac 터미널에 붙여넣지 않습니다.
2. 결과에 따라 다음 행동 정하기
- 전체 경로로는 실행됨: 공식 문서의 Add the install directory to your PATH 안내를 내 셸에 맞춰 확인합니다.
- 파일이 없음: 설치 로그의 마지막 오류와 실제 설치 위치를 확인합니다.
- 권한·인증서·네트워크 오류: PATH를 바꾸는 것으로 해결되지 않을 수 있습니다. 해당 오류 항목으로 이동합니다.
설정 파일 수정은 실제 사용 셸과 기존 설정을 확인한 다음 진행합니다. 인터넷에서 찾은 echo·export 명령을 반복 붙여넣어 같은 내용을 여러 번 추가하지 않습니다.
도움을 요청할 때 적을 것
운영체제와 버전:
사용한 창: Mac 터미널 / Windows PowerShell
설치 방식:
claude --version 결과:
전체 경로로 실행한 결과:
설치 안내 마지막 오류:
이름이 들어간 경로, API 키, 인증 코드는 가리고 공유하세요. 정상 실행된다면 일반 셸에서 claude doctor로 설치 상태 진단을 확인할 수 있습니다.
완료 기준: 일반 명령으로 버전이 표시됩니다. 이어서 로그인을 진행하세요.