클로드 코드 설치 가이드: OS별 설치와 첫 실행까지

클로드 코드 설치란?
앤트로픽이 만든 터미널 기반 AI 코딩 도구 Claude Code를 macOS, 리눅스, 윈도우에 내려받아 실행할 수 있는 상태로 만드는 과정이며, 설치 스크립트 한 줄과 계정 인증만으로 끝난다.

설치는 3분이면 끝난다. 문제는 그다음이다.

클로드 코드는 브라우저 챗봇이 아니라 터미널에서 도는 커맨드라인 도구다. 코드를 붙여넣고 답변을 받아 다시 붙여넣는 방식 대신, 프로젝트 폴더를 직접 읽고 파일을 고치고 테스트를 돌린다. 그래서 설치 단계도 IDE 확장 설치와는 성격이 다르다. 터미널, 셸 환경, 권한 설정을 한 번은 건드려야 한다.

설치 전 확인할 환경 조건

앤트로픽 공식 문서 기준으로 요구 사양은 높지 않다. 다만 운영체제 버전이 오래됐다면 설치 자체가 막힌다.

사내망에서 프록시나 방화벽을 쓴다면 마지막 항목이 실제 병목이 된다. 금융권과 공공 부문에서 설치 실패 문의의 상당수가 외부 도메인 차단 때문이라고 알려져 있다. 설치 명령을 치기 전에 네트워크 정책부터 확인하는 편이 낫다.

OS별 설치 방법

macOS와 리눅스, WSL

터미널에 아래 한 줄을 입력한다.

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

설치 스크립트가 실행 파일을 사용자 홈 디렉터리 아래에 놓고 PATH를 잡아준다. 설치가 끝나면 새 터미널 창을 열어야 경로가 반영된다. 기존 창에서 claude: command not found가 뜨는 사례 대부분이 여기서 나온다.

윈도우

PowerShell을 열고 다음을 실행한다.

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

윈도우 네이티브 환경에서도 동작하지만, git 기반 작업이 많다면 WSL(Windows Subsystem for Linux) 위에 리눅스 방식으로 까는 쪽이 경로 문제와 줄바꿈 문자 문제를 덜 겪는다. 팀 표준을 정할 때 이 선택을 먼저 못 박아두면 나중에 개발자마다 환경이 달라져 문제 재현이 어려워진다.

npm으로 설치하기

Node.js 18 이상이 이미 깔려 있다면 패키지 매니저를 써도 된다.

npm install -g @anthropic-ai/claude-code

여기서 주의할 점 하나. sudo를 붙여 전역 설치하면 권한 문제로 자동 업데이트가 깨진다고 알려져 있다. 앤트로픽도 sudo 없는 설치를 권한다. 이미 sudo로 깔았다면 지우고 네이티브 스크립트로 다시 설치하는 편이 깔끔하다.

첫 실행과 인증

설치가 끝났으면 작업할 프로젝트 폴더로 이동해 claude를 입력한다. 폴더 위치가 중요하다. 클로드 코드는 실행한 디렉터리를 작업 범위로 잡기 때문에, 홈 디렉터리에서 그냥 켜면 엉뚱한 파일을 읽는다.

1. 프로젝트 폴더로 이동: cd ~/projects/my-app
2. claude 실행
3. 브라우저가 열리며 인증 절차 진행
4. Claude 구독 계정 또는 Anthropic Console API 크레딧 중 하나 선택

과금 경로가 둘이라는 점은 도입 전에 짚고 넘어가야 한다. 개인 구독은 정액제, Console API는 토큰 사용량 기반 종량제다. 2026년 8월 기준 플랜 구성과 사용량 한도는 앤트로픽 공식 요금 페이지에서 수시로 바뀌므로, 팀 단위 예산을 잡을 때는 발표 시점의 공식 문서를 직접 확인해야 한다. 블로그에 적힌 작년 요금표를 기준으로 견적을 짜면 어긋난다.

설치가 제대로 됐는지 의심스러우면 세션 안에서 /doctor를 실행한다. PATH, 버전, 권한 상태를 한 번에 점검해준다. 업데이트는 claude update다.

설치는 쉽다, 그런데 효과는 자동이 아니다

여기서부터가 냉정하게 볼 대목이다. 설치 난이도가 낮다고 도입 성과가 보장되지는 않는다.

