클로드코드 설치 2026: 터미널이 처음이어도 명령 한 줄로 끝내고 첫 질문까지 15분 가이드
퀀텀점프클럽 정상록8분 읽기1 views클로드코드 설치 2026: 터미널이 처음이어도 명령 한 줄로 끝내고 첫 질문까지 15분 가이드
클로드코드: 터미널(글자로 컴퓨터에 명령을 내리는 창)에서 말로 지시하면 코드를 읽고 고쳐 주는 AI 도구예요. 구독 계정으로 로그인해 쓰고, 설치는 명령 한 줄이면 됩니다.
클로드코드 설치, 뭐부터 준비해야 하나요?
이 튜토리얼은 터미널을 한 번도 안 열어 본 분 기준이에요. 컴퓨터와 계정부터 볼게요.
Anthropic(클로드를 만든 회사) 공식 문서에 따르면 맥은 macOS 13.0 이상, 윈도우는 Windows 10 버전 1809 이상이 필요해요. 메모리는 4GB 이상이어야 합니다.
계정도 있어야 해요. Pro, Max, Team, Enterprise 구독이나 Console 계정(미리 충전한 크레딧으로 쓰는 계정)이면 됩니다. 공식 문서는 무료 플랜에 Claude Code(영어 표기, 이 글의 클로드코드와 같은 도구) 이용 권한이 없다고 밝혀요. 요금은 바뀔 수 있으니 공식 요금제 페이지에서 직접 확인하세요.
설치 방법은 여러 가지지만 공식 문서가 권장하는 건 1개, 기본 설치예요. 컴퓨터에 직접 깔고 알아서 업데이트되는 방식이고, 이 글도 이 방법을 따라가요.
맥과 리눅스에서는 명령 한 줄로 끝납니다
공식 문서가 안내하는 설치 명령은 운영체제와 셸(명령을 받아 실행해 주는 프로그램)에 따라 3개예요. 맥·리눅스용(윈도우 안의 리눅스 포함) 1개, 윈도우 PowerShell용 1개, 윈도우 CMD용 1개입니다. 여기서는 첫 번째를 써요.
설치 명령은 아래 한 줄이에요. 설치 파일을 인터넷에서 받아 바로 깔아 주는 명령입니다.
curl -fsSL https://claude.ai/install.sh | bash
순서는 이래요.
- 터미널을 열어요. 맥은 Cmd+Space를 누르고 Terminal을 입력한 뒤 Enter, 리눅스는 Ctrl+Alt+T예요. 명령을 칠 창이 있어야 하거든요.
- 위 명령을 복사해 붙여넣고 Enter를 눌러요. 붙여넣기는 맥이 Cmd+V, 리눅스가 Ctrl+Shift+V예요.
- 끝나면 "Claude Code successfully installed!"라는 문장이 보여요. 이게 보여야 설치가 끝난 거예요.
- 터미널을 닫고 새 창을 열어요. 방금 쓴 창은 설치 전 상태를 기억해서 새 프로그램을 못 찾아요.
전체 15분은 저희가 잡은 어림값이에요. 공식 빠른 시작 문서는 몇 분 안에 끝난다고만 적어요.
npm(Node.js라는 도구에 딸린 설치기)으로도 깔 수 있지만 굳이 필요 없어요. Node.js 22 이상이 필요한 건 이 npm 방식뿐이고, 공식 문서는 권한 문제와 보안 위험 때문에 sudo npm install -g를 쓰지 말라고 안내해요.
윈도우에서는 셸을 먼저 구분하세요
윈도우에는 명령줄 프로그램이 2개 있어요. PowerShell과 CMD예요. 설치 명령이 서로 달라서 지금 어느 쪽인지 먼저 알아야 해요.
구분은 줄 앞머리로 해요. PS C:\Users\이름>처럼 PS가 붙으면 PowerShell이고, C:\Users\이름>처럼 PS가 없으면 CMD예요. Win+X를 누른 뒤 Windows PowerShell을 고르면 PowerShell이 열려요.
PowerShell에서는 아래 한 줄을 붙여넣고 Enter를 눌러요. 붙여넣기는 Ctrl+V나 우클릭이에요.
irm https://claude.ai/install.ps1 | iex
CMD에서는 아래 한 줄을 써요. 설치 파일을 받아 실행하고 지우는 명령이에요.
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
셸을 잘못 고르면 오류가 나요. CMD용 명령을 PowerShell에 넣으면 The token '&&' is not a valid statement separator, PowerShell용 명령을 CMD에 넣으면 'irm' is not recognized가 떠요. 이 문구가 보이면 창을 바꿔서 다시 해요.
윈도우 실행 방식은 3개예요. 윈도우에 바로 설치하는 네이티브 Windows, WSL 2, WSL 1이에요. WSL은 윈도우 안에서 리눅스를 쓰는 기능이고, 이 글은 윈도우에 바로 설치하는 방식을 기준으로 해요. 공식 문서에 따르면 Git for Windows(코드 변경 기록을 관리하는 도구 모음)는 선택사항이라, 없으면 PowerShell을 대신 써요.
설치가 제대로 됐는지 어떻게 확인하나요?
공식 문서가 설치 확인용으로 안내하는 명령은 2개예요. 새 터미널 창에서 아래를 입력해요. 설치된 버전을 보여 주는 명령이에요.
claude --version
버전 번호 뒤에 (Claude Code)가 붙어 나오면 성공이에요. 2.1.211 (Claude Code) 같은 모양인데, 이 숫자는 공식 문서가 든 예시라 화면과 달라도 괜찮아요.
더 꼼꼼히 보려면 claude doctor를 입력해요. 공식 문서 기준으로 세션을 시작하지 않고 설치 상태와 설정 파일 오류만 읽어 주는 진단 명령이라, 아무것도 바꾸지 않아요. claude update는 바로 업데이트하는 명령이고, 이미 최신이면 "Claude Code is up to date"라고 알려 줘요.
처음 하면 여기서 막힙니다
막히는 경우는 크게 네 가지예요. 원인과 해결을 묶어 둘게요.
첫째, "command not found: claude"가 떠요. PATH(컴퓨터가 프로그램을 찾아보는 폴더 목록)에 설치 폴더가 없다는 뜻이에요. 새 터미널 창부터 열어 보고, 그래도 같으면 아래 두 줄을 입력해요. 첫 줄이 PATH에 설치 폴더를 더하는 설정을 적고, 둘째 줄이 지금 창에 바로 적용해요. 맥 기본 셸인 Zsh이면 ~/.zshrc 그대로 써요. Bash를 쓴다면 리눅스는 ~/.bashrc, 맥은 ~/.bash_profile로 두 줄의 ~/.zshrc를 모두 바꿔요. 맥 터미널은 Bash를 로그인 셸로 띄워서 ~/.bashrc를 읽지 않거든요.
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
둘째, 설치 주소가 HTML을 돌려줘요. syntax error near unexpected token '<' 같은 오류가 나오면 스크립트 대신 웹페이지가 온 거예요. 공식 문서에 따르면 그 안에 "App unavailable in region"이 보이면 지원하지 않는 국가라는 뜻이에요. 내용 없는 403이면 사내 방화벽일 수 있어요.
셋째, 셸을 헷갈렸어요. 윈도우에서 A parameter cannot be found that matches parameter name 'fsSL'이 뜨면 맥·리눅스용 명령을 PowerShell에 붙인 거예요. 앞의 윈도우 명령으로 바꿔요.
넷째, 사내 프록시나 방화벽이 막아요. 설치 파일은 downloads.claude.ai에서 받아서, 이 주소가 막히면 설치가 안 돼요. 아래 명령으로 점검해요. 주소에 접속이 되는지 보는 명령이에요.
curl -sI https://downloads.claude.ai/claude-code-releases/latest
첫 줄에 200이 보이면 정상이고, 403이나 5xx면 막혔거나 서비스가 잠시 불안정한 거예요. 윈도우 PowerShell에서는 curl 대신 curl.exe를 써야 해요. 사내 프록시(인터넷 접속을 중간에서 전달하는 서버) 뒤라면 설치 전에 HTTP_PROXY와 HTTPS_PROXY를 설정하고, 주소는 IT 팀에 물어보세요.
참고로 맥과 리눅스에서는 설치 기록이 6개 위치에 남아요. 공식 문서는 폴더 쓰기 권한이 없을 때를 대비한 확인 명령도 안내해요.
설치 후 첫 명령 실행하기
작업할 폴더로 옮긴 뒤 claude를 입력해요. cd는 폴더를 옮기는 명령이에요. 아래 첫 줄이 폴더로 이동하고, 둘째 줄이 클로드코드를 시작해요.
cd my-project
claude
처음 실행하면 브라우저가 열려 로그인하라고 해요. 한 번 로그인하면 자격 증명이 저장돼 다시 안 해도 돼요. 버전과 현재 모델, 작업 폴더가 화면에 보이면 준비가 끝난 거예요.
첫 질문으로 what does this project do?를 넣어 보세요. 파일을 읽고 요약해 줘요. 프로젝트가 없다면 make me a simple webpage that says hello world라고 해도 돼요. 권한을 물어 오면 Enter로 Yes를 골라 진행해요. 다만 최신 버전은 대화형 터미널 세션의 기본값이 자동 모드라서, 대부분의 파일 편집과 명령은 묻지 않고 바로 실행돼요. 현재 권한 모드는 Shift+Tab으로 바꿀 수 있어요.
기억할 조작은 몇 개 없어요. /help는 명령 목록이고 Esc는 실행 중 중단이에요. 터미널에서는 마우스 클릭이 안 되고 화살표 키로 움직여요. 끝낼 때는 exit를 입력해요. 맥과 리눅스에서는 아무것도 입력하지 않은 빈 줄에서 Ctrl+D를 두 번 눌러도 돼요. 여기까지 처음부터 15분 안팎이면 충분해요.
마무리
클로드코드 설치는 운영체제에 맞는 명령 한 줄을 붙여넣고, 새 창에서 버전을 확인하면 끝나요. 막히면 PATH, 셸, 네트워크 순서로 의심해 보세요. 첫 질문까지 해 보셨다면 다음엔 업무에 어떻게 쓸지 아래 글에서 이어 보셔도 좋아요.
관련 글
자주 묻는 질문
무료 계정으로도 클로드코드를 쓸 수 있나요?
공식 문서에 따르면 무료 플랜에는 이용 권한이 없어요. Pro, Max, Team, Enterprise 구독이나 Console 계정이 필요해요.
설치했는데 claude 명령이 없다고 나오면 어떻게 하나요?
새 터미널 창을 먼저 열어요. 그래도 같으면 설치 폴더가 PATH에 없는 거라, 막히는 지점의 두 줄을 입력해 폴더를 추가해요.
설치 주소를 열었더니 HTML이 나오면 어떻게 하나요?
설치 주소가 스크립트 대신 웹페이지를 돌려준 거예요. 지원하지 않는 국가이거나 사내 방화벽이 막은 경우라, 네트워크 점검 명령부터 해 봐요.
터미널 없이도 쓸 수 있나요?
공식 문서는 Desktop 앱으로 터미널 없이 쓰는 방법도 안내해요. 맥, 윈도우, 리눅스 모두 해당하지만 이 글은 터미널 방식만 다뤄요.
