Claude Code 처음 켜기.
스텝만 따라 하면 됩니다.

VS Code는 프로그래머용 텍스트 편집기예요. 이걸 Claude가 사는 집이라고 생각하면 편합니다.

1. 브라우저(엣지·크롬)에서 code.visualstudio.com으로 들어가세요.
2. 가운데 큰 Download 버튼이 보입니다. 자동으로 여러분 OS를 인식해서 Windows용을 줍니다. 만약 안 잡히면 버튼 옆 other platforms 눌러서 Windows x64 User Installer 받으세요.
3. 받은 .exe 파일 더블클릭 → 라이선스 동의 → 다음, 다음, 설치. 중간에 나오는 옵션은 다 기본값으로 두면 돼요.
4. 설치 끝나면 Visual Studio Code 시작 체크하고 마침.

이 화면이 뜨면 맞습니다. 큰 검정 버튼 누르면 됩니다.

VS Code를 열면 왼쪽에 세로 아이콘 바가 있어요. 그중 네모 네 개(하나가 삐져나온 모양) 아이콘이 확장(Extensions)입니다.

1. 확장 아이콘 클릭.
2. 위쪽 검색창에 claude code 입력.
3. 맨 위에 Anthropic이 만든 Claude Code for VS Code가 나옵니다. 아이콘은 주황색 별 모양.
4. 초록색 Install 버튼 클릭. 몇 초 걸립니다.

확장 페이지에서 보이는 게 이 화면과 같은지 확인. Anthropic 표시 + 주황색 별 아이콘.

웹 Marketplace에서 이 화면이 뜨면 정상. 제작자 Anthropic · 파란 체크 · 초록 Install 버튼.

설치가 끝나면 VS Code 오른쪽 위에 주황색 Claude 별 아이콘이 하나 생겨요. 이걸 눌러야 채팅창이 열립니다.

우측 상단 · 주황색 별 모양 아이콘. 이걸 눌러 Claude Code 패널을 엽니다.

주황색 별이 안 보일 때 — 확장이 활성화 안 됐을 가능성 높음. 아래 순서로 확인하세요.

확장 페이지에서 이 화면이 뜨면 정상 활성화. Anthropic · 25,058,346 installs · Free 표시.

"이 폴더를 신뢰합니까?" 나오면

VS Code에서 폴더 열 때마다 처음이면 이 창이 뜹니다. Trust the authors of the files in this folder (또는 한국어 "이 폴더의 작성자를 신뢰합니다") 눌러주세요. 신뢰 안 하면 Claude가 해당 폴더에서 작업 못 합니다. 본인이 만든 폴더면 무조건 Trust.

로그인 · 첫 실행 시

1. 주황 별 아이콘 클릭 → 채팅창 열림.
2. VS Code 오른쪽 아래 알림이 뜨면 Sign in with Claude 클릭.
3. 브라우저에서 anthropic 로그인 페이지가 열립니다. Claude 계정으로 로그인하세요. (없으면 claude.ai에서 무료 계정 먼저 만드세요.)
4. 페이지에 "Return to VS Code" 버튼 나오면 클릭. VS Code로 자동 복귀.
5. 다시 VS Code에서 연결됨 알림 뜨면 완료.

Claude는 폴더 단위로 일합니다. 그러니까 먼저 "무슨 작업을 할 폴더인지"를 정해서 열어줘야 해요.

1. VS Code 상단 메뉴 → 파일(File) → 폴더 열기(Open Folder).
2. 탐색기가 열리면, 바탕화면에 새 폴더 하나 만드세요. 이름은 아무거나 (내프로젝트, test, bumdongsan 등). 한글도 됩니다.
3. 그 폴더 선택 → 폴더 선택 클릭.
4. 처음이면 "이 폴더 만든 사람 믿나요?" 창이 나옵니다. 예(Yes, I trust).

이제 진짜 대화창을 엽니다. 두 가지 방법 중 아무거나 됩니다.

방법 A · 사이드바에서 열기

1. VS Code 왼쪽 아이콘 바에서 주황색 별 아이콘(Claude)을 클릭.
2. 오른쪽에 채팅창이 열립니다.

방법 B · 단축키

• 키보드 Ctrl + Esc — 채팅창이 바로 열립니다.

채팅창이 열리면 아래쪽 입력창에 그냥 한국어로 말 걸어보세요.

답이 오면 성공. 이제 여기가 여러분 새 작업실입니다.

실제 사용 화면 · 탐색기(왼쪽) · 편집기(가운데) · Claude Code(오른쪽) 3분할.

