클로드 코드 사용법 — 데스크탑 설치부터 첫 앱 만들기까지

클로드 코드 사용법 — 데스크탑 설치부터 첫 앱 만들기까지

클로드 코드(Claude Code)는 Anthropic의 AI 코딩 도구로, 내 컴퓨터의 작업 폴더 안에서 AI가 직접 파일을 만들고 프로그램을 실행하며 앱을 만들어 줍니다. 원래는 개발자가 터미널(명령창)에서 쓰는 도구로 시작했지만, 지금은 Claude 데스크톱 앱의 코드 탭에서 대화하듯 쓸 수 있어서 코딩을 모르는 분도 시작할 수 있습니다.

이 글은 클로드 코드를 처음 쓰는 분이 설치부터 첫 결과물을 보기까지 따라 할 수 있도록 순서대로 설명합니다.

클로드 코드는 어디서 쓸 수 있나

클로드 코드는 여러 곳에서 쓸 수 있습니다.

  • Claude 데스크톱 앱의 코드 탭 — 명령어 없이 대화창으로 씁니다. 처음 시작하는 분께 권합니다.
  • 터미널(CLI) — 개발자들이 명령창에서 씁니다.
  • VS Code 같은 코드 편집기 — 확장 기능을 설치해 편집기 안에서 씁니다.

어디서 쓰든 하는 일은 같습니다. 이 글에서는 가장 쉬운 데스크톱 앱을 기준으로 설명합니다.

1단계 — 데스크탑 앱 설치하고 로그인하기

claude.ai/download 에 들어가 윈도우나 맥에 맞는 데스크톱 앱을 내려받아 설치합니다. 설치가 끝나면 Claude 계정으로 로그인합니다. 클로드 코드의 작업 기능은 유료 요금제에서 쓸 수 있으니, 요금제는 공식 사이트의 안내를 확인하고 고르세요. 처음에는 가장 기본 유료 요금제로 시작해 보고, 사용량이 부족하면 그때 올려도 늦지 않습니다.

2단계 — 코드 탭을 열고 작업 폴더 고르기

앱 위쪽에서 코드(Code) 탭을 엽니다. 그러면 어느 폴더에서 일할지 고르게 됩니다. 만들 앱 이름으로 새 폴더를 하나 만들어 고르세요. 예를 들어 문서\모임공지-앱 같은 식입니다.

폴더를 고르는 것은 AI에게 “이 방 안에서만 일하라”고 정해 주는 것과 같습니다. 앱마다 폴더를 따로 두면 서로 섞이지 않습니다. OneDrive나 구글 드라이브 같은 동기화 폴더 안은 피하는 것이 좋습니다. 파일이 아주 많이 생기는 작업이라 동기화가 꼬이기 쉽습니다.

3단계 — 첫 대화 보내기

빈 폴더에서 첫 대화는 이렇게 시작하면 좋습니다.

✍️ 첫 대화
이 컴퓨터에서 처음 웹 앱을 만들어 보려고 합니다. 코딩은 모릅니다.
필요한 프로그램이 설치되어 있는지 먼저 확인해 주시고, 없으면 무엇을 설치해야 하는지 쉬운 말로 알려 주세요.

웹 앱을 만들려면 Node.js나 Git 같은 기본 프로그램이 필요할 때가 있는데, 클로드 코드가 컴퓨터를 살펴보고 무엇이 필요한지 알려 줍니다. 설치 화면에서 막히면 그 화면을 캡처해 대화창에 붙여 넣고 물어보면 됩니다.

4단계 — 권한 허락하기

클로드 코드는 파일을 만들거나 명령을 실행하기 전에 허락을 구합니다. 무엇을 하려는지 짧은 설명이 함께 나오니 읽어 보고 괜찮으면 허락하면 됩니다. 이해가 안 되면 허락하기 전에 “이건 무슨 작업인가요?”라고 물어보세요.

이 허락 단계가 번거롭게 느껴질 수 있지만, AI가 내 컴퓨터에서 마음대로 일하지 못하게 막아 주는 중요한 안전장치입니다. 익숙해지면 자주 쓰는 작업은 매번 묻지 않도록 설정할 수도 있지만, 처음에는 하나씩 읽어 보며 허락하는 것을 권합니다.

⚠️ 주의

인터넷에서 “권한 확인을 모두 건너뛰는 설정”을 소개하는 글을 볼 수 있습니다. 편하긴 하지만, 무엇을 하는지 모르는 상태에서 쓰면 중요한 파일이 지워지거나 바뀌어도 알아채기 어렵습니다. 처음 시작하는 분은 쓰지 않는 것이 좋습니다.

5단계 — 첫 앱 만들고 확인하기

준비가 끝나면 10분 안에 끝날 작은 것부터 만들어 봅니다.

✍️ 첫 앱 요청
우리 모임의 이번 주 공지를 보여 주는 한 페이지 웹사이트를 만들어 주세요.
- 제목, 날짜, 장소, 준비물을 보여 주기
- 폰에서 보기 좋게, 글씨는 크게
- 화면의 모든 글은 한국어로
다 만들면 제가 볼 수 있게 화면을 열어 주세요.

클로드 코드가 파일을 만들고 화면을 띄워 줍니다. 직접 열어 보고 “배경색을 바꿔 주세요”, “장소 아래에 지도 링크를 넣어 주세요”처럼 하나씩 고쳐 나가면 됩니다. 이 주고받기가 바로 바이브코딩입니다.

