첫 번째 대화 시작하기

🎯 학습 목표

2강에서 설치와 로그인을 마쳤다면, 이제 클로드 코드와 실제로 대화를 나눌 차례입니다. 이 강에서는 코드를 고치기 전 단계, 즉 질문하고, 답을 읽고, 대화를 이어 가고 멈추는 방법에 집중합니다. 운전으로 치면 출발·정지·방향 전환을 먼저 익히는 단계입니다.

• 프로젝트 폴더에서 대화형 세션을 시작하고 종료할 수 있습니다.
• 코드베이스를 이해하기 위한 첫 질문을 효과적으로 던질 수 있습니다.
• 응답 중에 나타나는 도구 사용 기록과 권한 확인을 읽고 대응할 수 있습니다.
• Esc로 중단하고, 메시지를 대기열에 넣고, claude -c로 대화를 이어 갈 수 있습니다.

실습을 위해 git으로 관리되는 작은 연습용 프로젝트를 하나 준비해 주세요. 직접 만든 토이 프로젝트나 GitHub에서 내려받은 오픈소스 예제면 충분합니다.

🚀 세션 시작하기: 어디서 실행하느냐가 중요하다

이 섹션에서는 세션을 시작하는 방법과, 실행 위치가 왜 중요한지 살펴보겠습니다.

cd ~/practice-project
claude

첫 줄은 작업할 프로젝트 폴더로 이동하고, 둘째 줄은 대화형 모드(interactive mode)를 시작합니다. 공식 퀵스타트에 따르면 프롬프트 위에 버전, 현재 모델, 작업 디렉터리가 표시됩니다. 이 표시를 보고 내가 의도한 폴더에서 실행했는지 반드시 확인하는 습관을 들이세요.

실행 위치가 중요한 이유는 클로드 코드가 실행한 디렉터리와 그 하위 폴더를 작업 범위로 삼기 때문입니다. 공식 문서는 이 디렉터리의 파일, 터미널, git 상태, CLAUDE.md에 접근한다고 설명하며, 다른 위치의 파일은 사용자 허락이 있을 때만 다룹니다. 홈 디렉터리에서 무심코 실행하면 수많은 무관한 파일이 탐색 대상이 되어 답이 흐려지고 시간도 낭비됩니다. 처음 여는 폴더라면 이 폴더를 신뢰하는지 묻는 확인 화면이 나올 수 있는데, 내가 아는 프로젝트인지 확인한 뒤 진행합니다.

세션을 시작하는 방법은 한 가지가 아닙니다. 공식 퀵스타트의 필수 명령을 정리하면 다음과 같습니다.

명령	동작	언제 쓰나
claude	대화형 모드 시작	일반적인 작업
claude "작업"	첫 프롬프트를 담아 대화형 시작	할 일이 정해져 있을 때
claude -p "질문"	한 번 답하고 종료	빠른 질문, 스크립트
claude -c	현재 디렉터리의 가장 최근 대화 이어 가기	어제 하던 작업 계속
claude -r	이전 대화를 골라 재개	여러 작업을 오갈 때

세션을 끝낼 때는 /exit를 입력하거나 Ctrl+D를 두 번 누릅니다. Ctrl+C는 실행 중인 작업이 있으면 중단하고, 아무것도 실행 중이 아니면 첫 번째에 입력을 지우고 두 번째에 종료합니다. 대화는 로컬에 저장되므로 종료해도 claude -c로 다시 이어 갈 수 있습니다.

💬 첫 질문 던지기: 읽기 전용 질문부터

이 섹션에서는 어떤 질문으로 대화를 시작하면 좋은지, 그리고 질문을 잘 쓰는 요령을 살펴보겠습니다.

공식 퀵스타트는 첫 단계로 코드베이스를 이해하는 질문을 권합니다. 파일을 바꾸지 않는 질문이라 부담이 없고, 클로드 코드가 프로젝트를 어떻게 탐색하는지 관찰하기에도 좋습니다. 질문은 한국어로 해도 됩니다.

