프로젝트 폴더(작업 폴더)

프로젝트 폴더는 Claude Code와 함께 한 가지 일을 진행하는 기준 폴더입니다. 홈페이지를 만들면 홈페이지 파일을, 강의를 준비하면 원고와 참고자료를 그 안에 둡니다. Claude Code를 이 폴더에서 실행한 뒤, 자료를 살펴보고 파일을 만들거나 고쳐 달라고 요청합니다.

1. 설치는 컴퓨터에, 작업은 프로젝트 폴더에서 합니다

새 프로젝트를 시작할 때마다 Claude Code를 다시 설치하지 않습니다. 이번 일을 할 폴더로 이동한 다음 claude를 실행합니다.

workspace/
  lecture-practice/   이번 강의 준비
  website/            별도 홈페이지 작업

이 예에서 workspace는 프로젝트들을 모은 큰 폴더입니다. 이름은 마음대로 바꿔도 됩니다. 강의 준비는 lecture-practice 안에서, 홈페이지 작업은 website 안에서 시작합니다.

Finder나 파일 탐색기에서 폴더를 열었다고 터미널도 그 위치로 바뀌지는 않습니다. 아래는 Claude Code 설치와 로그인을 마친 뒤 각자 컴퓨터에서 하는 연습입니다. 같은 이름의 폴더에 기존 자료가 있다면 새 연습 이름을 사용합니다. 명령은 한 줄씩 입력합니다.

Mac — 터미널 앱에서 입력합니다

mkdir -p "$HOME/workspace/lecture-practice"
cd "$HOME/workspace/lecture-practice"
pwd
claude

pwd 결과가 /Users/내계정/workspace/lecture-practice처럼 끝나는지 확인한 뒤 claude를 실행합니다. $HOME은 현재 로그인한 사람의 홈 폴더입니다.

Windows — PowerShell에서 입력합니다

New-Item -ItemType Directory -Force -Path "$HOME\workspace\lecture-practice"
Set-Location "$HOME\workspace\lecture-practice"
Get-Location
claude

Get-Location 결과가 C:\Users\내계정\workspace\lecture-practice처럼 끝나는지 확인합니다. 여기서는 Windows의 PowerShell을 사용합니다. WSL은 Linux 환경이므로 위 Windows 경로를 그대로 사용하지 않습니다.

공식 참고: 프로젝트 폴더에서 Claude Code 시작하기.

2. Claude는 자료를 살펴보고, 필요한 파일을 만들어 정리합니다

폴더를 열기만 하면 일정한 구조로 자동 정리되는 것은 아닙니다. 원하는 일을 말하면 Claude가 파일 목록을 확인하고 필요한 내용을 읽은 뒤 작업합니다. 어떤 폴더와 파일을 만들지는 기존 구조와 이번 요청에 따라 달라집니다.

자료를 폴더에 넣는 것과 Claude가 내용을 읽는 것은 별개입니다. 중요한 자료는 이름을 짚어 “이 파일을 읽고 작업해 줘”라고 요청합니다. 비어 있는 폴더라면 작업 목적부터 설명합니다.

공식 참고: 자료 확인 → 실행 → 결과 확인, 프로젝트와 파일 접근.

3. 강의 준비 폴더를 Claude에게 만들어 달라고 합니다

다음 글은 Mac·Windows 공통으로 실행 중인 Claude Code의 대화 입력창에 넣습니다. 일반 터미널의 명령 입력줄에 넣는 글이 아닙니다.

첫 요청 — 확인하고 제안받습니다

여기는 AI 코딩 입문 강의를 준비할 폴더야.
현재 폴더의 전체 경로와 들어 있는 파일을 먼저 확인해 줘.
참고자료, 작성 중인 원고, 완성 자료를 구분해서 관리하고 싶어.
아직 파일을 옮기거나 수정하지 말고 간단한 폴더 구성을 제안해 줘.
새로 만들 파일과 기존 파일을 구분해서 설명해 줘.

다음 요청 — 정한 구조를 실제 파일로 만듭니다

이 연습에서는 다음 구성으로 만들어 줘.
- materials: 내가 넣을 참고자료를 보관할 폴더
- drafts: 작성 중인 원고를 보관할 폴더
- output: 완성된 자료를 보관할 폴더
- README.md: 프로젝트의 목적과 각 폴더의 역할을 설명하는 파일

