클로드코드 설치 방법 (2026년 8월 기준)

"클로드코드 설치"라고 검색해 보신 적 있으신가요? 클로드 앱을 스마트폰에 받는 법과, 클로드코드(Claude Code)를 컴퓨터에 까는 법이 한데 뒤섞여 나옵니다. 결론부터 답해드리겠습니다. 클로드 앱은 앱스토어나 claude.ai에서 받는 대화용 챗입니다. 클로드코드는 터미널에 명령어 한 줄을 쳐서 설치하는 코딩 에이전트입니다. 오늘은 후자, 클로드코드 설치입니다. 맥·리눅스는 터미널에 curl -fsSL https://claude.ai/install.sh | bash를 입력하면 됩니다. 윈도우는 PowerShell에 irm https://claude.ai/install.ps1 | iex를 입력하면 됩니다. 설치가 끝나면 claude --version으로 확인합니다. 그다음 claude를 쳐서 뜨는 화면에서 Pro 이상 구독이나 Anthropic Console 계정으로 로그인하면 됩니다. 설치 방법은 특히 유통기한이 짧은 영역이라, 오늘 안내한 명령어가 여러분이 이 글을 읽는 시점엔 달라져 있을 수 있습니다. 명령어를 치기 전에 공식 문서에서 한 번 더 확인하시는 걸 권합니다.

설치 전 확인할 것

지난 레슨에서 맥의 Terminal이나 윈도우의 PowerShell을 여는 법을 배우셨습니다. 오늘은 그 화면에 명령어를 치는 것부터 시작합니다. 아직 터미널을 열어본 적이 없으시다면, 오늘 레슨보다 지난 레슨을 먼저 보고 오시길 권합니다.

설치 전에 짚고 넘어갈 게 하나 있습니다. 클로드코드는 무료로 쓸 수 없습니다. 지난 레슨(클로드 제품 라인업)에서 확인했듯, Pro·Max·Team·Enterprise 중 하나의 유료 구독이 있거나 Anthropic Console에서 API 크레딧을 결제한 계정이 있어야 합니다. 클로드 앱(claude.ai)의 무료(Free) 플랜 계정으로는 설치까지는 됩니다. 다만 로그인 단계에서 막힙니다. 지금 무료 계정만 갖고 계시다면 오늘 설치는 마칠 수 있습니다. 다만 마지막 로그인에서 멈추게 됩니다. 구독 결제를 먼저 해두시는 게 순서입니다.

시스템 요구 사항도 짧게 확인하겠습니다.

윈도우에서는 WSL(윈도우용 리눅스 서브시스템)이 필요 없습니다. 지난 레슨에서 연 PowerShell 그대로, 네이티브 윈도우 위에서 바로 설치되고 실행됩니다. WSL은 리눅스 도구 체인이 꼭 필요하거나, 명령 실행을 격리된 샌드박스 안에서 돌리고 싶을 때만 나중에 선택하면 되는 옵션입니다.

설치 방법 (2026년 8월, v2.1.226 기준)

설치라고 하면 스토어에서 앱을 내려받아 바탕화면에 아이콘이 뜨는 장면을 떠올리기 쉽지 않으신가요? 클로드코드는 다릅니다. 아이콘은 생기지 않습니다. 대신 터미널이 실행 파일 하나를 내 컴퓨터의 정해진 우편함, 정확히는 ~/.local/bin이라는 폴더에 넣어두는 것에 가깝습니다. 이 우편함 위치를 터미널(정확히는 셸)이 알고 있어야 claude라는 이름만 쳐도 실행이 됩니다. 뒤에 나오는 "자주 걸리는 문제" 대부분이 바로 이 우편함 위치를 셸이 못 찾아서 생깁니다.

아래는 공식 문서가 권장하는 방법, 네이티브 인스톨러(Native Install) 기준입니다. Homebrew(brew install --cask claude-code)나 WinGet(winget install Anthropic.ClaudeCode), npm으로도 설치할 수 있습니다. 다만 오늘은 가장 기본이 되는 경로만 다룹니다. 저라면 npm보다 네이티브 인스톨러를 권합니다. 뒤에서 다룰 PowerShell 실행 정책 오류를 애초에 피할 수 있기 때문입니다.

맥·리눅스

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

이 명령어는 설치 스크립트를 내려받아(curl) 곧바로 실행(bash)합니다. 설치가 끝나면 ~/.local/bin/claude라는 파일이 생깁니다.

윈도우

지난 레슨에서 확인하신 것처럼, 윈도우에는 PowerShell과 CMD 두 개의 명령줄 창이 있습니다. 오늘 명령어는 PowerShell 기준입니다. 창의 첫 줄이 PS로 시작하는지 다시 한번 확인해 주세요.

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

혹시 CMD를 쓰고 계시다면(첫 줄에 PS가 없다면) 이 명령어는 동작하지 않습니다. irm은 PowerShell 전용 명령어이기 때문입니다. CMD에서는 대신 이렇게 칩니다.

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

