처음 만나는 AI와 Claude Code

Claude Code를 열고 작업 폴더 확인하기

1장 둘째 페이지. Claude Code를 열고 작업 폴더 확인하기

이번 장에서는 Claude Code를 설치하고 연습용 폴더에서 대화를 시작합니다. 끝나면 AI가 어느 폴더를 보고 있는지 알 수 있어야 합니다. 잘못된 폴더에서 시작하면 관계없는 파일을 읽거나 바꿀 수 있으므로, 첫 질문은 폴더 확인에 씁니다. 함께 확인해 볼까요?

Claude를 쓰는 여러 화면

1장 첫째 페이지에서 LLM, Claude, Claude Code의 관계를 살펴봤습니다. 이제 같은 Claude를 만나는 여러 화면을 구분해 볼까요?

• Claude 웹사이트: 브라우저에서 claude.ai에 접속해 대화합니다. 별도 앱을 설치하지 않고 시작할 수 있습니다.

• Claude 데스크톱 앱: 컴퓨터에 앱을 설치해 Claude와 대화합니다. 지원되는 환경과 계정에서는 앱 안에서 Claude Code 기능도 사용할 수 있습니다.

• Claude Code CLI: 컴퓨터의 터미널에서 claude 명령을 실행합니다. 현재 작업 폴더를 기준으로 파일을 살펴보고 수정하거나 명령을 실행하는 실습에 적합합니다. CLI는 명령줄 인터페이스를 뜻합니다.

웹과 데스크톱에서도 Claude Code를 사용할 수 있습니다. Claude Code 공식 개요는 터미널, IDE, 데스크톱 앱, 웹을 안내합니다. 이 책에서 CLI를 쓰는 이유는 내 컴퓨터의 작업 폴더에서 바로 시작할 수 있기 때문입니다. 이미 있는 파일을 살펴보고 같은 폴더에 결과를 저장하며, 필요한 경우 컴퓨터에 설치된 명령도 사용할 수 있습니다. 작업할 파일을 다른 곳에 옮기거나 별도의 온라인 개발 환경을 준비하지 않아도 첫 실습을 따라갈 수 있습니다.

이 책의 모든 실습은 Claude Code CLI를 기준으로 설명합니다. 다음 절에서 설치한 뒤 연습용 폴더로 이동해 claude를 실행해 보세요. 실제로 사용할 수 있는 기능과 파일 접근 범위는 계정, 작업 환경, 허용한 권한에 따라 달라집니다.

아래는 Anthropic가 공개한 실제 Claude Code 터미널 화면입니다. 그림의 입력 줄처럼 터미널에서 Claude Code와 대화합니다. 화면 모양과 표시되는 정보는 버전과 계정에 따라 달라질 수 있습니다.

이미지 출처: Anthropic, 「Enabling Claude Code to work more autonomously」(2025).

설치하고 실행 확인하기

이미 Claude Code가 설치되어 있다면 터미널에서 claude --version을 실행해 버전이 표시되는지만 확인하고 다음 절로 넘어갑니다. 처음 설치한다면 공식 빠른 시작의 설치 단계를 열어 보세요. 공식 문서의 기본 설치 명령은 다음과 같습니다. 실행하기 전에 현재 공식 페이지와 자신의 운영체제를 다시 확인해 주세요.

macOS·Linux·WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows의 명령 프롬프트(CMD)를 쓰거나 다른 설치 방법이 필요하면 공식 페이지에서 해당 항목을 고릅니다. 설치가 끝나면 새 터미널을 열어 다음을 실행해 볼까요?

claude --version

버전 번호가 보이면 다음으로 넘어가면 됩니다. claude를 찾을 수 없다는 메시지가 나오면 설치가 끝나지 않았거나 실행 경로가 적용되지 않은 상태일 수 있습니다. 이때는 같은 공식 문서의 설치 문제 해결 링크를 따라가 보세요. 이 책의 예제 때문에 별도 개발 도구를 설치할 필요는 없습니다.

Claude Code를 사용하려면 지원되는 계정이나 조직에서 제공한 접근 권한이 필요합니다. 첫 실행에서 로그인 화면이 나오면 화면의 안내를 따릅니다. 로그인 방식과 비용은 계정에 따라 다르므로 공식 계정 안내를 확인해 주세요.

연습용 폴더에서 시작하기

