프로젝트 신뢰(Project trust)
가 설정을 읽기 전에 폴더를 믿는다고 허락하기. 무엇인지, 어떻게 돌아가고 어떻게 쓰는지, 조심할 점까지 그림과 예로 풀어 봅니다.
무엇인가요
프로젝트 신뢰는 대화형 세션에서 어떤 폴더에 를 처음 시작할 때 거치는 확인입니다. 는 자기 .claude/settings.json 을 가지고 올 수 있고, 그 안의 permissions.allow 규칙과 additionalDirectories 같은 항목은 힘을 더 줍니다. 신뢰 창은 그런 항목을 보여 주어 먼저 읽게 하고, 받아들이기 전에는 Claude Code 가 그 항목을 쓰지 않습니다. deny·ask 규칙은 막기만 하므로 받아들이기 전에도 적용됩니다. 저장소에서는 답이 저장소 루트에 저장되지만, 홈 폴더에서는 이번 세션에만 유효합니다.
어떻게 돌아가나요
-
새 폴더에서 claude 시작
-
창에 나온 항목 읽기
-
믿을 때만 받아들이기
-
저장소마다 답이 저장됨
이렇게 씁니다
-
~/.claude.json프로젝트별 상태와 함께 신뢰 답을 저장합니다. 키 이름은
hasTrustDialogAccepted입니다. -
claude -p신뢰 창을 띄우지 않습니다. 프로젝트 allow 규칙은 쓰지 않고 stderr 에
this workspace has not been trusted경고를 내지만, 훅과.mcp.json는 그대로 실행됩니다. -
--setting-sources user내가 쓰지 않은 저장소에서
claude -p를 돌리기 전에 붙이면, 프로젝트 과.mcp.json을 읽지 않습니다. -
.claude/settings.local.jsongit 이 추적하지 않는 내 파일입니다. git 이 추적하지 않는 한 신뢰 단계 없이 allow 규칙이 적용됩니다.
주의할 점
신뢰 전이라고 모든 것을 막지는 않습니다. 저장소 설정의 훅과 env 블록은 상위 폴더만 믿었거나 claude -p 로 돌려도 쓰입니다. 홈 폴더의 신뢰는 저장되지 않아 시작할 때마다 창이 다시 뜨니, 홈 폴더가 아닌 프로젝트 폴더에서 Claude Code 를 시작합니다.
함께 보면 좋은 용어
원문과 공식 문서
이 페이지는 용어를 쉬운 말로 풀어 쓴 것입니다. 기준은 원문이니, 다르면 원문을 따르세요.
- 원문에서 이 용어 보기Claude Code Docs — Glossary Anthropic · 2026-10-19 확인
- Anthropic — Claude Code docs: Configure permissions — Project allow rules and workspace trust(새 창에서 열림)
- Anthropic — Claude Code docs: Configure permissions — What runs before you trust a folder(새 창에서 열림)
- Anthropic — Claude Code docs: Security — Additional safeguards(새 창에서 열림)
- Anthropic — Claude Code docs: Explore the .claude directory(새 창에서 열림)