첫 세션 실전: 실행부터 첫 코드 변경까지

설치와 로그인을 마쳤으니 이제 진짜로 일을 시켜 봅니다. 이번 편은 첫 세션 한 바퀴입니다. 어느 폴더에서 켜야 하는지, 첫 질문은 무엇이 좋은지, 탐색과 이해와 실행을 어떤 순서로 시키는지, 연습 폴더에서 파일을 만들고 코드를 넣고 결과를 확인하는 세 단계, 그리고 권한 모드와 세션 이어가기까지 다룹니다. 읽고 따라 하면 Claude Code가 만든 파일이 내 폴더에 실제로 남고, 그 파일을 다음 날 이어서 고칠 수 있게 됩니다. 다음 편은 요금제입니다.

핵심 요약

• claude는 작업 폴더 안에서 실행합니다. 켠 폴더가 곧 작업 범위입니다.
• 첫 질문은 "이 폴더에 뭐가 있는지 정리해 줘"처럼 읽기만 하는 질문이 좋습니다.
• 순서는 탐색, 이해, 실행입니다. 바로 고치라고 하기 전에 먼저 읽게 합니다.
• Shift+Tab으로 권한 모드를 바꿉니다. 처음에는 기본 모드에서 승인 창을 읽는 습관을 들입니다.
• 세션은 자동 저장되며 claude -c로 최근 대화를, claude -r로 고른 대화를 이어갑니다.

어디서 claude 를 실행해야 하나

Claude Code는 실행한 폴더를 프로젝트 디렉터리로 삼습니다. 그 아래 파일을 읽고 고치며, 그 폴더의 CLAUDE.md를 지침으로 읽고, 세션 기록도 그 폴더 기준으로 저장합니다. 우리 2주차 표현으로는 "개발 경로는 Claude Code가 일하는 사무실"입니다. 사용자 폴더 루트나 바탕화면 전체에서 켜면 스캔이 느려지고 엉뚱한 파일을 건드릴 위험이 커집니다.

# Mac
cd ~/work/practice
claude

# Windows
cd C:\Users\내이름\work\practice
claude

세션이 열리면 버전, 현재 모델, 작업 디렉터리가 화면 위에 표시됩니다. 폴더 이동 명령이 헷갈리면 Claude 앱에 "윈도우에서 work 폴더로 이동하는 명령 알려줘"라고 묻습니다. 도구 사용법을 도구에게 묻는 것이 우리가 1주차부터 권하는 공부법입니다.

첫 질문은 무엇이 좋은가

첫 질문은 파일을 바꾸지 않는 질문이 좋습니다. Claude Code가 폴더를 어떻게 읽는지, 승인 창이 언제 뜨는지를 부담 없이 볼 수 있기 때문입니다. 공식 빠른 시작이 권하는 첫 질문도 "이 프로젝트는 무엇을 하나요", "폴더 구조를 설명해 주세요"입니다. 우리 1주차 첫 지시는 이것입니다.

이 폴더에 뭐가 있는지 정리해서 알려줘

Claude Code 자체에 대해 물어봐도 됩니다. "Claude Code는 무엇을 할 수 있나요", "이 화면에 뜬 영어가 무슨 뜻이야"처럼요. 막히는 순간조차 AI에게 물으면 된다는 것을 첫 세션에서 몸으로 익히는 것이 목적입니다.

탐색 → 이해 → 실행, 지시는 어떤 순서로 내리나

바로 "고쳐 줘"부터 시작하면 엉뚱한 파일을 손대거나 의도와 다른 결과가 나옵니다. 공식 문서의 초보자 팁도 "변경하기 전에 Claude가 먼저 탐색하도록" 하라고 적고, 우리 과정은 이를 세 단계 습관으로 만듭니다.

