본문에서 다룰 내용
Claude Code를 추가한 후, 처음 한 번에 무엇을 요청하고 어떤 화면에서 무엇을 확인할지. 이 글에서는 '확인 모드로 설정하여, 읽기 요청부터 시작해 쓰기 차이점(diff)을 읽고 승인하는' 흐름만을 설명합니다. 사용된 화면은 연습용 폴더(공휴일 CSV 파일과 이를 월별로 계산하는 짧은 Python 스크립트 2개. Git으로 관리)이며, 2026년 10월 12일에 실제로 조작하여 촬영한 것입니다.
1. 실행하고, 확인 모드로 설정하기
폴더 안에서 claude를 입력하여 실행합니다. 촬영된 환경에서는 실행 직후 왼쪽 하단 표시가 'auto mode on'(확인 없이 진행하는 모드)였습니다. Shift+Tab을 한 번 누르면 'manual mode on'(변경이나 명령어 전에 확인이 들어오는 모드)으로 바뀝니다. 익숙해질 때까지는 manual로 설정해 두는 것이 안전합니다.
練習用フォルダで claude を起動し、Shift+Tab で manual mode on に切り替えた画面
2. 읽기 전용 요청부터 시작하기
첫 번째 요청은 변경 범위가 작고, 결과를 직접 눈으로 확인할 수 있는 것을 선택합니다. 예를 들어 다음과 같은 요청입니다.
Claude Code는 파일 내용을 조사하는 명령을 실행하기 전에 확인 절차를 거칩니다. 표시된 명령을 읽고, 'Yes'를 선택한 후 Enter를 누릅니다.
コマンドを実行する前の確認画面。Do you want to proceed? に Yes・No などの選択肢が並んでいる
3. 쓰기를 요청하고, 차이점(diff) 읽기
다음으로 작은 쓰기 작업을 요청합니다.
README.md 파일을 만들고, 이 폴더의 개요와 count_holidays.py의 실행 방법을 작성해줘
'무엇을', '어디에', '어떤 방향으로'라는 3가지 요소가 포함되어 있으면 동작이 안정적입니다. '수정해줘', '테스트 코드를 써줘'와 같은 모호한 요청보다는, '파일명・기대하는 동작・지켜줬으면 하는 방침'까지 작성하는 것이 의도한 결과에 더 가깝습니다.
쓰기 작업을 하기 전에 다음 확인 화면이 나타납니다. 쓰게 될 내용이 줄 번호와 함께 표시되며, 그 아래에서 'Yes', 'Yes(이후 세션에서는 편집을 자동으로 승인)', 'No' 중에서 선택합니다.
README.md を作る前の確認画面。書き込む内容が行番号つきで表示され、Do you want to create README.md? と聞かれている
4. 승인하기 전에 확인해야 할 3가지
- 추가되는 줄(+): 의도한 내용인지
- 사라지는 줄(−): 사라지면 안 되는 처리(기존 파일 덮어쓰기 시)가 포함되어 있지 않은지
- 변경 범위: 요청하지 않은 파일이 대상에 포함되지는 않았는지
의미를 알 수 없을 때는 그 자리에서 '이 변경의 의도를 설명해줘'라고 되물을 수 있습니다. 차이점(diff)이 너무 크다고 느껴진다면, 요청을 작게 나누라는 신호입니다. '일단 승인'만 반복하다 보면, 의도하지 않은 변경 사항이 쌓여 나중에 원인을 찾기 어려워집니다.
5. 끝난 후에는 git status로 확인하기
작업 후에 git status --short를 실행하면, 늘어나거나 바뀌게 된 파일들을 Claude Code의 보고와 별개로 확인할 수 있습니다.
아래는 위의 세션을 마친 후의 결과입니다. 추가된 파일은 README.md 뿐입니다.
Claude Code を終了したあとに git status --short を実行した画面。README.md が新しいファイルとして表示されている
6. 실수로 승인했을 때
Claude Code는 요청을 보낼 때마다 파일 상태를 기록합니다(체크포인트). 입력창이 비어 있는 상태에서 /rewind를 입력하거나 Esc 키를 두 번 누르면, 되돌리고 싶은 시점을 선택할 수 있습니다. 파일과 대화 모두, 대화만, 파일만 중에서 선택할 수 있습니다 (공식 문서 'Checkpointing', 2026년 10월 16일 확인).
요약
- Shift+Tab으로 manual mode로 설정하여, 확인이 들어오는 상태로 만듭니다.
- 처음에는 '폴더에 무엇이 있는지'와 같은 읽기 요청부터 시작합니다.
- 쓰기는, + 줄・− 줄・변경 범위 3가지를 읽은 후에 승인합니다.
- 끝난 후에는
git status --short
로 증감한 파일을 확인합니다.
- 시작 전체 과정(설치부터 CLAUDE.md, 권한 모드까지)은 → Claude Code 시작 방법 (초보자가 먼저 할 일)
- Claude Code로 가능한 것 및 요금제 전반은 → Claude Code 입문 가이드
Discussion
