클로드 코드 설치 방법, 명령어는 됐는데 claude가 안 뜰 때

터미널을 거의 안 써 본 직장인이 Claude Code를 깔려다 막혔다면 이 순서대로 보세요.

Anthropic 공식 설치 문서(2026년 10월 30일 수정) 기준으로 맥은 터미널, 윈도우는 PowerShell이나 CMD에 한 줄이면 설치가 끝나요.

막히는 지점은 설치 뒤에 더 많아요. 준비물, 터미널별 명령, 명령이 안 뜰 때, 로그인 오류, 첫 실행 명령 순서로 점검해 볼게요.

한 줄 정답: 터미널에 맞는 명령으로 설치하고, 새 창에서 claude를 입력해 로그인해요.

1. 클로드 코드 설치 방법, 시작 전 준비물 점검

운영체제 버전, 메모리, 유료 계정 세 가지만 맞으면 설치는 금방 끝나요.

Anthropic 공식 설치 문서는 맥은 macOS 13.0 이상, 윈도우는 Windows 10 1809 이상을 요구해요. 메모리는 4GB 이상이고 인터넷 연결도 있어야 하죠.

한국은 Anthropic 지원 국가 목록에 들어 있어서 지역 제한에 걸릴 일은 없어요.

터미널이 낯설다면 공식 데스크톱 앱으로 시작하는 길도 있어요. 다만 이 글은 터미널 설치를 기준으로 설명해요.

2. 클로드 코드 윈도우, 맥 설치 명령은 터미널마다 달라요

같은 윈도우라도 PowerShell과 CMD 명령이 달라서, 프롬프트 모양부터 확인해야 해요.

Anthropic 공식 설치 문서에 따르면 PowerShell은 프롬프트 앞에 PS가 붙고, CMD는 PS 없이 C 드라이브 경로만 보여요. 설치 명령은 내려받는 동안 진행 표시가 없으니 멈춘 것처럼 보여도 기다리면 돼요.

기본 설치 방식은 백그라운드에서 알아서 업데이트돼요. Homebrew나 WinGet으로 깔면 업그레이드 명령을 가끔 직접 돌려야 하니, 관리가 귀찮다면 기본 설치 쪽이 편해요.

설치가 끝나면 새 터미널 창에서 claude --version을 입력해 보세요. 버전 번호가 찍히면 정상이에요.

3. 설치했는데 claude가 인식되지 않을 때, 원인은 PATH

설치는 됐는데 명령을 못 찾는다면 설치 폴더가 PATH에 안 들어간 경우예요.

Anthropic 설치·로그인 문제 해결 문서는 command not found나 not recognized 오류에 PATH부터 보라고 안내해요. 설치 프로그램은 맥, 리눅스는 홈 폴더의 .local/bin, 윈도우는 사용자 폴더의 .local\bin에 파일을 둬요.

설치 프로그램은 이 상황을 Setup notes 항목으로 알려 주지만 PATH를 직접 바꾸지는 않아요. 출력을 대충 넘기면 이 안내를 놓치기 쉽더라고요.

• 증상: 설치 명령은 끝났는데 claude를 치면 명령을 찾을 수 없다고 나와요.
• 원인: 설치 폴더가 PATH 목록에 없거나, 설치 직후 열려 있던 창을 그대로 쓰는 경우예요.
• 해결: 맥 Zsh라면 ~/.zshrc에 .local/bin 경로를 추가하고 새 창을 열어요. 윈도우는 사용자 환경 변수 Path에 해당 폴더를 넣으면 되죠.

Claude Code 깃허브 저장소의 PATH 안내 요청 이슈에도 같은 지적이 있어요. 설치 스크립트가 PATH 경고와 해결 명령을 출력하는데, 소개 페이지에는 이 내용이 없어서 그냥 지나치기 쉽다는 거죠.

맥에서 ~/.zshrc에 쓰기 권한 오류가 나면 파일 주인이 다른 계정인 경우예요. 이때는 공식 문서대로 소유자를 바꾼 뒤 PATH 명령을 다시 넣으면 돼요.

4. 로그인이 막힐 때 점검 순서

무료 플랜 계정이면 로그인 단계에서 막히니 요금제부터 확인해야 해요.

Anthropic 공식 설치 문서는 Pro, Max, Ultra, Team, Enterprise, Console 계정이 필요하다고 적었어요. 무료 claude.ai 플랜에는 Claude Code가 포함되지 않아요.

첫 실행 때 claude를 입력하면 브라우저가 열리고, 그 안내를 따라 로그인하면 돼요. 한 번 로그인하면 정보가 저장돼서 다음부터는 다시 묻지 않아요.

