AI 활용

클로드 코드 사용방법, 첫 요청부터 결과 확인까지

목차 보기

클로드 코드(Claude Code)는 프로젝트 파일을 읽고, 말로 받은 요청에 따라 코드를 고치는 AI 도구입니다. VS Code에서 프로젝트 폴더를 열고, 작은 수정 하나를 요청한 뒤, 바뀐 파일과 화면을 확인하는 순서로 시작하면 됩니다.

이 글은 VS Code 확장으로 처음 사용하는 사람을 위한 안내입니다. 계정·설치 조건과 화면 동작은 2026년 10월 9일 공식 문서로 확인했습니다. 아래 홈페이지 수정 요청은 방법을 이해하기 위한 예시입니다.

시작 전에 필요한 것

준비 쉽게 설명하면
VS Code 1.94.0 이상 프로젝트 파일을 열고 수정하는 편집기
Claude Code를 쓸 수 있는 계정 유료 Claude 구독이나 별도 사용료를 내는 Console 계정
작업할 프로젝트 폴더 홈페이지 파일처럼 AI가 읽고 고칠 파일이 모인 곳

개인 구독에서는 Pro·Max에 Claude Code가 포함됩니다. 무료 Claude 플랜에는 포함되지 않습니다. 가격과 한도는 클로드 요금제 비교에서 확인할 수 있습니다.

VS Code 확장은 채팅에 필요한 실행 도구를 포함하므로 확장 패널만 쓸 때는 터미널용 Claude Code를 따로 설치하지 않아도 됩니다. 터미널은 명령어를 입력하는 창이고, CLI는 이 창에서 명령어로 도구를 쓰는 방식입니다. 터미널에 claude를 입력해 실행하려면 별도 CLI 설치가 필요합니다. 공식 VS Code 안내

확장은 되는데 claude 명령을 못 찾는다면

확장 설치와 CLI 설치는 별개입니다. 확장 패널만 사용한다면 claude 명령이 없어도 그 자체로 오류는 아닙니다. 터미널 방식도 쓰려면 운영체제별 공식 설치 안내를 따릅니다.

CLI를 설치했다면 새 터미널에서 claude --version으로 실행 여부를 확인합니다. 여전히 명령을 찾지 못하면 PATH, 즉 명령어가 있는 폴더를 찾는 목록을 확인합니다. 실행은 되지만 설정 문제가 있다면 claude doctor의 진단을 볼 수 있습니다. 명령 자체를 찾지 못할 때는 doctor도 실행되지 않으므로 공식 PATH 해결 안내를 먼저 봅니다.

1. 확장을 설치하고 로그인하기

VS Code의 확장 메뉴에서 Claude Code를 검색해 설치합니다. Windows·Linux에서는 Ctrl+Shift+X, Mac에서는 Cmd+Shift+X로 확장 메뉴를 열 수 있습니다.

파일 메뉴에서 작업할 폴더를 열고 파일 하나를 선택합니다. 편집기 오른쪽 위의 Spark 아이콘으로 Claude Code 패널을 열 수 있습니다. 처음에는 로그인 화면이 나오고, 브라우저에서 계정을 인증합니다. 설치·로그인 절차

폴더는 작업 대상입니다. 바탕화면 전체처럼 관계없는 파일이 많은 곳보다 이번에 고칠 프로젝트 하나를 여는 편이 요청 범위를 설명하기 쉽습니다.

2. 먼저 파일을 설명해 달라고 요청하기

처음부터 사이트 전체를 고치기보다 파일을 읽고 구조를 설명해 달라고 요청합니다.

이 폴더의 홈페이지 구조를 설명해줘. 제목이 어느 파일에 있는지 알려주고, 아직 수정하지는 마.

답변에서 파일 이름과 수정 위치를 확인합니다. 내용이 이해되지 않으면 “이 파일이 화면의 어느 부분을 담당하는지 쉽게 설명해줘”라고 이어서 물어보면 됩니다.

AI가 읽은 위치가 내가 고치려는 페이지와 같은지도 확인합니다. 예를 들어 소개 페이지를 바꾸려는데 홈페이지 파일을 찾았다면 실행 전에 대상을 바로잡습니다.

3. 작은 변경 하나를 요청하기

첫 작업은 결과를 눈으로 확인할 수 있는 변경이 좋습니다. 제목 하나를 바꾸는 예시는 다음과 같습니다.

홈페이지 제목을 ‘Simply AI’로 바꿔줘. 제목 문구만 수정하고 글꼴, 다른 문장, 배치는 그대로 둬. 바꾼 파일과 확인 방법을 알려줘.

