작업 폴더 — 왜 그 폴더에서 시작할까요
이 가이드는 곳곳에 “일할 프로젝트 폴더에 들어가서 claude를 치십시오”라고 적었습니다. 그런데 써 보면 의문이 생깁니다. 클로드는 어디서 켜도 다른 폴더의 파일을 읽어 오고, 허락하면 쓰기도 합니다. 그러면 왜 굳이 그 폴더에 들어가서 켜야 할까요. 저도 처음에는 바탕화면에서 켜 놓고 “저쪽 폴더의 문서를 고쳐 줘”라고 시켰고, 그때마다 우리 회사 규칙을 모르는 낯선 직원을 상대하는 기분이었습니다. 다른 폴더의 파일도 읽고 쓸 수 있지만, 규칙과 직원은 켠 폴더의 것을 씁니다.
클로드를 켜는 일은 아침에 출근해 오늘 일할 사무실 문을 열고 들어서는 것과 같습니다. 클로드는 다른 사무실의 서류도 가져다 읽을 수 있습니다. 하지만 그날 따를 규정, 함께 일할 직원, 보안 검사, 근무 기록은 출근한 사무실의 것입니다. 다른 사무실 서류를 읽는다고 그 사무실 직원이 되지는 않습니다. 클로드 코드에서 출근한 사무실은 claude를 친 폴더입니다. 이 폴더를 공식 안내는 작업 폴더(working directory)라고 부릅니다.
작업 폴더가 정하는 다섯 가지
아래 다섯 가지는 전부 세션(대화창을 열어 일하고 닫기까지)을 시작한 폴더를 기준으로 정해집니다. 중간에 다른 폴더의 파일을 읽어도 바뀌지 않습니다. 세션 중에 작업 폴더를 다른 폴더로 바꾸려면 /cd 뒤에 그 폴더 경로를 붙여 칩니다. 대화는 그대로 이어지고, 새 폴더의 규칙·직원·설정을 읽어 옵니다(v2.1.246 이상).
| 무엇이 | 정해지는 방식 | 한 줄 요약 |
|---|---|---|
| ① 규칙 ( CLAUDE.md) | 정해지는 방식작업 폴더에서 위로 올라가며 만나는 CLAUDE.md를 전부 읽습니다. 아래 폴더에 있는 것은 켤 때 읽지 않고, 클로드가 그 폴더의 파일을 읽을 때 함께 읽습니다. | 한 줄 요약위 폴더의 CLAUDE.md는 켤 때 모두 읽고, 아래 폴더 것은 그 폴더 파일을 열 때 읽습니다. |
| ② 직원·스킬 (서브에이전트·스킬) | 정해지는 방식작업 폴더부터 저장소 맨 위까지의 .claude/agents/·.claude/skills/에서 읽어 옵니다. 저장소는 깃(파일이 바뀐 기록을 남기는 도구)으로 기록을 관리하는 폴더입니다. 홈 폴더(내 계정의 맨 위 폴더)에 있는 ~/.claude/에서도 읽어 옵니다. 아래 폴더에 둔 직원은 켤 때 명단에 오르지 않아 이름으로 못 부릅니다. 스킬은 클로드가 그 아래 폴더의 파일을 한 번 다룬 뒤에야 함께 읽힙니다. 세션 중에 /add-dir 뒤에 그 아래 폴더의 경로를 붙여 치면, 그 폴더의 직원과 스킬을 바로 불러와 세션이 끝날 때까지 씁니다(v2.1.257 이상). | 한 줄 요약켤 때는 위로만 찾아 읽습니다. |
| ③ 설정·훅 ( settings.json·훅) | 정해지는 방식홈 폴더의 설정과 작업 폴더의 .claude/settings.json을 읽습니다. 위쪽 폴더의 설정까지 모아 읽지는 않습니다. 권한 규칙과 훅이 여기 들어 있으니, 작업 폴더가 다르면 걸리는 검사도 달라집니다. | 한 줄 요약홈 폴더와 작업 폴더의 설정만 읽습니다. |
| ④ 기억 (대화 기록·자동 메모리) | 정해지는 방식기억은 두 가지입니다. 대화 기록은 작업 폴더의 경로마다 따로 쌓여서, claude --continue는 지금 폴더의 가장 최근 대화를 엽니다. 클로드가 스스로 적는 자동 메모리는 깃 저장소 단위라, 같은 저장소 안이면 어느 하위 폴더에서 켜도 함께 씁니다. | 한 줄 요약대화 기록은 폴더마다, 자동 메모리는 저장소마다 쌓입니다. |
| ⑤ 묻지 않고 쓰는 범위 (권한) | 정해지는 방식수동 모드에서는 작업 폴더와 그 아래에만 씁니다. 그 바깥에 쓰려 하면 허락을 묻고, 바깥의 파일을 읽을 때도 한 번 묻습니다. 자동 모드도 바깥 파일을 처음 읽을 때는 묻습니다. 이때 Yes, but ask again next time을 고르면 이번 한 번만 읽게 하고, 다음에 바깥 파일을 읽을 때 또 묻습니다(v2.1.284 이상). 설정 permissions.를 켜면 그런 읽기를 아예 막습니다. | 한 줄 요약울타리가 작업 폴더에 쳐집니다. |
정리하면, 클로드는 어느 폴더의 파일이든 읽을 수 있지만 ① 규칙 ② 직원 ③ 설정 ④ 기억 ⑤ 쓰기 범위는 작업 폴더 하나를 따릅니다.
~/.claude/projects/ 아래, 작업 폴더 경로 이름으로 하나씩 생기는 폴더에 쌓이고, 자동 메모리는 그 안의 memory/ 폴더에 저장소 단위로 모입니다. 어제 대화가 안 보이면 대개 어제와 다른 폴더에서 켠 것입니다. 직접 뒤지실 필요는 없고, 세션 고르는 화면에서 Ctrl+A를 누르면 이 컴퓨터의 모든 폴더 세션이 한 번에 보입니다.
그래서 어디서 켜야 할까요 — 세 가지 경우
- 일할 프로젝트 폴더에서 켭니다. 이것이 기본이고, 대부분은 이것으로 충분합니다. 그 폴더의 규칙·직원·검사가 모두 갖춰진 채로 일합니다.
- 상위 폴더에서 켜면 — 위쪽 규칙은 읽히지만, 아래 폴더에 둔 규칙·직원·검사는 빠진 채 일합니다. 회사 폴더 안에 사업부 폴더를 두었다면, 회사 폴더에서 켜는 순간 사업부 직원은 명단에 없고 사업부 검사도 걸리지 않습니다. 파일은 읽히니 겉으로는 잘되는 것처럼 보여서 더 위험합니다.
- 하위 폴더에서 켜면 — 위쪽 폴더의 규칙(
CLAUDE.md)은 모두 따라오고, 직원·스킬은 저장소 맨 위 폴더까지만 따라옵니다(위 표 ②). 설정 파일(settings.json)은 켠 폴더와 홈 폴더 것만 읽습니다(위 표 ③). 다만 옆 폴더(같은 상위 폴더 안에 있는 다른 폴더)는 울타리 밖이라, 거기에 쓰려면 매번 허락을 묻습니다.
홈 폴더에서는 켜지 마십시오. 공식 안내에 따르면 홈 폴더에서는 “이 폴더를 믿느냐”는 확인이 저장되지 않아 켤 때마다 다시 묻습니다. 그래서 공식 안내는 그 아래의 프로젝트 폴더에서 시작하라고 권합니다. 홈 폴더에는 내 컴퓨터의 거의 모든 파일이 들어 있어서, 여기서 켜면 그 파일이 모두 울타리 안에 들어옵니다.
# 일할 폴더로 들어간 다음 켭니다 cd ~/내회사/출판팀 claude # 켠 뒤 — 규칙과 직원이 읽혔는지 확인 /context # Memory files 목록에 우리 CLAUDE.md가 있는가 # 직원 명단은 말로 묻습니다 — 우리 직원이 있는가 우리 직원 명단 보여 줘
지금 해 볼 것 —
exit로 나와서 직원 파일이 있는 폴더(.claude/agents/가 든 폴더)에 cd로 들어간 뒤 다시 claude를 칩니다. 그다음 “우리 직원 명단 보여 줘”라고 물어 명단을 확인합니다.그래도 안 되면 — 서브에이전트 페이지의 “두는 곳”에서 파일 위치와 이름 규칙을 확인하십시오.
/add-dir로 다른 폴더를 추가하면 파일을 읽고 쓰는 범위가 그 폴더까지 넓어지고, 그 폴더의 직원과 스킬(옛 방식의 커스텀 명령어 포함)도 함께 읽어 옵니다. 직원과 커스텀 명령어는 추가할 때 읽은 내용 그대로 쓰니, 그 뒤에 파일을 고쳐도 바로 반영되지 않습니다. 하지만 그 폴더의 규칙(CLAUDE.md)과 설정·훅은 기본으로 따라오지 않습니다. 설정 파일에서는 플러그인 관련 항목만 읽고, CLAUDE.md는 따로 설정을 켜 둔 경우에만 읽습니다. 설정 파일의 추가 폴더(additionalDirectories) 항목에 적어 둔 폴더는 파일을 다루는 범위에만 들어가고, 그 폴더의 직원과 스킬은 읽지 않습니다. 그 폴더의 규칙과 검사까지 필요하면 그 폴더에서 새로 켜는 편이 확실합니다.
데스크톱 앱에서도 같습니다
검은 창 대신 데스크톱 앱으로 쓰더라도 원리는 같습니다. 앱에서 새 세션을 열며 고르는 폴더가 곧 작업 폴더이고, 앱도 터미널과 같은 규칙·설정·직원 파일을 읽습니다. 어느 화면에서 쓰든, 일의 기준은 작업 폴더입니다.
책과 함께 읽기
책 8장(회사의 뼈대를 세운다)은 회사 폴더 하나에 정체성(CLAUDE.md)·권한(설정)·기억이라는 뼈대를 세우는 이야기입니다. 그 뼈대는 “어느 폴더에서 켰는가”에 따라 읽히기도 하고 빠지기도 합니다. 자료를 어디에 두는지는 앞 페이지(내 자료와 결과물 두는 곳)에서 다뤘습니다.