이 프로젝트는 무엇을 하는 프로젝트야?
이 프로젝트는 어떤 기술을 사용해?
프로그램의 진입점(main entry point)은 어디야?
폴더 구조를 설명해 줘

이런 질문을 할 때 파일을 직접 붙여 넣을 필요가 없습니다. 공식 문서는 클로드 코드가 필요할 때 프로젝트 파일을 스스로 읽으므로 수동으로 맥락을 추가하지 않아도 된다고 설명합니다. 이것이 1강에서 배운 채팅형 도구와의 결정적 차이입니다. 특정 파일을 콕 집어 보여 주고 싶다면 @를 입력해 파일 경로 자동완성을 쓸 수 있습니다.

클로드 코드 자체에 대해 물어볼 수도 있습니다. "클로드 코드로 무엇을 할 수 있어?", "클로드 코드에서 커스텀 스킬은 어떻게 만들어?"처럼 질문하면 사용법을 설명해 줍니다. 입력창에 /를 치면 사용할 수 있는 명령 목록이 나오고, /help로 도움말을 볼 수 있습니다.

질문의 품질이 답의 품질을 좌우합니다. 공식 문서의 초보자 팁은 "버그를 고쳐 줘" 대신 "잘못된 비밀번호를 입력하면 빈 화면이 뜨는 로그인 버그를 고쳐 줘"처럼 구체적으로 요청하라고 권합니다. 긴 요청은 여러 줄로 나눠 쓰면 읽기 좋은데, Enter는 전송이므로 줄바꿈은 \ 다음 Enter를 누르거나 Ctrl+J를 씁니다. 두 방법은 별도 설정 없이 모든 터미널에서 동작합니다.

👀 응답 읽기: 답변보다 과정을 본다

이 섹션에서는 클로드 코드의 응답을 어떻게 읽어야 하는지 살펴보겠습니다. 초보자는 마지막 답변 문장만 보는 경우가 많지만, 실력자는 답에 이르는 과정을 함께 봅니다.

질문을 보내면 클로드 코드는 곧바로 답하지 않고 1강에서 배운 에이전틱 루프를 돕니다. 화면에는 파일을 검색하고 읽는 등 어떤 도구를 사용했는지가 순서대로 표시되고, 충분한 맥락을 모은 뒤 최종 답변이 나옵니다. 이 기록을 보면 클로드 코드가 어떤 파일을 근거로 답했는지 알 수 있습니다. 예를 들어 진입점을 물었는데 설정 파일 한두 개만 읽고 답했다면, 추측이 섞였을 수 있으니 "실제 코드를 확인하고 다시 답해 줘"라고 요청하는 것이 좋습니다.

화면에서 줄여 보여 주는 부분을 자세히 보고 싶다면 Ctrl+O로 트랜스크립트 뷰어를 엽니다. 공식 문서에 따르면 도구 사용과 실행 내역을 자세히 보여 주며, 각 응답에 타임스탬프와 사용된 모델이 함께 표시됩니다.

응답 도중 권한 확인이 뜰 수도 있습니다. 파일을 수정하거나 명령을 실행하려 할 때 허락을 구하는 화면입니다. 어떤 행동에서 묻는지는 권한 모드에 따라 다릅니다. 공식 퀵스타트 기준으로 Pro·Max·Team 요금제의 대화형 터미널 세션은 분류기가 위험한 행동을 걸러 내는 Auto 모드로 시작하고, 다른 요금제는 파일 편집과 명령 실행 전에 묻는 Manual 모드로 시작합니다. 설정이나 조직 정책에 따라 달라질 수 있으며, Shift+Tab으로 언제든 모드를 바꿀 수 있습니다. 권한 확인 화면에서 Esc를 누르면 그 행동을 거절한 것으로 처리됩니다.