다른 작업 파일과 섞이지 않도록 내 컴퓨터에 새 폴더를 만듭니다. 홈 폴더는 내 계정의 파일을 두는 기본 위치이며, 터미널에서는 ~로 나타냅니다. 이 절을 마치면 폴더 위치는 다음과 같습니다. index.html은 아직 없고 2장에서 만듭니다.

내 컴퓨터
└─ 내 홈 폴더 (~)
   └─ reading-club-practice/  ← 이 책의 연습용 폴더

다음 명령은 macOS·Linux의 터미널과 Windows PowerShell에서 사용할 수 있습니다. 각 명령을 입력한 뒤 Enter를 누르고, 결과를 확인한 다음 다음 단계로 가세요.

1. 홈 폴더로 이동합니다.

   복사

   cd ~

   화면에 아무 글도 나오지 않아도 정상입니다. 터미널의 현재 위치가 홈 폴더로 바뀝니다.

2. 홈 폴더 안에 연습용 폴더를 만듭니다.

   복사

   mkdir reading-club-practice

   macOS·Linux에서는 보통 아무 글도 나오지 않고, PowerShell에서는 새 폴더 정보가 표시될 수 있습니다. 같은 이름의 폴더가 이미 있다는 오류가 나오면 기존 내용을 살펴보거나 다른 폴더 이름을 정하세요. 다른 이름을 골랐다면 아래 명령에도 같은 이름을 쓰면 됩니다.

3. 방금 만든 폴더로 이동합니다.

   복사

   cd reading-club-practice

   오류 없이 다음 입력 줄이 나타나면 그 폴더로 이동한 것입니다.

4. 현재 위치를 확인합니다. pwd는 지금 어느 폴더에 있는지 경로를 보여 줍니다.

   복사

   pwd

   경로의 앞부분은 컴퓨터마다 다릅니다. macOS에서는 /Users/사용자이름/reading-club-practice, Linux에서는 /home/사용자이름/reading-club-practice, Windows PowerShell에서는 C:\Users\사용자이름\reading-club-practice 같은 경로가 보일 수 있습니다. 끝이 연습용 폴더 이름인지 확인하세요.

5. 폴더 안을 확인합니다. ls는 현재 폴더에 있는 파일과 폴더의 이름을 보여 줍니다.

   복사

   ls

   새 폴더라면 아무 이름도 나오지 않습니다. 파일 이름이 보인다면 다른 폴더에 있거나 기존 폴더를 연 것일 수 있으니, pwd 결과를 다시 확인하세요.

6. 위치와 내용을 확인했으면 Claude Code를 시작합니다.

   복사

   claude

   첫 실행에서는 로그인 안내가 나올 수 있습니다. 로그인을 마치고 대화 입력창이 보이면 작업을 시작할 수 있습니다. Claude Code가 표시하는 작업 폴더도 방금 확인한 reading-club-practice인지 살펴보세요. 작업 폴더는 Claude Code가 파일을 살펴볼 때의 출발점이지만, 접근 권한을 저절로 제한하지는 않습니다. 이후 파일 작업을 허용할 때도 대상을 확인해 주세요.

첫 질문은 읽기만

아래 문장을 대화창에 입력합니다.

지금 어느 폴더에서 작업 중이야? 이 폴더에 어떤 파일이 있는지 알려줘. 아직 파일을 만들거나 바꾸지 마.

방금 만든 빈 폴더라면 파일이 없다는 답을 받는 것이 정상입니다. 이미 파일이 있다고 하면 현재 폴더를 다시 확인합니다. 작업형 AI에 처음 부탁할 때는 이처럼 현재 상태를 먼저 묻는 요청이 유용합니다. 질문에 답하는 동안 Claude Code가 폴더를 읽을 수는 있지만, 위 요청에서는 파일 변경을 지시하지 않았습니다.

직접 확인하기

대화에서 보고된 폴더 이름이 내가 만든 폴더와 같은지, index.html이 아직 없다고 말하는지 확인해 봅니다. 둘 다 맞으면 2장으로 넘어가면 됩니다. 작업 폴더가 다르면 Claude Code를 종료하고 올바른 폴더로 이동한 뒤 다시 시작해 주세요.

참고 링크

• https://claude.ai

• https://code.claude.com/docs/en/overview

• https://www.anthropic.com/news/enabling-claude-code-to-work-more-autonomously

• https://code.claude.com/docs/en/quickstart