클로드 코드(Claude Code)란 무엇인가요?
요즘 개발자들 사이에서 가장 핫하게 떠오르고 있는 AI 코딩 도구가 바로 클로드 코드(Claude Code)입니다. AI에게 “이런 기능 만들어줘” 하고 부탁하면 진짜로 코드를 짜주고, 파일까지 직접 수정해주는 신기한 도구인데요. 오늘은 처음 사용하시는 분들을 위해 설치 방법을 하나하나 친절하게 알려드리려고 합니다.
클로드 코드는 Anthropic이라는 회사에서 만든 터미널 기반 AI 코딩 도구입니다. 우리가 흔히 보는 그래픽 프로그램이 아니라, 검은 화면에 명령어를 입력해서 사용하는 방식이에요. 처음에는 어색할 수 있지만, 한번 익숙해지면 정말 편리합니다.
클로드 코드 설치 전 꼭 알아야 할 것들
설치를 시작하기 전에 몇 가지 준비해야 할 것들이 있습니다.
- 유료 계정 필요: 클로드 코드는 무료 Claude.ai 계정으로는 사용할 수 없습니다. Pro, Max, Team, Enterprise 같은 유료 플랜이나 API 콘솔 계정이 필요합니다.
- 인터넷 연결 필수: AI가 Anthropic의 서버와 계속 통신하기 때문에 안정적인 인터넷이 필요합니다.
- 최소 사양: RAM 4GB 이상, 디스크 여유 공간 약 2~4GB 정도면 충분합니다.
- 운영체제: Windows 10/11, macOS 13 이상, 또는 Ubuntu 같은 리눅스 환경에서 사용 가능합니다.
Windows에서 클로드 코드 설치하기
예전에는 Windows에서 클로드 코드를 사용하려면 WSL(Windows Subsystem for Linux)이라는 복잡한 리눅스 환경을 따로 설치해야 했습니다. 하지만 2025년부터는 Windows 네이티브 설치가 지원되어 훨씬 간편해졌습니다.
1단계: Git for Windows 설치하기
클로드 코드는 내부적으로 Git Bash를 사용하기 때문에 Windows에서는 Git for Windows가 반드시 필요합니다. 이걸 설치하지 않으면 설치 자체가 실패하거나 이상하게 동작할 수 있어요.
Git 공식 홈페이지(git-scm.com)에 접속해서 Windows용 설치 파일을 다운로드합니다. 설치할 때는 대부분의 옵션을 기본값 그대로 두고 “Next” 버튼만 누르셔도 됩니다. 설치가 완료되면 Git Bash라는 프로그램이 함께 설치됩니다.
2단계: PowerShell 열기
이제 Windows의 검색창에 “PowerShell”이라고 입력해서 PowerShell을 실행합니다. 관리자 권한은 필요하지
않으니 일반 모드로 열어도 됩니다.
혹시 PowerShell과 명령 프롬프트(CMD)를 헷갈리실 수 있는데요. 화면 맨 앞에 PS C:\ 이렇게 표시되어 있다면 PowerShell이고, 그냥 C:\ 만 표시되어 있다면 CMD입니다. 클로드 코드 설치는 PowerShell에서 진행하는 것이 편합니다.
3단계: 클로드 코드 설치 명령어 실행
PowerShell 창에 아래 명령어를 그대로 입력하고 엔터를 누릅니다.
irm https://claude.ai/install.ps1 | iex이 명령어 한 줄이면 끝입니다. Anthropic의 공식 설치 스크립트가 자동으로 실행되어 클로드 코드 바이너리를 사용자 폴더의 .local/bin 디렉터리에 설치해 줍니다. Node.js를 따로 설치할 필요도 없어요.
만약 PowerShell이 부담스럽고 명령 프롬프트(CMD)를 선호하신다면 아래 명령어를 사용하시면 됩니다.
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd4단계: 터미널 재시작
설치가 완료되면 반드시 현재 열려 있는 터미널 창을 닫고 새로 열어주세요. PATH 환경 변수가 적용되려면 터미널을 새로 시작해야 하기 때문입니다. 이 과정을 건너뛰면 “claude 명령어를 찾을 수 없습니다” 같은 오류가 나타날 수 있습니다.
윈도우 파워쉘에서 아래의 명령어를 입력한 뒤, 나오는 출력 결과를 시스템 환경변수로 등록합니다.
npm config get prefix
macOS에서 클로드 코드 설치하기
맥 사용자라면 Windows보다 더 간단합니다.
1단계: 터미널 열기
맥에서는 응용 프로그램 → 유틸리티 → 터미널을 실행하거나, Spotlight 검색(command + space)에서 “터미널”을 검색해서 실행합니다.
2단계: 설치 명령어 입력
아래 명령어를 입력합니다.
curl -fsSL https://claude.ai/install.sh | bash
설치는 보통 1분 이내에 끝납니다. Homebrew를 즐겨 사용하는 분이라면 brew install –cask claude-code 명령어로도 설치할 수 있어요.
3단계: 새 터미널 창 열기
Windows와 마찬가지로 설치가 끝나면 터미널을 닫고 새로 열어야 합니다.
설치 확인 및 첫 실행
설치가 제대로 되었는지 확인해 봅시다.
버전 확인하기
새 터미널 창에서 claude –version 명령어를 입력해 보세요. 정상적으로 설치되었다면 버전 번호가 표시됩니다. 만약 “claude is not recognized” 같은 오류가 나타난다면 PATH 설정이 제대로 적용되지 않은 것이니, 터미널을 다시 한 번 완전히 종료하고 새로 열어주세요.
설치 상태 점검하기
claude doctor 명령어를 실행하면 설치 상태와 환경 설정을 자동으로 점검해 줍니다. 문제가 있으면 어떤 부분에서 문제가 생겼는지 친절하게 알려주니 꼭 한 번 실행해 보세요.
로그인하기
이제 claude 명령어를 그냥 입력해 보세요. 처음 실행하면 자동으로 웹 브라우저가 열리면서 로그인 페이지로 연결됩니다. 본인의 Claude 유료 계정으로 로그인하시면 OAuth 인증이 자동으로 처리됩니다. API 키를 따로 복사하고 붙여넣을 필요가 없어서 정말 편리합니다.
클로드 코드 첫 사용해 보기
설치와 인증이 끝났다면 이제 진짜로 사용해 볼 차례입니다.
프로젝트 폴더로 이동하기
터미널에서 cd 명령어로 본인의 프로젝트 폴더로 이동합니다. 예를 들어 cd C:\Users\본인이름\Documents\my-project 같은 식으로요.
클로드 코드 실행하기
프로젝트 폴더에서 claude라고 입력하면 클로드 코드가 시작됩니다. 그러면 화면에 입력창이 나타나는데, 여기에 자연어로 원하는 작업을 입력하시면 됩니다.
예를 들어 “이 프로젝트의 구조를 분석해줘” 또는 “hello world를 출력하는 파이썬 파일을 만들어줘” 같은 식으로 한국어로 부탁해도 잘 알아듣습니다. 처음에는 작은 작업부터 시켜보시면서 어떤 식으로 동작하는지 익혀보세요.
알아두면 좋은 기본 명령어
- /help: 사용 가능한 모든 명령어를 보여줍니다.
- /clear: 현재 대화를 초기화하고 새로 시작합니다.
- /config: 환경 설정을 변경합니다.
- /quit: 클로드 코드를 종료합니다.
설치 중 자주 만나는 오류 해결법
설치 과정에서 종종 마주치는 문제들과 해결 방법을 정리해 드립니다.
“claude 명령어를 찾을 수 없습니다” 오류
이 오류는 PATH 환경 변수에 클로드 코드 설치 경로가 추가되지 않았을 때 발생합니다. 가장 먼저 터미널을 완전히 종료하고 새로 여는 것으로 해결되는 경우가 많습니다. 그래도 해결되지 않으면 본인 사용자 폴더의 .local\bin 경로가 PATH에 포함되어 있는지 확인해 보세요.
Git Bash를 찾을 수 없다는 오류
Git for Windows를 설치하지 않았거나 다른 경로에 설치한 경우입니다. Git을 먼저 설치하시고, 그래도 인식이 안 된다면 settings.json 파일에 Git Bash 경로를 직접 입력해 주셔야 합니다.
인증 루프에 빠지는 경우
브라우저 인증이 자꾸 반복되는 문제는 보통 쿠키 차단이나 트래커 차단 설정 때문에 발생합니다. 시크릿 모드로 시도해 보거나, 브라우저의 보안 설정을 잠시 완화해 보시면 해결됩니다.
마치며
여기까지 클로드 코드 설치 방법을 처음부터 끝까지 따라해 보셨다면, 이제 AI와 함께 코딩하는 새로운 개발 환경이 준비된 것입니다. 처음에는 터미널 환경이 낯설고 명령어 한 줄 한 줄이 어색하게 느껴질 수 있지만, 며칠만 사용해 보시면 금방 익숙해지실 거예요.
개인적으로 추천드리고 싶은 점은, 처음부터 거창한 작업을 시키려 하지 마시고 “이 파일을 분석해줘”, “주석을 추가해줘” 같은 작은 작업부터 시작해 보시라는 것입니다. 클로드 코드가 어떤 방식으로 응답하고 어떤 식으로 파일을 다루는지 감을 잡으신 후에 점점 더 복잡한 작업을 맡기시면 훨씬 효율적으로 사용하실 수 있습니다.
오늘 설치 가이드가 클로드 코드를 처음 시작하시는 분들께 도움이 되셨길 바랍니다. 다음 글에서는 클로드 코드를 더 똑똑하게 사용하는 다양한 팁들을 소개해 드릴게요!