• 증상 1: 로그인 뒤 403 Forbidden이 뜨면 claude.ai/settings에서 구독이 살아 있는지 봐요.
• 증상 2: OAuth Invalid code는 코드가 만료됐거나 복사하다 잘린 경우라서, 브라우저가 열리면 바로 끝내는 게 좋아요.
• 증상 3: 브라우저가 안 열리면 c 키로 로그인 주소를 복사해 직접 붙여 넣어요.
• 증상 4: WSL2나 원격 접속 환경이라면 claude auth login으로 받은 코드를 터미널에 붙여 넣어요.

원인이 애매할 땐 /logout으로 완전히 나간 뒤 Claude Code를 닫고 다시 실행해 로그인하세요. Anthropic 설치·로그인 문제 해결 문서도 이 순서를 기본 해결책으로 내놓았어요.

회사 Enterprise 계정에서 접근 권한이 없다는 문구가 나오면 내 쪽 설정으로는 못 풀어요. 조직 소유자에게 Claude Code가 포함된 역할을 요청해야 하죠.

5. 클로드 코드 사용법, 첫 실행 기본 명령

작업할 프로젝트 폴더로 이동한 뒤 claude를 입력하면 대화형 세션이 열려요.

Anthropic 빠른 시작 문서는 첫 세션 화면 위쪽에 버전, 현재 모델, 작업 폴더가 보인다고 설명해요. 명령이 기억나지 않으면 세션 안에서 /help를 치면 목록이 나오죠.

세션을 끝낼 때는 /exit를 입력하거나 Ctrl+D를 두 번 누르면 돼요. 계정을 바꾸고 싶다면 세션 안에서 /login을 다시 입력하세요.

첫 질문은 코드 수정보다 이 프로젝트가 무슨 일을 하는지 물어보는 쪽이 부담이 적어요. 지시를 잘 쓰는 요령은 클로드 프롬프트 작성법 글에 따로 정리해 두었어요.

6. 이럴 땐 설치가 꼬이더라고요, 증상별 마무리 점검

업데이트 직후 명령이 사라졌다면 설치 방식과 권한을 섞어 쓴 경우가 많아요.

WinGet 업그레이드 뒤 명령이 사라진 이슈에는 일반 창과 관리자 창에서 번갈아 업그레이드했다가 claude 명령이 사라진 보고가 있어요. 한 가지 방식, 같은 권한으로만 업데이트하는 게 덜 꼬여요.

정리하면, 윈도우 초보라면 PowerShell 기본 설치가 손이 덜 가요. 리눅스 도구나 격리 실행이 필요한 개발자라면 WSL 2 쪽이 맞고요.

요금제 한도가 고민이라면 클로드 프로 맥스 차이 글을, 코딩 말고 문서 업무에 쓰려면 클로드 코워크 사용법 글을 함께 보세요.

7. 함께 보면 좋은 글

• Pro와 Max 중 Claude Code 사용량에 맞는 요금제는 클로드 프로 맥스 차이 글에서 비교해 볼 수 있어요.
• 터미널 없이 업무 자동화를 해 보고 싶다면 클로드 코워크 사용법 글을 참고해 보세요.
• Claude Code에 일을 시킬 때 지시문 쓰는 요령은 클로드 프롬프트 작성법 글에 있어요.

8. 클로드 코드 설치 방법, 자주 묻는 질문

Q1. 무료 claude.ai 계정으로도 Claude Code를 쓸 수 있나요?

아니요, 무료 플랜에는 Claude Code가 포함되지 않아요. Anthropic 공식 설치 문서는 Pro, Max, Ultra, Team, Enterprise, Console 계정 중 하나가 필요하다고 안내해요. API 키를 쓰는 Console 계정은 선불 크레딧 방식이에요.

Q2. 윈도우에서 관리자 권한으로 설치해야 하나요?

아니요, 일반 PowerShell이나 CMD 창에서 설치하면 돼요. 공식 문서는 관리자 권한이 필요 없다고 적었어요. Git for Windows도 선택 사항이라 없으면 PowerShell 도구로 명령을 실행해요.

Q3. 설치한 버전은 직접 업데이트해야 하나요?

기본 설치라면 백그라운드에서 알아서 업데이트돼요. Homebrew, WinGet, apt 같은 패키지 관리자로 깔았다면 업그레이드 명령을 직접 실행해야 해요. 업데이트가 실패하면 claude doctor로 마지막 시도 결과를 확인할 수 있어요.

Q4. 터미널이 너무 어려우면 다른 방법이 있나요?

네, 공식 데스크톱 앱으로도 Claude Code를 쓸 수 있어요. Anthropic은 맥과 윈도우용 데스크톱 앱을 따로 제공해요. 명령어 입력 없이 화면에서 작업할 수 있어서 터미널이 낯선 분께 부담이 적어요.