Claude Code 설치 및 환경 구축하기
들어가며
이번 챕터에서는 바이브 코딩(Vibe Coding) 중에서도 최근 가장 주목받고 있는 Claude Code를 설치하고 설정하는 방법을 살펴본 뒤, 이를 활용하여 간단한 스케줄링 프로그램을 직접 만들어보는 과정을 소개하고자 합니다. Claude Code는 터미널 환경에서 사용하는 Claude Code CLI이 가장 강력한 성능을 발휘합니다. 다만 터미널 기반 인터페이스는 윈도우 GUI 환경에 익숙한 비개발자에게는 검은 화면에 텍스트로만 명령을 입력해야 한다는 점 때문에 다소 진입 장벽이 높게 느껴질 수 있습니다. 하지만 실제로 몇 번만 사용해 보면 생각보다 어렵지 않고, 오히려 자연어로 AI와 대화하며 개발을 진행할 수 있다는 점에서 매우 직관적이고 편리한 도구라는 것을 느끼실 수 있습니다.
따라서 이번 글에서는 개발 경험이 없는 비개발자도 충분히 따라 해볼 수 있도록 Claude Code 설치와 기본 설정 과정을 단계별로 정리했습니다. 이러한 기본 사용법을 익힌 뒤, 자신이 일하고 있는 분야에서 반복적으로 발생하는 문제나 비효율을 Claude Code와 대화하면서 프로그램으로 해결해 보는 경험을 해볼 수 있습니다. 즉, 개발자가 아니더라도 AI와 협업하며 직접 프로그램을 만드는 경험, 바로 이것이 바이브 코딩의 핵심이라고 할 수 있습니다. Claude Code는 터미널에서 직접 실행하는 방식이 가장 강력하지만, VS Code와 함께 사용하면 훨씬 편리하게 활용할 수 있습니다. 터미널에서는 자연어로 Claude와 대화하며 전체 프로그램 구조를 만들고, VS Code 확장 프로그램을 활용하면 파일을 직접 확인하면서 세부 코드를 수정하거나 보완할 수 있기 때문입니다. 따라서 이번 챕터에서는
터미널 기반 Claude Code CLI
VS Code 확장 프로그램 Claude Code
이 두 가지를 함께 활용하는 방법을 중심으로 설명하겠습니다.
1. Claude Code를 시행하기 위한 기본 프로그램 설치하기
1) VS Code 설치하기
Claude Code는 터미널 상에서 직접 실행해도 되지만, 좀 더 GUI를 활용하며 활용하기 위해서는 VS Code를 활용하면 더 편리하게 사용할 수 있습니다. 따라서 VS Code를 먼저 설치하고자 합니다.
https://code.visualstudio.com/
우선 위 Visual Studio Code 공식 웹사이트에 접속합니다. 메인화면 중간에 [Download for Windows]를 클릭하고 다운로드하여지는 설치 파일을 실행합니다. 설치 팝업 화면이 활성화되면 안내에 따라 '동의', '다음', '설치' 버튼 등을 아래와 화면과 같이 순서대로 클릭해서 설치를 진행합니다.
2) Python 설치하기
다음으로 Visual Studio Code에 Python을 설치하고자 합니다. 설치를 위해서는 우선 왼쪽 사이드 바에 있는 Extensions(블록 모양 아이콘)을 클릭한 후 검색창에 Python을 입력하고 나오는 Python 프로그램 좌측 하단에 있는 [Install] 버튼을 클릭하여 설치를 진행하시면 됩니다.
3) Node.js 설치하기
두 번째는 Node.js입니다. Node.js는 자바스크립트를 브라우저가 아닌 로컬 개발 환경에서 실행할 수 있게 해주는 런타임 환경입니다. React, Vite, Next.js 같은 대부분의 웹 개발 도구가 Node.js 기반으로 동작하기 때문에 웹 애플리케이션 개발을 위해서는 사실상 필수적으로 설치해야 하는 프로그램입니다.
https://nodejs.org/ko/download
Node.js는 위 링크를 통해 홈페이지에 접속하여 아래 이미지 순서대로 설치하시면 됩니다. 설치할 때는 모두 기본 설정값으로 Next를 클릭하며 진행하면 어려움 없이 설치하실 수 있습니다.
4) Git 설치하기
세 번째는 Git입니다. Git은 소스코드의 변경 이력을 관리하는 버전 관리 도구로 대부분의 개발 환경에서 기본적으로 사용됩니다. Claude Code 역시 프로젝트 작업 과정에서 Git 명령어를 활용할 수 있기 때문에 Git for Windows를 함께 설치해 두는 것이 권장됩니다. Anthropic의 Windows용 터미널 가이드에서도 Git 설치를 기본 개발 환경 구성 요소로 안내하고 있습니다. 아래 그림을 통해 확인할 수 있는 것처럼 설치 과정에서는 별도의 설정을 변경할 필요 없이 기본 설정값으로 Next 버튼을 클릭하며 진행하면 어려움 없이 설치할 수 있습니다.
2. Claude Code를 실행하기 위한 터미널 실행 방법
Claude Code는 터미널 기반 CLI 도구이기 때문에 실행을 위해서는 먼저 터미널을 열어야 합니다. Windows 환경에서는 여러 가지 방법으로 터미널을 실행할 수 있으며, 이번 글에서는 가장 많이 사용하는 두 가지 방법을 소개하겠습니다.
1) Window 탐색기에서 바로 실행하기
가장 간단한 방법은 Windows 탐색기에서 바로 터미널을 실행하는 방법입니다. 이 방법은 특정 프로젝트 폴더에서 바로 터미널을 열 수 있기 때문에 매우 편리합니다. 먼저 프로젝트 작업을 진행할 폴더를 엽니다. 예를 들어 저의 경우 'workspace' 폴더를 작업 폴더로 사용하고 있습니다. 그다음 폴더 내부의 빈 공간에서 마우스 오른쪽 버튼을 클릭합니다. 그러면 여러 메뉴가 나타나는데, 여기서 “터미널에서 열기” 메뉴를 선택하면 해당 폴더 경로에서 바로 터미널이 실행됩니다. 이 방법을 사용하면 별도 터미널 상에서 'cd' 명령어를 통해 폴더 이동을 하지 않아도 되기 때문에 작업 환경을 빠르게 시작할 수 있습니다. 또 다른 방법으로는 주소창을 이용하는 방법입니다. Windows 탐색기의 주소창을 클릭한 뒤 'cmd'라고 입력하고 Enter를 누르면 해당 폴더 경로에서 바로 Command Prompt가 실행됩니다. 이 방법 역시 현재 폴더를 기준으로 터미널이 실행되기 때문에 프로젝트 작업을 시작할 때 매우 유용합니다.
2) Video Studio Code에서 실행하기
두 번째 방법은 Visual Studio Code 내부에서 터미널을 실행하는 방법입니다. 실제 제가 개발 작업을 수행할 때에서는 이 방법을 가장 많이 사용합니다. 코드 편집과 터미널 명령 실행을 한 화면에서 동시에 진행할 수 있기 때문입니다. 먼저 VS Code에서 작업할 프로젝트 폴더를 엽니다. 그러면 화면 하단에 터미널 창이 표시되거나 새 터미널을 실행할 수 있는 상태가 됩니다(만약, 하단 터미널 창이 보이지 않는 경우, 화면 우측 상단에 있는 창 분할 아이콘을 이용해 창을 활성화할 수 있습니다.). 해당 아이콘을 클릭하면 좌측 창, 우측 창, 하단 창을 각각 활성화할 수 있으며 여기서 하단 창을 활성화하면 터미널 영역이 나타납니다. 하단 터미널 창이 활성화되면 터미널 종류를 선택할 수 있습니다.
터미널 창 오른쪽에 있는 화살표(▼) 버튼을 클릭하면 다음과 같은 메뉴가 나타납니다.
- PowerShell
- Git Bash
- Command Prompt(cmd)
여기에서 원하는 터미널을 선택하면 해당 터미널이 실행됩니다. 일반적으로 Windows 환경에서는 PowerShell 또는 Command Prompt(cmd)를 많이 사용하며 Claude Code 역시 두 환경 모두에서 정상적으로 실행됩니다.
3) 터미널에서 Node.js와 git 설치 완료 확인법
Node.js와 Git 설치가 정상적으로 완료되었는지 확인하려면 터미널에서 간단한 명령어를 실행하면 됩니다. 설치가 제대로 되었다면 각 프로그램의 버전 번호가 출력됩니다. Node.js의 경우 아래 명령어를 통해 설치 여부를 확인할 수 있습니다.
node -v
npm -v
위 명령어를 실행했을 때 Node.js와 npm의 버전 번호가 출력되면 정상적으로 설치된 것입니다. Git 설치 여부는 다음 명령어로 확인할 수 있습니다.
git -v
해당 명령어를 실행했을 때 Git 버전이 표시되면 정상적으로 설치가 완료된 것입니다. 이처럼 Node.js와 Git의 버전이 정상적으로 출력되면 Claude Code를 실행하기 위한 기본 개발 환경이 준비된 것입니다.
3. VS Code 확장 프로그램 및 터미널 Claude Code 설치
1) VS Code 확장 Claude Code 프로그램 설치
VS code 확장 Claude Code 프로그램 설치 방법은 간단합니다. 좌측창이 활성화되어 있지 않은 경우 우측 상단에 있는 창 활성화 아이콘 중 좌측창 활성화 아이콘을 클릭하여 창을 활성화합니다. 그 이후에는 Claude를 검색해서 'Claude Code for VS Code' 프로그램 오른쪽에 표시되어 있는 [설치]를 클릭하고 확장 프로그램을 설치합니다. 확장 프로그램이 설치된 경우 오른쪽 창을 활성화 할 경우 'ClaudeCode'가 활성화 화된 것을 확인할 수 있습니다. 해당 탭을 클릭하면 우측창에 Claude Code VS code 확장 프로그램이 활성화됩니다.
Cluade Code 확장 프로그램의 장점은 하단 이미지와 같이 프로젝트 내 파일을 직접 클릭하여 각 파일의 코드를 직접 보며 수정, 보완할 수 있다는 장점을 가지고 있습니다. 또한 하단 터미널에 활성화된 Claude Code CLI 버전과 함께 활용할 수 있어서 큰 작업은 터미널로 시행하되, 각 프로그램 파일별 세부적인 내용을 세밀하게 보완하고 싶은 경우 확장 프로그램을 통해 보완하면 효율적으로 Claude Code를 사용할 수 있습니다.
2) 터미널용 Claude Code CLI 설치 및 설정
터미널용 Claude Code CLI 버전은 PowerShell 또는 Cmd에서 설치할 수 있습니다. 아래 그림과 같이 PowerShell 또는 Cmd를 클릭해서 VS Code 하단에 터미널을 활성화시킵니다. 만약 하단 Cmd 화면이 활성화되어 있지 않다면 우측 상단에 있는 창 활성화 버튼 중 하단창 활성화 버튼을 클릭하여 창을 활성화시킨 후 아래 방향 화살표 클릭 다음으로 [PowerShell] 또는 Command Prompt 메뉴를 클릭해서 터미널 창을 활성화시킵니다.
터미널을 활성화시킨 후에는 터미널에 아래와 같은 명령어를 입력합니다.
npm install -g @anthropic-ai/claude-code
아래와 같은 화면이 나오면 Claude Code CLI 버전 설치가 완료된 것입니다.
Claude Code CLI를 설치한 후에는 터미널에서 'claude' 명령어를 입력하여 Claude Code CLI를 실행합니다. 설치 후 처음으로 Claude Code CLI를 실행하면 아래와 같이 터미널 사용 환경을 최적화하기 위한 설정 여부를 묻는 화면이 나타납니다. 여기에서 “Yes, use recommended settings” 옵션을 선택하면 Claude Code가 권장하는 터미널 설정이 자동으로 적용됩니다. 설정을 선택한 뒤 Enter 키를 눌러 진행합니다.
다음 단계에서는 터미널 색상 테마를 선택하는 화면이 나타납니다. Dark mode, Light mode 등 다양한 옵션 중에서 원하는 스타일을 선택하면 됩니다.
이후 아래 화면과 같이 Claude Code 사용을 위해 로그인 방식을 선택하는 단계가 나타납니다. 일반적으로는 다음과 같은 세 가지 옵션이 제공됩니다.
Claude 계정 구독 로그인
Anthropic Console API 계정 로그인
AWS Bedrock, Microsoft Foundry 등 외부 플랫폼 계정 로그인
일반적인 개인 사용 환경에서는 Claude 계정 구독 로그인 방식을 선택하는 것이 가장 간단하고 비용 관리 측면에서도 편리합니다.
로그인 방식을 선택하면 브라우저가 자동으로 열리면서 Claude 계정 연결 승인 화면이 나타납니다. 여기서 ‘승인’ 버튼을 클릭하면 VS Code와 Claude 계정이 연결됩니다. 연결이 완료되면 터미널에 다음과 같은 메시지가 표시됩니다. 아래와 같이 'Login successful' 메시지가 나타나면 Claude Code 설정과 로그인 과정이 모두 정상적으로 완료된 상태입니다. 이제 터미널 환경에서 Claude Code를 활용하여 코드 작성, 수정, 분석 등의 작업을 수행할 수 있습니다.
Claude Code CLI는 단순한 채팅형 AI가 아니라 프로젝트 전체를 이해하고 작업을 수행하는 개발 에이전트로 동작합니다. 터미널에서 실행하면 현재 폴더의 코드 구조를 기반으로 파일을 생성하거나 수정하고, 필요한 명령을 실행하면서 개발 과정을 자동으로 진행할 수 있습니다. 이러한 방식은 일반적인 웹 기반 AI 도구와 달리 실제 개발 환경과 직접 연결된 상태에서 작업이 이루어진다는 점에서 큰 장점을 가집니다. Claude Code CLI는 AI와 대화하면서 프로그램을 실제로 개발할 수 있는 환경을 제공하며, 이러한 방식이 바로 최근 많은 개발자들이 주목하고 있는 바이브 코딩(Vibe Coding)의 핵심적인 특징이라고 할 수 있습니다.
나가며
이번 챕터에서는 Cladue Code CLI 버전과 VS Code 확장 프로그램 버전을 함께 설치하는 방법에 대해서 살펴보았습니다. 터미널 기반 도구는 처음 접하는 사용자에게 다소 어렵게 느껴질 수 있지만, 실제로 몇 번만 사용해 보면 생각보다 직관적이고 강력한 개발 도구라는 것을 알 수 있습니다. 특히 Claude Code는 자연어로 AI와 대화하며 코드 생성, 수정, 분석 등의 작업을 수행할 수 있기 때문에 개발 경험이 많지 않은 사용자에게도 새로운 방식의 개발 경험을 제공합니다.
또한 VS Code 확장 프로그램을 함께 사용하면 터미널에서 프로그램을 생성하는 과정과 실제 코드 파일을 확인하며 수정하는 작업을 동시에 진행할 수 있어 개발 과정을 훨씬 효율적으로 만들수 있습니다. 이러한 환경은 단순히 코드를 작성하는 것을 넘어, AI와 협업하면서 문제를 해결하는 새로운 개발 방식인 바이브 코딩을 경험할 수 있게 해 줍니다.
다음글에서는 이렇게 구축한 Claude Code 환경을 활용하여 실제로 간단한 스케줄러 프로그램을 개발하는 과정을 살펴보겠습니다. Claude Code에 프롬프트를 전달하여 PRD(Product Requirement Document)를 기반으로 프로그램을 개발하는 과정을 단계별로 진행하면서, AI와 함께 프로그램을 만드는 바이브 코딩의 실제 활용 사례를 살펴보겠습니다.
바이브 코딩 관련 HRKIM 콘텐츠 읽을거리
https://brunch.co.kr/@publichr/180
https://brunch.co.kr/@publichr/177
https://brunch.co.kr/@publichr/176