Claude에는 여러 모델이 있어요. 지금 어떤 놈이 대답하는지 확인하고, 필요하면 바꿀 수 있습니다.

채팅창 입력줄에 /model 을 치고 엔터. (슬래시로 시작하는 건 "명령어" 입니다.)

/model

Current model: Sonnet 5

모델을 바꾸려면 /switch-model 을 칩니다. 목록이 나오고 ↑↓ 화살표로 골라서 엔터.

/switch-model

  ○ Haiku 4.5     - 빠름 · 저렴 · 짧은 답
  ○ Sonnet 5      - 균형 · 무난 (기본값)
  ● Opus 5        - 똑똑함 · 실제로 쓸만함
  ○ Fable 5.1     - 최상급 · 실험적 · 더 똑똑함

모델 4개 설명 · 짧게

얼마나 쓰고 있는지 궁금하면:

/status

현재 로그인 계정, 지금 모델, 이번 5시간 창의 사용률, 리셋까지 남은 시간이 다 나옵니다.

더 자세한 사용량 (달 단위)는 브라우저에서 claude.ai/settings/usage로 가면 됩니다.

Claude가 파일 만들 때마다, 명령어 실행할 때마다 "허락해줘" 물어봅니다. 이거 매번 답하기 귀찮으면 자동모드(auto)로 바꾸세요.

채팅창 우측 하단에 조그맣게 아이콘 두 개가 있어요.

• 왼쪽 아이콘 — 현재 모델 (여기서도 클릭해서 Opus로 바꿀 수 있음).
• 오른쪽 아이콘 — 권한 모드. 클릭하면 3단 선택:
  • default — 위험한 것만 물어봄. 기본.
  • plan — 계획만 세우고 실제 실행은 안 함. 미리보기용.
  • auto — 다 알아서. 안 물어봄. 가장 편함. 대신 감시는 해야 함.

모드 변경 단축키는 Shift + Tab 두 번. 한번 누르면 plan, 또 누르면 auto, 또 누르면 default로 돌아옵니다.

모델은 여기서 바로 Opus로 바꿔두면 좋아요. 복잡한 부동산 리서치 같은 건 Opus가 훨씬 낫습니다.

PC에서 세션 하나 켜두면, 같은 대화를 데스크톱 앱이나 휴대폰 앱에서 이어받을 수 있습니다. 지하철에서 Claude한테 지시 내리는 게 가능해요.

준비 1 · Claude 앱 설치

1. 브라우저 claude.ai/download 접속.
2. Windows용 데스크톱 앱 받아서 설치. Claude 계정으로 로그인.
3. 휴대폰은 앱스토어/플레이스토어에서 Claude 검색 후 설치.

claude.ai/download 페이지. 데스크톱 앱 + 모바일 링크가 다 있습니다.

준비 2 · PC에서 원격 제어 켜기

1. VS Code에서 Claude Code 채팅창이 실행 중인 상태로 유지.
2. Claude Code 채팅 입력창에 /remote-control 입력 → Enter.
3. "원격 제어가 활성화되었습니다" 안내와 함께 세션 URL(또는 QR 코드)이 표시됩니다.

준비 3 · 폰/데탑앱에서 세션 열기

1. 휴대폰 Claude 앱 열기 (PC와 같은 계정으로 로그인 필수).
2. 하단 또는 사이드 메뉴에서 Code 탭 선택.
3. 연결된 기기 목록에 PC의 활성 세션이 뜹니다. 탭.
4. 메시지 보내면 → PC의 Claude가 받아서 실행 → 결과를 폰에서도 확인.

공식 문서: PC Claude Code에서 /remote-control 실행 → 폰 Code 탭에서 세션 선택 → 이어서 지시.

부동산 데이터 다루려면 국토부 실거래가 API가 필수. 무료입니다. 승인 몇 시간 걸립니다.

1. 브라우저에서 data.go.kr 접속.
2. 우측 상단 회원가입 → 개인 회원 → 이름·이메일 등록.
3. 상단 검색창에 국토교통부 실거래가 입력.
4. 결과 목록에서 원하는 부동산 종류별 실거래 자료 클릭 → 오픈API 탭.
5. 우측 활용 신청 버튼 클릭.

data.go.kr 첫 화면. 여기서 검색으로 진입합니다.

부동산 종류별로 따로 신청 — 링크

