Windows PC에서 Claude Code를 사용하고 싶은데 어디서부터 시작해야 할지 모르겠다고요? 이 가이드는 Windows 10이나 11에서 Claude Code를 설치하고 설정하는 방법을 정확히 보여줄 거예요. 터미널을 한 번도 써본 적이 없어도 괜찮습니다. 전체 설치 과정은 약 10분 정도 걸리고 기술적인 사전 지식이 필요 없어요. Visual Studio Code를 설치하고, Claude Code 확장 프로그램을 추가한 다음, API 접근을 설정하고 첫 번째 프로젝트를 만들 거예요. 각 단계마다 스크린샷과 간단한 설명이 있어서 길을 잃지 않고 따라갈 수 있습니다.
Windows에서 Claude Code를 설치하기 위한 필수 요구사항은 뭔가요?
시작하기 전에 세 가지가 필요해요: 최신 Windows 10 또는 11, 최소 4GB RAM, 안정적인 인터넷 연결. Claude Code는 최근의 어떤 PC에서나 잘 작동하고, 고사양 컴퓨터가 필요하지 않습니다.
필수 요구사항의 전체 목록은 다음과 같습니다:
- 운영체제: Windows 10 (버전 1809 이상) 또는 Windows 11
- 메모리 RAM: 최소 4GB, 최적의 성능을 위해 8GB 권장
- 디스크 공간: Visual Studio Code와 확장 프로그램을 위해 500MB
- 인터넷 연결: 도구 다운로드 및 Claude API와 통신하기 위해 필수
- 관리자 권한: 초기 설치 시에만 필요
강력한 그래픽 카드나 최신 프로세서가 필요 없어요. Claude Code는 Anthropic의 API를 통해 클라우드에서 실행되고, 당신의 컴퓨터는 인터페이스 역할만 합니다. 2018년의 기본 데스크톱 PC도 완벽하게 작동합니다.
Mac을 사용 중이라면, 해당 환경의 특성을 자세히 설명하는 macOS 설치 가이드를 확인해보세요.
Visual Studio Code를 어떻게 다운로드하고 설치하나요?
code.visualstudio.com에 가서 Windows 설치 프로그램을 다운로드한 후 기본 옵션을 수락하면서 실행하세요. 설치는 최대 2~3분 정도 걸립니다.
자세한 과정은 다음과 같습니다:
- 브라우저를 열고 code.visualstudio.com으로 이동하세요
- 파란색 "Download for Windows" 버튼을 클릭하세요
- VSCodeUserSetup-x64-1.XX.X.exe 파일이 자동으로 다운로드됩니다
- 다운로드 폴더에서 다운로드한 파일을 더블클릭하세요
- 사용 약관에 동의하고 "다음"을 클릭하세요
- 기본 설치 경로를 그대로 두세요 (C:\Users\YourName\AppData\Local\Programs\Microsoft VS Code)
- 중요: 설치 중에 "PATH에 추가" 체크박스를 선택하세요
- "바탕화면에 아이콘 만들기"도 선택해서 쉽게 접근할 수 있게 하세요
- "설치"를 클릭하고 2분 정도 기다리세요
- "Visual Studio Code 실행" 체크를 해제하고 "완료"를 클릭하세요
Visual Studio Code (줄여서 VS Code)는 Microsoft에서 개발한 무료 코드 편집기입니다. 개발자들이 코드를 작성하는 데 사용하는 도구지만, Claude Code와 함께 사용하려면 코딩을 알 필요가 없어요. VS Code를 코드 전용 Word라고 생각하면 됩니다.
다운로드 크기는 약 90MB입니다. 안티바이러스가 확인을 요청하면 수락하세요: VS Code는 공식 소프트웨어이고 안전하며, Microsoft 통계에 따르면 2천만 명 이상의 개발자가 사용합니다.
VS Code에서 Claude Code 확장 프로그램을 어떻게 설치하나요?
VS Code를 열고, 왼쪽 사이드바의 확장 프로그램 아이콘 (네 개의 작은 사각형)을 클릭한 다음, 검색창에 "Claude Code"를 입력하고 "설치"를 클릭하세요. 확장 프로그램이 몇 초 안에 설치됩니다.
자세한 단계:
- 바탕화면의 아이콘이나 시작 메뉴에서 Visual Studio Code를 실행하세요
- 창의 왼쪽에 있는 수직 아이콘 바를 찾으세요
- 네 개의 작은 사각형처럼 보이는 아이콘을 클릭하세요 (확장 프로그램 관리자입니다)
- 위에 나타나는 검색창에 정확히 다음을 입력하세요: Claude Code
- 공식 확장 프로그램이 첫 번째 검색 결과로 나타납니다 (Anthropic에서 발행했는지 확인하세요)
- 이름 오른쪽의 파란색 "설치" 버튼을 클릭하세요
- 설치 중에 10~15초 정도 기다리세요
- 오른쪽 아래에 "확장 프로그램이 성공적으로 설치되었습니다"라는 확인 메시지가 나타납니다
- 새로운 Claude 아이콘 (작은 주황색 로고)이 왼쪽 사이드바에 나타납니다
확장 프로그램을 찾을 수 없다면, "Claude Code"를 정확히 입력했는지 확인하세요. "Claude"만 입력하면 안 돼요. Claude와 관련된 여러 확장 프로그램이 있지만, 우리가 원하는 것은 정확히 "Claude Code" 또는 버전에 따라 "Claude Dev"입니다.
확장 프로그램의 크기는 약 15MB이고 컴퓨터를 느리게 하지 않습니다. VS Code에 인터페이스를 추가해서 Anthropic의 API를 통해 Claude와 통신할 수 있게 해줄 뿐입니다.
Claude API 키를 어떻게 얻고 설정하나요?
console.anthropic.com으로 가서 무료 계정을 만들고, 설정에서 API 키를 생성한 다음, 확장 프로그램이 요청할 때 VS Code에 붙여넣으세요. 이 키를 통해 Claude Code가 Claude AI와 통신할 수 있습니다.
전체 절차:
- 브라우저에서 console.anthropic.com을 열으세요
- 오른쪽 위의 "Sign Up"을 클릭하세요
- 이메일로 계정을 만드세요 (확인 이메일을 받게 됩니다)
- 로그인한 후, 오른쪽 위의 이름을 클릭하고 "API Keys"를 선택하세요
- "Create Key" 또는 "키 만들기" 버튼을 클릭하세요
- 키에 이름을 지으세요 (예: "Claude Code Windows")
- "Create"를 클릭하세요: 키가 나타납니다 ("sk-ant-"로 시작합니다)
- 중요: 이 키를 즉시 복사해서 텍스트 파일에 저장하세요
- 이 키를 다시 볼 수 없습니다. 잃어버리면 새로운 키를 만들어야 합니다
이제 VS Code에서 키를 설정하세요:
- Visual Studio Code로 돌아가세요
- 왼쪽 사이드바의 Claude 아이콘을 클릭하세요
- API 키를 입력하라는 창이 나타납니다
- 방금 복사한 키를 붙여넣으세요 (Ctrl+V)
- Enter를 눌러서 확인하세요
- 연결이 작동한다는 메시지가 확인됩니다
API 키는 컴퓨터가 Claude 서버와 대화할 수 있게 해주는 비밀번호 같은 것입니다. Anthropic은 가입할 때 5달러의 무료 크레딧을 제공하는데, 이는 그들의 공식 가격 책정 문서에 따르면 Claude가 생성한 약 200,000단어에 해당합니다. 처음 프로젝트에는 충분합니다.
주의: API 키를 공개적으로 공유하지 마세요 (GitHub, Discord 등). 누군가 이를 얻으면 당신의 크레딧을 대신 사용할 수 있습니다.
Claude Code로 첫 번째 프로젝트를 어떻게 만드나요?
바탕화면에 새 폴더를 만들고, 파일 > 폴더 열기를 통해 VS Code에서 열은 다음, Claude Code를 실행해서 간단한 웹 페이지를 만들도록 요청하세요. 30초 안에 Claude가 당신을 위해 코드를 작성하는 것을 볼 수 있습니다.
방법은 다음과 같습니다:
- Windows 바탕화면에서 마우스 오른쪽 버튼을 클릭하세요
- "새로 만들기 > 폴더"를 선택하세요
- 폴더 이름을 "my-first-claude-project"로 지으세요
- VS Code에서 위의 "파일" 메뉴를 클릭하세요
- "폴더 열기..."를 선택하세요
- 바탕화면으로 이동해서 방금 만든 폴더를 선택하세요
- "폴더 선택"을 클릭하세요
- VS Code가 작성자를 신뢰하는지 묻을 수 있습니다: "예, 신뢰합니다"를 클릭하세요
- 이제 왼쪽 사이드바의 Claude 아이콘을 클릭하세요
- 아래의 텍스트 상자에 다음을 입력하세요: "Create me a simple web page that displays Hello World in a big title"
- Enter를 누르세요
Claude는 다음을 수행합니다:
- 폴더에 index.html 파일을 자동으로 만듭니다
- 필요한 HTML 코드를 작성합니다
- 하는 각 단계를 보여줍니다
- 결과를 미리 보도록 제안합니다
웹 페이지를 보려면, 왼쪽의 파일 탐색기에서 index.html 파일을 마우스 오른쪽 버튼으로 클릭한 다음 "파일 탐색기에서 표시"를 선택하세요. 파일을 더블클릭하면 브라우저에서 열립니다.
이 첫 번째 테스트는 Claude Code의 강력함을 보여줍니다: 일반 한국어로 원하는 것을 설명하면, Claude가 당신을 위해 기술적인 코드를 작성합니다. 이것이 바로 Skilzy에서 가르치는 원칙입니다. 여기서는 한 줄의 코드도 작성하지 않고 완전한 애플리케이션을 만드는 방법을 배웁니다.
더 나아가고 싶다면, Claude Code로 더 복잡한 프로젝트를 만들기 위해 할 수 있는 20가지 필수 명령어를 발견해보세요.
일반적인 문제와 해결 방법은 뭔가요?
가장 흔한 세 가지 오류는: 잘못된 API 키, 인터넷 연결 문제, 안티바이러스 충돌입니다. 각각 몇 분 안에 해결됩니다.
오류: "Invalid API Key"
이 메시지가 보이면 API 키가 제대로 설정되지 않은 것입니다. 해결 방법:
- 전체 키를 제대로 복사했는지 확인하세요 ("sk-ant-"로 시작해야 합니다)
- 처음이나 끝에 공백을 추가하지 않았는지 확인하세요
- console.anthropic.com으로 돌아가서 필요하면 새 키를 생성하세요
- VS Code에서 왼쪽 아래의 톱니바퀴 아이콘을 클릭하세요 > 설정 > 확장 프로그램 > Claude Code > API 키 편집
오류: "Connection timeout"
Claude Code가 Anthropic 서버에 연결할 수 없습니다. 확인하세요:
- 인터넷 연결이 작동합니다 (웹사이트를 열어서 테스트하세요)
- Windows 방화벽이 너무 제한적이지 않습니다 (설정 > 업데이트 및 보안 > Windows 보안 > 방화벽)
- 필요하면 VS Code에 대한 예외를 추가하세요
- 회사 네트워크에 있다면 API 접근을 차단할 수 있습니다
설치 후 VS Code가 실행되지 않음
VS Code가 시작을 거부하는 드문 경우:
- 컴퓨터를 다시 시작하세요 (문제의 80%를 해결합니다)
- 설정 > 앱 > Visual Studio Code > 제거를 통해 VS Code를 제거하세요
- 공식 웹사이트에서 최신 버전을 다운로드하세요
- 설치 프로그램을 마우스 오른쪽 버튼으로 클릭하고 관리자로 실행해서 다시 설치하세요
Claude Code 확장 프로그램이 나타나지 않음
설치 후 Claude 아이콘이 보이지 않으면:
- VS Code를 완전히 종료하세요 (파일 > 종료)
- VS Code를 다시 열으세요
- 확장 프로그램으로 가서 Claude Code가 "설치됨" 목록에 있는지 확인하세요
- 확장 프로그램 옆에 새로고침 아이콘이 나타나면 클릭하세요
- 마지막 수단으로 확장 프로그램을 제거했다가 다시 설치하세요
Claude Code Discord 커뮤니티와 Anthropic 포럼도 특정 문제가 있을 때 훌륭한 자료입니다. 또한 Cursor와 비교해볼 수 있습니다. 이것은 다르게 작동하는 대안이며 일부 Windows 설정에 더 적합할 수 있습니다.
결론
Windows PC에서 Claude Code가 이제 작동합니다. 전체 설치 과정은 15분 미만이 걸렸습니다: 기반으로서의 Visual Studio Code, 인터페이스를 위한 Claude Code 확장 프로그램, AI에 접근하기 위한 API 키, 모든 것이 작동하는지 테스트하기 위한 첫 번째 프로젝트. 다음 단계는 이 도구로 만들 수 있는 것을 탐색하는 것입니다: 웹사이트, 애플리케이션, 자동화. 간단한 프로젝트부터 시작해서 점진적으로 복잡성을 높여가세요. Claude Code는 당신의 요청에서 배우고 대화를 통해 개선됩니다.
Skilzy에서는 이 설치를 전문적인 기술로 변환하는 방법을 보여줍니다. 우리의 학습 방법은 오늘 HTML과 CSS의 차이를 모르더라도 진정한 애플리케이션을 만드는 방법을 단계별로 안내합니다. 초보자를 위한 완전한 튜토리얼을 확인해서 Claude Code로 무엇을 할 수 있는지 발견해보세요.
