공식 문서 · 03

첫 세션 따라하기

claude 실행 → 첫 질문 → 첫 수정 → 승인까지. 화면 그대로 손으로 따라 해본다.

성격 실습환경 Windows소요 약 15분
리듬첫 세션의 흐름

질문 → 제안 → 승인 → 반영

Claude Code의 기본 리듬은 단순하다. 내가 말로 시키면, Claude가 바꿀 내용을 미리(diff로) 보여주고, 내가 승인하면 반영한다. 이 리듬만 익히면 나머지는 응용이다.

STEP 1·2시작

폴더로 가서 claude 실행

작업할 폴더로 이동한 뒤 claude를 실행하면 대화창(REPL)이 뜬다.

Windows PowerShell
cd C:\Users\나\Documents\my-app
claude
Claude Code · model: sonnet · C:\Users\나\Documents\my-app
무엇을 도와드릴까요?
_
프롬프트가 떴다면이제부터는 한국어로 그냥 말하듯 입력하면 된다. 명령어를 외울 필요 없다.
STEP 3첫 질문

이 프로젝트가 뭔지 물어보기

가장 안전한 첫 질문은 "이거 뭐 하는 코드야?"다. Claude가 폴더를 읽고 요약해준다.

claude — 대화
나
이 프로젝트는 뭘 하는 코드야?
CLAUDE

폴더의 파일을 살펴봤습니다. 이 프로젝트는 간단한 할 일 관리 웹앱입니다.

  • 기술: Node.js + Express, 프런트는 순수 HTML/JS
  • 진입점: server.js
  • 주요 파일: routes/todo.js(API), public/(화면)

특정 부분을 더 깊이 볼까요?

이런 질문도주요 진입점이 어디야? · 이 시스템 구조를 설명해줘 · 데이터 흐름을 따라가줘
STEP 4·5첫 수정

고쳐달라고 하면 미리보기부터 준다

수정을 요청하면 Claude는 바로 고치지 않고, 바뀔 내용을 diff로 먼저 보여준다. 내가 y로 승인해야 반영된다.

claude — 대화
나
server.js 맨 위에 시작 로그 한 줄 추가해줘
CLAUDE

다음과 같이 수정하려 합니다:

server.js
+ console.log('서버를 시작합니다...');

적용할까요? (y/n)

나
y
CLAUDE

✓ server.js를 수정했습니다.

승인 화면에서키결과
반영한다y 또는 Enter수정 적용
거절한다n적용 안 함
방향을 바꾼다수정 지시를 입력"로그 대신 주석으로"처럼 바로 재지시
멈추고 싶을 때Claude가 뭔가 열심히 하는 중이라도 Esc를 누르면 즉시 멈춘다. 대화 기록은 남으니 이어서 다시 지시하면 된다.
STEP 6git · 종료

변경 확인하고 마무리

claude — 대화
나
방금 뭐가 바뀌었어?
CLAUDE

server.js 1개 파일, 시작 로그 1줄이 추가됐습니다.

나
이 변경 커밋해줘
CLAUDE

✓ 커밋 완료: "서버 시작 로그 추가"

대화를 끝내려면 Ctrl+D를 두 번 누르거나 /exit를 입력한다.

팁@파일 참조

특정 파일을 콕 집어 말하기

메시지에 @를 붙이면 파일·폴더를 정확히 지목할 수 있다.

@routes/todo.js 이 파일이 하는 일을 설명해줘
@public 폴더 구조를 알려줘
실습따라하기

빈 폴더에서 처음부터

실습 2

연습 폴더에서 첫 대화 · 첫 파일 만들기

약 10분

고칠 코드가 아직 없어도 괜찮다. 연습용 빈 폴더를 만들어 Claude에게 파일을 만들게 해본다.

  1. PowerShell에서 연습 폴더를 만들고 들어간다:
    mkdir C:\claude-practice ; cd C:\claude-practice
  2. claude 실행.
  3. 첫 지시: 간단한 인사말을 출력하는 hello.py 파일을 만들어줘
  4. Claude가 보여주는 diff를 읽고 y로 승인.
  5. 확인: 방금 만든 파일 내용을 보여줘
  6. 마무리: /exit 로 종료.
예상 결과

✓ 폴더에 hello.py가 생기고, 안에는 print("안녕하세요") 비슷한 한 줄이 들어 있다.
✓ 파일 생성 전에 Claude가 내용을 미리 보여주고 승인을 물었다면 정상 흐름을 경험한 것이다.
응용: "여기에 이름을 입력받아 인사하도록 바꿔줘"라고 이어서 시켜보자 — 같은 리듬(제안→승인)이 반복된다.

다음공식 문서 → 04 자주 쓰는 워크플로에서 버그 수정·테스트·리팩터링 같은 실제 작업 패턴을 익힌다. ▸ 워크플로 보기
클로드코드 시작하기공식 문서 · 03 첫 세션 따라하기