Claude 가이드

클로드 코드 사용법: 연습용 폴더에서 첫 작업 시작하기

4분 읽기수정 유튜브 「메이커 에반」을 만드는 스킬샵 운영자

Claude Code는 프로젝트의 파일을 읽고 수정하고 명령을 실행할 수 있는 AI 도구예요. 이 글에서는 터미널에서 시작하는 방법을 다뤄요. 연습용 폴더에서 파일 목록을 읽게 한 뒤 새 파일을 만들어 보고, 변경 내용을 직접 확인하면 작업 방식에 익숙해질 수 있어요.

스킬샵 코딩 카테고리 화면. 바이브코딩 스타터킷을 비롯한 코딩 스킬 카드가 격자로 놓여 있다.
스킬샵에서 관련 작업의 스킬과 사용 예시를 살펴볼 수 있어요.

Claude Code로 무엇을 할 수 있나요?

Claude Code는 작업 폴더의 코드를 읽고 수정하거나 명령을 실행할 수 있어요. 문서 정리와 파일 변환처럼 코드 작성 외의 작업에도 사용할 수 있고 한국어로 요청할 수 있어요.

사용 가능한 도구와 권한에 따라 처리 범위가 달라져요. 이 글은 터미널 사용을 기준으로 설명하며, 설치와 지원 환경은 공식 안내에서 확인해 주세요.

웹 대화창
  • 결과는 화면 안의 글로 끝나요
  • 내가 복사해서 옮겨 붙여요
  • 파일 업로드나 연결 기능에 따라 접근 범위가 달라요
클로드 코드
  • 결과는 바뀐 파일로 남아요
  • 옮겨 붙일 일이 없어요
  • 지금 열어 둔 폴더를 통째로 읽어요
Claude Code는 작업 폴더의 코드를 읽고 수정하거나 명령을 실행할 수 있어요.

계정과 연습용 폴더를 준비해요

운영체제에 맞는 설치 방법과 사용할 계정을 공식 문서에서 확인해요. 터미널을 처음 쓴다면 설치 명령을 입력할 창과 작업 폴더로 이동하는 방법부터 익혀 보세요.

연습용 폴더에 민감하지 않은 파일 몇 개를 복사해 두면 좋아요. 실행 전에 현재 위치가 그 폴더인지 확인하고, 중요한 원본을 바꾸는 작업은 복사본에서 먼저 해 보세요.

명령 창운영체제에 맞는 터미널과 설치 환경을 준비해요
계정설치 방법과 요금제는 공식 안내를 따라요. 자주 바뀌어요
작업 폴더실행한 곳이 곧 작업 대상이다. 연습용 폴더부터 시작해요
운영체제에 맞는 설치 방법과 사용할 계정을 공식 문서에서 확인해요.
Claude Code 설치 절에 네이티브 설치·Homebrew·WinGet 탭이 있고, macOS·리눅스·WSL 은 curl 한 줄, 윈도우는 PowerShell 과 CMD 용 명령이 따로 붙어 있다.
공식 문서의 화면 예시예요. 현재 설정은 연결된 공식 안내에서 확인해 주세요.출처: 클로드 코드 공식 문서 · 빠른 시작

파일 읽기, 만들기, 수정하기 순서로 해 봐요

첫 요청은 ‘이 폴더의 파일 목록과 용도를 정리해 줘. 파일은 수정하지 마’처럼 읽는 작업으로 해 보세요. AI가 어떤 파일을 확인했는지 응답과 함께 살펴봐요.

그다음 새 문서 하나를 만들게 하고 직접 열어 확인해요. 기존 파일을 수정할 때는 복사본이나 버전 기록을 남긴 뒤 변경 전후를 비교해 주세요.

STEP 1읽어요훑어만 보게 시키면 망가질 것이 없어요
STEP 2만들어요새 파일 하나를 만들고 내용을 열어 확인해요
STEP 3고쳐요되돌릴 방법을 만들어 두고 시작해요
첫 요청은 ‘이 폴더의 파일 목록과 용도를 정리해 줘.

대상과 결과 형식을 구체적으로 알려 주세요

‘자료를 정리해 줘’보다 ‘이 폴더의 CSV를 합쳐 result.csv로 저장해 줘’처럼 입력과 결과를 알려 주면 작업 범위가 분명해져요. 수정하면 안 되는 파일과 확인할 조건도 함께 적어요.

결과가 다르면 ‘날짜 열을 YYYY-MM-DD로 맞춰 줘’처럼 고칠 부분을 짚어 주세요. 큰 작업은 중간 결과를 확인할 수 있는 단위로 나누면 문제를 찾기 쉬워요.