지금은 이 한 줄이지만 예전에는 아니었습니다. 저는 홈브루를 깔고 Node.js를 깔고 npm으로 설치하는 경로로 시작했는데, 그 단어들이 하나같이 처음 보는 것이었습니다. 하라는 대로 치면 또 다른 걸 깔라고 했습니다.

그때 제가 쓴 방법은 창을 두 개 여는 것이었습니다. 터미널에 뜬 영어를 통째로 복사해서 웹 챗봇에 붙여넣고, 거기서 알려주는 대로 다시 터미널에 치고, 또 붙여넣고를 반복했습니다. 그렇게 왔다 갔다 하는데도 안 되는 경우가 태반이었습니다. 설치 하나에 한참이 걸렸습니다.

지금 이 레슨이 한 줄로 끝나는 건 그 사이에 설치 방식이 바뀌었기 때문입니다. 예전 글을 보고 홈브루부터 깔고 계셨다면 멈추셔도 됩니다.

설치 확인하기

설치가 끝났다면 버전을 확인해 보겠습니다. 맥·윈도우 모두 같은 명령어입니다.

claude --version

2.1.226 (Claude Code)

버전 숫자는 여러분이 설치하는 시점마다 다르게 나옵니다. 클로드코드는 릴리스가 잦아서 며칠 단위로 버전이 올라갑니다. 이 글을 쓴 시점(2026년 8월 9일) 기준 최신 버전은 GitHub 릴리스 페이지 확인 결과 v2.1.226(2026년 8월 8일 배포)입니다. 다음 주에 이 글을 읽으신다면 다른 숫자가 뜰 가능성이 높습니다. 숫자 자체보다 "(Claude Code)"라는 문구까지 함께 뜨는지가 중요합니다. 그게 뜨면 설치는 정상입니다.

더 자세한 진단이 필요하면 이렇게도 쳐볼 수 있습니다.

claude doctor

claude doctor는 세션을 시작하지 않고 설치 상태와 설정 파일에 문제가 없는지만 읽기 전용으로 점검해 줍니다.

로그인하기

버전이 정상적으로 뜬다면 이제 claude라고만 쳐보시면 됩니다.

claude

처음 실행하면 로그인을 요구합니다. 브라우저가 자동으로 열리고, 거기서 로그인을 마치면 터미널로 돌아와 이어집니다. 로그인 계정은 두 갈래 중 하나입니다. Claude Pro·Max·Team·Enterprise 중 하나의 유료 구독 계정, 또는 Anthropic Console(API 크레딧) 계정입니다. 앞서 "설치 전 확인할 것"에서 말씀드렸듯, claude.ai 무료 플랜 계정으로는 이 단계에서 막힙니다.

브라우저가 자동으로 안 열리는 환경(SSH 원격 접속 등)이라면 당황하지 않으셔도 됩니다. 터미널에서 c를 누르면 로그인 링크가 복사됩니다. 이걸 여러분이 평소 쓰는 브라우저에 직접 붙여넣으면 됩니다. WSL2처럼 브라우저는 열리지만 로그인 후 터미널로 자동으로 돌아오지 않는 환경이라면 반대 방향입니다. 브라우저 화면에 뜨는 코드를 복사해 터미널에 붙여넣으면 로그인이 끝납니다. 한 번 로그인하면 자격 증명이 컴퓨터에 저장됩니다. 다음부터는 다시 로그인할 필요가 없습니다.

로그인이 끝났다고 곧바로 대화 입력창이 뜨는 건 아닙니다. 처음 열어보는 폴더에서 claude를 실행하면, 로그인과는 별개로 "이 폴더를 신뢰합니까" 같은 확인이 한 번 더 뜰 수 있습니다. 새 코드베이스를 처음 열 때마다 나타나는 안전장치이니, 본인이 방금 연 폴더가 맞다면 신뢰를 선택하면 됩니다. 이 확인까지 지나야 실제 대화 입력창이 뜹니다.

VS Code 확장 설치 (선택)

터미널 대신 에디터 안에서 쓰고 싶으시다면 VS Code 확장이 있습니다. 지난 레슨(클로드 제품 라인업)에서 다룬 바로 그 확장입니다. VS Code 1.94.0 이상이 필요합니다.

1. VS Code에서 Cmd+Shift+X(맥) 또는 Ctrl+Shift+X(윈도우)를 눌러 확장 탭을 엽니다.
2. "Claude Code"를 검색합니다.
3. Install을 누릅니다.
4. 처음 열면 로그인 화면이 뜹니다. Sign in을 누르고 브라우저에서 인증을 마치면 됩니다.

여기서 헷갈리기 쉬운 지점이 하나 있습니다. VS Code 확장은 채팅창을 띄우기 위한 CLI 사본을 확장 안에 따로 담아둡니다. 그래서 확장만 설치해서는 VS Code의 통합 터미널에 claude라고 쳐도 실행되지 않습니다. 확장의 채팅창과, 터미널에서 직접 부르는 claude 명령어는 서로 다른 설치 경로를 씁니다. VS Code 통합 터미널에서도 claude를 쓰고 싶으시다면, 위 "설치 방법"에서 다룬 표준 설치를 별도로 한 번 더 해주셔야 합니다. 반대로 이미 CLI를 설치하셨다면, 채팅창 없이 통합 터미널에서 claude를 그대로 쓸 수 있으니 확장은 꼭 필요하지 않습니다.