알아 두면 편한 기능

  • 계획 먼저 받기 — 큰 작업은 “바로 만들지 말고 계획부터 보여 주세요”라고 하면, 무엇을 어떻게 할지 먼저 설명하고 승인을 기다립니다.
  • 화면 캡처 붙여 넣기 — 고칠 곳을 말로 설명하기 어려우면 캡처를 붙여 넣으세요.
  • 저장점 만들기 — 잘 되는 상태에서 “지금 상태를 저장해 주세요”라고 하면 나중에 되돌아올 수 있습니다.
  • 원칙 기억시키기 — 작업 폴더에 CLAUDE.md라는 파일을 두면 클로드 코드가 매번 먼저 읽고 그 원칙을 따릅니다.

자주 묻는 질문

클로드 코드와 그냥 Claude 대화는 무엇이 다른가요?

일반 대화는 질문에 답하고 코드를 글로 보여 주는 데서 끝납니다. 클로드 코드는 작업 폴더 안에서 실제로 파일을 만들고, 실행하고, 오류를 고칩니다. 사람이 코드를 복사해 붙일 필요가 없습니다.

클로드 코드가 느려지거나 대화가 길어지면 어떻게 하나요?

한 대화에서 너무 많은 작업을 하면 대화가 길어져 느려질 수 있습니다. 기능 하나가 끝나면 새 대화를 여는 것이 좋습니다. 이어서 작업할 내용은 CLAUDE.md에 원칙으로 남겨 두면 새 대화에서도 이어집니다.

클로드 코드에 맡기기 좋은 일, 조심할 일

클로드 코드는 여러 파일을 오가는 일을 잘합니다. 처음 써 보는 분이 효과를 크게 느끼는 일은 이런 것들입니다.

  • 한 페이지짜리 안내 사이트, 신청서, 체크리스트 같은 작은 웹 앱 만들기
  • 엑셀 파일을 읽어 정리하고 표나 그래프로 보여 주기
  • 반복되는 파일 이름 바꾸기, 사진 크기 줄이기 같은 컴퓨터 작업
  • 이미 만든 앱의 글자, 색, 배치 고치기

반대로 조심할 일도 있습니다. 실제 사용자 자료를 지우거나 옮기는 작업, 결제와 관련된 기능, 비밀번호와 API 키를 다루는 작업은 AI가 무엇을 하려는지 한 줄 한 줄 확인하고 허락하세요. 특히 “정리해 주세요”, “필요 없는 것 지워 주세요”처럼 범위가 넓은 요청은 지울 대상을 이름으로 짚어 주는 것이 안전합니다.

클로드 코드 사용량을 아끼는 법

유료 요금제에도 일정 기간의 사용량 한도가 있습니다. 같은 요금으로 더 많은 일을 하려면 이렇게 해 보세요.

  • 기능 하나가 끝나면 새 대화를 엽니다. 대화가 길어질수록 AI가 매번 앞의 내용을 다시 읽어야 해서 사용량이 빨리 줄어듭니다.
  • 계획을 먼저 받고 확정합니다. 잘못 만든 것을 뜯어고치는 데 드는 사용량이 가장 큽니다.
  • 원칙은 CLAUDE.md에 적어 둡니다. 매번 같은 설명을 반복하지 않아도 됩니다.
  • 긴 대화는 요약해서 이어 갑니다. 터미널에서 쓰는 경우 지난 대화를 요약해 줄이는 명령(/compact)도 있습니다.

클로드 코드를 처음 쓸 때 자주 묻는 것들

작업 중에 컴퓨터를 꺼도 되나요? 작업이 진행되는 동안에는 켜 두어야 합니다. 작업이 끝난 뒤에는 꺼도 만든 파일은 작업 폴더에 그대로 남아 있고, 다음에 같은 폴더를 열어 이어서 작업할 수 있습니다.

만든 앱은 어디에 있나요? 처음에 고른 작업 폴더 안에 있습니다. 탐색기로 그 폴더를 열면 AI가 만든 파일들을 볼 수 있습니다. 파일을 직접 고칠 필요는 없지만, 어디에 있는지는 알아 두세요.

대화 기록이 사라지면 어떻게 하나요? 대화가 끝나도 파일은 남습니다. 다만 그동안 정한 원칙이 대화 속에만 있었다면 새 대화에서 다시 설명해야 하므로, 중요한 원칙은 CLAUDE.md에 적어 두는 습관을 들이세요.

영어 오류 메시지가 나오면요? 그대로 복사해서 “이 오류가 무슨 뜻인지 쉬운 말로 설명하고 고쳐 주세요”라고 하면 됩니다. 오류 메시지를 직접 해석할 필요는 없습니다.

처음 한 주 동안 해 보면 좋은 연습

클로드 코드에 익숙해지려면 첫 주에 작은 연습을 몇 가지 해 보세요. 첫날은 한 페이지 안내 사이트, 둘째 날은 체크리스트 앱, 셋째 날은 엑셀 파일을 읽어 표로 보여 주는 화면을 만들어 봅니다. 그다음에는 이 중 하나를 골라 인터넷에 올려 보세요. 일주일 동안 이렇게 해 보면 요청하고, 확인하고, 고치고, 저장하는 흐름이 몸에 익습니다.

함께 읽으면 좋은 글: 바이브코딩 툴 추천 — 클로드 코드 vs 커서, 바이브코딩이란? 뜻과 원리, 장단점

정리

데스크톱 앱을 설치하고, 코드 탭에서 작업 폴더를 고르고, 첫 대화를 보내면 클로드 코드를 시작할 수 있습니다. 권한 요청은 읽어 보고 허락하고, 첫 결과물은 작게 만들어 직접 확인하는 것부터 시작하세요.

바이브코딩 가이드 — 함께 읽으면 좋은 글