프로젝트 신뢰(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.json

git 이 추적하지 않는 내 파일입니다. git 이 추적하지 않는 한 신뢰 단계 없이 allow 규칙이 적용됩니다.

주의할 점

신뢰 전이라고 모든 것을 막지는 않습니다. 저장소 설정의 훅과 env 블록은 상위 폴더만 믿었거나 claude -p 로 돌려도 쓰입니다. 홈 폴더의 신뢰는 저장되지 않아 시작할 때마다 창이 다시 뜨니, 홈 폴더가 아닌 프로젝트 폴더에서 Claude Code 를 시작합니다.

원문과 공식 문서

이 페이지는 용어를 쉬운 말로 풀어 쓴 것입니다. 기준은 원문이니, 다르면 원문을 따르세요.

알림

알림을 켜는 방법

무엇인가요

어떻게 돌아가나요

이렇게 씁니다

주의할 점

원문과 공식 문서

무엇인가요

어떻게 돌아가나요

이렇게 씁니다

주의할 점

함께 보면 좋은 용어

원문과 공식 문서