🚀 Claude Code 설치부터 첫 실행까지｜윈도우·맥 초보자 가이드 (2026)

🚀 Claude Code 설치부터 첫 코딩까지

처음 설치하는 사용자를 위한 단계별 가이드 | 완전 초보자도 따라 할 수 있습니다

윈도우와 맥에서 Claude Code를 설치하고 로그인한 뒤 첫 프로젝트를 실행하는 과정을 순서대로 알아봅니다.

0단계: 필수 확인 사항

시작하기 전에 다음을 확인하세요:

✅ 필요한 것:
• Anthropic 계정
• Claude Pro, Max, Team, 또는 Enterprise 구독 (또는 Claude Console의 API 크레딧)
• 작업할 프로젝트 폴더

선택 준비물:
• Git과 GitHub 계정 (추후 필요하면 설정)
• Node.js (웹앱 개발 시)

필요 없는 것:
• 개발 경험 (초보자 환영)
• 터미널 지식 (비개발자도 가능)

1단계: Claude Desktop 앱 다운로드 및 설치

1공식 웹사이트 접속

claude.com/download에 접속합니다.

2당신의 OS에 맞는 버전 다운로드

macOS: 공식 설치 파일을 내려받아 응용 프로그램 폴더에 설치합니다.

Windows (x64): Intel 또는 AMD 프로세서를 사용하는 대부분의 컴퓨터. claude-setup-x64.exe를 다운로드하여 실행합니다.

Windows (ARM64): Microsoft Surface Pro X 또는 ARM 기반 Windows 노트북을 사용한다면 ARM64 설치 파일을 다운로드합니다.

3앱 실행 후 로그인

Claude Desktop 앱을 열고 Anthropic 계정으로 로그인합니다. 처음 접속 시 "Chat", "Cowork", "Code" 세 탭을 확인할 수 있습니다. Windows 사용자라면 처음 실행 시 Git for Windows 설치 여부를 묻거나 자동으로 안내합니다.

2단계: 로그인 방식 선택 (구독 또는 API)

Claude Code는 두 가지 인증 방식을 지원합니다. Pro, Max, Team, Enterprise 등의 구독이 있으면 계정 로그인만 해도 Claude Code를 사용할 수 있습니다. API를 통해 별도로 과금하려면 Claude Console에서 API Key를 설정하세요.

방식	과금 구조	적합한 경우
Claude 계정 로그인	Pro·Max 등 구독의 사용 한도 적용	개인 사용과 입문
Claude Console API	모델과 토큰 사용량에 따라 별도 과금	API 비용을 직접 관리하거나 자동화할 때

⚠️ 중요한 과금 정보:
Pro, Max 등의 구독료에는 Claude Console API 사용료가 포함되지 않습니다. 이 두 가지는 서로 다른 결제 시스템입니다. 환경 변수에 ANTHROPIC_API_KEY를 설정하면 구독 계정 로그인보다 API Key가 우선적으로 사용되어 별도 과금이 발생할 수 있습니다. 혼동을 피하기 위해 처음엔 계정 로그인만으로 시작하고, 나중에 필요하면 API를 추가 설정하세요.

🔒 API Key 보안 경고:
API Key는 절대 공개 저장소에 커밋하거나 공유하지 마세요. Key가 노출되면 타인이 당신의 계정으로 API를 사용할 수 있고 예상치 못한 비용이 발생할 수 있습니다. .env 파일이나 환경 변수에 안전하게 저장하고, .gitignore에 추가하세요.

3단계: 첫 프로젝트 폴더 만들기

1프로젝트 폴더 생성

작업할 폴더를 만드세요. 예시: ~/my-first-claude-project

mkdir ~/my-first-claude-project cd ~/my-first-claude-project

2Claude Desktop에서 폴더 열기

Claude Desktop의 "Code" 탭을 클릭 → 프롬프트 상단의 "Select Folder" → 방금 만든 폴더 선택

3첫 HTML 파일 요청

프롬프트 입력창에 다음을 입력합니다:

간단한 HTML 파일을 만들어줄래? 제목은 'Hello Claude Code', 본문에 큰 버튼 하나 있고 클릭하면 'Claude Code 작동!' 알림이 뜨게

4단계: 권한 모드 이해하기

프롬프트 입력창 옆의 드롭다운 메뉴에서 권한 모드를 선택합니다. 각 모드는 Claude Code가 얼마나 자동으로 일하는지 조절합니다:

모드	동작 방식	적합한 상황
Ask permissions (기본값)	파일 수정이나 명령 실행 전에 승인을 요청	처음 사용할 때, Claude Code가 하는 일을 모두 확인하고 싶을 때
Auto accept edits	파일 수정과 일부 파일 명령은 자동 처리하고 다른 터미널 명령은 확인 요청	반복 작업으로 변경 내용을 계속 검토할 때
Plan mode	소스 코드를 수정하지 않고 탐색한 뒤 작업 계획을 먼저 제시	복잡한 작업을 시작하기 전에 계획을 검토하고 싶을 때
Auto mode	백그라운드 안전 검사를 거쳐 작업을 자동 실행	승인 요청을 줄이고 싶을 때 (특정 계정에만 제공)

처음 사용할 때는 Ask permissions 모드를 추천합니다. 각 단계를 검토하고 승인하면서 Claude Code가 어떻게 작동하는지 배울 수 있습니다.