drafts/intro.md에 'AI에게 일을 부탁할 때 필요한 세 가지'라는
짧은 강의 원고를 작성해 줘.
기존 파일은 옮기거나 덮어쓰지 말고, 겹치는 이름이 있으면 알려 줘.
끝나면 생성한 파일의 전체 경로와 확인 방법을 알려 줘.

하위 폴더를 명령어로 하나씩 만들지 않아도 됩니다. Claude Code에 목적과 저장 위치를 알려 주면 허용된 도구를 사용해 폴더와 파일을 만듭니다. 권한 확인이 표시되면 대상과 작업 내용을 읽고 진행합니다.

4. 답변이 실제 파일로 남았는지 확인합니다

위 요청을 처리한 뒤 기대하는 모습입니다. 이는 이번 연습에서 정한 구성이며 모든 Claude Code 프로젝트의 필수 구조는 아닙니다.

lecture-practice/
  README.md
  materials/
  drafts/
    intro.md
  output/

Mac은 Finder, Windows는 파일 탐색기에서 같은 프로젝트 폴더를 엽니다. “작성했습니다”라는 답변만 보지 말고 drafts/intro.md가 실제로 생겼는지 확인합니다. 파일이 없으면 저장 경로를 다시 확인하도록 요청합니다.

5. 반복해서 지킬 정리 방식은 CLAUDE.md에 적습니다

README.md는 프로젝트 소개 문서이고, CLAUDE.md는 Claude Code가 작업할 때 참고하는 지침 파일입니다. 매번 같은 저장 위치와 규칙을 설명한다면 그 내용을 남깁니다.

Mac·Windows 공통으로 Claude Code 대화 입력창에 다음과 같이 요청할 수 있습니다.

이 프로젝트의 CLAUDE.md에 다음 규칙을 정리해 줘.
- 참고자료는 materials에 두고 원본은 요청 없이 수정하지 마.
- 작성 중인 원고는 drafts에 저장해 줘.
- 완성본을 요청받으면 output에 별도 파일로 저장해 줘.
- 설명 문장은 '~입니다 / ~합니다'로 통일해 줘.
- 작업이 끝나면 바뀐 파일과 확인 방법을 알려 줘.
이미 CLAUDE.md가 있으면 먼저 읽고 기존 지침과 충돌하는지 확인해 줘.

기존 프로젝트에서는 Claude Code 안에서 /init으로 프로젝트를 살펴보고 CLAUDE.md의 초안을 만들 수도 있습니다. 이 명령은 자료를 폴더별로 자동 분류하는 기능이 아닙니다. 만들어진 지침은 읽고 실제 작업 방식에 맞게 다듬습니다.

CLAUDE.md는 지침이지 파일 접근을 강제로 막는 장치는 아닙니다. 프로젝트 폴더를 정했다고 그 밖의 모든 파일 접근이 차단되는 것도 아닙니다. 실제 접근 범위는 실행 환경과 권한 설정에 따라 달라집니다.

공식 참고: 프로젝트 지침과 /init, 지침 파일과 기억의 차이.

6. 다음 날에도 같은 폴더에서 이어서 작업합니다

같은 프로젝트 폴더로 들어가 claude를 실행합니다. 새 대화가 이전 대화를 모두 기억한다고 가정하지 말고, “README.md와 drafts/intro.md를 읽고 원고를 다듬어 줘”처럼 이어서 할 일을 알려 줍니다.

기존 홈페이지 프로젝트를 정리한다면 파일 이동이 코드 경로나 링크에 영향을 줄 수 있습니다. “어디를 옮기면 무엇에 영향을 주는지 먼저 확인해 줘”라고 요청합니다.

SSH로 원격 컴퓨터(SSH로 접속한 컴퓨터)에 접속했다면 작업 폴더도 원격 컴퓨터에 있습니다. 예를 들어 /home/user/projects/lecture에서 Claude Code를 실행하면 원격 컴퓨터의 강의 파일을 다룹니다. 내 컴퓨터(로컬)의 같은 이름 폴더와 자동으로 같은 내용이 되지는 않습니다.

함께 보기: Mac·Windows 명령어 · 경로 · 로컬·SSH에서 끌어다 놓기 · 마크다운