실거래 API는 부동산 종류마다 별개입니다. 아래는 각 API 신청 페이지 직접 링크. 클릭 → 로그인 → 우측 활용신청. 처음 클릭 시 로그인 창이 뜨면 공공데이터포털 계정으로 로그인.

신청서 입력 · 이렇게 채우세요

신청서에 이것저것 묻는데, 여기 붙여넣기용 예시를 준비했습니다. 정직해도 되고, 예시 그대로 써도 문제없어요. 어차피 심사관은 사람이 아니라 자동승인입니다.

활용 목적

개인 학습 및 부동산 시장 분석용으로 활용 예정입니다. 개인 학습 목적으로 아파트 매매 실거래 데이터를 수집·분석하여 서울·경기 지역 부동산 시장 동향을 파악하고, 관심 지역의 시세 추이를 시각화하는 개인 프로젝트에 활용하고자 합니다.

서비스 유형

웹 사이트 개발 또는 기타 선택.

서비스 정보 (URL, 있으면)

없으면 그냥 개인 프로젝트라고 적어도 됩니다. 개인 프로젝트 (운영 중인 도메인 없음)

일일 트래픽 예상

개인용이면 낮게. 10,000건 정도가 무난. 일 10,000건 이내 (개인 학습 용도)

이용약관 동의

다 체크. 특히 재배포 금지 조항이 있는데, 개인 용도면 상관 없어요.

신청 → 마이페이지 → 오픈API → 개발계정에서 승인 상태 확인. 보통 즉시 또는 몇 시간 내에 자동승인. 승인되면 일반 인증키(Encoding/Decoding) 두 종류가 발급됩니다.

부동산 데이터 뽑으면 결국 지도에 찍고 싶어져요. 그런데 지도는 대부분 API 키가 필요합니다. 카카오지도·네이버지도·구글맵 다 무료 티어가 있지만, 가입·앱 등록·도메인 등록이 귀찮아요. 여기선 가입 한 번으로 끝나는 방법과 완전 가입 없이 되는 방법 두 개를 보여줍니다.

방법 A · VWorld (국토부 공식 · 무료 · 지적도까지 포함)

브이월드(VWorld)는 국토교통부가 직접 운영하는 국가 공간정보 지도입니다. 무료. 부동산·필지 다룰 때 가장 좋아요. 지적도(필지 경계선)까지 볼 수 있는 거의 유일한 무료 지도입니다.

vworld.kr 개발자 페이지. 오픈API · 부동산 서비스 카드가 보이면 정상.

1. 브라우저에서 vworld.kr 접속.
2. 우측 상단 회원가입. 개인용으로 이름·이메일 등록.
3. 로그인 후 상단 인증키 발급 메뉴 → 인증키 신청.
4. 신청 내용:
   • 서비스 URL — 개인용이면 http://localhost:8080 이나 본인 도메인.
   • 서비스 유형 — 2D 지도 선택. (필요하면 3D, Data도 함께.)
   • 이용 목적 — 개인 학습 / 부동산 분석 목적.
5. 승인 → 즉시 발급. 마이페이지에서 인증키(32자) 복사.

방법 B · OpenStreetMap (가입 안 함 · 즉시 가능)

완전 가입 없이 지도만 띄우고 싶으면 OpenStreetMap(OSM)을 쓰면 됩니다. 전 세계 오픈소스 지도 프로젝트. API 키 필요 없음.

Claude한테 그냥 이렇게 말하면 끝나요.

Claude가 index.html 하나 만들어서 브라우저에서 여는 순간 지도가 뜹니다. 코드도, 계정도, 키도 필요 없습니다.

간단 요약

키를 받았으면 Claude한테 넘기면 됩니다. 이때 중요한 게 말투예요. 그냥 "이 키 줬으니까 알아서 다 해줘" 라고 하면 됩니다. 세세히 설명할 필요 없어요.

Claude가 알아서 Python 스크립트 만들고 API 호출해서 결과 뽑아줍니다. 처음엔 이렇게 직접 붙여넣는 방식이 제일 빨라요.

Claude가 미적거리면 · 졸라기

Claude가 종종 "이건 어떻게 하실 건가요?", "확인 한번 해주시겠어요?", "이러이러한 방법이 있는데 어떤 걸 원하세요?" 이렇게 묻습니다. 이때 딱 이렇게 말하세요.

이 한 마디로 대부분 해결됩니다. Claude는 원래 안전하게 동작하려고 자주 확인하는 성향이 있어요. 확인이 성가시면 미리 "자동으로 다 해줘"라고 못박아 두세요. 안 되면 한 번 더 "묻지 말라니까" 하면 됩니다.