주의할 점은 그럴듯한 답이 항상 정확한 답은 아니라는 것입니다. 특히 프로젝트에 없는 함수나 설정을 언급하면 "그 코드가 어느 파일 몇 번째 줄에 있어?"라고 되물어 근거를 확인하세요. 근거를 요구하는 습관이 AI 도구를 안전하게 쓰는 가장 쉬운 방법입니다.

🔄 대화 흐름 제어하기: 멈추고, 끼어들고, 되돌리기

이 섹션에서는 대화가 진행되는 구조와, 흐름을 원하는 방향으로 조종하는 조작법을 살펴보겠습니다.

클로드 코드의 대화는 턴(turn) 단위로 진행됩니다. 내가 메시지를 보내면 클로드가 필요한 만큼 도구를 쓰고 답을 마칠 때까지가 한 턴입니다. 그리고 대화는 누적됩니다. 앞에서 한 질문과 읽은 파일이 컨텍스트로 남아 있으므로, "그럼 거기서 에러 처리는 어떻게 해?"처럼 이어서 물어도 이해합니다.

상황	조작	동작(공식 문서 기준)
방향이 틀렸다	Esc	현재 응답·도구 실행을 중단, 그때까지 한 작업은 유지
작업 중 추가 지시	메시지 입력 후 Enter	중단하지 않고 대기열에 넣었다가 진행 중인 도구 실행이 끝나면 전달
대기열 취소	입력창 첫 줄에서 ↑	대기 중인 메시지를 입력창으로 되돌림
이전 시점으로	입력창이 빈 상태에서 Esc 두 번	되감기 메뉴에서 코드·대화를 이전 시점으로 복원
주제 전환	/clear	대화 기록 비우기

현장에서 가장 많이 보는 실수는 잘못된 방향으로 가는 것을 보면서도 끝날 때까지 기다리는 것입니다. 기다린 만큼 시간과 사용량이 소모되고, 틀린 결과를 되돌리는 일까지 생깁니다. 이상하다 싶으면 바로 Esc를 누르고 "그 파일이 아니라 src/api 쪽을 봐 줘"처럼 방향을 다시 잡아 주세요. 반대로 방향은 맞는데 조건을 하나 빠뜨렸다면, 멈추지 말고 메시지를 대기열에 넣는 편이 흐름이 끊기지 않습니다.

두 번째 실수는 전혀 다른 작업을 같은 대화에서 계속 이어 가는 것입니다. 앞선 작업의 내용이 컨텍스트에 쌓여 새 작업의 답이 흐려질 수 있습니다. 작업이 바뀌면 /clear로 비우고 시작하는 것이 좋습니다. 컨텍스트를 관리하는 더 정교한 방법은 18강에서 자세히 다룹니다.

📝 핵심 요약

• ☐ 반드시 프로젝트 폴더에서 claude를 실행하고, 상단의 작업 디렉터리를 확인합니다.
• ☐ 첫 대화는 파일을 바꾸지 않는 코드베이스 이해 질문으로 시작합니다. 파일은 붙여 넣지 않아도 됩니다.
• ☐ 요청은 구체적으로, 여러 줄은 \+Enter 또는 Ctrl+J로 씁니다.
• ☐ 답변만 보지 말고 어떤 파일을 근거로 했는지 도구 기록을 확인합니다(Ctrl+O).
• ☐ 틀리면 Esc, 조건 추가는 대기열, 주제가 바뀌면 /clear, 이어 하기는 claude -c.

다음 4강에서는 클로드 코드가 파일을 읽고, 새로 만들고, 편집하는 과정을 직접 실습하며 변경 내용을 검토하고 승인하는 방법을 익혀 보겠습니다.

📚 참고 자료

• Quickstart — Claude Code Docs (Anthropic)
• Interactive mode — Claude Code Docs (Anthropic)
• How Claude Code works — Claude Code Docs (Anthropic)
• Permission modes — Claude Code Docs (Anthropic)