자주 걸리는 문제

설치는 끝났다는데 claude를 치면 "command not found"(또는 "is not recognized")가 뜬다, 가장 흔한 문제입니다. 실제로 이 문제로 등록된 GitHub 이슈가 한 번이 아니라 여러 번입니다. 이슈 #21365(v2.1.20 당시)와 이슈 #42337(v2.1.89 당시) 모두 같은 패턴을 신고합니다. 설치 스크립트는 "Installation complete!"라고 성공을 알립니다. 동시에 노란 글씨로 "Setup notes: Native installation exists but ....local\bin is not in your PATH"라는 경고도 함께 띄웁니다. 설치 자체는 됐는데, 셸이 그 우편함 위치(PATH)를 아직 모르는 상태인 겁니다. 맥의 기본 셸인 zsh 기준으로는 아래처럼 고칩니다. 리눅스에서 기본 셸로 bash를 쓰고 계시다면 ~/.zshrc 대신 ~/.bashrc에 같은 줄을 추가하시면 됩니다.

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

윈도우 PowerShell은 아래로 고친 뒤, 터미널을 완전히 닫았다 다시 엽니다. PATH 변경은 새로 여는 창부터 적용되기 때문입니다.

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

윈도우 PowerShell에서 "running scripts is disabled on this system"이 뜬다, 이건 npm으로 설치했을 때만 나오는 오류입니다. npm이 만드는 .ps1 실행 스크립트를 PowerShell의 실행 정책(Execution Policy)이 막아서 생깁니다. 위에서 다룬 네이티브 인스톨러(irm ... | iex)로 설치했다면 애초에 이 오류를 안 만납니다. 이미 npm으로 설치해서 이 오류를 보고 계신다면 방법은 두 가지입니다. Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser로 정책을 풀거나, 아예 네이티브 인스톨러로 다시 설치하시면 됩니다.

CMD에서 irm이 안 먹히거나, PowerShell에서 &&가 오류로 뜬다, 지난 레슨에서 다룬 PowerShell·CMD 구분이 여기서 그대로 쓰입니다. irm이 인식 안 되면 CMD에 계신 겁니다. 위의 CMD용 명령어로 바꿔 치시면 됩니다. 반대로 &&가 유효하지 않다는 오류가 뜨면 PowerShell에서 CMD용 명령어를 친 겁니다. irm ... | iex 쪽으로 바꿔 치시면 됩니다.

권한 오류로 설치 자체가 안 된다, 맥·리눅스에서 ~/.local/bin이나 ~/.claude 폴더에 쓰기 권한이 없을 때 나옵니다. 아래로 소유권을 내 계정으로 돌려준 뒤 다시 설치합니다.

sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

회사 네트워크나 보안 소프트웨어 때문에 설치 자체가 안 된다, 회사 프록시나 방화벽이 claude.ai, downloads.claude.ai 접속을 막고 있으면 설치 명령어가 403 오류나 인증서(TLS) 오류로 실패합니다. 이런 환경이라면 먼저 IT팀에 프록시 주소를 문의하시면 됩니다. 받은 주소로 HTTPS_PROXY·HTTP_PROXY 환경 변수를 설정한 뒤, 설치 명령어를 다시 실행하면 됩니다. 윈도우에서는 백신 프로그램이 다운로드 중인 파일을 검사하느라 설치가 일시적으로 실패하기도 합니다, 잠시 기다렸다가 다시 시도하면 됩니다.

막혔을 때 제가 쓴 방법은 앞에서 말한 그대로입니다. 화면에 뜬 영어를 통째로 복사해서 챗봇에 던지고 무슨 뜻인지 물어보는 것입니다. 오류 메시지는 대개 무엇이 없거나 어디를 못 찾겠다는 말이고, 그걸 한국어로 한 줄만 받으면 다음에 뭘 할지가 정해집니다. 메시지를 읽으려 애쓰지 마시고 그대로 옮겨서 물어보시면 됩니다.

결과물

오늘 할 일은 하나입니다. 터미널(또는 PowerShell)에 claude라고 쳤을 때, 에러 문구 대신 로그인된 상태로 클로드코드가 실행되는 화면을 보는 것입니다. 아직 아무 질문도 하지 않으셔도 됩니다. 실행이 되는 상태를 만드는 것 자체가 오늘의 결과물입니다.

다음 레슨 예고

설치와 로그인까지 마치셨다면, 이제 클로드코드가 실제로 여러분의 컴퓨터 위에서 대기하고 있는 상태입니다. 다음 레슨에서는 이 화면에 첫 질문을 던져봅니다. 코드를 몰라도 괜찮습니다. "이 폴더에 뭐가 있어?" 같은 질문부터 시작해서, 클로드코드가 실제로 어떻게 답하고 움직이는지 함께 확인합니다.