키가 하나 두 개일 땐 상관없는데, 카카오맵·네이버·국토부·기상청 등등 늘어나면 관리가 번거로워집니다. 그리고 실수로 인터넷에 올리면 큰일이에요. 그래서 .env 파일이라는 걸 씁니다.

.env 파일이란?

여러 키를 한 파일에 모아두고, 코드에서는 이름으로만 부르는 방식입니다. 파일 자체는 .gitignore에 넣어서 절대 공유 안 되게 처리해요.

방법 A · 편한 방법 (Claude에게 키 알려줌)

가장 편함. 대신 키가 Anthropic 서버로 감. 개인용이면 실용적.

방법 B · 안전한 방법 (권장)

여러분이 직접 .env를 만들고 채웁니다. Claude는 키 값을 절대 보지 않아요.

1. 먼저 Claude에게 구조만 만들어달라고 합니다.
   이 폴더에 빈 .env 파일 하나 만들어주고, .gitignore에 .env 추가해줘. 그리고 .env.example도 하나 만들어서 필요한 변수 이름들만 값 없이 적어줘. 예: MOLIT_API_KEY= (값 비워둠)
2. 파일 열기 · Ctrl+O → .env 타이핑 → Enter. VS Code 편집기에 열립니다.
3. 여러분이 직접 키 값을 붙여넣고 저장 (Ctrl+S). 이 순간 값은 여러분 PC에만 존재.
4. Claude에게 "이제 .env에 키 넣었어. API 호출할 때 이거 참조해서 써줘"라고만 하면, Claude는 os.getenv("MOLIT_API_KEY") 같은 형태로 코드를 만듭니다. 값 자체는 안 봅니다.

Windows에서 .env 파일 보이게 하기

.env는 이름이 점(.)으로 시작하는 파일입니다. Windows에서는 기본적으로 숨김 파일로 취급돼서 파일 탐색기에 안 보일 수 있어요. VS Code에서는 잘 보이지만, Windows 탐색기에서도 봐야 할 때가 있죠.

1. 파일 탐색기 열기 (Win + E).
2. 상단 메뉴 보기(View) 클릭.
3. 표시(Show) → 숨긴 항목(Hidden items) 체크.
4. 이제 .env가 회색으로 살짝 흐리게 보입니다.

Windows 10 이하는 보기 → 옵션 → 폴더 및 검색 옵션 변경 → 보기 탭 → 숨김 파일 · 폴더 · 드라이브 표시 순서.

여기까지 오면 도구는 다 세팅됐어요. 마지막으로, Claude Code를 잘 굴리는 사람과 못 굴리는 사람의 차이가 뭔지 알려드릴게요. 이거 하나입니다.

잘 굴리는 사람은 집요합니다.

Claude가 처음에 "안 됩니다", "복잡합니다", "이 방법은 어렵습니다"라고 하면, 대부분의 사람은 거기서 포기합니다. 그런데 한 번 더 밀어붙이면 됩니다. 정말로 됩니다.

PC에서 세션 돌리는 건 좋은데, 지하철에서·카페에서·자기 전 침대에서 Claude한테 뭘 시키고 싶을 때가 있습니다. 텔레그램 봇을 만들어서 붙이면 메신저로 Claude한테 지시할 수 있어요. Claude는 여러분 PC에서 실행되고, 결과만 텔레그램으로 답장.

전체 흐름 · 한눈에

봇 만들기 · 단계별 자세히

1. 텔레그램에서 BotFather 검색 → 파란 체크 마크 있는 공식 계정 클릭.
2. /start → 봇 메뉴 나옵니다.
3. /newbot 입력.
4. "봇 이름을 뭐로 할까요?" → 아무거나. 예: My Claude Relay.
5. "봇 아이디는?" → _bot으로 끝나야 함. 예: my_claude_relay_bot. 중복이면 다시.
6. 성공하면 봇 링크와 봇 토큰이 옵니다. 토큰만 복사.
7. 봇 링크 눌러서 여러분 봇과 대화 시작 → /start 한 번 눌러주세요. 이거 안 하면 봇이 여러분한테 답 못 보냅니다.

Claude 세션에 붙이는 정확한 문장

봇 토큰 받았으면 Claude 채팅창에 이걸 그대로 붙여넣으세요.

Claude가 스텝별로 진행하면서 중간에 "봇한테 /start 눌러주세요"같은 액션을 요청할 수 있어요. 시키는 대로 해주면 됩니다.