1. 탐색: "이 폴더의 파일을 종류별로 분류해서 보여 줘." 파일을 읽기만 합니다.
2. 이해: "옮기기 전에 어떻게 정리할지 계획을 먼저 보여 줘." 계획을 글로 받습니다.
3. 실행: "내가 승인하면 실행해." 승인 창에서 내용을 읽고 허용합니다.

이 세 줄이 우리 1주차 실습 2의 원형이고, 5주차에서는 "원인 분석, 최소 수정, 변경 정리"라는 좋은 요청의 황금 문장으로 발전합니다. 큰 작업은 Shift+Tab으로 plan 모드에 들어가 계획만 받고 승인하는 것이 같은 원리입니다.

연습 폴더에서 첫 코드 변경 해 보기

빈 연습 폴더 practice에서 세 단계를 그대로 따라 해 봅니다. 실제 업무 파일이 아니라 빈 폴더에서 하는 이유는, 승인 창에서 "아니오"를 눌러도 아무 손해가 없는 상태에서 흐름을 익히기 위해서입니다.

1. 파일 생성 부탁하기

이 폴더에 CLAUDE.md 파일을 만들어 줘. 내용은 세 줄이야.
1. 나는 정책자금 컨설턴트다. 모든 문서는 존댓말로 쓴다.
2. 고객 실명은 문서에 그대로 쓰지 않는다. 홍OO 형태로 쓴다.
3. 확실하지 않은 수치는 지어내지 않는다.

Claude Code가 파일 내용을 보여 주고 승인을 묻습니다. 여기서 뜨는 창이 바로 권한 프롬프트입니다. 내용을 읽고 허용하면 파일이 생깁니다. 이 파일은 다음 세션부터 지침으로 자동 로드됩니다.

2. 코드 추가 부탁하기

이 폴더에 hello.py를 만들고, 실행하면 오늘 날짜와 "첫 세션 성공"을 출력하는 코드를 넣어 줘.

파이썬이 없는 컴퓨터라면 "실행 환경이 없으면 텍스트 파일로 대신 만들어 줘"라고 덧붙여도 됩니다. 요점은 코드 내용이 아니라, Claude가 파일을 찾고 변경안을 보여 주고 승인을 받고 편집하는 네 단계를 눈으로 보는 것입니다.

3. 결과 확인하기

방금 만든 파일을 실행해서 결과를 보여 줘. 그리고 이 폴더에 지금 어떤 파일이 있는지 목록으로 알려 줘.

명령 실행도 승인 대상입니다. 결과 화면이 실제로 찍히는 것을 확인합니다. 우리 과정의 정지 규칙은 "증거"입니다. AI가 "만들었습니다"라고 말한 것이 아니라, 실행 화면과 파일 목록이 증거입니다. 세션 안에서 ! 접두사로 셸 명령을 직접 칠 수도 있습니다. ! ls 또는 Windows에서 ! dir을 치면 Claude를 거치지 않고 결과가 대화에 붙습니다.

승인 모드(Shift+Tab)는 무엇을 바꾸나

Shift+Tab을 누를 때마다 권한 모드가 default, acceptEdits, plan 순으로 돌고, 현재 모드가 상태 줄에 표시됩니다.

auto 모드(분류기가 안전 검사를 대신하는 모드)와 bypassPermissions(모든 확인 생략)도 있지만 기본 순환에는 조건부로만 나타납니다. bypassPermissions는 인터넷이 없는 격리 컨테이너에서만 쓰라는 것이 공식 경고이고, 우리 과정에서는 다루지 않습니다. 첫 2주는 default에서 승인 창을 읽는 습관을 들이고, 3주차 이후 파일 정리 같은 반복 작업에서 acceptEdits를 씁니다. 시작할 때 모드를 정하려면 claude --permission-mode plan처럼 플래그를 붙입니다.

실제 프로젝트에서 처음 30분은 어떻게 쓰나

연습이 끝났으면 실제 업무 폴더(예: 고객 상담 메모가 쌓인 폴더)에서 30분 플랜을 돌립니다. 우리 정책지도사 과정 수강생이 실제로 쓰는 순서입니다.