5단계: 첫 프로젝트 완성까지의 과정

Ask permissions 모드에서 위의 HTML 요청을 실행하면 다음과 같이 진행됩니다:

✅ 일반적인 진행 과정:

1️⃣ Claude Code가 프로젝트 폴더 검토
2️⃣ HTML 파일 생성 계획 제시
3️⃣ 파일 수정 승인 요청 (Diff 화면에서 변경 내용 검토)
4️⃣ 생성 완료
5️⃣ Preview 패널에서 결과 확인
6️⃣ 버튼 테스트 (클릭해서 알림이 뜨는지 확인)
7️⃣ 완료!

윈도우와 맥에서 Claude Code를 설치하고 로그인한 뒤 첫 프로젝트를 실행하는 과정을 순서대로 알아봅니다.

초보자 팁 5가지

1️⃣ 구체적으로 지시하기

❌ 나쁜 예: "웹사이트 만들어줘"
✅ 좋은 예: "현재 시각을 표시하는 웹페이지. 제목을 굵게 표시하고, 1초마다 자동으로 업데이트되게"

2️⃣ Ask permissions 모드에서 시작

처음엔 Claude Code가 하는 모든 일을 봐야 합니다. Ask permissions 모드로 두고, 각 단계를 검토하고 승인하세요. 익숙해지면 모드를 올려도 괜찮습니다.

3️⃣ 오류 메시지를 그대로 복사

뭔가 실패하면, 터미널에 나타난 오류 메시지를 그대로 Claude Code에 붙여넣고 "이 에러 고쳐줄래?"라고 하면 됩니다.

4️⃣ Git으로 백업하기

큰 변경 전에 커밋을 해두세요. Claude Code의 실수로부터 복구할 수 있습니다.

git init git add . git commit -m "Initial setup"

5️⃣ 여러 세션 병렬 사용

좌측 사이드바에서 "New Session" 버튼으로 여러 작업을 동시에 진행하세요. 각 세션이 개별적으로 진행되므로 한 작업을 중단하지 않고 다른 작업을 할 수 있습니다.

문제 해결 (FAQ)

Q: 파일 수정 후 "Permission denied" 오류가 나요

A: 파일 수정 권한이 없는 경로를 작업하고 있을 가능성이 높습니다. 프로젝트 폴더를 사용자의 문서나 바탕화면으로 옮긴 뒤 다시 시도하세요. 특정 파일이나 명령에 대해서만 권한이 필요하다면, 그 작업만 선택해서 승인하고 나머지는 거부해도 됩니다.

Q: 포트 충돌로 웹 서버가 안 켜져요

A: 다른 프로그램이 같은 포트를 사용 중입니다. Claude Code가 포트 변경을 자동으로 제안하거나, 직접 요청해서 "8000 대신 8080 포트로 서버 열어줄래?" 하면 됩니다.

Q: 터미널을 열려면 어떻게 하나요?

A: Ctrl+` (역따옴표, backtick)를 누르면 터미널이 나타납니다. 또는 상단 메뉴에서 "View" → "Terminal"을 선택해도 됩니다.

Q: Node.js가 없어도 괜찮나요?

A: HTML과 CSS만 사용하는 프로젝트는 괜찮습니다. 하지만 React, Vue 같은 JavaScript 프레임워크를 사용하려면 Node.js가 설치되어 있어야 합니다. 처음엔 HTML 프로젝트로 시작하고, 나중에 필요하면 설치하세요.

Linux 사용자를 위한 안내

Claude Desktop은 현재 macOS와 Windows에서만 공식 지원됩니다. Linux 사용자는 터미널용 Claude Code CLI를 설치해야 합니다.

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

설치 후 프로젝트 폴더에서 claude 명령을 실행하세요. CLI를 통해서도 프로젝트 탐색, 파일 수정, 명령 실행 등 Claude Code의 핵심 코딩 작업을 모두 수행할 수 있습니다. 자세한 내용은 공식 CLI 시작 가이드를 참고하세요.

다음 편 예고

다음 게시글에서는 Claude Code 실전 활용 & 고급 팁을 다룹니다:

✅ GitHub 자동 연동 & Pull Request 생성
✅ 자동 코드 리뷰 & 버그 수정
✅ 복잡한 프로젝트 구조 다루기
✅ 팀 협업 워크플로우 설정
✅ 프로덕션 배포까지의 자동화

📚 관련 게시글

• ⚡ Claude Code란? 터미널에서 직접 일하는 AI 코딩 에이전트 (2026) - 기본 개념과 활용 사례
• 🧑‍💻 클로드 코딩으로 홈페이지 만드는 방법 - 비개발자의 첫 웹사이트 제작기
• 🤖 Claude vs ChatGPT vs Gemini - 2026 최신 AI 도구 비교

📌 공식 참고 자료:

• 설치 & 시작: Get Started with Claude Code Desktop

• 완전한 기능 참고서: Use Claude Code Desktop

• 설치 문제 해결: Troubleshoot Installation and Login

• CLI 시작하기: Get Started with Claude Code CLI

💡 팁: 이 가이드는 2026년 7월 기준 Claude Code 최신 버전을 기반으로 작성되었습니다. 설치 과정이나 UI가 변경될 수 있으므로, 문제가 발생하면 공식 문서를 참고하세요. 궁금한 점이 있다면 Anthropic의 공식 지원팀에 문의할 수 있습니다.