하지 말 것건드리지 말 폴더와 쓰지 말 형식을 먼저 적어요
확인할 결과행 수나 테스트처럼 확인 가능한 조건을 적어요
한 번에 하나결과를 확인할 수 있는 단위로 작업을 나눠요
‘자료를 정리해 줘’보다 ‘이 폴더의 CSV를 합쳐 result.csv로 저장해 줘’처럼 입력과 결과를 알려 주면 작업 범위가 분명해져요.

파일·지침·결과·권한을 확인해요

파일을 못 찾으면 현재 폴더와 요청한 경로부터 확인해요. 중요한 지침이 반영되지 않으면 실제로 읽은 문서와 적용 범위를 살펴봐 주세요.

완료됐다는 응답만으로 판단하지 말고 생성된 파일을 열어 봐요. 권한 요청이 나오면 어떤 명령이 어느 파일이나 외부 서비스에 영향을 주는지 읽은 뒤 진행해 주세요.

폴더가 달라요확인해요지금 어느 곳에서 실행됐는지부터 봐요
대화가 길어요규칙 유실중요한 지침이 계속 반영되는지 확인해요
말과 결과가 달라요직접 확인고쳤다고 해도 파일을 열어 봐요
다 허용해 뒀다위험묻는 단계가 사라지면 지나간 줄도 알기 어려워요
파일을 못 찾으면 현재 폴더와 요청한 경로부터 확인해요.

외부에 영향을 주는 작업은 결과를 검토해요

새 초안이나 파일 정리는 비교적 확인하고 고치기 쉬워요. 메일 발송, 공개 게시, 결제, 삭제는 대상과 결과를 검토할 단계가 필요해요.

매번 같은 경계를 설명한다면 CLAUDE.md에 적어 두세요. 지침 파일을 남기면 다음 작업에서도 참고할 수 있지만, 중요한 실행 결과는 여전히 확인해야 해요.

사람이 정하는 일작업 목적과 변경할 범위를 먼저 정해요
승인을 받고 나가는 일발송·결제·게시·삭제의 대상과 결과를 검토해요
그냥 맡겨도 되는 일새로 만들기와 형식 맞추기, 초안 쓰기. 결과가 나빠도 지우면 돼요
새 초안이나 파일 정리는 비교적 확인하고 고치기 쉬워요.

반복한 요청은 스킬로 저장해요

같은 준비물과 절차를 반복해서 설명하고 있다면 SKILL.md로 정리해 보세요. 언제 쓰는지, 무엇을 입력하는지, 어떤 결과를 만들고 어떻게 확인하는지 적으면 돼요.

스킬 폴더를 지원되는 위치에 둔 뒤 실제로 호출해 보세요. 팀과 공유할 때는 필요한 프로그램과 예시 입력도 같이 알려 주면 처음 사용하는 사람이 따라 하기 좋아요.

같은 설명을 또 해요반복해서 설명하는 요청을 모아 봐요
파일에 적어요SKILL.md에 작업 절차를 적고 필요한 자료를 함께 둬요
도구가 먼저 읽어요작업을 시작하기 전에 그 파일부터 봐요
팀이 같이 써요고치면 그다음 작업부터 바로 반영돼요
같은 준비물과 절차를 반복해서 설명하고 있다면 SKILL.md로 정리해 보세요.

자주 묻는 질문

클로드 코드를 쓰려면 무엇을 준비해야 하나요?

운영체제에 맞는 설치 환경과 사용할 계정을 공식 안내에서 확인해요. 터미널을 처음 쓴다면 명령을 입력하고 작업 폴더로 이동하는 방법부터 익혀 보세요. 연습용 폴더에 민감하지 않은 파일을 복사하고 현재 위치가 맞는지 확인한 뒤 시작하면 좋아요.

클로드 코드로 처음에 무엇을 시켜 보면 좋나요?

‘이 폴더의 파일 목록과 용도를 정리해 줘. 파일은 수정하지 마’처럼 읽는 작업부터 해 보세요. 다음에는 새 파일을 만들고 직접 열어 확인해요. 기존 파일을 수정할 때는 복사본이나 버전 기록을 남긴 뒤 변경 전후를 비교해 주세요.

클로드 코드를 쓸 때 자주 막히는 곳은 어디인가요?

파일을 못 찾으면 현재 폴더와 경로를, 지침이 반영되지 않으면 실제로 읽은 문서와 적용 범위를 확인해요. 완료 응답 뒤에도 결과 파일을 직접 열어 봐 주세요. 권한 요청은 어떤 명령이 어디에 영향을 주는지 읽고 판단하면 돼요.

참고 자료