1. 0~5분: 폴더에서 claude를 켜고 "이 폴더에 뭐가 있는지 정리해 줘". 파일 종류와 개수를 파악합니다.
2. 5~10분: "CLAUDE.md를 만들어 줘"로 존댓말, 실명 마스킹, 수치 확인 세 줄을 넣습니다.
3. 10~20분: 반복 업무 하나를 골격대로 시킵니다. "나는 정책자금 컨설턴트야. 매주 상담 메모를 보고서로 정리하는데, 이 폴더의 메모로 그 일을 해 줘. 결과 형식은 고객명, 상담일, 핵심 쟁점, 다음 액션 표로." 실행 전에 계획을 먼저 보여 달라고 합니다.
4. 20~25분: 결과 파일을 직접 열어 봅니다. 잘된 것 하나, 안 된 것 하나를 메모합니다.
5. 25~30분: 안 된 것을 "원인을 분석하고 최소한으로 수정해 줘"로 다시 시킵니다.

원구연이 운영하는 자동화 10종도 처음에는 전부 이 30분짜리 한 바퀴에서 출발했습니다. 처음부터 완성품을 노리지 않고, 돌아가는 최소 단위를 남기는 것이 목표입니다.

잘 먹히는 지시와 그렇지 않은 지시

1주차 교재의 "자주 하는 실수" 첫 번째가 애매하게 시키고 실망하는 것입니다. 공식 팁도 같은 말을 합니다. "버그 수정"이 아니라 "잘못된 자격증명을 입력한 뒤 빈 화면이 나오는 로그인 버그 수정"처럼 구체적으로 쓰라는 것입니다.

세 번째 줄이 5주차의 황금 문장 "원인 분석, 최소 수정, 변경 정리"입니다. 누구를 위해, 어떤 상황에서, 어떤 형태로를 넣으면 대부분의 실망은 사라집니다.

세션을 끝내고 다시 이어가려면

세션을 끝내려면 /exit를 입력하거나 Ctrl+D를 누릅니다. 대화는 ~/.claude/projects/<프로젝트>/<세션ID>.jsonl에 자동 저장되며 기본 30일간 보관됩니다(cleanupPeriodDays 설정으로 조정). 다음 날 같은 폴더에서 이어가는 방법은 두 가지입니다.

# 이 폴더의 가장 최근 대화 이어가기
claude -c

# 목록에서 골라 이어가기 (세션 선택기)
claude -r

# 이름으로 바로 이어가기
claude -r "상담보고서"

세션에 이름을 붙여 두면 찾기 쉽습니다. 시작할 때 claude -n 상담보고서, 세션 중에는 /rename 상담보고서입니다. 세션 안에서 다른 대화로 갈아타려면 /resume입니다. 세션을 재개하면 대화뿐 아니라 체크포인트도 함께 복원되므로 /rewind(또는 입력창이 빈 상태에서 Esc 두 번)로 이전 프롬프트 시점의 코드와 대화로 되돌릴 수 있습니다. 단, rm이나 mv 같은 셸 명령으로 바뀐 파일은 되돌리기 대상이 아닙니다. 영구 기록은 Git이고 체크포인트는 세션 안의 빠른 되돌리기입니다.

정리

• 작업 폴더 안에서 claude를 켜고, 첫 질문은 읽기만 하는 질문으로 시작합니다.
• 탐색, 이해, 실행 순서를 지키고 실행 전에 계획을 먼저 받습니다.
• 연습 폴더에서 파일 생성, 코드 추가, 결과 확인 세 단계를 승인 창과 함께 경험합니다.
• 권한 모드는 Shift+Tab으로 바꾸되 처음에는 기본 모드를 유지합니다.
• claude -c와 claude -r로 이어가고, /rewind로 세션 안에서 되돌립니다.

자주 묻는 질문