요청에 넣을 것은 무엇을 바꿀지, 어디까지 바꿀지, 어떻게 확인할지입니다. “사이트를 깔끔하게 만들어줘”보다 원하는 결과를 비교하기 쉽습니다.

여러 요청이 있다면 제목을 먼저 확인하고 다음 작업으로 넘어갑니다. 문제가 생겼을 때 어느 변경부터 확인해야 할지 분명해집니다.

4. 권한 요청은 대상과 동작을 읽기

권한은 AI가 파일을 고치거나 명령을 실행해도 되는 범위를 말합니다. VS Code 패널의 권한 모드에 따라 파일 편집을 바로 진행하기도 하고, 변경안을 보여준 뒤 허락을 묻기도 합니다. 자동 모드가 작업 결과의 정확성을 보장하는 것은 아닙니다. 공식 권한 모드 안내

하려는 동작 확인할 것
파일 수정 요청한 페이지와 문구를 바꾸는가
검사 명령 실행 해당 프로젝트를 검사하는 명령인가
파일 삭제 무엇을 지우며 되돌릴 방법이 있는가
서버 업로드 로컬 수정에서 실제 사이트 공개까지 범위가 바뀌는가

삭제나 운영 서버 변경이 갑자기 등장하면 “이 작업이 지금 요청에 왜 필요한지 먼저 설명해줘”라고 확인합니다. 낯선 명령은 의미를 물어본 뒤 판단할 수 있습니다.

5. ‘완료’ 답변보다 바뀐 결과 확인하기

AI가 작업을 끝냈다고 하면 바꾼 파일과 검사 결과를 함께 봅니다. 변경 비교 화면을 diff라고 부르는데, 수정 전후 무엇이 달라졌는지 나란히 보여주는 화면입니다.

제목 수정이라면 다음 세 가지를 확인합니다.

  1. 파일: 요청한 제목이 바뀌고 다른 내용은 그대로인가.
  2. 검사: 프로젝트에 빌드나 테스트가 있다면 통과했는가. 빌드는 파일을 실제 사이트로 만드는 과정입니다.
  3. 화면: 미리보기에서 제목이 보이고 모바일에서도 잘리지 않는가.

검사 명령을 모르면 “이 프로젝트에 있는 확인 명령을 찾아 실행하고 결과를 알려줘”라고 요청합니다. 단순 문구 수정에 관계없는 새 검사까지 만들 필요는 없습니다.

화면이 예상과 다르면 증상을 구체적으로 전달합니다. “이상해”보다 “모바일에서 제목의 마지막 글자가 잘려”가 수정 위치를 찾는 데 도움이 됩니다.

원치 않는 수정이 섞였다면 커밋 전에 내 수정은 보존하고 되돌리는 방법을 확인합니다. 같은 파일의 변경 전체를 취소하면 직접 고친 내용도 함께 사라질 수 있습니다.

저장과 실제 사이트 공개는 별개

로컬 파일을 고쳤다고 인터넷의 사이트까지 바뀌지는 않습니다. Git을 쓰는 프로젝트에서 커밋은 변경 기록을 남기는 일, 배포는 그 결과를 실제 사이트에 올리는 일입니다.

먼저 변경과 화면을 확인하고, 필요한 때 커밋·배포를 요청합니다. minml의 실제 공개 절차는 Astro 블로그 발행 흐름과 릴리스 배포·되돌리기에 따로 정리했습니다.

실제 작업은 이렇게 나눴습니다

2026년 9월 26일 minml을 점검할 때도 먼저 읽기와 점검을 요청하고, 결과를 본 뒤 수정을 지시했습니다. 수정 후에는 글·링크·이미지 검사와 화면 확인을 거쳐 공개했습니다.

처음 사용하는 사람에게 중요한 것은 같은 규모의 작업을 따라 하는 것이 아니라, 점검 → 작은 수정 → 결과 확인의 순서를 익히는 것입니다. AI에게 맡길 일과 직접 결정할 일은 작업 분담 기준에, 반복해서 설명하는 규칙을 파일로 남기는 방법은 하네스와 규칙 파일에 이어집니다.

첫 로컬 작업을 익힌 뒤 노션 같은 외부 서비스의 자료도 다루고 싶다면 MCP의 뜻과 필요한 상황을 확인합니다. 연결부터 추가하기 전에 현재 기본 기능으로 충분한지 판단할 수 있습니다.

공식 자료

2026년 10월 9일 확인