일상 워크플로 기본기 — 코드 탐색·수정 지시·결과 검토·권한

• 시리즈 3회 · 유형: 기본편 · 주제: 일상 워크플로 기본기 — 코드 탐색·수정 지시·결과 검토·권한
• 선수: 1회차 (1회 「Claude Code란 무엇인가 — 첫걸음」)
• 학습 목표
  • LO-05: 실제 저장소에서 코드 탐색·버그 수정·테스트 실행을 Claude Code에 지시하고, 결과 diff를 검토해 수용/거부를 결정할 수 있다.
  • LO-06: 파일 수정·명령 실행에 대한 권한 확인 요청이 각각 무엇을 허용하는 것인지 구분해 상황에 맞게 허용·거부할 수 있다.
• 확인 시점: 2026-08-23 — 제품 사실(명령·화면 표기·권한 모드(1호 §4.5가 Auto·Manual만 부분 소개한 설정 — 3.6에서 확장)의 명칭과 동작·기능 동작·단축키)은 이 날짜에 Anthropic 공식 문서로 확인했습니다. 진술별 출처는 8장. 화면이 다르게 보이면 공식 문서(https://code.claude.com/docs)를 기준으로 삼으세요.

1. 이번 회차를 마치면 할 수 있는 것

1. 한 바퀴를 스스로 돌릴 수 있다 (LO-05) — 내 저장소(1호 §2)에서 ① 탐색 ② 수정 지시 ③ diff(파일의 수정 전/후 차이를 줄 단위로 보여 주는 변경 내역서 — 1호 §4.5·§7) 검토 ④ 수용/거부 판정 ⑤ 되돌리기(1호 §4.5) ⑥ 테스트 실행 확인까지 혼자 돌릴 수 있습니다.
2. 묻는 창 앞에서 망설이지 않는다 (LO-06) — 권한 확인(도구가 파일 수정·명령 실행 전에 사용자의 허락을 구하는 절차 — 1호 §4.5·§7) 요청이 파일을 고치겠다는 뜻인지, 명령을 실행하겠다는 뜻인지 구분하고, 각각이 무엇을 허용하는 것인지 알고 허용·거부를 고를 수 있습니다.

1회차의 첫 작업 한 사이클을 매일 쓰는 작업 습관으로 바꾸는 회차입니다. 읽기 약 25분, 실습까지 60~90분을 권합니다(필자 제안). 도달 여부는 5장의 퀴즈와 실습 체크리스트로 확인합니다.

2. 대상 독자와 사전 요건

2.1 이 회차를 읽으면 좋은 사람

터미널(명령어를 글자로 입력해 컴퓨터를 조작하는 창)과 Git으로 일하지만 AI에게 작업을 통째로 맡겨 본 적은 많지 않은 분, 1회차를 마치고 "그래서 매일 어떻게 쓰지?"가 궁금한 분이 독자입니다. 코드를 읽지 못하는 분도 3장(개념)과 7장(용어 풀이)은 사전 지식 없이 읽을 수 있습니다. 4장 실습은 터미널 사용을 전제합니다.

2.2 선수 회차

선수는 1회차입니다: 1회 「Claude Code란 무엇인가 — 첫걸음」. 1회차의 설치·로그인·첫 작업 사이클은 끝난 것으로 놓고 시작합니다.

2.3 1회차를 읽지 않았다면 — 최소 요건 자기 확인 3항 (확인 시점: 2026-08-23)

1회차를 건너뛰고 여기부터 읽어도 됩니다. 다만 아래 세 가지가 갖춰져야 4장 실습을 따라올 수 있습니다.

2.4 계정·비용 전제 (확인 시점: 2026-08-23)

공식 시작 가이드가 드는 준비물은 ① 터미널 또는 명령 프롬프트 ② 작업할 코드 프로젝트 ③ Claude 구독(Pro, Max, Team, Enterprise), Claude Console 계정(선불 크레딧을 충전해 쓰는 API 방식의 계정), 또는 지원되는 클라우드 사업자를 경유하는 접근 중 하나입니다. 즉 무료 이용을 전제로 하지 않습니다.

비용 유의: 구체적인 요금액은 변동될 수 있어 적지 않습니다. 결제 전에 공식 요금 페이지(https://claude.com/pricing)에서 현재 금액을 확인하세요.

또 하나. 어떤 요금제를 쓰는지, 어디에서 실행하는지에 따라 세션이 시작하는 권한 모드가 다릅니다. 3.6과 4.1에서 다룹니다.

3. 개념 — 하루의 작업은 여섯 마디로 이루어진다

3.1 전체 그림

Claude Code는 에이전트(agent, 목표를 받으면 필요한 일을 스스로 골라 수행하고 결과까지 확인하는 프로그램 — 1호 §3.1·§7)형 코딩 도구입니다. 1회차에서 공식 문서의 작동 루프를 맥락 파악 → 작업 수행 → 결과 검증의 3단계 반복으로 소개했습니다(1호 §3.2). 이번 회차는 그 루프를 사람 쪽에서 본 여섯 마디로 풉니다.

탐색 → 수정 지시 → diff 검토 → 수용·거부·재지시 → 되돌리기 → 권한 판단

여섯 마디는 순서대로만 흐르지 않습니다. diff가 마음에 안 들면 수정 지시로 되돌아가고, 권한 판단은 중간중간 끼어듭니다. 집을 고치러 온 기술자와 일하는 하루와 같습니다 — 둘러보며 묻고, 고쳐 달라고 말하고, 시안을 보고 답하고, 원상 복구를 요청하고, 그 사이사이 "이 벽 뚫어도 될까요?"에 답합니다.

3.2 탐색 — 고치기 전에 물어보기

탐색은 아직 아무것도 바꾸지 않은 채로 저장소에 대해 묻는 단계입니다. 파일을 붙여 넣을 필요는 없습니다 — 공식 시작 가이드는 "Claude Code가 필요한 프로젝트 파일을 알아서 읽으므로 맥락을 직접 추가하지 않아도 된다"고 안내합니다. 공식 문서의 탐색 질문 예시입니다 (확인 시점: 2026-08-23. 괄호 안 한국어는 필자 번역).

• what does this project do? — 이 프로젝트는 무엇을 하는 프로젝트인가?
• where is the main entry point? — 시작 지점이 어디인가?
• find the files that handle user authentication — 사용자 인증을 담당하는 파일들을 찾아 줘.

세 줄은 넓은 질문에서 좁은 질문으로 내려가는 순서입니다. 공식 문서도 "넓은 질문에서 시작해 특정 영역으로 좁혀 가라"고 권합니다.

3.3 수정 지시와 프롬프트 구체화

지시는 프로그래밍 문법이 아니라 일상 언어(자연어), 즉 평소 말로 내립니다(1호 §3.3). 다만 아무렇게나 말해도 되는 것은 아닙니다.

여기서 새 용어가 나옵니다. 프롬프트 구체화 — 지시문에 대상(어느 파일·어느 기능), 증상이나 목표, 범위, 확인 방법(무엇으로 됐다고 판단하나)을 채워 넣어 애매함을 줄이는 작업입니다. "아파요" 대신 "사흘 전부터 왼쪽 무릎이, 계단 내려갈 때만 아파요"라고 말하면 진료가 빨라지는 것과 같습니다. 아래는 공식 문서의 대비표 — 지시문은 예시 원문이고, 괄호 안 한국어는 필자 번역입니다(짧은 지시문은 번역 생략). 확인 시점: 2026-08-23.

마지막 줄이 특히 중요합니다. 공식 문서의 설명은 이렇습니다. "Claude는 일이 끝난 것처럼 보이면 멈춥니다. 스스로 돌려 볼 수 있는 확인 수단이 없으면 '끝난 것처럼 보인다'가 유일한 신호입니다." 지시문에 테스트를 돌려 보라는 한 줄을 붙이는 것만으로 결과가 달라집니다. 공식 문서는 또 "성공했다고 주장하게 두지 말고 증거를 보여 달라고 하라"고 권합니다.

3.4 diff 검토 — 승인하기 전에 읽는 습관

수정 지시를 내리면 Claude Code는 알맞은 파일을 찾아 변경 내용을 먼저 보여 줍니다. 이 화면이 diff입니다. 계약서에서 바뀐 부분만 빨간 줄로 표시해 주는 것과 같아, 코드를 다 읽지 못해도 어디가 얼마나 바뀌는지는 판단됩니다.

세션 안에서 diff를 보는 방법은 두 가지입니다 (확인 시점: 2026-08-23). ① 권한 확인 화면에 딸려 나오는 변경 제안. ② /diff — 커밋되지 않은 변경과 지시별 변경을 함께 보는 대화형 뷰어를 엽니다. 화살표로 파일 목록을 훑고 Enter로 고른 파일의 diff를 엽니다.

여기서 슬래시 명령어라는 새 용어가 나옵니다. /로 시작해 세션 안에서 입력하는 짧은 명령입니다(예: /help, /diff, /permissions). 터미널에 입력하는 셸 명령(claude, git status)과는 입력하는 자리가 다릅니다. 입력창에 /만 쳐 보면 쓸 수 있는 목록이 뜹니다.

초보자가 diff를 읽는 3단 점검을 권합니다. ① 파일 목록 — 예상한 파일만 바뀌는가? ② 분량 — 한 줄 고쳐 달라고 했는데 200줄이 바뀌면 지시가 너무 넓었던 것입니다. ③ 삭제 줄 — 추가되는 줄보다 사라지는 줄이 위험합니다.

3.5 수용·거부·재지시, 그리고 되돌리기

diff를 읽고 나면 셋 중 하나를 고릅니다. 수용하면 변경이 적용됩니다. 거부하면 적용되지 않는데, 이때 이유를 함께 적어 보낼 수 있습니다: 대부분의 권한 확인 화면에서 Yes 또는 No에 커서를 두고 Tab을 누르면 메모 입력란이 열립니다. No로 보낸 메모는 거부 사유로 전달되고 Claude는 작업을 이어 갑니다(메모 없이 No면 그 작업이 멈춥니다). 재지시는 방향이 틀렸을 때 합니다 — 진행 도중이라면 Esc로 멈출 수 있고, 한 작업은 유지되므로 방향만 바꿔 이어 갑니다.

이미 파일이 바뀐 뒤라면 되돌리기가 있습니다. 1회차가 "Esc 두 번"으로 소개한 동작의 정식 이름이 체크포인트입니다 (확인 시점: 2026-08-23).

• Claude Code는 지시를 보낼 때마다 체크포인트를 하나씩 만들어 그 시점의 코드 상태를 담아 둡니다. 한 세션에서 최근 100개의 파일 스냅샷을 보관하며, 대화와 함께 저장되므로 세션을 다시 이어 붙인 뒤에도 /rewind를 쓸 수 있습니다.
• 되돌리기 메뉴는 /rewind를 입력하거나 입력창이 비어 있을 때 Esc를 두 번 눌러 엽니다. 글자가 남아 있으면 Esc 두 번은 그 글자를 지웁니다(↑로 다시 불러올 수 있습니다). 1회차 4.5의 "Esc 두 번으로 되돌리기" 설명에 입력창이 비어 있어야 한다는 조건과, 메뉴에서 복원 범위를 고르는 단계가 추가된 것입니다.
• 메뉴 선택지: 코드와 대화 모두 복원 / 대화만 복원 / 코드만 복원 / 여기서부터 요약 / 여기까지 요약 / 취소. 코드 복원 두 항목은 고른 체크포인트에 되돌릴 파일 변경이 있을 때만 나타납니다.

되돌리기에는 알아 둬야 할 한계가 있습니다. 모르면 "되돌렸는데 그대로다"를 만납니다.

• 셸 명령이 바꾼 파일은 추적되지 않습니다. rm file.txt, mv old.txt new.txt, cp source.txt dest.txt로 생긴 변경은 취소할 수 없습니다. Claude의 파일 편집 도구를 통한 직접 수정만 추적됩니다. 세션 밖에서 생긴 변경(편집기로 직접 고친 것, 다른 세션이 고친 것)과 심볼릭 링크·하드 링크 경로도 복원하지 않습니다.
• 버전 관리를 대신하지 못합니다. 공식 문서는 체크포인트를 "빠른 세션 단위 복구"용으로 설계했다고 밝히며, 영구 이력과 협업은 Git 같은 버전 관리를 쓰라고 안내합니다.

3.6 권한 확인 — 무엇을 허락하는 것인가

권한 확인 화면이 뜰 때 무엇을 허락하는 것일까요? 답은 "요청의 종류에 따라 다르다"입니다.

3.6.1 도구 종류에 따라 허락의 범위가 다르다 (확인 시점: 2026-08-23)

공식 문서의 도구 종류별 승인 요구와 "다시 묻지 않기" 유효 기간입니다. 표는 Manual 모드 기준이며, 다른 권한 모드는 이 중 어떤 것을 묻는지를 바꿉니다.

첫째, 파일 수정 승인과 명령 실행 승인은 남는 기간이 다릅니다. 파일 수정 승인은 세션이 끝나면 사라지고, Bash 명령 승인은 그 저장소·그 명령에 대해 영구히 저장됩니다(git 저장소 루트 .claude/settings.local.json).

둘째, 읽기 전용 명령은 애초에 묻지 않습니다. 내장 읽기 전용 명령 집합은 ls, cat, echo, pwd, head, tail, grep, find, wc, which, diff, stat, du, cd와 git의 읽기 전용 형태이며, 모든 모드에서 권한 확인 없이 실행되고 설정으로 바꿀 수 없습니다.

3.6.2 파일 수정 요청 vs 명령 실행 요청

명령 실행 쪽이 더 위험한 이유가 이 표에 다 있습니다. 되돌리기가 안 통하고, 허락이 오래 가고, 컴퓨터 전체에 영향을 줄 수 있습니다. 판단이 어려우면 Bash 또는 PowerShell 권한 확인 화면에서 Ctrl+E를 누르세요. 그 명령이 무엇을 하는지, 왜 실행하려는지, 무엇이 잘못될 수 있는지를 Low risk / Med risk / High risk 라벨과 함께 설명해 줍니다. 설명을 띄운다고 명령이 실행되지는 않습니다.

3.6.3 권한 모드 — 무엇을 묻고 무엇을 안 물을지의 기본 설정

1회차에서 Auto·Manual 모드를 부분적으로만 소개하고 "상세는 3회에서"라고 예고했습니다. 여기가 그 자리입니다.

권한 모드 — 한 세션에서 Claude가 먼저 묻지 않고 할 수 있는 동작의 범위를 정하는 설정입니다. 주행 보조를 어디까지 켜 둘지 고르는 것과 비슷합니다. 공식 문서 기준 여섯 가지이며, 원어 표기는 설정 파일에 그대로 쓰이는 값입니다 (확인 시점: 2026-08-23).

Manual 모드에서 Claude Code는 "파일을 수정하거나 셸 명령을 실행하거나 네트워크에 접근하는 대부분의 동작 전에 멈추고 물어봅니다." Auto 모드에서는 여러분 대신 두 번째 모델인 분류기(classifier)가 동작을 검토하며, 공식 문서는 분류기가 막는 대상으로 범위 이탈·알려지지 않은 인프라·악의적 내용이 유도한 동작을 듭니다. plan 모드에서는 "Claude가 파일을 읽고 살펴보기 위한 셸 명령을 실행하며 계획을 쓰지만, 여러분의 소스는 수정하지 않습니다."

어느 모드로 시작되는가. 공식 문서는 "Pro, Max, Team 요금제에서는 내장 시작 권한 모드가 Auto 모드"라고 명시합니다. 다만 조건이 붙습니다 (확인 시점: 2026-08-23).

• 내장 기본값 표는 첫 번째로 일치하는 행이 적용됩니다. claude -p 실행(사람이 지켜보지 않고 자동으로 실행하는 방식), Amazon Bedrock 등 클라우드 사업자 경유, Enterprise 요금제 또는 Claude Console API 키, 설치·업그레이드 후 첫 세션인 경우에는 default(Manual) 로 시작합니다.
• Pro·Max·Team 요금제이면서 터미널 또는 VS Code 확장에서 시작한 세션이 auto로 시작하는 행에 해당합니다. 내장 auto 기본값은 macOS·Linux·WSL(Windows 안에서 Linux를 쓰는 기능 — 1호 §4.1)에서 v2.1.228 이상, 네이티브 Windows에서 v2.1.233 이상을 요구하며, 낮은 버전에서는 Manual입니다.
• 표면(제공 형태 — 터미널·IDE 확장·데스크톱 앱·웹 등, 1호 §3.4)마다 고를 수 있는 모드와 전환 방법이 다릅니다. 이 회차의 실습은 터미널 기준입니다.

모드 전환은 터미널에서 Shift+Tab입니다. auto에서 처음 누르면 default로 가고, 이후 default → acceptEdits → plan → 다시 default 순으로 돕니다. 시작할 때 정하려면 claude --permission-mode default처럼 플래그를 붙입니다. 현재 모드는 상태 표시줄에 나옵니다: ⏸ manual mode on, ⏵⏵ accept edits on, ⏸ plan mode on, ⏵⏵ auto mode on.

이 회차에서 다루지 않는 말 하나 — 한 세션 동안 Claude Code가 참고하는 대화와 파일 내용의 누적분을 컨텍스트라고 부릅니다. 이번 회차는 이름만 소개하고, 정식 정의와 관리 방법은 5회 「프로젝트에 맞게 길들이기」에서 다룹니다.

4. 실습 — 한 바퀴를 직접 돌린다

아래 절차는 2026-08-23에 공식 문서로 확인했습니다. 실습 저장소는 사람마다 다르므로 각 단계의 성공 기준은 저장소가 무엇이든 똑같이 판정할 수 있는 문장으로 적었습니다.

4.1 [0단계] 세션 시작과 권한 모드 맞추기

cd /path/to/your/project
claude

상태 표시줄이 ⏸ manual mode on이 아니라면 Shift+Tab으로 Manual 모드에 맞춥니다(처음부터 지정하려면 claude --permission-mode default). 이번 실습의 목적이 권한 확인 화면을 직접 만나 판단해 보는 것이기 때문입니다 — Auto 모드에서는 분류기가 대신 검토합니다.

성공 기준: 상태 표시줄에 ⏸ manual mode on이 보이고 입력창에 글자를 칠 수 있으면 성공입니다.

4.2 [1단계] 넓게 탐색하기

입력: what does this project do?

화면 — 저장소 파일을 읽어 만든 요약이 돌아옵니다. 읽기 전용 동작이라 권한 확인 화면은 대개 뜨지 않습니다.

성공 기준: 파일을 붙여 넣지 않았는데도 내 저장소의 실제 내용을 근거로 삼은 설명이 돌아오면 성공입니다.

4.3 [2단계] 좁게 탐색하기

입력: where is the main entry point? — 이어서 find the files that handle user authentication(인증을 담당하는 파일들을 찾아 줘)처럼 물어봅니다.

성공 기준: 1단계보다 좁은 범위를 가리키는 답이 나오고, 파일 경로나 함수 이름 같은 지점이 한 곳 이상 제시되면 성공입니다.

4.4 [3단계] 수정 지시하기 — 애매하게 한 번, 구체적으로 한 번

3.3의 프롬프트 구체화를 몸으로 확인하기 위해 일부러 두 번 합니다.

첫 번째(애매하게): fix the bug

두 번째(구체적으로): 2단계에서 찾아 둔 지점을 넣어 [어디에서] [어떤 상황일 때] [무엇이 잘못된다]. [어느 파일/영역]을 봐 줘. [무엇이 되면 고쳐진 것인지]. 형식으로 다시 지시합니다. 고칠 버그가 마땅치 않다면 공식 예시 add a hello world function to the main file(메인 파일에 hello world 함수를 추가해 줘)을 쓰세요.

성공 기준: 두 응답이 서로 다르면 성공입니다(예: 앞은 어느 파일인지 되물었고, 뒤는 바로 그 파일을 열었다). 그 차이를 한 문장으로 적어 두세요.

4.5 [4단계] 파일 수정 권한 확인 화면 만나기

화면 — 파일을 고치려 하면 어느 파일을 어떻게 바꿀지 보여 주면서 허락을 묻습니다. 아직 답하지 말고 3.4의 3단 점검(파일 목록 · 분량 · 삭제 줄)을 하세요.

성공 기준: 화면에 변경될 파일과 그 변경 내용(diff) 이 표시되고, 답하기 전까지는 파일이 아직 바뀌지 않은 상태로 멈춰 있으면 성공입니다.

4.6 [5단계] 일부러 거부하고, 이유를 적어 보내기

할 일 — No에 커서를 둔 채 Tab으로 메모 입력란을 열고 이유를 적어 보내세요(예: "이 파일은 건드리지 말고 다른 방법을 제안해 줘").

성공 기준: 거부한 변경이 적용되지 않은 채로 Claude Code가 다음 지시를 기다리거나 다른 방법을 제안하면 성공입니다.

4.7 [6단계] 수용하고 결과 확인하기

같은 작업을 다시 시키고 Yes로 수용한 뒤 /diff 또는 what files have I changed?(내가 바꾼 파일이 뭐지?)로 확인합니다.

성공 기준: 방금 승인한 변경이 변경 목록에 나타나면 성공입니다.

4.8 [7단계] 되돌리기

입력 — 입력창을 비운 뒤 Esc를 두 번 누르거나 /rewind를 입력합니다.

화면 — 보낸 지시들이 목록으로 뜹니다. 되돌릴 지점을 고른 뒤 코드만 복원을 선택해 보세요.

성공 기준: 되돌리기 메뉴가 열려 보낸 지시들이 목록으로 보이고, 복원을 고른 뒤 /diff나 git diff에서 그 변경이 사라져 있으면 성공입니다. (Esc 두 번에 메뉴가 아니라 입력창 글자만 지워졌다면 정상입니다 — 입력창이 비어 있어야 메뉴가 열립니다.)

4.9 [8단계] 명령 실행 권한 확인 화면 만나기 — 테스트 실행

입력: run the new tests and fix any failures (테스트를 실행하고 실패하는 것을 고쳐 줘.) 테스트가 없는 저장소라면 run git status and show me the result로 바꿉니다 — 목적은 명령 실행 확인 화면을 만나는 것입니다. 테스트 명령을 알면 함께 적어 주세요.

화면 — 이번 확인 화면은 4단계와 모양이 다릅니다. diff가 아니라 실행하려는 명령 문자열이 보입니다. Ctrl+E를 눌러 보세요 — 3.6.2에서 본 설명과 위험도 라벨이 표시됩니다.

성공 기준: 파일 수정 때와 다른 형태의 확인 화면(실행될 명령 문자열)이 뜨고, 허용한 뒤 실행 결과가 돌아오면 성공입니다.

4.10 [9단계] 내가 지금 무엇을 허락해 뒀는지 보기

입력: /permissions

화면 — allow(허용) · ask(물어보기) · deny(금지) 규칙 목록과 각 규칙의 출처 설정 파일이 표시됩니다. 규칙은 deny → ask → allow 순으로 평가되며, 먼저 일치한 것이 결과를 정합니다.

성공 기준: 규칙 목록 화면이 열리고, 실습 중 "다시 묻지 않기"로 저장한 규칙이 있다면 목록에서 찾을 수 있으면 성공입니다. 이제 평소 쓰던 권한 모드로 돌아가세요.

4.11 트러블슈팅 — 막히는 지점과 대처 (확인 시점: 2026-08-23)

5. 이해 점검

정답 근거가 되는 제품 사실은 전부 2026-08-23에 공식 문서로 확인했습니다. 진술별 출처는 8장에 있습니다.

5.1 권한 판단 퀴즈 3문항 (LO-06 확인)

Q1. Manual 모드에서 "설정 파일에서 쓰이지 않는 항목을 지워 줘"라고 지시했더니, 화면에 어느 파일의 어느 줄이 지워지는지가 표시되면서 허락을 묻습니다. 여러분이 허락하는 것은?

1. 그 파일이 화면에 보이는 대로 바뀌는 것
2. 앞으로 그 저장소의 모든 파일 수정을 묻지 않는 것
3. 내 컴퓨터에서 임의의 명령이 실행되는 것
4. 그 파일이 Git에 커밋되는 것

Q2. 이번에는 실행하려는 명령 문자열을 보여 주며 허락을 묻는데, 그 명령이 무엇을 하는지 확신이 서지 않습니다. 가장 알맞은 행동은?

1. 일단 허락하고 문제가 생기면 Esc 두 번으로 되돌린다
2. Ctrl+E로 명령 설명과 위험도 라벨을 보고 나서 판단한다
3. "Yes, and don't ask again"을 골라 앞으로 안 묻게 한다
4. 세션을 종료한다

Q3. 매일 쓰는 테스트 실행 명령의 확인 화면에 "Yes, and don't ask again"이 보입니다. 이것을 고르면 그 허락은 언제까지 유효합니까?

1. 이번 한 번만
2. 이 세션이 끝날 때까지
3. 그 저장소에서 그 명령에 대해 영구히
4. 내 컴퓨터 전체에서 모든 명령에 대해 영구히

정답과 해설

• Q1 정답: 1 — 파일 수정 권한 확인이 허락하는 것은 화면에 보이는 그 변경이 그 파일에 적용되는 것뿐입니다. 커밋도 명령 실행도 일괄 허용도 아닙니다. "다시 묻지 않기"를 골라도 세션이 끝날 때까지만 유효합니다.
• Q2 정답: 2 — 명령 실행 확인은 그 명령이 실제로 도는 것을 허락합니다. Ctrl+E로 설명과 위험도를 먼저 보세요. 1번이 특히 위험합니다 — 셸 명령이 만든 파일 변경은 되돌리기가 추적하지 않기 때문입니다.
• Q3 정답: 3 — Bash 명령의 "다시 묻지 않기"는 저장소·명령 단위로 영구히 저장됩니다. "세션이 끝날 때까지"인 것은 파일 수정 승인입니다. 두 승인의 유효 기간이 다른 것이 핵심입니다.

5.2 실습 체크리스트 (LO-05 확인)

아래 칸을 모두 채웠다면 LO-05에 도달한 것입니다. 빈칸은 직접 적어야 합니다 — 판단 기록이 남아야 확인이 됩니다.

• 탐색 1건 — 입력한 탐색 질문: ____________ / 답이 가리킨 구체적 지점: ____________
• 수정 지시 1건 — 애매한 지시와 구체적인 지시를 각각 보냈다. 두 응답의 차이 한 문장: ____________
• 파일 수정 권한 확인 화면을 만났다 — 변경될 파일과 diff가 표시된 채 답하기 전에 멈춰 있었고, 3단 점검(파일 목록·분량·삭제 줄)을 했다
• 검토 판정 기록 1건 — 판정: ☐ 수용 ☐ 거부 ☐ 재지시 / 그렇게 판정한 이유 한 문장: ____________
• 되돌리기 1회 — 복원 범위를 골랐고, 복원 후 그 변경이 사라진 것을 확인했다
• 명령 실행 권한 확인 화면을 만났다 — 파일 수정 때와 화면이 다른 것을 확인했고 Ctrl+E로 설명을 봤다
• /permissions를 열어 봤다 — 지금 무엇을 허용해 뒀는지 확인했다

(거부할 때는 Tab으로 메모 입력란을 열어 사유를 적어 보내세요 — 4.6.)

6. 요약과 다음 회차 예고

이번 회차 요약

• 하루치 작업은 탐색 → 수정 지시 → diff 검토 → 수용·거부·재지시 → 되돌리기 → 권한 판단의 여섯 마디로 돈다. 탐색은 넓은 질문에서 좁은 질문으로 내려간다.
• 프롬프트 구체화는 대상·증상·범위·확인 방법을 지시문에 채우는 일이다. "테스트를 실행하고 결과를 보여 줘" 한 줄이 결과를 바꾼다 — 확인 수단이 없으면 "끝난 것처럼 보인다"가 유일한 신호이기 때문이다.
• diff 검토는 ① 파일 목록 ② 분량 ③ 삭제되는 줄 순으로 본다. 거부는 이유와 함께 보낸다(Tab으로 메모 입력란).
• 되돌리기는 /rewind 또는 입력창이 빈 상태에서 Esc 두 번으로 체크포인트로 돌아간다. 단 셸 명령이 바꾼 파일은 추적되지 않으며, 버전 관리를 대신하지 못한다.
• 파일 수정 권한과 명령 실행 권한은 다르다. 허락 대상도, 되돌릴 수 있는지도, "다시 묻지 않기"가 남는 기간(세션 종료까지 vs 저장소·명령 단위로 영구히)도 다르다.
• 권한 모드는 무엇을 묻고 무엇을 안 물을지의 기본 설정이며 터미널에서는 Shift+Tab으로 바꾼다. Pro·Max·Team 요금제의 터미널·VS Code 확장 세션은 내장 기본값이 auto이고, 여기에는 요금제·표면·버전 조건이 붙는다 (2026-08-23 확인).

다음 회차 예고 — 4회는 최신편 「최신 소식 따라잡기 #2」입니다. 발행 시점의 변경 사항을 이번 회차에서 익힌 일상 워크플로 관점으로 걸러 정리하고, 내 작업에 영향을 주는 항목을 골라 적용 여부와 이유를 기록하는 것이 목표입니다. 기본편은 5회 「프로젝트에 맞게 길들이기」로 이어지며, 이번 회차에서 이름만 소개한 컨텍스트를 거기서 다룹니다.

7. 용어 풀이 — 이번 회차의 새 용어 (확인 시점: 2026-08-23)

8. 근거·출처

이 문서의 Claude Code 관련 사실 진술은 아래 허용 근거 목록(집필 착수 시 선확정, 전부 Anthropic 공식 문서)에서만 가져왔으며, 진술 단위의 상세 대응은 별도 근거표로 관리하며, 아래 목록이 그 출처 전부입니다. 모든 출처의 확인 시점: 2026-08-23.

• 이 문서에 적지 않은 것: 구체 요금액(변동 가능 — 공식 요금 페이지로 안내), 확인하지 못한 세부 동작. 허용 근거에서 확인되지 않는 사항은 본문에 싣지 않았습니다.
• 본문 예시 명령·지시문은 출처 4·5·9의 공식 예시이며, 대괄호 자리표시자와 괄호 안 한국어는 이해를 돕기 위한 필자 표기입니다.
• 권한 모드 관련 진술은 요금제·표면(터미널/VS Code 확장 등)·실행 방식(사람이 지켜보는 세션인지, 자동 실행인지)·버전에 따라 달라지는 조건부 사실이므로, 본문에서 그 조건을 함께 적었습니다. 조건 없이 일반화해 읽지 마세요.