Claude Code 완전 가이드

Mac 사용자

1. 1nodejs.org에 접속합니다
2. 2초록색 LTS 버튼을 클릭해서 다운로드합니다 (오른쪽 버튼 말고 왼쪽 것!)
3. 3다운로드된 .pkg 파일을 더블클릭 → "계속"만 누르면 설치 완료
4. 4
   설치 확인: 화면 우측 상단 🔍 클릭 → "터미널" 입력 → 검은 창이 열림

   (터미널 = 텍스트로 컴퓨터에 명령을 내리는 프로그램. 무섭게 생겼지만 복사-붙여넣기만 하면 됩니다)
5. 5터미널에 node --version 을 입력하고 엔터. 숫자가 나오면 성공!

Windows 사용자

1. 1nodejs.org에 접속합니다
2. 2초록색 LTS 버튼을 클릭해서 다운로드합니다
3. 3다운로드된 .msi 파일을 더블클릭 → "Next"만 누르면 설치 완료
4. 4
   설치 확인: 시작 메뉴 → "PowerShell" 검색 → 파란 창이 열림

   (PowerShell = Windows의 터미널. Mac의 "터미널"과 같은 역할입니다)
5. 5창에 node --version 을 입력하고 엔터. 숫자가 나오면 성공!

❓ 자주 하는 질문

⚠️ 권한 에러가 나는 경우

1. 1console.anthropic.com에 접속 → "Sign up" (Google 계정으로도 가능)
2. 2터미널에 claude 입력 → 브라우저가 자동으로 열림 → 방금 만든 계정으로 로그인
3. 3로그인 완료! 터미널로 돌아가면 Claude Code가 준비되어 있습니다.

💰 비용 안내

따라하기

1. 1
   터미널을 엽니다

   Mac: 🔍 → "터미널" / Windows: 시작 → "PowerShell"

2. 2
   아래 두 줄을 복사해서 붙여넣고 엔터

   $ mkdir my-app

   $ cd my-app

   복사

   mkdir = 폴더 만들기, cd = 그 폴더 안으로 이동하기. 외울 필요 없어요.

3. 3
   Claude Code 시작

   $ claude

   복사

   이제부터 자연어로 대화할 수 있습니다. > 표시가 나타나면 준비 완료!

4. 4
   만들고 싶은 것을 말합니다

   > 할 일 목록 앱을 만들어줘.

   > 할 일을 추가하고, 완료 체크하고, 삭제할 수 있어야 해.

   > 예쁘게 만들어줘.

   복사

   기술 용어 안 써도 됩니다. 그냥 한국어로 원하는 걸 말하세요.

5. 5
   결과 확인

   Claude Code가 파일 생성이 끝나면, 브라우저(Chrome, Safari 등)를 열고 주소창에 localhost:3000 을 입력하세요.

   localhost:3000 = "내 컴퓨터에서 실행 중인 앱"이라는 뜻입니다. 인터넷 주소가 아니에요.

1단계: GitHub 계정 만들기

1. 1github.com 접속 → "Sign up" 클릭
2. 2이메일, 비밀번호, 사용자 이름 입력 → 이메일 인증 → 완료

2단계: GitHub CLI 설치 & 로그인

Claude Code가 GitHub에 코드를 올리려면 "GitHub CLI"라는 도구가 필요합니다. 한 번만 설치하면 됩니다.

3단계: GitHub에 로그인

설치가 끝났으면, 터미널에서 GitHub에 로그인합니다:

✅ 확인 방법

"Logged in to github.com"이 나오면 성공입니다. 이제 Claude Code가 GitHub에 코드를 올릴 수 있습니다.

사전 준비: GitHub 계정 만들기

GitHub는 코드를 저장하는 곳입니다. Google Drive에 파일을 저장하듯, 코드를 GitHub에 저장합니다. 무료예요.

1. 1github.com에 접속 → "Sign up" → 이메일/비밀번호 입력 → 완료

사전 준비: Vercel 계정 만들기

Vercel은 앱을 인터넷에 올려주는 서비스입니다. 여러분의 앱을 24시간 실행해주는 컴퓨터라고 생각하세요. 무료예요.

1. 1vercel.com에 접속 → "Sign Up" → "Continue with GitHub" 선택 (방금 만든 GitHub 계정으로)

배포하기 (Claude Code에게 시키기)

계정이 준비됐으면, Claude Code에게 한 마디만 하면 됩니다:

Claude Code가 자동으로:

• ✅ GitHub에 코드를 업로드하고
• ✅ Vercel에 연결하고
• ✅ 배포를 실행합니다

몇 분 후, 이런 URL을 받게 됩니다:

이 주소를 친구에게 보내보세요. 세계 어디서든 접속할 수 있습니다! 🎉

🌐 내 도메인 쓰기 (선택사항)

"vercel.app" 대신 "myname.com" 같은 내 주소를 쓰고 싶다면: Namecheap에서 도메인 구매 (연 약 1만원) → Vercel에서 연결. 없어도 괜찮습니다 — vercel.app 주소로 충분해요.

'claude' 명령어를 찾을 수 없다고 나와요

Node.js를 먼저 설치했는지 확인하세요. 설치 후 터미널을 완전히 껐다가 다시 열어야 합니다. 그래도 안 되면 'npx @anthropic-ai/claude-code'로 실행해보세요.

API 키 에러가 나요

'claude' 명령어 실행 시 브라우저 로그인 방식을 사용하세요. 또는 console.anthropic.com에서 API 키를 새로 발급받고 export ANTHROPIC_API_KEY=새키 를 실행하세요.

Claude Code가 파일을 수정하려는데 권한을 물어봐요

정상입니다. Claude Code는 안전을 위해 파일 수정 전 허락을 구합니다. 'y'를 눌러 허용하거나, 신뢰할 수 있는 작업이면 '--dangerously-skip-permissions'로 자동 허용할 수 있습니다.

비용이 너무 빨리 나가요

/cost로 현재 비용을 확인하세요. /compact로 대화를 압축하면 토큰을 절약할 수 있습니다. 또는 Max 플랜($100/월)을 구독하면 별도 API 비용 없이 사용할 수 있습니다.

생성된 코드가 에러가 나요

에러 메시지를 그대로 Claude Code에게 알려주세요. '이 에러가 나는데 고쳐줘: [에러 메시지]'라고 하면 됩니다. Claude Code는 에러를 직접 읽고 수정합니다.

이전 대화를 이어가고 싶어요

'claude --continue'로 마지막 대화를 이어갈 수 있습니다. 또는 'claude --resume'으로 이전 세션 목록에서 선택할 수 있습니다.