이 글에는 쿠팡 파트너스 링크가 있으며, 구매 시 일정액의 수수료를 받습니다.
클로드 데스크톱 로컬 모드 사용법, 개발 초보의 클로드 코드 첫걸음
클로드 데스크톱 로컬 모드는 내 컴퓨터의 폴더를 클로드 코드가 직접 읽고 파일을 만들게 하는 작업 방식입니다. 개발이 처음인 사람이 클로드 코드를 어디서부터 시작하면 좋은지 다섯 가지 방법을 12단계로 나누고, 영상이 건너뛴 로컬 모드 전환 위치와 그대로 붙여 넣을 요청 문구 예시를 편집자 정리에 더했습니다.
56초 쇼츠가 꼽은 클로드 코드 입문 방법 다섯 가지
나민수 AI 채널의 56초 쇼츠입니다. 핵심은 브라우저나 모바일이 아니라, 내 컴퓨터의 연습용 폴더와 클로드 데스크톱 앱 로컬 모드로 시작하라는 겁니다.
화자는 "이 프로그램 대박입니다."로 시작해 "세 달도 안 써 본 사람이 클로드 코드로 로컬 파일을 만들었습니다"라고 말합니다. 그 사람이 누구인지, 무엇을 만들었는지는 발화에 없습니다.
이어서 클로드 코드 입문 방법 다섯 가지를 차례로 말합니다.
- 첫째, 시작 전에 구독과 API를 구분한다.
- 둘째, 채팅 화면에서 모델, 프로젝트, 아티팩트, 앱과 확장 프로그램의 위치를 익힌다.
- 셋째, 개발이 처음이면 브라우저나 모바일 클로드 코드부터 시작하지 않는다.
- 넷째, 컴퓨터에 연습용 폴더를 만들고 데스크톱 앱 로컬 모드에서 작업을 요청한다.
- 다섯째, 기존 프로젝트가 있으면 폴더와 파일부터 읽게 하고 무엇을 하는 프로젝트인지 설명하게 한다.
화자는 이 내용이 24분짜리 영상을 정리한 것이라고 말합니다.
아래는 다섯 가지를 따라 할 수 있는 동작 단위 12단계로 나눈 것입니다. 셋째 방법은 하지 말라는 주의라서 동작 단계로 세지 않고 3장 앞에 주의로 넣었습니다.
준비물
- 클로드 계정. 클로드 코드를 쓸 수 있는 플랜인지는 1단계에서 확인합니다.
- 클로드 데스크톱 앱. 설치 방법은 영상에서 건너뛰어, 편집자 정리에 적었습니다.
- 연습용 폴더를 만들 수 있는 컴퓨터(맥 또는 윈도우)
- 이미 가지고 있는 프로젝트 폴더(4장만 해당)
- 비용은 플랜에 따라 다르고, 금액은 발화에 없습니다. 요금은 바뀌는 값이라 클로드 공식 요금 안내를 확인해야 합니다.
1장. 시작 전에 구독과 API 구분하기
- 내 플랜에서 클로드 코드를 쓸 수 있는지 확인합니다.
- 화자는 클로드 코드 사용 가능 여부를 플랜별로 확인하라고 합니다.
- 위치: 영상에는 확인 화면이 나오지 않습니다. 클로드 웹이나 앱의 설정 안 요금제(결제) 항목에서 지금 쓰는 플랜 이름을 보고, 클로드 공식 요금 페이지에서 그 플랜에 클로드 코드가 포함되는지 대조하면 됩니다.
- 확인: 내 플랜이 클로드 코드를 쓸 수 있는 플랜인지 알게 됩니다.
- 주의: API는 구독과 "별도 체계로" 생각하라고 합니다. 구독은 월정액으로 정해진 사용 한도 안에서 쓰는 방식이고, API(프로그램끼리 연결해 쓰는 통로)는 쓴 만큼 따로 돈을 내는 방식입니다. 결제 화면도 따로입니다.
2장. 채팅 화면 위치 익히기
화자는 채팅 화면에서 네 가지 메뉴의 위치를 익히라고 합니다. 화면 어디에 있는지는 영상에 나오지 않아, 일반적인 자리를 함께 적었습니다. 앱 버전에 따라 자리가 바뀔 수 있습니다.
- 채팅 화면에서 '모델' 위치를 찾습니다.
- 위치: 보통 입력창 근처에 지금 쓰는 모델 이름(예: Opus, Sonnet)이 적힌 버튼이 있습니다.
- 확인: 모델을 고르는 곳을 찾았습니다.
- 채팅 화면에서 '프로젝트' 위치를 찾습니다.
- 위치: 보통 왼쪽 사이드바에 있습니다. 프로젝트는 관련 대화와 자료를 한데 묶어 두는 공간입니다.
- 확인: 프로젝트 메뉴를 찾았습니다.
- 채팅 화면에서 '아티팩트' 위치를 찾습니다.
- 아티팩트는 클로드가 대화 옆 창에 따로 만들어 보여 주는 문서, 코드, 간단한 웹 화면 같은 결과물입니다.
- 확인: 아티팩트 메뉴를 찾았습니다.
- 채팅 화면에서 '앱과 확장 프로그램' 위치를 찾습니다.
- 확인: 앱과 확장 프로그램 메뉴를 찾았습니다.
- 브라우저, 모바일, 데스크톱에서 어떤 기능을 쓸 수 있는지 살펴봅니다.
- 확인: 환경마다 쓸 수 있는 기능이 어떻게 다른지 알게 됩니다.
3장. 연습용 폴더와 로컬 모드로 시작하기
주의: 개발이 처음이면 브라우저·모바일 클로드 코드부터 시작하지 마세요 (셋째 방법)
화자가 든 이유는 이렇습니다. 그 환경은 로컬(내 컴퓨터)에서 작업할 수 없고 깃허브(코드를 인터넷에 저장하고 버전을 관리하는 서비스)를 거쳐야 한다는 겁니다. 그래서 깃허브의 기본 구조를 익힌 뒤 필요할 때 쓰라고 합니다.
자막에는 깃허브가 '기터브', '기처브'로 찍혀 있습니다. 뒷부분도 자막은 "익힌 뒤할 때"로 끊겨 있는데, 더보기란에는 "익힌 뒤 필요할 때"로 적혀 있습니다.
- 컴퓨터에 연습용 폴더를 하나 만듭니다.
- 위치: 폴더를 어디에 만들지, 이름을 뭐로 할지는 영상에 없습니다. 문서 폴더나 바탕화면에
claude-practice처럼 영어와 숫자로 된 이름을 쓰면 나중에 경로를 다룰 때 덜 헷갈립니다. - 확인: 빈 연습용 폴더가 생깁니다.
- 위치: 폴더를 어디에 만들지, 이름을 뭐로 할지는 영상에 없습니다. 문서 폴더나 바탕화면에
- 클로드 데스크톱 앱을 로컬 모드로 바꿉니다.
- 순서 고정: 화자는 "로컬 모드로 바꾸고 폴더를 선택한 뒤" 요청하라고 말합니다. 8단계, 9단계, 10단계 순서를 바꾸지 않습니다.
- 위치: 영상은 메뉴 위치를 말하지 않습니다. 데스크톱 앱에서는 클로드 코드 화면(Code 탭)으로 들어가 새 작업을 시작할 때 실행 위치를 로컬(Local)과 원격(클라우드) 가운데서 고르는 방식입니다. 자세한 순서는 편집자 정리에 적었습니다.
- 확인: 앱이 로컬 모드 상태가 됩니다.
- 7단계에서 만든 폴더를 선택합니다.
- 순서 고정: 로컬 모드로 바꾼 다음에 선택합니다.
- 확인: 앱에 연습용 폴더가 선택됩니다. 처음 여는 폴더면 이 폴더를 믿고 작업해도 되는지 묻는 창이 뜰 수 있고, 연습용 폴더이니 허용하면 됩니다.
- 만들고 싶은 작업을 구체적으로 요청합니다.
- 순서 고정: 폴더를 선택한 다음에 요청합니다.
- 확인: 연습용 폴더에 클로드가 만든 파일이 생겼는지 파일 탐색기(맥은 Finder)로 열어 봅니다.
- 화자가 붙인 조건은 '구체적으로'뿐입니다. 무엇을, 어떤 모양으로, 어떤 파일로 만들지를 적은 요청 예시는 편집자 정리에 있습니다.
4장. 기존 프로젝트를 읽고 설명하게 하기
기존 프로젝트가 있을 때만 해당합니다.
- 클로드 코드에 기존 프로젝트의 폴더와 파일부터 읽게 합니다.
- 확인: 클로드 코드가 폴더와 파일을 읽습니다.
- 프로젝트가 무엇을 하는지 분석해서 설명하도록 요청합니다.
- 주의: 화자는 "파일 목록만 확인하지 말고"라고 말합니다.
- 확인: 그 프로젝트가 무슨 일을 하는지 설명이 돌아옵니다. 파일 목록만 나열되면 다시 요청합니다.
최종 점검
- 내 플랜에서 클로드 코드를 쓸 수 있는지 확인했다.
- 채팅 화면에서 모델, 프로젝트, 아티팩트, 앱과 확장 프로그램 위치를 찾았다.
- 연습용 폴더를 만들고, 데스크톱 앱 로컬 모드에서 그 폴더를 선택했다.
- 만들고 싶은 작업을 구체적으로 요청했다.
- 기존 프로젝트가 있으면 폴더와 파일을 읽게 하고 프로젝트 설명을 받았다.
로컬 모드 따라 하다 막힐 수 있는 곳
56초짜리라 동작 이름만 있고 방법은 빠져 있습니다. 막힐 수 있는 곳은 두 군데입니다.
8단계, 로컬 모드 전환. 메뉴 위치를 말하지 않습니다. 편집자 정리의 순서를 참고합니다.
10단계, 요청 문구. '구체적으로'라고만 하고 예시가 없습니다. 편집자 정리의 예시를 바꿔 쓰면 됩니다.
화자가 정리했다는 24분짜리 원본 영상(아래 더보기란 링크)에 더 자세한 화면이 나올 수 있으니 함께 확인해 보세요. 원본 영상은 이 글에서 대조하지 않았습니다.
마지막에 화자는 자료가 궁금하면 댓글에 "로컬"을 남기라고 합니다. 그 자료가 무엇인지는 발화에 없고, 수집한 댓글과 더보기란에서도 자료 본문은 확인하지 못했습니다.
더보기란·고정 댓글에서 확인한 것
이 절은 채널이 글로 적은 내용입니다.
- 발화와 같은 다섯 가지 방법이 글로 적혀 있습니다. 내용은 같고 표기만 다릅니다. 깃허브(자막 '기터브', '기처브'), "익힌 뒤 필요할 때"(자막 "익힌 뒤할 때"), "그 폴더를 선택한 뒤"(자막 "폴더를 선택한 뒤")입니다 (더보기란).
- 원본 영상 링크: youtu.be/… (더보기란). 화자가 말한 24분짜리 영상으로 보입니다.
- 설치 명령어, 다운로드 주소, 입력 문구 예시는 더보기란에도 없습니다 (더보기란).
- 채널이 운영하는 교육 과정 신청 링크와 AI 시스템 제작 대행 문의 링크가 있습니다 (더보기란). 채널이 운영하는 교육 과정·제작 대행 안내라 이해관계에 해당하고, 링크는 옮기지 않았습니다.
- 고정 댓글과 채널 주인 댓글은 없습니다.
영상에 없는 배경 (편집자 정리)
여기부터는 영상에서 다루지 않은 내용입니다. 실제로 따라 해 보려면 알아야 하는 것들을 따로 정리했습니다. 앱 메뉴 구성은 버전에 따라 바뀌니 클로드 공식 도움말과 함께 보세요. 아래 요청 문구는 편집자가 만든 예시입니다.
데스크톱 앱 설치와 로그인
- 클로드 공식 사이트(claude.ai)의 다운로드 페이지에서 내 운영체제(맥 또는 윈도우)용 데스크톱 앱을 받습니다.
- 받은 설치 파일을 실행합니다. 맥은 앱을 응용 프로그램 폴더로 끌어다 놓고, 윈도우는 설치 마법사를 따라갑니다.
- 앱을 열고 웹에서 쓰던 클로드 계정으로 로그인합니다.
- 확인: 웹에서 하던 대화 목록이 앱에도 보입니다.
로컬 모드로 바꾸고 폴더 고르기
- 데스크톱 앱 화면에서 클로드 코드 화면(Code 탭)을 엽니다.
- 새 작업(세션)을 시작하는 버튼을 누릅니다.
- 실행 위치를 고르는 곳에서 로컬(Local)을 고릅니다. 원격(클라우드)을 고르면 깃허브 저장소를 연결해야 해서, 화자가 말한 "깃허브를 거쳐야 하는" 방식이 됩니다.
- 폴더 선택 창에서 연습용 폴더를 고릅니다.
- 확인: 화면 어딘가에 선택한 폴더 이름이 표시됩니다. 메뉴 이름이 다르면 공식 도움말에서 "Claude Code desktop"을 검색해 최신 화면을 확인합니다.
10단계에 쓸 구체적인 요청 예시
'구체적으로'는 무엇을, 어떤 모양으로, 어떤 파일로 만들지를 적는다는 뜻입니다.
이 폴더에 내 한 달 지출을 기록하는 간단한 웹페이지를 만들어 줘.
- 파일은 index.html 하나로 만들고, 브라우저에서 더블클릭으로 열 수 있게 해 줘.
- 날짜, 항목, 금액을 입력하면 아래 표에 쌓이고 맨 아래에 합계가 보이게 해 줘.
- 입력한 내용은 브라우저를 닫았다 열어도 남아 있게 해 줘.
- 다 만들면 어떤 파일을 만들었는지, 어떻게 열면 되는지 알려 줘.
11~12단계에 쓸 요청 예시
이 폴더의 파일을 먼저 훑어보고, 파일 목록만 나열하지 말고 아래를 설명해 줘.
1. 이 프로젝트가 무엇을 하는 프로그램인지 한 문단으로
2. 어떤 파일이 시작점이고, 주요 파일이 각각 무슨 역할인지
3. 이 프로젝트를 내 컴퓨터에서 실행하려면 무엇이 필요한지
4. 개발 초보가 먼저 손대 보기 좋은 부분 한 곳
아직 파일은 고치지 마.
마지막 줄처럼 "아직 고치지 마"를 붙이면 설명만 받고 파일이 바뀌는 일을 막을 수 있습니다.
처음 쓸 때 알아 둘 점
- 로컬 모드에서는 클로드 코드가 고른 폴더 안의 파일을 실제로 만들고 고칩니다. 중요한 폴더가 아니라 연습용 폴더부터 쓰라는 화자의 조언이 그래서 맞습니다.
- 파일을 고치거나 명령을 실행하기 전에 허락을 묻는 창이 뜹니다. 무엇을 하려는지 읽어 보고 허용하는 습관을 들이면 안전합니다.
- 기존 프로젝트를 다룰 때는 시작 전에 폴더를 통째로 복사해 백업해 두면 되돌리기 쉽습니다.
자주 묻는 질문
클로드 데스크톱 로컬 모드는 무엇인가요?
클로드 코드가 내 컴퓨터의 폴더를 직접 읽고 파일을 만들거나 고치는 작업 방식입니다. 브라우저·모바일 클로드 코드와 달리 깃허브를 거치지 않아도 되어서, 화자는 개발이 처음인 사람에게 이쪽부터 권합니다.
클로드 코드는 무료 플랜에서도 쓸 수 있나요?
화자는 플랜별로 사용 가능 여부를 확인하라고만 했습니다. 클로드 코드는 유료 구독이나 API 결제가 있어야 쓰는 경우가 많고, 조건은 바뀔 수 있으니 클로드 공식 요금 안내에서 내 플랜을 확인해야 합니다.
구독과 API는 무엇이 다른가요?
구독은 월정액으로 정해진 한도 안에서 쓰는 방식이고, API는 쓴 만큼 따로 비용을 내는 방식입니다. 화자도 API를 구독과 별도 체계로 생각하라고 했습니다. 결제와 사용량 확인 화면도 따로 있습니다.
기존 프로젝트를 클로드 코드에 맡겨도 망가지지 않을까요?
먼저 읽고 설명만 하게 하면 파일은 바뀌지 않습니다. 요청 끝에 "아직 파일은 고치지 마"를 붙이고, 고치기 전에는 폴더를 통째로 백업해 두는 편이 안전합니다.
이 글은 유튜브 자동 자막을 바탕으로 정리했으며 화면은 대조하지 못했습니다. 원 영상은 나민수 AI 채널의 56초 쇼츠이고, 단계는 발화에서 확인한 범위입니다. 데스크톱 앱 설치, 로컬 모드 전환 위치, 요청 문구 예시는 편집자가 덧붙인 것이며, 자막의 '기터브', '기처브'는 깃허브로 옮겼습니다.
출처: youtube.com/…