2025년 7월 METR이 발표한 무작위 대조 실험은 이 지점을 정면으로 건드린다. 숙련된 오픈소스 개발자들이 익숙한 저장소에서 AI 코딩 도구를 썼을 때 오히려 작업 시간이 늘었고, 정작 참가자 본인들은 더 빨라졌다고 인식했다는 결과로 알려져 있다. 체감 생산성과 실측 생산성이 반대 방향을 가리켰다는 뜻이다. 표본이 크지 않고 특정 조건(대규모 성숙 코드베이스, 고숙련자)에 한정된 연구라 일반화는 조심해야 하지만, "설치했더니 팀이 빨라졌다"는 자기 보고를 그대로 믿기 어렵게 만드는 근거인 것은 분명하다.

컨설팅 펌들이 내놓는 AI 도입 성과 수치도 같은 눈으로 봐야 한다. 맥킨지와 BCG 같은 곳은 AI 전환 자문 서비스를 직접 파는 당사자라, 긍정적 수치 쪽으로 기울 유인이 구조적으로 있다. 수치 자체를 버릴 이유는 없지만, 어떤 조건에서 측정했는지가 빠진 백분율은 의사결정 근거로 약하다.

그래서 설치 다음에 와야 할 것은 도구 확산이 아니라 측정 설계다. 도입 전 4주와 도입 후 4주의 PR 리드타임, 리뷰 반려율, 버그 재유입률을 같은 기준으로 비교하지 않으면 효과는 영원히 인상으로만 남는다. 비용 대비 성과를 어떤 틀로 따질지는 AI 전환 ROI: 기업이 알아야 할 경제학에서 더 깊이 다뤘다.

팀 단위로 깔 때 먼저 정해둘 것

• 설치 방식 통일: 네이티브 스크립트와 npm 중 하나로 표준을 정한다. 섞이면 버전 관리가 흐트러진다
• 권한 경계: 어떤 저장소에서 파일 수정을 허용할지, 커밋과 푸시를 도구에 맡길지 사전에 규칙화한다
• 비밀 정보 차단: .env, 인증서, 키 파일이 컨텍스트에 딸려 들어가지 않도록 제외 설정을 먼저 넣는다
• 보안 검토: 외부 API로 소스가 전송되는 구조이므로, 사내 정보보호 정책과 부딪히는지 법무나 보안 담당과 사전 확인한다
• 측정 기준: 도입 전 기준선 데이터를 먼저 확보한다. 나중에는 못 모은다

설치는 개인이 3분에 끝내지만, 조직 도입은 위 다섯 항목을 정리하는 데 몇 주가 걸린다. 이 격차를 인정하지 않은 채 "전사에 깔았다"를 전환 완료로 보고하는 순간, 성과 측정은 처음부터 불가능해진다.

더 읽어보기

• AI 전환 ROI: 기업이 알아야 할 경제학

자주 묻는 질문

클로드 코드 설치에 유료 구독이 꼭 필요한가?

설치 자체는 무료지만 실행하려면 인증이 필요하고, 인증은 Claude 구독 계정 또는 Anthropic Console의 API 크레딧 중 하나를 요구한다. 즉 무과금 상태로 계속 쓰는 경로는 없다. 팀 규모가 크면 개인 구독 합계와 API 종량제 중 어느 쪽이 저렴한지 실사용 토큰량을 두 주 정도 재본 뒤 결정하는 편이 안전하다.

설치했는데 claude 명령을 못 찾는다고 나온다

PATH가 현재 셸 세션에 반영되지 않은 경우가 대부분이다. 터미널을 완전히 닫았다가 새로 열어보고, 그래도 안 되면 셸 설정 파일(.zshrc, .bashrc)에 설치 경로가 들어갔는지 확인한다. 회사 노트북에서 설치 스크립트가 조용히 실패했을 가능성도 있으니 방화벽 로그를 함께 본다.

기존 IDE 확장이나 다른 AI 코딩 도구와 같이 써도 되나?

기술적으로 충돌하지는 않는다. 다만 도구를 나란히 늘릴수록 어떤 도구가 어떤 변화를 만들었는지 가릴 수 없게 된다. 효과를 검증할 생각이라면 한 팀에서는 한 도구로 기간을 나눠 비교하는 설계가 낫다.

다음 단계

설치는 출발선이지, 전환의 완료 지점이 아니다. 도구를 깐 뒤 무엇을 재고 어떤 기준으로 확대 여부를 판단할지가 실제 성과를 가른다. AI 전환을 근거 기반으로 설계하는 방법이 궁금하다면 Nitrox 블로그에서 관련 가이드를 더 살펴보길 권한다.